march-ai-sdk 0.3.0

package/dist/extensions/langgraph.d.ts

@@ -0,0 +1,144 @@
+import { M as MarchAgentApp } from '../app-C_umwZXh.js';
+import 'zod';
+
+/**
+ * March Agent SDK - LangGraph Extension
+ *
+ * HTTPCheckpointSaver for LangGraph that stores state via HTTP API.
+ *
+ * @packageDocumentation
+ */
+
+interface RunnableConfig {
+    configurable?: {
+        thread_id?: string;
+        checkpoint_ns?: string;
+        checkpoint_id?: string;
+    };
+}
+interface Checkpoint {
+    v?: number;
+    id?: string;
+    ts?: string;
+    channel_values?: Record<string, unknown>;
+    channel_versions?: Record<string, string>;
+    versions_seen?: Record<string, Record<string, string>>;
+    pending_sends?: unknown[];
+}
+interface CheckpointMetadata {
+    source?: string;
+    step?: number;
+    writes?: unknown;
+    parents?: Record<string, string>;
+}
+interface CheckpointTuple {
+    config: RunnableConfig;
+    checkpoint: Checkpoint;
+    metadata: CheckpointMetadata;
+    parent_config?: RunnableConfig;
+    pending_writes?: unknown[];
+}
+interface PendingWrite {
+    [key: string]: unknown;
+}
+/**
+ * HTTP-based checkpoint saver for LangGraph.
+ *
+ * Stores graph state via HTTP calls to the conversation-store checkpoint API,
+ * enabling distributed checkpoint storage without direct database access.
+ *
+ * @example
+ * ```typescript
+ * import { MarchAgentApp } from 'march-ai-sdk'
+ * import { HTTPCheckpointSaver } from 'march-ai-sdk/extensions/langgraph'
+ * import { StateGraph } from '@langchain/langgraph'
+ *
+ * const app = new MarchAgentApp({
+ *   gatewayUrl: 'agent-gateway:8080',
+ *   apiKey: 'your-key',
+ * })
+ *
+ * const checkpointer = new HTTPCheckpointSaver(app)
+ *
+ * const graph = new StateGraph(MyState)
+ * // ... define graph ...
+ * const compiled = graph.compile({ checkpointer })
+ *
+ * const config = { configurable: { thread_id: 'my-thread' } }
+ * const result = await compiled.invoke({ messages: [...] }, config)
+ * ```
+ */
+declare class HTTPCheckpointSaver {
+    private readonly client;
+    constructor(app: MarchAgentApp);
+    /**
+     * Get thread_id from config.
+     */
+    private getThreadId;
+    /**
+     * Get checkpoint_ns from config.
+     */
+    private getCheckpointNs;
+    /**
+     * Get checkpoint_id from config.
+     */
+    private getCheckpointId;
+    /**
+     * Generate a unique checkpoint ID.
+     */
+    private generateCheckpointId;
+    /**
+     * Fetch a checkpoint tuple asynchronously.
+     */
+    getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
+    /**
+     * List checkpoints asynchronously.
+     */
+    list(config: RunnableConfig | undefined, options?: {
+        filter?: Record<string, unknown>;
+        before?: RunnableConfig;
+        limit?: number;
+    }): AsyncGenerator<CheckpointTuple>;
+    /**
+     * Store a checkpoint asynchronously.
+     */
+    put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, newVersions?: Record<string, unknown>): Promise<RunnableConfig>;
+    /**
+     * Store intermediate writes asynchronously.
+     */
+    putWrites(_config: RunnableConfig, _writes: PendingWrite[], _taskId: string): Promise<void>;
+    /**
+     * Delete all checkpoints for a thread.
+     */
+    deleteThread(threadId: string): Promise<void>;
+    /**
+     * Convert checkpoint to API format.
+     */
+    private checkpointToApi;
+    /**
+     * Convert metadata to API format.
+     */
+    private metadataToApi;
+    /**
+     * Convert API response to CheckpointTuple.
+     */
+    private responseToTuple;
+    /**
+     * Serialize channel values for transmission.
+     */
+    private serializeChannelValues;
+    /**
+     * Serialize a value for JSON transmission.
+     */
+    private serializeValue;
+    /**
+     * Deserialize checkpoint data.
+     */
+    private deserializeCheckpoint;
+    /**
+     * Deserialize a value.
+     */
+    private deserializeValue;
+}
+
+export { type Checkpoint, type CheckpointMetadata, type CheckpointTuple, HTTPCheckpointSaver, type PendingWrite, type RunnableConfig };

package/dist/extensions/langgraph.js

@@ -0,0 +1,326 @@
+// src/exceptions.ts
+var MarchAgentError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "MarchAgentError";
+    Error.captureStackTrace?.(this, this.constructor);
+  }
+};
+var APIException = class extends MarchAgentError {
+  statusCode;
+  constructor(message, statusCode) {
+    super(message);
+    this.name = "APIException";
+    this.statusCode = statusCode;
+  }
+};
+
+// src/checkpoint-client.ts
+var CheckpointClient = class {
+  baseUrl;
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+  }
+  /**
+   * Store a checkpoint.
+   */
+  async put(config, checkpoint, metadata, newVersions = {}) {
+    const url = `${this.baseUrl}/checkpoints/`;
+    const payload = {
+      config,
+      checkpoint,
+      metadata,
+      new_versions: newVersions
+    };
+    try {
+      const response = await fetch(url, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new APIException(`Failed to store checkpoint: ${response.status} - ${errorText}`, response.status);
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof APIException) throw error;
+      throw new APIException(`Failed to store checkpoint: ${error}`);
+    }
+  }
+  /**
+   * Get a checkpoint tuple.
+   */
+  async getTuple(threadId, checkpointNs = "", checkpointId) {
+    const url = new URL(`${this.baseUrl}/checkpoints/${threadId}`);
+    url.searchParams.set("checkpoint_ns", checkpointNs);
+    if (checkpointId) {
+      url.searchParams.set("checkpoint_id", checkpointId);
+    }
+    try {
+      const response = await fetch(url.toString());
+      if (response.status === 404) {
+        return null;
+      }
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new APIException(`Failed to get checkpoint: ${response.status} - ${errorText}`, response.status);
+      }
+      const result = await response.json();
+      return result || null;
+    } catch (error) {
+      if (error instanceof APIException) throw error;
+      throw new APIException(`Failed to get checkpoint: ${error}`);
+    }
+  }
+  /**
+   * List checkpoints.
+   */
+  async list(options = {}) {
+    const url = new URL(`${this.baseUrl}/checkpoints/`);
+    if (options.threadId) url.searchParams.set("thread_id", options.threadId);
+    if (options.checkpointNs !== void 0) url.searchParams.set("checkpoint_ns", options.checkpointNs);
+    if (options.before) url.searchParams.set("before", options.before);
+    if (options.limit) url.searchParams.set("limit", String(options.limit));
+    try {
+      const response = await fetch(url.toString());
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new APIException(`Failed to list checkpoints: ${response.status} - ${errorText}`, response.status);
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof APIException) throw error;
+      throw new APIException(`Failed to list checkpoints: ${error}`);
+    }
+  }
+  /**
+   * Delete all checkpoints for a thread.
+   */
+  async deleteThread(threadId) {
+    const url = `${this.baseUrl}/checkpoints/${threadId}`;
+    try {
+      const response = await fetch(url, { method: "DELETE" });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new APIException(`Failed to delete checkpoints: ${response.status} - ${errorText}`, response.status);
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof APIException) throw error;
+      throw new APIException(`Failed to delete checkpoints: ${error}`);
+    }
+  }
+};
+
+// src/extensions/langgraph.ts
+var HTTPCheckpointSaver = class {
+  client;
+  constructor(app) {
+    this.client = new CheckpointClient(app.gatewayClient.conversationStoreUrl);
+  }
+  /**
+   * Get thread_id from config.
+   */
+  getThreadId(config) {
+    const threadId = config.configurable?.thread_id;
+    if (!threadId) {
+      throw new Error("Config must contain configurable.thread_id");
+    }
+    return threadId;
+  }
+  /**
+   * Get checkpoint_ns from config.
+   */
+  getCheckpointNs(config) {
+    return config.configurable?.checkpoint_ns ?? "";
+  }
+  /**
+   * Get checkpoint_id from config.
+   */
+  getCheckpointId(config) {
+    return config.configurable?.checkpoint_id;
+  }
+  /**
+   * Generate a unique checkpoint ID.
+   */
+  generateCheckpointId() {
+    return (/* @__PURE__ */ new Date()).toISOString();
+  }
+  /**
+   * Fetch a checkpoint tuple asynchronously.
+   */
+  async getTuple(config) {
+    const threadId = this.getThreadId(config);
+    const checkpointNs = this.getCheckpointNs(config);
+    const checkpointId = this.getCheckpointId(config);
+    const result = await this.client.getTuple(threadId, checkpointNs, checkpointId);
+    if (!result) {
+      return void 0;
+    }
+    return this.responseToTuple(result);
+  }
+  /**
+   * List checkpoints asynchronously.
+   */
+  async *list(config, options) {
+    const threadId = config?.configurable?.thread_id;
+    const checkpointNs = config?.configurable?.checkpoint_ns;
+    const beforeId = options?.before?.configurable?.checkpoint_id;
+    const results = await this.client.list({
+      threadId,
+      checkpointNs,
+      before: beforeId,
+      limit: options?.limit
+    });
+    for (const result of results) {
+      const tuple = this.responseToTuple(result);
+      if (tuple) {
+        yield tuple;
+      }
+    }
+  }
+  /**
+   * Store a checkpoint asynchronously.
+   */
+  async put(config, checkpoint, metadata, newVersions) {
+    const threadId = this.getThreadId(config);
+    const checkpointNs = this.getCheckpointNs(config);
+    let checkpointId = this.getCheckpointId(config);
+    if (!checkpointId) {
+      checkpointId = checkpoint.id ?? this.generateCheckpointId();
+    }
+    const apiConfig = {
+      configurable: {
+        thread_id: threadId,
+        checkpoint_ns: checkpointNs,
+        checkpoint_id: checkpointId
+      }
+    };
+    const checkpointData = this.checkpointToApi(checkpoint);
+    const metadataData = this.metadataToApi(metadata);
+    const result = await this.client.put(
+      apiConfig,
+      checkpointData,
+      metadataData,
+      newVersions ?? {}
+    );
+    return result.config;
+  }
+  /**
+   * Store intermediate writes asynchronously.
+   */
+  async putWrites(_config, _writes, _taskId) {
+  }
+  /**
+   * Delete all checkpoints for a thread.
+   */
+  async deleteThread(threadId) {
+    await this.client.deleteThread(threadId);
+  }
+  /**
+   * Convert checkpoint to API format.
+   */
+  checkpointToApi(checkpoint) {
+    return {
+      v: checkpoint.v ?? 1,
+      id: checkpoint.id ?? this.generateCheckpointId(),
+      ts: checkpoint.ts ?? (/* @__PURE__ */ new Date()).toISOString(),
+      channel_values: this.serializeChannelValues(checkpoint.channel_values ?? {}),
+      channel_versions: checkpoint.channel_versions ?? {},
+      versions_seen: checkpoint.versions_seen ?? {},
+      pending_sends: checkpoint.pending_sends ?? []
+    };
+  }
+  /**
+   * Convert metadata to API format.
+   */
+  metadataToApi(metadata) {
+    return {
+      source: metadata.source ?? "input",
+      step: metadata.step ?? -1,
+      writes: metadata.writes,
+      parents: metadata.parents ?? {}
+    };
+  }
+  /**
+   * Convert API response to CheckpointTuple.
+   */
+  responseToTuple(response) {
+    return {
+      config: response.config,
+      checkpoint: this.deserializeCheckpoint(response.checkpoint),
+      metadata: response.metadata,
+      parent_config: response.parent_config,
+      pending_writes: response.pending_writes ?? []
+    };
+  }
+  /**
+   * Serialize channel values for transmission.
+   */
+  serializeChannelValues(values) {
+    return this.serializeValue(values);
+  }
+  /**
+   * Serialize a value for JSON transmission.
+   */
+  serializeValue(value, depth = 0) {
+    const MAX_DEPTH = 100;
+    if (depth > MAX_DEPTH) {
+      return { __max_depth_exceeded__: true };
+    }
+    if (value === null || value === void 0) {
+      return value;
+    }
+    if (Buffer.isBuffer(value) || value instanceof Uint8Array) {
+      return { __bytes__: Buffer.from(value).toString("base64") };
+    }
+    if (Array.isArray(value)) {
+      return value.map((item) => this.serializeValue(item, depth + 1));
+    }
+    if (typeof value === "object") {
+      const result = {};
+      for (const [key, val] of Object.entries(value)) {
+        result[key] = this.serializeValue(val, depth + 1);
+      }
+      return result;
+    }
+    return value;
+  }
+  /**
+   * Deserialize checkpoint data.
+   */
+  deserializeCheckpoint(data) {
+    return {
+      ...data,
+      channel_values: this.deserializeValue(data.channel_values)
+    };
+  }
+  /**
+   * Deserialize a value.
+   */
+  deserializeValue(value) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    if (typeof value === "object" && !Array.isArray(value)) {
+      const obj = value;
+      if ("__bytes__" in obj && typeof obj.__bytes__ === "string") {
+        return Buffer.from(obj.__bytes__, "base64");
+      }
+      const result = {};
+      for (const [key, val] of Object.entries(obj)) {
+        result[key] = this.deserializeValue(val);
+      }
+      return result;
+    }
+    if (Array.isArray(value)) {
+      return value.map((item) => this.deserializeValue(item));
+    }
+    return value;
+  }
+};
+
+export { HTTPCheckpointSaver };
+//# sourceMappingURL=langgraph.js.map
+//# sourceMappingURL=langgraph.js.map

package/dist/extensions/langgraph.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exceptions.ts","../../src/checkpoint-client.ts","../../src/extensions/langgraph.ts"],"names":[],"mappings":"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","file":"langgraph.js","sourcesContent":["/**\n * March Agent SDK - Custom Errors\n * Port of Python march_agent/exceptions.py\n */\n\n/**\n * Base error class for March Agent SDK\n */\nexport class MarchAgentError extends Error {\n    constructor(message: string) {\n        super(message)\n        this.name = 'MarchAgentError'\n        Error.captureStackTrace?.(this, this.constructor)\n    }\n}\n\n/**\n * Error during agent registration with AI Inventory\n */\nexport class RegistrationError extends MarchAgentError {\n    constructor(message: string) {\n        super(message)\n        this.name = 'RegistrationError'\n    }\n}\n\n/**\n * Error during Kafka operations (produce/consume)\n */\nexport class KafkaError extends MarchAgentError {\n    constructor(message: string) {\n        super(message)\n        this.name = 'KafkaError'\n    }\n}\n\n/**\n * Error in SDK configuration\n */\nexport class ConfigurationError extends MarchAgentError {\n    constructor(message: string) {\n        super(message)\n        this.name = 'ConfigurationError'\n    }\n}\n\n/**\n * Error from API calls to backend services\n */\nexport class APIException extends MarchAgentError {\n    statusCode?: number\n\n    constructor(message: string, statusCode?: number) {\n        super(message)\n        this.name = 'APIException'\n        this.statusCode = statusCode\n    }\n}\n\n/**\n * Error during heartbeat operations\n */\nexport class HeartbeatError extends MarchAgentError {\n    constructor(message: string) {\n        super(message)\n        this.name = 'HeartbeatError'\n    }\n}\n\n/**\n * Error during gRPC connection/communication\n */\nexport class GatewayError extends MarchAgentError {\n    constructor(message: string) {\n        super(message)\n        this.name = 'GatewayError'\n    }\n}\n","/**\n * March Agent SDK - Checkpoint Client\n * Port of Python march_agent/checkpoint_client.py\n */\n\nimport { APIException } from './exceptions.js'\n\nexport interface CheckpointConfig {\n    configurable: {\n        thread_id: string\n        checkpoint_ns?: string\n        checkpoint_id?: string\n    }\n}\n\nexport interface CheckpointData {\n    v: number\n    id: string\n    ts: string\n    channel_values: Record<string, unknown>\n    channel_versions: Record<string, string>\n    versions_seen: Record<string, Record<string, string>>\n    pending_sends?: unknown[]\n}\n\nexport interface CheckpointMetadata {\n    source: string\n    step: number\n    writes?: unknown\n    parents?: Record<string, string>\n}\n\nexport interface CheckpointTuple {\n    config: CheckpointConfig\n    checkpoint: CheckpointData\n    metadata: CheckpointMetadata\n    parent_config?: CheckpointConfig\n    pending_writes?: unknown[]\n}\n\nexport interface CheckpointListOptions {\n    threadId?: string\n    checkpointNs?: string\n    before?: string\n    limit?: number\n}\n\n/**\n * Async HTTP client for checkpoint-store API.\n * Used by LangGraph integration for persisting graph state.\n */\nexport class CheckpointClient {\n    private readonly baseUrl: string\n\n    constructor(baseUrl: string) {\n        this.baseUrl = baseUrl.replace(/\\/$/, '')\n    }\n\n    /**\n     * Store a checkpoint.\n     */\n    async put(\n        config: CheckpointConfig,\n        checkpoint: CheckpointData,\n        metadata: CheckpointMetadata,\n        newVersions: Record<string, unknown> = {}\n    ): Promise<{ config: CheckpointConfig }> {\n        const url = `${this.baseUrl}/checkpoints/`\n        const payload = {\n            config,\n            checkpoint,\n            metadata,\n            new_versions: newVersions,\n        }\n\n        try {\n            const response = await fetch(url, {\n                method: 'PUT',\n                headers: { 'Content-Type': 'application/json' },\n                body: JSON.stringify(payload),\n            })\n\n            if (!response.ok) {\n                const errorText = await response.text()\n                throw new APIException(`Failed to store checkpoint: ${response.status} - ${errorText}`, response.status)\n            }\n\n            return await response.json() as { config: CheckpointConfig }\n        } catch (error) {\n            if (error instanceof APIException) throw error\n            throw new APIException(`Failed to store checkpoint: ${error}`)\n        }\n    }\n\n    /**\n     * Get a checkpoint tuple.\n     */\n    async getTuple(\n        threadId: string,\n        checkpointNs: string = '',\n        checkpointId?: string\n    ): Promise<CheckpointTuple | null> {\n        const url = new URL(`${this.baseUrl}/checkpoints/${threadId}`)\n        url.searchParams.set('checkpoint_ns', checkpointNs)\n        if (checkpointId) {\n            url.searchParams.set('checkpoint_id', checkpointId)\n        }\n\n        try {\n            const response = await fetch(url.toString())\n\n            if (response.status === 404) {\n                return null\n            }\n\n            if (!response.ok) {\n                const errorText = await response.text()\n                throw new APIException(`Failed to get checkpoint: ${response.status} - ${errorText}`, response.status)\n            }\n\n            const result = await response.json() as CheckpointTuple | null\n            return result || null\n        } catch (error) {\n            if (error instanceof APIException) throw error\n            throw new APIException(`Failed to get checkpoint: ${error}`)\n        }\n    }\n\n    /**\n     * List checkpoints.\n     */\n    async list(options: CheckpointListOptions = {}): Promise<CheckpointTuple[]> {\n        const url = new URL(`${this.baseUrl}/checkpoints/`)\n\n        if (options.threadId) url.searchParams.set('thread_id', options.threadId)\n        if (options.checkpointNs !== undefined) url.searchParams.set('checkpoint_ns', options.checkpointNs)\n        if (options.before) url.searchParams.set('before', options.before)\n        if (options.limit) url.searchParams.set('limit', String(options.limit))\n\n        try {\n            const response = await fetch(url.toString())\n\n            if (!response.ok) {\n                const errorText = await response.text()\n                throw new APIException(`Failed to list checkpoints: ${response.status} - ${errorText}`, response.status)\n            }\n\n            return await response.json() as CheckpointTuple[]\n        } catch (error) {\n            if (error instanceof APIException) throw error\n            throw new APIException(`Failed to list checkpoints: ${error}`)\n        }\n    }\n\n    /**\n     * Delete all checkpoints for a thread.\n     */\n    async deleteThread(threadId: string): Promise<{ thread_id: string; deleted: number }> {\n        const url = `${this.baseUrl}/checkpoints/${threadId}`\n\n        try {\n            const response = await fetch(url, { method: 'DELETE' })\n\n            if (!response.ok) {\n                const errorText = await response.text()\n                throw new APIException(`Failed to delete checkpoints: ${response.status} - ${errorText}`, response.status)\n            }\n\n            return await response.json() as { thread_id: string; deleted: number }\n        } catch (error) {\n            if (error instanceof APIException) throw error\n            throw new APIException(`Failed to delete checkpoints: ${error}`)\n        }\n    }\n}\n","/**\n * March Agent SDK - LangGraph Extension\n * \n * HTTPCheckpointSaver for LangGraph that stores state via HTTP API.\n * \n * @packageDocumentation\n */\n\nimport type { MarchAgentApp } from '../app.js'\nimport { CheckpointClient } from '../checkpoint-client.js'\nimport type {\n    CheckpointConfig,\n    CheckpointData,\n    CheckpointMetadata as APICheckpointMetadata,\n    CheckpointTuple as APICheckpointTuple,\n} from '../checkpoint-client.js'\n\n// Type definitions for LangGraph (optional peer dependency)\n// These are compatible with @langchain/langgraph-checkpoint\ninterface RunnableConfig {\n    configurable?: {\n        thread_id?: string\n        checkpoint_ns?: string\n        checkpoint_id?: string\n    }\n}\n\ninterface Checkpoint {\n    v?: number\n    id?: string\n    ts?: string\n    channel_values?: Record<string, unknown>\n    channel_versions?: Record<string, string>\n    versions_seen?: Record<string, Record<string, string>>\n    pending_sends?: unknown[]\n}\n\ninterface CheckpointMetadata {\n    source?: string\n    step?: number\n    writes?: unknown\n    parents?: Record<string, string>\n}\n\ninterface CheckpointTuple {\n    config: RunnableConfig\n    checkpoint: Checkpoint\n    metadata: CheckpointMetadata\n    parent_config?: RunnableConfig\n    pending_writes?: unknown[]\n}\n\ninterface PendingWrite {\n    [key: string]: unknown\n}\n\n/**\n * HTTP-based checkpoint saver for LangGraph.\n * \n * Stores graph state via HTTP calls to the conversation-store checkpoint API,\n * enabling distributed checkpoint storage without direct database access.\n * \n * @example\n * ```typescript\n * import { MarchAgentApp } from 'march-ai-sdk'\n * import { HTTPCheckpointSaver } from 'march-ai-sdk/extensions/langgraph'\n * import { StateGraph } from '@langchain/langgraph'\n * \n * const app = new MarchAgentApp({\n *   gatewayUrl: 'agent-gateway:8080',\n *   apiKey: 'your-key',\n * })\n * \n * const checkpointer = new HTTPCheckpointSaver(app)\n * \n * const graph = new StateGraph(MyState)\n * // ... define graph ...\n * const compiled = graph.compile({ checkpointer })\n * \n * const config = { configurable: { thread_id: 'my-thread' } }\n * const result = await compiled.invoke({ messages: [...] }, config)\n * ```\n */\nexport class HTTPCheckpointSaver {\n    private readonly client: CheckpointClient\n\n    constructor(app: MarchAgentApp) {\n        this.client = new CheckpointClient(app.gatewayClient.conversationStoreUrl)\n    }\n\n    /**\n     * Get thread_id from config.\n     */\n    private getThreadId(config: RunnableConfig): string {\n        const threadId = config.configurable?.thread_id\n        if (!threadId) {\n            throw new Error('Config must contain configurable.thread_id')\n        }\n        return threadId\n    }\n\n    /**\n     * Get checkpoint_ns from config.\n     */\n    private getCheckpointNs(config: RunnableConfig): string {\n        return config.configurable?.checkpoint_ns ?? ''\n    }\n\n    /**\n     * Get checkpoint_id from config.\n     */\n    private getCheckpointId(config: RunnableConfig): string | undefined {\n        return config.configurable?.checkpoint_id\n    }\n\n    /**\n     * Generate a unique checkpoint ID.\n     */\n    private generateCheckpointId(): string {\n        return new Date().toISOString()\n    }\n\n    /**\n     * Fetch a checkpoint tuple asynchronously.\n     */\n    async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {\n        const threadId = this.getThreadId(config)\n        const checkpointNs = this.getCheckpointNs(config)\n        const checkpointId = this.getCheckpointId(config)\n\n        const result = await this.client.getTuple(threadId, checkpointNs, checkpointId)\n\n        if (!result) {\n            return undefined\n        }\n\n        return this.responseToTuple(result)\n    }\n\n    /**\n     * List checkpoints asynchronously.\n     */\n    async *list(\n        config: RunnableConfig | undefined,\n        options?: {\n            filter?: Record<string, unknown>\n            before?: RunnableConfig\n            limit?: number\n        }\n    ): AsyncGenerator<CheckpointTuple> {\n        const threadId = config?.configurable?.thread_id\n        const checkpointNs = config?.configurable?.checkpoint_ns\n        const beforeId = options?.before?.configurable?.checkpoint_id\n\n        const results = await this.client.list({\n            threadId,\n            checkpointNs,\n            before: beforeId,\n            limit: options?.limit,\n        })\n\n        for (const result of results) {\n            const tuple = this.responseToTuple(result)\n            if (tuple) {\n                yield tuple\n            }\n        }\n    }\n\n    /**\n     * Store a checkpoint asynchronously.\n     */\n    async put(\n        config: RunnableConfig,\n        checkpoint: Checkpoint,\n        metadata: CheckpointMetadata,\n        newVersions?: Record<string, unknown>\n    ): Promise<RunnableConfig> {\n        const threadId = this.getThreadId(config)\n        const checkpointNs = this.getCheckpointNs(config)\n\n        let checkpointId = this.getCheckpointId(config)\n        if (!checkpointId) {\n            checkpointId = checkpoint.id ?? this.generateCheckpointId()\n        }\n\n        const apiConfig: CheckpointConfig = {\n            configurable: {\n                thread_id: threadId,\n                checkpoint_ns: checkpointNs,\n                checkpoint_id: checkpointId,\n            },\n        }\n\n        const checkpointData = this.checkpointToApi(checkpoint)\n        const metadataData = this.metadataToApi(metadata)\n\n        const result = await this.client.put(\n            apiConfig,\n            checkpointData,\n            metadataData,\n            newVersions ?? {}\n        )\n\n        return result.config as RunnableConfig\n    }\n\n    /**\n     * Store intermediate writes asynchronously.\n     */\n    async putWrites(\n        _config: RunnableConfig,\n        _writes: PendingWrite[],\n        _taskId: string\n    ): Promise<void> {\n        // Stub - writes are not persisted separately\n        // They are included in the checkpoint metadata\n    }\n\n    /**\n     * Delete all checkpoints for a thread.\n     */\n    async deleteThread(threadId: string): Promise<void> {\n        await this.client.deleteThread(threadId)\n    }\n\n    /**\n     * Convert checkpoint to API format.\n     */\n    private checkpointToApi(checkpoint: Checkpoint): CheckpointData {\n        return {\n            v: checkpoint.v ?? 1,\n            id: checkpoint.id ?? this.generateCheckpointId(),\n            ts: checkpoint.ts ?? new Date().toISOString(),\n            channel_values: this.serializeChannelValues(checkpoint.channel_values ?? {}),\n            channel_versions: checkpoint.channel_versions ?? {},\n            versions_seen: checkpoint.versions_seen ?? {},\n            pending_sends: checkpoint.pending_sends ?? [],\n        }\n    }\n\n    /**\n     * Convert metadata to API format.\n     */\n    private metadataToApi(metadata: CheckpointMetadata): APICheckpointMetadata {\n        return {\n            source: metadata.source ?? 'input',\n            step: metadata.step ?? -1,\n            writes: metadata.writes,\n            parents: metadata.parents ?? {},\n        }\n    }\n\n    /**\n     * Convert API response to CheckpointTuple.\n     */\n    private responseToTuple(response: APICheckpointTuple): CheckpointTuple {\n        return {\n            config: response.config as RunnableConfig,\n            checkpoint: this.deserializeCheckpoint(response.checkpoint),\n            metadata: response.metadata,\n            parent_config: response.parent_config as RunnableConfig | undefined,\n            pending_writes: response.pending_writes ?? [],\n        }\n    }\n\n    /**\n     * Serialize channel values for transmission.\n     */\n    private serializeChannelValues(values: Record<string, unknown>): Record<string, unknown> {\n        return this.serializeValue(values) as Record<string, unknown>\n    }\n\n    /**\n     * Serialize a value for JSON transmission.\n     */\n    private serializeValue(value: unknown, depth: number = 0): unknown {\n        const MAX_DEPTH = 100\n        if (depth > MAX_DEPTH) {\n            return { __max_depth_exceeded__: true }\n        }\n\n        if (value === null || value === undefined) {\n            return value\n        }\n\n        // Handle Buffer/Uint8Array\n        if (Buffer.isBuffer(value) || value instanceof Uint8Array) {\n            return { __bytes__: Buffer.from(value).toString('base64') }\n        }\n\n        // Handle arrays\n        if (Array.isArray(value)) {\n            return value.map(item => this.serializeValue(item, depth + 1))\n        }\n\n        // Handle objects\n        if (typeof value === 'object') {\n            const result: Record<string, unknown> = {}\n            for (const [key, val] of Object.entries(value)) {\n                result[key] = this.serializeValue(val, depth + 1)\n            }\n            return result\n        }\n\n        return value\n    }\n\n    /**\n     * Deserialize checkpoint data.\n     */\n    private deserializeCheckpoint(data: CheckpointData): Checkpoint {\n        return {\n            ...data,\n            channel_values: this.deserializeValue(data.channel_values) as Record<string, unknown>,\n        }\n    }\n\n    /**\n     * Deserialize a value.\n     */\n    private deserializeValue(value: unknown): unknown {\n        if (value === null || value === undefined) {\n            return value\n        }\n\n        if (typeof value === 'object' && !Array.isArray(value)) {\n            const obj = value as Record<string, unknown>\n\n            // Decode base64 bytes\n            if ('__bytes__' in obj && typeof obj.__bytes__ === 'string') {\n                return Buffer.from(obj.__bytes__, 'base64')\n            }\n\n            // Recurse into object\n            const result: Record<string, unknown> = {}\n            for (const [key, val] of Object.entries(obj)) {\n                result[key] = this.deserializeValue(val)\n            }\n            return result\n        }\n\n        if (Array.isArray(value)) {\n            return value.map(item => this.deserializeValue(item))\n        }\n\n        return value\n    }\n}\n\nexport type { RunnableConfig, Checkpoint, CheckpointMetadata, CheckpointTuple, PendingWrite }\n"]}

package/dist/extensions/vercel-ai.d.ts

@@ -0,0 +1,124 @@
+import { M as MarchAgentApp } from '../app-C_umwZXh.js';
+import 'zod';
+
+/**
+ * March Agent SDK - Vercel AI SDK Extension
+ *
+ * VercelAIMessageStore for persistent message history with Vercel AI SDK.
+ *
+ * @packageDocumentation
+ */
+
+interface CoreMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | Array<{
+        type: string;
+        [key: string]: unknown;
+    }>;
+    [key: string]: unknown;
+}
+/**
+ * Persistent message store for Vercel AI SDK.
+ *
+ * Stores and retrieves AI SDK message history using the agent-state API.
+ * Messages are serialized as JSON for full fidelity.
+ *
+ * @example
+ * ```typescript
+ * import { MarchAgentApp } from 'march-ai-sdk'
+ * import { VercelAIMessageStore } from 'march-ai-sdk/extensions/vercel-ai'
+ * import { streamText } from 'ai'
+ * import { openai } from '@ai-sdk/openai'
+ *
+ * const app = new MarchAgentApp({
+ *   gatewayUrl: 'agent-gateway:8080',
+ *   apiKey: 'your-key',
+ * })
+ *
+ * const store = new VercelAIMessageStore(app)
+ * const agent = app.registerMe({ ... })
+ *
+ * agent.onMessage(async (message, sender) => {
+ *   // Load message history
+ *   const history = await store.load(message.conversationId)
+ *
+ *   // Add user message
+ *   const messages: CoreMessage[] = [
+ *     ...history,
+ *     { role: 'user', content: message.content }
+ *   ]
+ *
+ *   // Stream response
+ *   const streamer = agent.streamer(message)
+ *
+ *   const result = await streamText({
+ *     model: openai('gpt-4o'),
+ *     messages,
+ *     onChunk: ({ chunk }) => {
+ *       if (chunk.type === 'text-delta') {
+ *         streamer.stream(chunk.textDelta)
+ *       }
+ *     }
+ *   })
+ *
+ *   await streamer.finish()
+ *
+ *   // Save updated history
+ *   await store.save(message.conversationId, [
+ *     ...messages,
+ *     { role: 'assistant', content: result.text }
+ *   ])
+ * })
+ *
+ * app.run()
+ * ```
+ */
+declare class VercelAIMessageStore {
+    private static readonly NAMESPACE;
+    private readonly client;
+    constructor(app: MarchAgentApp);
+    /**
+     * Load message history for a conversation.
+     *
+     * @param conversationId - The conversation ID to load history for
+     * @returns Array of CoreMessage objects (empty array if no history)
+     */
+    load(conversationId: string): Promise<CoreMessage[]>;
+    /**
+     * Save message history for a conversation.
+     *
+     * @param conversationId - The conversation ID to save history for
+     * @param messages - Array of CoreMessage objects to save
+     */
+    save(conversationId: string, messages: CoreMessage[]): Promise<void>;
+    /**
+     * Clear message history for a conversation.
+     *
+     * @param conversationId - The conversation ID to clear history for
+     */
+    clear(conversationId: string): Promise<void>;
+    /**
+     * Append messages to existing history.
+     *
+     * @param conversationId - The conversation ID
+     * @param newMessages - Messages to append
+     */
+    append(conversationId: string, newMessages: CoreMessage[]): Promise<void>;
+    /**
+     * Get the last N messages from history.
+     *
+     * @param conversationId - The conversation ID
+     * @param count - Number of messages to retrieve
+     */
+    getLastMessages(conversationId: string, count: number): Promise<CoreMessage[]>;
+    /**
+     * Validate that an object is a valid message.
+     */
+    private isValidMessage;
+    /**
+     * Serialize a message for storage.
+     */
+    private serializeMessage;
+}
+
+export { type CoreMessage, VercelAIMessageStore };