@slashfi/agents-sdk 0.20.0 → 0.21.0

package/dist/client.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent Client
+ *
+ * Creates a typed client from a SerializedAgentDefinition.
+ * The client spawns (or connects to) the MCP server and proxies
+ * tool calls via JSON-RPC.
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@slashfi/agents-sdk';
+ * import definition from './agents/notion/definition.json';
+ *
+ * const client = createClient(definition, {
+ *   env: { NOTION_TOKEN: process.env.NOTION_TOKEN },
+ * });
+ *
+ * const result = await client.call('API-post-search', { query: 'meeting notes' });
+ * await client.close();
+ * ```
+ */
+import type { SerializedAgentDefinition, SerializedTool } from "./serialized.js";
+export interface CreateClientOptions {
+    /** Extra environment variables for the MCP server process */
+    env?: Record<string, string | undefined>;
+    /** Override the server command (defaults to definition.serverSource) */
+    serverCommand?: string;
+    /** Timeout for tool calls in ms (default: 30000) */
+    timeout?: number;
+}
+export interface AgentClient {
+    /** The definition this client was created from */
+    readonly definition: SerializedAgentDefinition;
+    /** List available tools */
+    tools(): SerializedTool[];
+    /** Call a tool by name */
+    call(toolName: string, input?: Record<string, unknown>): Promise<unknown>;
+    /** Check if connected */
+    isConnected(): boolean;
+    /** Close the MCP server connection */
+    close(): void;
+}
+/**
+ * Create an agent client from a serialized definition.
+ *
+ * The client lazily spawns the MCP server on first call and
+ * proxies tool invocations via JSON-RPC over stdio.
+ */
+export declare function createClient(definition: SerializedAgentDefinition, options?: CreateClientOptions): AgentClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EACV,yBAAyB,EACzB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAE/C,2BAA2B;IAC3B,KAAK,IAAI,cAAc,EAAE,CAAC;IAE1B,0BAA0B;IAC1B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1E,yBAAyB;IACzB,WAAW,IAAI,OAAO,CAAC;IAEvB,sCAAsC;IACtC,KAAK,IAAI,IAAI,CAAC;CACf;AA0MD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,yBAAyB,EACrC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,WAAW,CAEb"}

package/dist/client.js

@@ -0,0 +1,190 @@
+/**
+ * Agent Client
+ *
+ * Creates a typed client from a SerializedAgentDefinition.
+ * The client spawns (or connects to) the MCP server and proxies
+ * tool calls via JSON-RPC.
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@slashfi/agents-sdk';
+ * import definition from './agents/notion/definition.json';
+ *
+ * const client = createClient(definition, {
+ *   env: { NOTION_TOKEN: process.env.NOTION_TOKEN },
+ * });
+ *
+ * const result = await client.call('API-post-search', { query: 'meeting notes' });
+ * await client.close();
+ * ```
+ */
+import { spawn } from "node:child_process";
+class McpStdioClient {
+    definition;
+    proc = null;
+    messageId = 0;
+    buffer = "";
+    pending = new Map();
+    initialized = false;
+    initPromise = null;
+    serverCommand;
+    env;
+    timeout;
+    constructor(definition, options = {}) {
+        this.definition = definition;
+        this.serverCommand = options.serverCommand ?? definition.serverSource ?? "";
+        this.env = options.env ?? {};
+        this.timeout = options.timeout ?? 30000;
+        if (!this.serverCommand) {
+            throw new Error(`No server command for agent "${definition.path}". Set serverSource in the definition or pass serverCommand in options.`);
+        }
+    }
+    tools() {
+        return this.definition.tools;
+    }
+    isConnected() {
+        return this.proc !== null && !this.proc.killed;
+    }
+    async call(toolName, input = {}) {
+        // Validate tool exists
+        const tool = this.definition.tools.find((t) => t.name === toolName);
+        if (!tool) {
+            const available = this.definition.tools.map((t) => t.name).join(", ");
+            throw new Error(`Tool "${toolName}" not found. Available: ${available}`);
+        }
+        // Ensure connected + initialized
+        await this.ensureInitialized();
+        // Send tools/call
+        const result = await this.sendRequest("tools/call", {
+            name: toolName,
+            arguments: input,
+        });
+        // MCP tools/call returns { content: [{ type, text }] }
+        const resultObj = result;
+        if (resultObj && typeof resultObj === "object" && "content" in resultObj) {
+            const content = resultObj.content;
+            if (Array.isArray(content) && content.length > 0) {
+                const first = content[0];
+                if (first.type === "text") {
+                    try {
+                        return JSON.parse(first.text);
+                    }
+                    catch {
+                        return first.text;
+                    }
+                }
+                return first;
+            }
+        }
+        return result;
+    }
+    close() {
+        if (this.proc) {
+            this.proc.kill();
+            this.proc = null;
+        }
+        this.initialized = false;
+        this.initPromise = null;
+        // Reject all pending
+        for (const req of Array.from(this.pending.values())) {
+            clearTimeout(req.timer);
+            req.reject(new Error("Client closed"));
+        }
+        this.pending.clear();
+    }
+    // ── Private ──
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this.connect();
+        await this.initPromise;
+        this.initialized = true;
+    }
+    async connect() {
+        const parts = this.serverCommand.split(/\s+/);
+        this.proc = spawn(parts[0], parts.slice(1), {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: { ...process.env, ...this.env },
+        });
+        this.proc.stdout?.on("data", (chunk) => this.onData(chunk));
+        this.proc.on("error", (err) => {
+            for (const req of Array.from(this.pending.values())) {
+                clearTimeout(req.timer);
+                req.reject(err);
+            }
+            this.pending.clear();
+        });
+        // Initialize handshake
+        await this.sendRequest("initialize", {
+            protocolVersion: "2024-11-05",
+            capabilities: {},
+            clientInfo: { name: "agents-sdk-client", version: "1.0.0" },
+        });
+        // Send initialized notification
+        this.sendNotification("notifications/initialized");
+    }
+    sendRequest(method, params = {}) {
+        return new Promise((resolve, reject) => {
+            const id = ++this.messageId;
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Timeout after ${this.timeout}ms calling ${method}`));
+            }, this.timeout);
+            this.pending.set(id, { resolve, reject, timer });
+            const msg = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+            this.proc?.stdin?.write(`${msg}\n`);
+        });
+    }
+    sendNotification(method, params) {
+        const msg = JSON.stringify({
+            jsonrpc: "2.0",
+            method,
+            ...(params ? { params } : {}),
+        });
+        this.proc?.stdin?.write(`${msg}\n`);
+    }
+    onData(chunk) {
+        this.buffer += chunk.toString();
+        const lines = this.buffer.split("\n");
+        this.buffer = lines.pop() || "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (parsed.id != null && this.pending.has(parsed.id)) {
+                    const req = this.pending.get(parsed.id);
+                    if (!req)
+                        continue;
+                    this.pending.delete(parsed.id);
+                    clearTimeout(req.timer);
+                    if (parsed.error) {
+                        req.reject(new Error(JSON.stringify(parsed.error)));
+                    }
+                    else {
+                        req.resolve(parsed.result);
+                    }
+                }
+            }
+            catch {
+                // ignore non-JSON lines (stderr leakage, etc.)
+            }
+        }
+    }
+}
+// ============================================
+// Factory
+// ============================================
+/**
+ * Create an agent client from a serialized definition.
+ *
+ * The client lazily spawns the MCP server on first call and
+ * proxies tool invocations via JSON-RPC over stdio.
+ */
+export function createClient(definition, options) {
+    return new McpStdioClient(definition, options);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -85,4 +85,8 @@ export { createRegistryConsumer } from "./registry-consumer.js";
 export type { RegistryConsumer, RegistryConsumerOptions, RegistryConfiguration, AgentListing, SecretResolver, } from "./registry-consumer.js";
 export { codegen, useAgent, listAgentTools } from "./codegen.js";
 export type { CodegenOptions, CodegenResult, CodegenManifest, McpToolDefinition, McpServerInfo, McpTransport, ServerSource, } from "./codegen.js";
+export { serializeAgent, serializeTool } from "./serialized.js";
+export type { SerializedAgentDefinition, SerializedTool, } from "./serialized.js";
+export { createClient } from "./client.js";
+export type { AgentClient, CreateClientOptions, } from "./client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -83,4 +83,12 @@ export { normalizeRef, normalizeRegistry, isSecretUrl, isSecretUri, } from "./de
 export { createRegistryConsumer } from "./registry-consumer.js";
 // Codegen
 export { codegen, useAgent, listAgentTools } from "./codegen.js";
+// ============================================
+// Serialized Agent Definitions
+// ============================================
+export { serializeAgent, serializeTool } from "./serialized.js";
+// ============================================
+// Agent Client
+// ============================================
+export { createClient } from "./client.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAiDH,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGtD,WAAW;AACX,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOpD,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAc7C,SAAS;AACT,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AASrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAMhC,OAAO;AACP,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AASrC,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,UAAU;AACV,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,WAAW,EACX,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AAOxC,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM;AACN,OAAO,EACL,OAAO,EACP,SAAS,EACT,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,GACV,MAAM,UAAU,CAAC;AAQlB,wBAAwB;AAExB,eAAe;AACf,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAiB7C,kBAAkB;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,QAAQ;AACR,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAOtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAE3C,OAAO,EACL,gBAAgB,GAMjB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAY5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAShE,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAiDH,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGtD,WAAW;AACX,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOpD,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAc7C,SAAS;AACT,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AASrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAMhC,OAAO;AACP,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AASrC,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,UAAU;AACV,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,WAAW,EACX,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AAOxC,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM;AACN,OAAO,EACL,OAAO,EACP,SAAS,EACT,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,GACV,MAAM,UAAU,CAAC;AAQlB,wBAAwB;AAExB,eAAe;AACf,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAiB7C,kBAAkB;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,QAAQ;AACR,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAOtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAE3C,OAAO,EACL,gBAAgB,GAMjB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAY5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAShE,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAWjE,+CAA+C;AAC/C,+BAA+B;AAC/B,+CAA+C;AAE/C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhE,+CAA+C;AAC/C,eAAe;AACf,+CAA+C;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/serialized.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Serialized Agent Definition
+ *
+ * Pure-data, JSON-serializable representation of an agent.
+ * No execute functions, no runtime hooks — just schemas and metadata.
+ *
+ * This is the universal IR:
+ * - Codegen produces it (MCP introspection → SerializedAgentDefinition)
+ * - Registry stores it (JSON in DB or filesystem)
+ * - API serves it (GET /agents/:name → SerializedAgentDefinition)
+ * - createClient() hydrates it (definition → typed proxy with real calls)
+ */
+import type { JsonSchema, SecurityScheme } from "./types.js";
+export interface SerializedTool {
+    /** Tool name (unique within agent) */
+    name: string;
+    /** Short description for tool discovery */
+    description: string;
+    /** JSON Schema for input parameters */
+    inputSchema: JsonSchema;
+    /** JSON Schema for output (optional) */
+    outputSchema?: JsonSchema;
+}
+export interface SerializedAgentDefinition {
+    /** Agent path (e.g., 'notion', 'linear', 'github') */
+    path: string;
+    /** Human-readable name */
+    name: string;
+    /** Short description */
+    description: string;
+    /** Version of the definition */
+    version: string;
+    /** Visibility level */
+    visibility: "public" | "private";
+    /** Auth requirements */
+    auth?: SecurityScheme;
+    /** MCP server source command (e.g., 'npx @notionhq/notion-mcp-server') */
+    serverSource?: string;
+    /** Server info from MCP introspection */
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+    /** Tool definitions (schemas only, no execute) */
+    tools: SerializedTool[];
+    /** ISO timestamp of when this was generated */
+    generatedAt?: string;
+    /** SDK version used for codegen */
+    sdkVersion?: string;
+}
+import type { AgentDefinition, ToolContext, ToolDefinition } from "./types.js";
+/**
+ * Serialize an AgentDefinition to its pure-data representation.
+ * Strips execute functions, runtime hooks, listeners, etc.
+ */
+export declare function serializeAgent(agent: AgentDefinition, meta?: {
+    serverSource?: string;
+    version?: string;
+}): SerializedAgentDefinition;
+/**
+ * Serialize a single ToolDefinition to its pure-data representation.
+ */
+export declare function serializeTool(tool: ToolDefinition<ToolContext, unknown, unknown>): SerializedTool;
+//# sourceMappingURL=serialized.d.ts.map

package/dist/serialized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized.d.ts","sourceRoot":"","sources":["../src/serialized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM7D,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,EAAE,UAAU,CAAC;IACxB,wCAAwC;IACxC,YAAY,CAAC,EAAE,UAAU,CAAC;CAC3B;AAMD,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,wBAAwB;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,kDAAkD;IAClD,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/E;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,yBAAyB,CAY3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,GAClD,cAAc,CAOhB"}

package/dist/serialized.js

@@ -0,0 +1,41 @@
+/**
+ * Serialized Agent Definition
+ *
+ * Pure-data, JSON-serializable representation of an agent.
+ * No execute functions, no runtime hooks — just schemas and metadata.
+ *
+ * This is the universal IR:
+ * - Codegen produces it (MCP introspection → SerializedAgentDefinition)
+ * - Registry stores it (JSON in DB or filesystem)
+ * - API serves it (GET /agents/:name → SerializedAgentDefinition)
+ * - createClient() hydrates it (definition → typed proxy with real calls)
+ */
+/**
+ * Serialize an AgentDefinition to its pure-data representation.
+ * Strips execute functions, runtime hooks, listeners, etc.
+ */
+export function serializeAgent(agent, meta) {
+    return {
+        path: agent.path,
+        name: agent.config?.name ?? agent.path,
+        description: agent.config?.description ?? "",
+        version: meta?.version ?? "1.0.0",
+        visibility: agent.visibility ?? "public",
+        auth: agent.config?.security,
+        serverSource: meta?.serverSource,
+        tools: agent.tools.map(serializeTool),
+        generatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Serialize a single ToolDefinition to its pure-data representation.
+ */
+export function serializeTool(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        ...(tool.outputSchema ? { outputSchema: tool.outputSchema } : {}),
+    };
+}
+//# sourceMappingURL=serialized.js.map

package/dist/serialized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized.js","sourceRoot":"","sources":["../src/serialized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAyDH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAsB,EACtB,IAAkD;IAElD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI;QACtC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE;QAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,OAAO;QACjC,UAAU,EAAG,KAAK,CAAC,UAAmC,IAAI,QAAQ;QAClE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ;QAC5B,YAAY,EAAE,IAAI,EAAE,YAAY;QAChC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;QACrC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAmD;IAEnD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slashfi/agents-sdk",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "author": "Slash Financial",
   "repository": {
     "type": "git",

package/src/client.ts

@@ -0,0 +1,273 @@
+/**
+ * Agent Client
+ *
+ * Creates a typed client from a SerializedAgentDefinition.
+ * The client spawns (or connects to) the MCP server and proxies
+ * tool calls via JSON-RPC.
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@slashfi/agents-sdk';
+ * import definition from './agents/notion/definition.json';
+ *
+ * const client = createClient(definition, {
+ *   env: { NOTION_TOKEN: process.env.NOTION_TOKEN },
+ * });
+ *
+ * const result = await client.call('API-post-search', { query: 'meeting notes' });
+ * await client.close();
+ * ```
+ */
+
+import { type ChildProcess, spawn } from "node:child_process";
+import type {
+  SerializedAgentDefinition,
+  SerializedTool,
+} from "./serialized.js";
+
+// ============================================
+// Client Options
+// ============================================
+
+export interface CreateClientOptions {
+  /** Extra environment variables for the MCP server process */
+  env?: Record<string, string | undefined>;
+  /** Override the server command (defaults to definition.serverSource) */
+  serverCommand?: string;
+  /** Timeout for tool calls in ms (default: 30000) */
+  timeout?: number;
+}
+
+// ============================================
+// Agent Client
+// ============================================
+
+export interface AgentClient {
+  /** The definition this client was created from */
+  readonly definition: SerializedAgentDefinition;
+
+  /** List available tools */
+  tools(): SerializedTool[];
+
+  /** Call a tool by name */
+  call(toolName: string, input?: Record<string, unknown>): Promise<unknown>;
+
+  /** Check if connected */
+  isConnected(): boolean;
+
+  /** Close the MCP server connection */
+  close(): void;
+}
+
+// ============================================
+// MCP Stdio Transport
+// ============================================
+
+interface PendingRequest {
+  resolve: (value: unknown) => void;
+  reject: (error: Error) => void;
+  timer: ReturnType<typeof setTimeout>;
+}
+
+class McpStdioClient implements AgentClient {
+  readonly definition: SerializedAgentDefinition;
+  private proc: ChildProcess | null = null;
+  private messageId = 0;
+  private buffer = "";
+  private pending = new Map<number, PendingRequest>();
+  private initialized = false;
+  private initPromise: Promise<void> | null = null;
+  private serverCommand: string;
+  private env: Record<string, string | undefined>;
+  private timeout: number;
+
+  constructor(
+    definition: SerializedAgentDefinition,
+    options: CreateClientOptions = {},
+  ) {
+    this.definition = definition;
+    this.serverCommand = options.serverCommand ?? definition.serverSource ?? "";
+    this.env = options.env ?? {};
+    this.timeout = options.timeout ?? 30000;
+
+    if (!this.serverCommand) {
+      throw new Error(
+        `No server command for agent "${definition.path}". Set serverSource in the definition or pass serverCommand in options.`,
+      );
+    }
+  }
+
+  tools(): SerializedTool[] {
+    return this.definition.tools;
+  }
+
+  isConnected(): boolean {
+    return this.proc !== null && !this.proc.killed;
+  }
+
+  async call(
+    toolName: string,
+    input: Record<string, unknown> = {},
+  ): Promise<unknown> {
+    // Validate tool exists
+    const tool = this.definition.tools.find((t) => t.name === toolName);
+    if (!tool) {
+      const available = this.definition.tools.map((t) => t.name).join(", ");
+      throw new Error(`Tool "${toolName}" not found. Available: ${available}`);
+    }
+
+    // Ensure connected + initialized
+    await this.ensureInitialized();
+
+    // Send tools/call
+    const result = await this.sendRequest("tools/call", {
+      name: toolName,
+      arguments: input,
+    });
+
+    // MCP tools/call returns { content: [{ type, text }] }
+    const resultObj = result as Record<string, unknown> | null;
+    if (resultObj && typeof resultObj === "object" && "content" in resultObj) {
+      const content = resultObj.content;
+      if (Array.isArray(content) && content.length > 0) {
+        const first = content[0];
+        if (first.type === "text") {
+          try {
+            return JSON.parse(first.text);
+          } catch {
+            return first.text;
+          }
+        }
+        return first;
+      }
+    }
+    return result;
+  }
+
+  close(): void {
+    if (this.proc) {
+      this.proc.kill();
+      this.proc = null;
+    }
+    this.initialized = false;
+    this.initPromise = null;
+    // Reject all pending
+    for (const req of Array.from(this.pending.values())) {
+      clearTimeout(req.timer);
+      req.reject(new Error("Client closed"));
+    }
+    this.pending.clear();
+  }
+
+  // ── Private ──
+
+  private async ensureInitialized(): Promise<void> {
+    if (this.initialized) return;
+    if (this.initPromise) return this.initPromise;
+
+    this.initPromise = this.connect();
+    await this.initPromise;
+    this.initialized = true;
+  }
+
+  private async connect(): Promise<void> {
+    const parts = this.serverCommand.split(/\s+/);
+    this.proc = spawn(parts[0], parts.slice(1), {
+      stdio: ["pipe", "pipe", "pipe"],
+      env: { ...process.env, ...this.env },
+    });
+
+    this.proc.stdout?.on("data", (chunk: Buffer) => this.onData(chunk));
+    this.proc.on("error", (err) => {
+      for (const req of Array.from(this.pending.values())) {
+        clearTimeout(req.timer);
+        req.reject(err);
+      }
+      this.pending.clear();
+    });
+
+    // Initialize handshake
+    await this.sendRequest("initialize", {
+      protocolVersion: "2024-11-05",
+      capabilities: {},
+      clientInfo: { name: "agents-sdk-client", version: "1.0.0" },
+    });
+
+    // Send initialized notification
+    this.sendNotification("notifications/initialized");
+  }
+
+  private sendRequest(
+    method: string,
+    params: Record<string, unknown> = {},
+  ): Promise<unknown> {
+    return new Promise((resolve, reject) => {
+      const id = ++this.messageId;
+      const timer = setTimeout(() => {
+        this.pending.delete(id);
+        reject(new Error(`Timeout after ${this.timeout}ms calling ${method}`));
+      }, this.timeout);
+
+      this.pending.set(id, { resolve, reject, timer });
+
+      const msg = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+      this.proc?.stdin?.write(`${msg}\n`);
+    });
+  }
+
+  private sendNotification(
+    method: string,
+    params?: Record<string, unknown>,
+  ): void {
+    const msg = JSON.stringify({
+      jsonrpc: "2.0",
+      method,
+      ...(params ? { params } : {}),
+    });
+    this.proc?.stdin?.write(`${msg}\n`);
+  }
+
+  private onData(chunk: Buffer): void {
+    this.buffer += chunk.toString();
+    const lines = this.buffer.split("\n");
+    this.buffer = lines.pop() || "";
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (parsed.id != null && this.pending.has(parsed.id)) {
+          const req = this.pending.get(parsed.id);
+          if (!req) continue;
+          this.pending.delete(parsed.id);
+          clearTimeout(req.timer);
+          if (parsed.error) {
+            req.reject(new Error(JSON.stringify(parsed.error)));
+          } else {
+            req.resolve(parsed.result);
+          }
+        }
+      } catch {
+        // ignore non-JSON lines (stderr leakage, etc.)
+      }
+    }
+  }
+}
+
+// ============================================
+// Factory
+// ============================================
+
+/**
+ * Create an agent client from a serialized definition.
+ *
+ * The client lazily spawns the MCP server on first call and
+ * proxies tool invocations via JSON-RPC over stdio.
+ */
+export function createClient(
+  definition: SerializedAgentDefinition,
+  options?: CreateClientOptions,
+): AgentClient {
+  return new McpStdioClient(definition, options);
+}

package/src/index.ts

@@ -294,3 +294,23 @@ export type {
   McpTransport,
   ServerSource,
 } from "./codegen.js";
+
+// ============================================
+// Serialized Agent Definitions
+// ============================================
+
+export { serializeAgent, serializeTool } from "./serialized.js";
+export type {
+  SerializedAgentDefinition,
+  SerializedTool,
+} from "./serialized.js";
+
+// ============================================
+// Agent Client
+// ============================================
+
+export { createClient } from "./client.js";
+export type {
+  AgentClient,
+  CreateClientOptions,
+} from "./client.js";

package/src/serialized.ts

@@ -0,0 +1,102 @@
+/**
+ * Serialized Agent Definition
+ *
+ * Pure-data, JSON-serializable representation of an agent.
+ * No execute functions, no runtime hooks — just schemas and metadata.
+ *
+ * This is the universal IR:
+ * - Codegen produces it (MCP introspection → SerializedAgentDefinition)
+ * - Registry stores it (JSON in DB or filesystem)
+ * - API serves it (GET /agents/:name → SerializedAgentDefinition)
+ * - createClient() hydrates it (definition → typed proxy with real calls)
+ */
+
+import type { JsonSchema, SecurityScheme } from "./types.js";
+
+// ============================================
+// Serialized Tool
+// ============================================
+
+export interface SerializedTool {
+  /** Tool name (unique within agent) */
+  name: string;
+  /** Short description for tool discovery */
+  description: string;
+  /** JSON Schema for input parameters */
+  inputSchema: JsonSchema;
+  /** JSON Schema for output (optional) */
+  outputSchema?: JsonSchema;
+}
+
+// ============================================
+// Serialized Agent Definition
+// ============================================
+
+export interface SerializedAgentDefinition {
+  /** Agent path (e.g., 'notion', 'linear', 'github') */
+  path: string;
+  /** Human-readable name */
+  name: string;
+  /** Short description */
+  description: string;
+  /** Version of the definition */
+  version: string;
+  /** Visibility level */
+  visibility: "public" | "private";
+  /** Auth requirements */
+  auth?: SecurityScheme;
+  /** MCP server source command (e.g., 'npx @notionhq/notion-mcp-server') */
+  serverSource?: string;
+  /** Server info from MCP introspection */
+  serverInfo?: {
+    name: string;
+    version: string;
+  };
+  /** Tool definitions (schemas only, no execute) */
+  tools: SerializedTool[];
+  /** ISO timestamp of when this was generated */
+  generatedAt?: string;
+  /** SDK version used for codegen */
+  sdkVersion?: string;
+}
+
+// ============================================
+// Serialization helpers
+// ============================================
+
+import type { AgentDefinition, ToolContext, ToolDefinition } from "./types.js";
+
+/**
+ * Serialize an AgentDefinition to its pure-data representation.
+ * Strips execute functions, runtime hooks, listeners, etc.
+ */
+export function serializeAgent(
+  agent: AgentDefinition,
+  meta?: { serverSource?: string; version?: string },
+): SerializedAgentDefinition {
+  return {
+    path: agent.path,
+    name: agent.config?.name ?? agent.path,
+    description: agent.config?.description ?? "",
+    version: meta?.version ?? "1.0.0",
+    visibility: (agent.visibility as "public" | "private") ?? "public",
+    auth: agent.config?.security,
+    serverSource: meta?.serverSource,
+    tools: agent.tools.map(serializeTool),
+    generatedAt: new Date().toISOString(),
+  };
+}
+
+/**
+ * Serialize a single ToolDefinition to its pure-data representation.
+ */
+export function serializeTool(
+  tool: ToolDefinition<ToolContext, unknown, unknown>,
+): SerializedTool {
+  return {
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+    ...(tool.outputSchema ? { outputSchema: tool.outputSchema } : {}),
+  };
+}