#workgraph-llm

workgraph-llm adapts mizchi/llm messages, tools, and collected results to workgraph-core nodes without selecting a provider or runtime.

#Package

import {
  "totto2727/workgraph-llm"
}

The module prefers JavaScript and supports JavaScript and native targets. Wasm targets are excluded because mizchi/llm exposes aborting Wasm stubs for required runtime operations.

#Example

moon run package/workgraph-llm/src/examples/basic

#
LlmNodeError

source

pub suberror LlmNodeError {
  ProviderFailed(String)
} derive(@moonbitlang/core/debug.Debug
Debug)

Raised when an LLM provider reports a stream failure.

#
LlmNodeSpec

source

pub struct LlmNodeSpec[S, P] {
  provider : @mizchi/llm.BoxedProvider
BoxedProvider
  build_request : (@totto2727/workgraph-core.NodeContext
NodeContext, S) -> LlmRequest raise
  decode_response : (S, @mizchi/llm.CollectResult
CollectResult) -> @totto2727/workgraph-core.NodeOutput
NodeOutput[P] raise
}

#
LlmNodeSpec::LlmNodeSpec

source

fn[S, P] LlmNodeSpec::LlmNodeSpec(provider : @mizchi/llm.BoxedProvider
BoxedProvider, build_request : (@totto2727/workgraph-core.NodeContext
NodeContext, S) -> LlmRequest raise, decode_response : (S, @mizchi/llm.CollectResult
CollectResult) -> @totto2727/workgraph-core.NodeOutput
NodeOutput[P] raise) -> LlmNodeSpec[S, P]

Creates a provider-backed LLM graph-node specification.

#
LlmRequest

source

pub(all) struct LlmRequest {
  messages : Array[@mizchi/llm.Message
Message]
  tools : Array[@mizchi/llm/tools.ToolDef
ToolDef]
}

A provider-neutral request built from mizchi/llm message and tool types.

#
LlmRequest::LlmRequest

source

fn LlmRequest::LlmRequest(messages : Array[@mizchi/llm.Message
Message], tools? : Array[@mizchi/llm/tools.ToolDef
ToolDef]) -> LlmRequest

Creates one LLM invocation request.

#
llm_node

source

fn[S, P] llm_node(id : @totto2727/workgraph-core.NodeId
NodeId, metadata : @totto2727/workgraph-core.NodeMetadata
NodeMetadata, spec : LlmNodeSpec[S, P]) -> @totto2727/workgraph-core.Node
Node[S, P]