blazen 0.1.150 → 0.1.152

package/index.d.ts

@@ -54,6 +54,17 @@ export declare class ChatMessage {
   get role(): string
   /** The text content of the message, if any. */
   get content(): string | null
+  /**
+   * The structured tool-result payload, if this message is a tool result
+   * produced by a tool returning a non-string value or carrying an
+   * `llmOverride`. Plain-string tool results live in `content` instead and
+   * this returns `null`.
+   */
+  get toolResult(): ToolOutput | null
+  /** The tool call ID this message responds to, for `Role::Tool` messages. */
+  get toolCallId(): string | null
+  /** The tool/function name that produced this result, for `Role::Tool` messages. */
+  get name(): string | null
 }
 export type JsChatMessage = ChatMessage
 
@@ -333,10 +344,12 @@ export declare class Context {
   /**
    * Retrieve a value previously stored under the given key.
    *
-   * Returns `Buffer` for binary data, the original JS value for JSON data,
-   * or `null` if the key does not exist.
+   * Returns the original JS value for JSON data, an array-of-bytes
+   * representation for binary data (use `getBytes` for proper
+   * `Buffer` round-trip), or `defaultValue` if the key is missing
+   * or the stored value is `null`/`Native`.
    */
-  get(key: string): Promise<StateValue | null>
+  get(key: string, defaultValue?: StateValue): Promise<StateValue | null>
   /**
    * Emit an event into the internal routing queue.
    *
@@ -362,10 +375,11 @@ export declare class Context {
   /**
    * Retrieve raw binary data previously stored under the given key.
    *
-   * Returns `null` if the key does not exist or the stored value is
-   * not binary data.
+   * Returns `defaultValue` if the key does not exist or the stored
+   * value is not binary data; if no default is provided, returns
+   * `null`.
    */
-  getBytes(key: string): Promise<Buffer | null>
+  getBytes(key: string, defaultValue?: Buffer): Promise<Buffer | null>
   /** Get the workflow run ID. */
   runId(): Promise<string>
   /**
@@ -1187,9 +1201,9 @@ export declare class SessionNamespace {
   set(key: string, value: unknown): Promise<void>
   /**
    * Retrieve a value previously stored under the given key. Returns
-   * `null` if the key does not exist.
+   * `defaultValue` if the key is missing.
    */
-  get(key: string): Promise<unknown>
+  get(key: string, defaultValue?: unknown): Promise<unknown>
   /** Check whether a value exists under the given key. */
   has(key: string): Promise<boolean>
   /** Remove the value stored under the given key. */
@@ -1207,12 +1221,18 @@ export type JsSessionNamespace = SessionNamespace
 export declare class StateNamespace {
   /** Store a JSON-serializable value under the given key. */
   set(key: string, value: Exclude<StateValue, Buffer>): Promise<void>
-  /** Retrieve a value previously stored under the given key. */
-  get(key: string): Promise<StateValue | null>
+  /**
+   * Retrieve a value previously stored under the given key.
+   * Returns `defaultValue` if the key is missing.
+   */
+  get(key: string, defaultValue?: StateValue): Promise<StateValue | null>
   /** Store raw binary data under the given key. */
   setBytes(key: string, data: Buffer): Promise<void>
-  /** Retrieve raw binary data previously stored under the given key. */
-  getBytes(key: string): Promise<Buffer | null>
+  /**
+   * Retrieve raw binary data previously stored under the given key.
+   * Returns `defaultValue` if the key is missing.
+   */
+  getBytes(key: string, defaultValue?: Buffer): Promise<Buffer | null>
 }
 export type JsStateNamespace = StateNamespace
 
@@ -2528,6 +2548,37 @@ export interface JsWorkflowResult {
   data: any
 }
 
+/**
+ * Variant-tagged provider-aware override for what the LLM sees.
+ *
+ * `kind` is one of `"text"`, `"json"`, `"parts"`, or `"provider_raw"`.
+ * Other fields are populated based on the variant:
+ * - `text` for `kind: "text"`
+ * - `value` for `kind: "json"` or `kind: "provider_raw"`
+ * - `parts` for `kind: "parts"` (serialized `ContentPart[]`)
+ * - `provider` for `kind: "provider_raw"` — one of `"openai"`,
+ *   `"openai_compat"`, `"azure"`, `"anthropic"`, `"gemini"`, `"responses"`,
+ *   or `"fal"`.
+ */
+export interface LlmPayload {
+  /** Which variant: `"text"`, `"json"`, `"parts"`, or `"provider_raw"`. */
+  kind: string
+  /** Plain text body. Required for `kind: "text"`. */
+  text?: string
+  /**
+   * Structured JSON value. Required for `kind: "json"` and
+   * `kind: "provider_raw"`.
+   */
+  value?: any
+  /**
+   * Multimodal content parts (serialized `ContentPart[]`).
+   * Required for `kind: "parts"`.
+   */
+  parts?: any
+  /** Provider id string. Required for `kind: "provider_raw"`. */
+  provider?: string
+}
+
 /**
  * Look up pricing for a model by its ID.
  *
@@ -2670,5 +2721,24 @@ export declare const enum SessionPausePolicy {
   HardError = 'HardError'
 }
 
+/**
+ * `ToolOutput` carrying both the user-visible `data` and an optional
+ * `llmOverride` controlling what the LLM sees on the next turn.
+ *
+ * Either return one from a JS tool handler:
+ *   `return { data: { items: [1,2,3] }, llmOverride: { kind: 'text', text: 'summary' } };`
+ * Or just return a plain value, which will be auto-wrapped with no override.
+ */
+export interface ToolOutput {
+  /** The full structured payload the caller sees programmatically. */
+  data: any
+  /**
+   * Optional override for what the LLM sees on the next turn.
+   * `None`/`undefined` means the provider applies its default conversion
+   * from `data`.
+   */
+  llmOverride?: LlmPayload
+}
+
 /** Returns the version of the blazen library. */
 export declare function version(): string

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blazen",
-  "version": "0.1.150",
+  "version": "0.1.152",
   "description": "Blazen - Event-driven AI workflow framework for Node.js/TypeScript",
   "main": "index.js",
   "types": "index.d.ts",
@@ -45,12 +45,12 @@
     "node": ">= 18"
   },
   "optionalDependencies": {
-    "@blazen-dev/blazen-linux-x64-gnu": "0.1.150",
-    "@blazen-dev/blazen-linux-x64-musl": "0.1.150",
-    "@blazen-dev/blazen-linux-arm64-gnu": "0.1.150",
-    "@blazen-dev/blazen-linux-arm64-musl": "0.1.150",
-    "@blazen-dev/blazen-darwin-arm64": "0.1.150",
-    "@blazen-dev/blazen-win32-x64-msvc": "0.1.150"
+    "@blazen-dev/blazen-linux-x64-gnu": "0.1.152",
+    "@blazen-dev/blazen-linux-x64-musl": "0.1.152",
+    "@blazen-dev/blazen-linux-arm64-gnu": "0.1.152",
+    "@blazen-dev/blazen-linux-arm64-musl": "0.1.152",
+    "@blazen-dev/blazen-darwin-arm64": "0.1.152",
+    "@blazen-dev/blazen-win32-x64-msvc": "0.1.152"
   },
   "scripts": {
     "build": "napi build --release --platform --features local-all --js index.js",