simple-agents-wasm 0.3.5 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-agents-wasm",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Browser-compatible SimpleAgents client for OpenAI-compatible providers",
   "type": "module",
   "main": "index.js",
@@ -18,6 +18,7 @@
     "index.d.ts",
     "workflow_stream_printer.mjs",
     "workflow_stream_printer.d.ts",
+    "workflow_event.d.ts",
     "runtime",
     "README.md",
     "pkg",
@@ -34,6 +35,9 @@
       "types": "./workflow_stream_printer.d.ts",
       "import": "./workflow_stream_printer.mjs",
       "default": "./workflow_stream_printer.mjs"
+    },
+    "./workflow_event": {
+      "types": "./workflow_event.d.ts"
     }
   },
   "engines": {

package/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "simple-agents-wasm-rust"
-version = "0.3.5"
+version = "0.3.6"
 edition = "2021"
 license = "MIT OR Apache-2.0"
 

package/workflow_event.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Event names emitted by the Rust YAML workflow runner (stream callbacks).
+ * Source of truth: crates/simple-agents-workflow/src/yaml_runner/ (execute.rs,
+ * client_executor.rs, node_execution.rs).
+ * The runner may add new types without a semver bump; treat as open-ended.
+ */
+export type WorkflowRunnerEventType =
+  | 'workflow_started'
+  | 'workflow_completed'
+  | 'node_started'
+  | 'node_completed'
+  | 'resolved_llm_input'
+  | 'node_stream_delta'
+  | 'node_stream_thinking_delta'
+  | 'node_stream_output_delta'
+  | 'node_tool_call_requested'
+  | 'node_tool_call_completed'
+  | 'node_tool_call_failed'
+  | 'node_tool_roundtrip_completed'
+  | 'node_healed'
+  | (string & {})
+
+export interface WorkflowRunnerEvent {
+  event_type: WorkflowRunnerEventType
+  node_id?: string
+  step_id?: string
+  node_kind?: string
+  streamable?: boolean
+  message?: string
+  delta?: string
+  token_kind?: string
+  is_terminal_node_token?: boolean
+  elapsed_ms?: number
+  metadata?: Record<string, unknown>
+}

package/workflow_stream_printer.d.ts

@@ -10,3 +10,16 @@ export interface WorkflowStreamPrinterOptions {
 export function createWorkflowStreamPrinter(
   options?: WorkflowStreamPrinterOptions,
 ): (event: Record<string, unknown>) => void;
+
+/**
+ * Ready-made `onEvent` callback that prints streamed tokens inline and silences
+ * lifecycle events. A simpler alternative to {@link createWorkflowStreamPrinter}
+ * (no step headers, no state).
+ *
+ * Usage:
+ * ```ts
+ * import { defaultOnEvent } from 'simple-agents-wasm/workflow_stream_printer';
+ * await client.runWorkflow(yaml, input, { onEvent: defaultOnEvent });
+ * ```
+ */
+export declare function defaultOnEvent(event: Record<string, unknown>): void;

package/workflow_stream_printer.mjs

@@ -85,3 +85,31 @@ export function createWorkflowStreamPrinter(options = {}) {
     }
   };
 }
+
+/**
+ * Ready-made `onEvent` callback that prints streamed tokens inline and silences
+ * lifecycle events. A simpler alternative to {@link createWorkflowStreamPrinter}
+ * (no step headers, no state).
+ *
+ * Usage:
+ * ```js
+ * import { defaultOnEvent } from 'simple-agents-wasm/workflow_stream_printer';
+ * await client.runWorkflow(yaml, input, { onEvent: defaultOnEvent });
+ * ```
+ *
+ * @param {Record<string, unknown>} event
+ */
+export function defaultOnEvent(event) {
+  const eventType = event?.event_type;
+  if (typeof eventType !== "string") return;
+  if (
+    eventType === "node_stream_delta" ||
+    eventType === "node_stream_thinking_delta" ||
+    eventType === "node_stream_output_delta"
+  ) {
+    const delta = event.delta;
+    if (typeof delta === "string") {
+      writeChunk(delta);
+    }
+  }
+}