simple-agents-wasm 0.3.6 → 0.3.7

package/README.md

@@ -4,9 +4,10 @@ Browser-compatible SimpleAgents client for OpenAI-compatible providers.
 
 ## Status
 
-This package now loads a Rust-compiled WASM core (`rust/src/lib.rs`) for
-runtime execution when wasm artifacts are available. A JS fallback remains for
-non-wasm environments and local Node tests.
+This package is Rust-WASM only. Runtime execution is provided by the
+Rust-compiled core in `rust/src/lib.rs` and requires generated wasm artifacts.
+If artifacts are missing or initialization fails, the package throws an
+explicit backend-load error.
 
 ## Install
 
@@ -51,4 +52,4 @@ console.log(result.content);
   - step workflows (`steps` DSL)
   - graph workflows (`entry_node` + `nodes` + `edges`) with `llm_call`, `switch`, and `custom_worker`.
 - Graph `custom_worker` nodes call `workflowOptions.functions[handler]` and throw a runtime error when the handler is missing.
-- Use `hasRustBackend()` to check whether Rust wasm backend was loaded.
+- Use `hasRustBackend()` to check whether the Rust wasm backend is available.

package/index.d.ts

@@ -147,6 +147,30 @@ export interface WorkflowTraceConfig {
   tenant?: WorkflowTraceTenant;
 }
 
+/**
+ * First argument to `workflow_options.functions` handlers for `custom_worker` nodes
+ * (Rust wasm graph runner). Matches the JSON object built in Rust.
+ */
+export interface CustomWorkerArgs {
+  handler?: string;
+  handler_file?: string | null;
+  handler_lookup_key?: string;
+  nodeId?: string;
+  payload?: unknown;
+}
+
+/**
+ * Second argument to `custom_worker` handlers: live graph context (`input`, `nodes`, and
+ * optional `globals` / `trace` when the runner provides them).
+ */
+export interface WorkflowGraphContext {
+  input?: Record<string, unknown>;
+  nodes?: Record<string, unknown>;
+  globals?: Record<string, unknown>;
+  trace?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
 export interface WorkflowRunOptions {
   model?: string;
   telemetry?: WorkflowTelemetryConfig;
@@ -155,8 +179,8 @@ export interface WorkflowRunOptions {
   functions?: Record<
     string,
     (
-      args: Record<string, unknown>,
-      context: Record<string, unknown>
+      args: CustomWorkerArgs,
+      context: WorkflowGraphContext
     ) => unknown | Promise<unknown>
   >;
 }