blazen 0.1.157 → 0.1.158

package/index.d.ts

@@ -920,11 +920,6 @@ export declare class ContentStore {
   constructor()
   /** Build a default ephemeral in-memory store. */
   static inMemory(): ContentStore
-  /**
-   * Build a filesystem-backed store rooted at `root`. The directory is
-   * created if it doesn't yet exist.
-   */
-  static localFile(root: string): ContentStore
   /** Build a store backed by the `OpenAI` Files API. */
   static openaiFiles(apiKey: string, baseUrl?: string | undefined | null): ContentStore
   /** Build a store backed by the Anthropic Files API. */
@@ -1005,6 +1000,11 @@ export declare class ContentStore {
    * implementations on most stores are no-ops.
    */
   delete(handle: JsContentHandle): Promise<void>
+  /**
+   * Build a filesystem-backed store rooted at `root`. The directory is
+   * created if it doesn't yet exist.
+   */
+  static localFile(root: string): ContentStore
 }
 export type JsContentStore = ContentStore
 
@@ -1859,6 +1859,54 @@ export declare class HttpClient {
 }
 export type JsHttpClient = HttpClient
 
+/**
+ * HTTP/JSON peer client. Mirrors
+ * [`crate::peer::client::JsBlazenPeerClient`]'s method surface but speaks
+ * pure HTTP/JSON to a peer (or peer-shim) at `baseUrl`. Available on every
+ * target — including `wasm32-wasip1*` where the gRPC client doesn't
+ * compile.
+ *
+ * ```typescript
+ * const client = HttpPeerClient.newHttp("https://peer.example.com", "node-a");
+ * const resp = await client.invokeSubWorkflow({
+ *     workflowName: "summarize",
+ *     stepIds: ["fetch", "summarize"],
+ *     input: { url: "https://example.com" },
+ *     timeoutSecs: 60,
+ * });
+ * ```
+ */
+export declare class HttpPeerClient {
+  /**
+   * Build a new HTTP/JSON peer client.
+   *
+   * `baseUrl` is the peer's HTTP root (e.g.
+   * `https://peer.example.com`); a trailing slash is tolerated and
+   * trimmed before each request. `nodeId` identifies this caller in
+   * trace logs and is sent to the peer as the
+   * `X-Blazen-Peer-Node-Id` header.
+   *
+   * On wasi the underlying HTTP client comes from a
+   * [`blazen_llm::http_napi_wasi::LazyHttpClient`] proxy that defers
+   * to whatever the host registered via `setDefaultHttpClient`. On
+   * native a stock [`blazen_llm::ReqwestHttpClient`] is used.
+   */
+  static newHttp(baseUrl: string, nodeId: string): HttpPeerClient
+  /** Invoke a sub-workflow on the connected peer. */
+  invokeSubWorkflow(request: JsSubWorkflowRequest): Promise<JsSubWorkflowResponse>
+  /**
+   * Dereference a remote session ref. Returns the raw bytes of the
+   * underlying value and the envelope version of the response.
+   */
+  derefSessionRef(request: JsDerefRequest): Promise<JsDerefResponse>
+  /**
+   * Release (drop) a remote session ref. Returns whether the ref was
+   * found and released on the origin node.
+   */
+  releaseSessionRef(request: JsReleaseRequest): Promise<JsReleaseResponse>
+}
+export type JsHttpPeerClient = HttpPeerClient
+
 /**
  * Base class for custom image-generation providers.
  *
@@ -2343,20 +2391,12 @@ export declare class Memory {
    * @param backend  - An `InMemoryBackend` instance.
    */
   constructor(embedder: EmbeddingModel, backend: InMemoryBackend)
-  /** Create a memory store with an embedding model and a `JsonlBackend`. */
-  static withJsonl(embedder: EmbeddingModel, backend: JsonlBackend): Memory
-  /** Create a memory store with an embedding model and a `ValkeyBackend`. */
-  static withValkey(embedder: EmbeddingModel, backend: ValkeyBackend): Memory
   /**
    * Create a memory store in local-only mode (no embedding model) with an `InMemoryBackend`.
    *
    * Only `searchLocal()` is available; `search()` will throw.
    */
   static local(backend: InMemoryBackend): Memory
-  /** Create a memory store in local-only mode with a `JsonlBackend`. */
-  static localJsonl(backend: JsonlBackend): Memory
-  /** Create a memory store in local-only mode with a `ValkeyBackend`. */
-  static localValkey(backend: ValkeyBackend): Memory
   /**
    * Add a text entry to the memory store.
    *
@@ -2412,6 +2452,18 @@ export declare class Memory {
   delete(id: string): Promise<boolean>
   /** Return the number of entries in the store. */
   count(): Promise<number>
+  /** Create a memory store with an embedding model and a `JsonlBackend`. */
+  static withJsonl(embedder: EmbeddingModel, backend: JsonlBackend): Memory
+  /** Create a memory store with an embedding model and a `ValkeyBackend`. */
+  static withValkey(embedder: EmbeddingModel, backend: ValkeyBackend): Memory
+  /** Create a memory store in local-only mode with a `JsonlBackend`. */
+  static localJsonl(backend: JsonlBackend): Memory
+  /** Create a memory store in local-only mode with a `ValkeyBackend`. */
+  static localValkey(backend: ValkeyBackend): Memory
+  /** Create a memory store with an embedding model and an `UpstashBackend`. */
+  static withUpstash(embedder: EmbeddingModel, backend: UpstashBackend): Memory
+  /** Create a memory store in local-only mode with an `UpstashBackend`. */
+  static localUpstash(backend: UpstashBackend): Memory
 }
 export type JsMemory = Memory
 
@@ -3635,8 +3687,10 @@ export declare class RetryMemoryBackend {
   static wrapJsonl(backend: JsonlBackend, config?: JsRetryConfig | undefined | null): RetryMemoryBackend
   /** Wrap a `ValkeyBackend` with retry-on-transient-error behaviour. */
   static wrapValkey(backend: ValkeyBackend, config?: JsRetryConfig | undefined | null): RetryMemoryBackend
+  /** Wrap an `UpstashBackend` with retry-on-transient-error behaviour. */
+  static wrapUpstash(backend: UpstashBackend, config?: JsRetryConfig | undefined | null): RetryMemoryBackend
   /**
-   * Generic factory accepting any of the three concrete backends. Useful
+   * Generic factory accepting any of the four concrete backends. Useful
    * when the caller doesn't statically know which backend is in hand.
    */
   static wrap(backend: AnyBackend, config?: JsRetryConfig | undefined | null): RetryMemoryBackend
@@ -4519,6 +4573,37 @@ export declare class TypedTool {
 }
 export type JsTypedTool = TypedTool
 
+/**
+ * An Upstash Redis REST-backed backend for the memory store.
+ *
+ * Wasi-compatible alternative to [`JsValkeyBackend`] for Cloudflare Workers,
+ * Deno, and other wasi hosts that cannot use raw TCP. Talks to Upstash's
+ * REST API over the host-registered HTTP client (set via
+ * `setDefaultHttpClient`).
+ *
+ * ```javascript
+ * const backend = UpstashBackend.create("https://us1-merry-cat-32242.upstash.io", "AYAg...");
+ * const memory = Memory.withUpstash(embedder, backend);
+ * ```
+ */
+export declare class UpstashBackend {
+  /**
+   * Create an Upstash REST backend.
+   *
+   * `restUrl` is the Upstash REST endpoint (e.g.
+   * `https://us1-merry-cat-32242.upstash.io`). `restToken` is the REST
+   * token, sent as a `Bearer` token on every request. The HTTP client is
+   * resolved via `setDefaultHttpClient` — call that before issuing any
+   * memory operations.
+   *
+   * `prefix` overrides the default key prefix (`blazen:memory:`). Pass
+   * `null`/`undefined` for the default. Useful when running multiple
+   * logical stores against the same Upstash database.
+   */
+  static create(restUrl: string, restToken: string, prefix?: string | undefined | null): UpstashBackend
+}
+export type JsUpstashBackend = UpstashBackend
+
 /**
  * A sink for emitted [`JsUsageEvent`]s.
  *
@@ -5005,21 +5090,6 @@ export declare class WorkflowBuilder {
    * `crates/blazen-node/Cargo.toml`.
    */
   withHistory(): this
-  /**
-   * Attach a checkpoint store to the workflow.
-   *
-   * Mirrors [`blazen_core::WorkflowBuilder::checkpoint_store`]. The
-   * underlying call is gated on the `persist` feature of
-   * `blazen-core`, which is **not** currently enabled in the Node
-   * binding's compilation. The flag is recorded on the builder for
-   * forward compatibility but does not yet flow into the core
-   * engine — pass a [`JsCheckpointStore`] (typically a concrete
-   * subclass like `RedbCheckpointStore` or `ValkeyCheckpointStore`)
-   * so the JS API is stable; the binding will start forwarding the
-   * store once the `blazen-core/persist` feature is enabled in
-   * `crates/blazen-node/Cargo.toml`.
-   */
-  checkpointStore(store: CheckpointStore): this
   /**
    * Enable or disable automatic checkpointing after each step
    * completes. Same forward-compatibility caveat as
@@ -5039,6 +5109,21 @@ export declare class WorkflowBuilder {
    * are enabled in the Node binding's `Cargo.toml`.
    */
   build(): Workflow
+  /**
+   * Attach a checkpoint store to the workflow.
+   *
+   * Mirrors [`blazen_core::WorkflowBuilder::checkpoint_store`]. The
+   * underlying call is gated on the `persist` feature of
+   * `blazen-core`, which is **not** currently enabled in the Node
+   * binding's compilation. The flag is recorded on the builder for
+   * forward compatibility but does not yet flow into the core
+   * engine — pass a [`JsCheckpointStore`] (typically a concrete
+   * subclass like `RedbCheckpointStore` or `ValkeyCheckpointStore`)
+   * so the JS API is stable; the binding will start forwarding the
+   * store once the `blazen-core/persist` feature is enabled in
+   * `crates/blazen-node/Cargo.toml`.
+   */
+  checkpointStore(store: CheckpointStore): this
 }
 export type JsWorkflowBuilder = WorkflowBuilder
 

package/index.js

@@ -660,6 +660,8 @@ module.exports.HostDispatch = nativeBinding.HostDispatch
 module.exports.JsHostDispatch = nativeBinding.JsHostDispatch
 module.exports.HttpClient = nativeBinding.HttpClient
 module.exports.JsHttpClient = nativeBinding.JsHttpClient
+module.exports.HttpPeerClient = nativeBinding.HttpPeerClient
+module.exports.JsHttpPeerClient = nativeBinding.JsHttpPeerClient
 module.exports.ImageModel = nativeBinding.ImageModel
 module.exports.JsImageModel = nativeBinding.JsImageModel
 module.exports.ImageProvider = nativeBinding.ImageProvider
@@ -828,6 +830,8 @@ module.exports.TTSProvider = nativeBinding.TTSProvider
 module.exports.JsTTSProvider = nativeBinding.JsTTSProvider
 module.exports.TypedTool = nativeBinding.TypedTool
 module.exports.JsTypedTool = nativeBinding.JsTypedTool
+module.exports.UpstashBackend = nativeBinding.UpstashBackend
+module.exports.JsUpstashBackend = nativeBinding.JsUpstashBackend
 module.exports.UsageEmitter = nativeBinding.UsageEmitter
 module.exports.JsUsageEmitter = nativeBinding.JsUsageEmitter
 module.exports.UsageRecordingCompletionModel = nativeBinding.UsageRecordingCompletionModel
@@ -1016,9 +1020,27 @@ module.exports.videoInput = nativeBinding.videoInput
     // emits classes with PascalCase names; we leave those callable as-is
     // so `new ClassName(...)` keeps working but their methods are
     // already patched above.
-    const isLikelyClass =
+    //
+    // Detect "class-ness" via either prototype methods OR own static
+    // properties beyond the built-in function metadata fields. Without the
+    // static-property check, a class whose only public surface is a static
+    // factory (e.g. `UpstashBackend.create`) would slip through and get
+    // replaced with a `wrap()`-returned function that loses the static
+    // method.
+    const FUNCTION_BUILTIN_PROPS = new Set([
+      'length',
+      'name',
+      'arguments',
+      'caller',
+      'prototype',
+    ])
+    const ownStaticPropNames = Object.getOwnPropertyNames(orig).filter(
+      (p) => !FUNCTION_BUILTIN_PROPS.has(p),
+    )
+    const hasPrototypeMethods =
       orig.prototype &&
       Object.getOwnPropertyNames(orig.prototype).some((p) => p !== 'constructor')
+    const isLikelyClass = hasPrototypeMethods || ownStaticPropNames.length > 0
     if (!isLikelyClass) {
       module.exports[key] = wrap(orig)
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blazen",
-  "version": "0.1.157",
+  "version": "0.1.158",
   "description": "Blazen - Event-driven AI workflow framework for Node.js/TypeScript",
   "main": "index.js",
   "types": "index.d.ts",
@@ -13,7 +13,8 @@
       "aarch64-unknown-linux-gnu",
       "aarch64-unknown-linux-musl",
       "aarch64-apple-darwin",
-      "x86_64-pc-windows-msvc"
+      "x86_64-pc-windows-msvc",
+      "wasm32-wasi"
     ]
   },
   "publishConfig": {
@@ -39,8 +40,12 @@
     "error-classes.js"
   ],
   "devDependencies": {
-    "@napi-rs/cli": "^3.0.0",
     "@biomejs/biome": "^2",
+    "@emnapi/core": "^1.10.0",
+    "@emnapi/runtime": "^1.10.0",
+    "@napi-rs/cli": "^3.0.0",
+    "@napi-rs/wasm-runtime": "^1.1.4",
+    "@tybys/wasm-util": "^0.10.2",
     "ava": "^6.4.1"
   },
   "engines": {
@@ -58,12 +63,13 @@
     "verbose": true
   },
   "optionalDependencies": {
-    "@blazen-dev/blazen-linux-x64-gnu": "0.1.157",
-    "@blazen-dev/blazen-linux-x64-musl": "0.1.157",
-    "@blazen-dev/blazen-linux-arm64-gnu": "0.1.157",
-    "@blazen-dev/blazen-linux-arm64-musl": "0.1.157",
-    "@blazen-dev/blazen-darwin-arm64": "0.1.157",
-    "@blazen-dev/blazen-win32-x64-msvc": "0.1.157"
+    "@blazen-dev/blazen-linux-x64-gnu": "0.1.158",
+    "@blazen-dev/blazen-linux-x64-musl": "0.1.158",
+    "@blazen-dev/blazen-linux-arm64-gnu": "0.1.158",
+    "@blazen-dev/blazen-linux-arm64-musl": "0.1.158",
+    "@blazen-dev/blazen-darwin-arm64": "0.1.158",
+    "@blazen-dev/blazen-win32-x64-msvc": "0.1.158",
+    "@blazen-dev/blazen-wasm32-wasi": "0.1.158"
   },
   "scripts": {
     "build": "napi build --release --platform --features local-all,langfuse --js index.js && node scripts/post-build.mjs",