@slashfi/agents-sdk 0.1.0

package/dist/define.js

@@ -0,0 +1,71 @@
+/**
+ * Define Agent and Tool Functions
+ *
+ * Factory functions for creating agent and tool definitions.
+ */
+/**
+ * Create a tool definition.
+ *
+ * @example
+ * ```typescript
+ * const greet = defineTool({
+ *   name: 'greet',
+ *   description: 'Greet a user',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       name: { type: 'string', description: 'Name to greet' }
+ *     },
+ *     required: ['name']
+ *   },
+ *   execute: async (input) => ({ message: `Hello, ${input.name}!` })
+ * });
+ * ```
+ */
+export function defineTool(options) {
+    return {
+        name: options.name,
+        description: options.description,
+        inputSchema: options.inputSchema,
+        outputSchema: options.outputSchema,
+        visibility: options.visibility,
+        allowedCallers: options.allowedCallers,
+        execute: options.execute,
+    };
+}
+/**
+ * Create an agent definition.
+ *
+ * @example
+ * ```typescript
+ * const agent = defineAgent({
+ *   path: '@my-agent',
+ *   entrypoint: 'You are a helpful assistant.',
+ *   config: {
+ *     name: 'My Agent',
+ *     description: 'A helpful agent'
+ *   },
+ *   tools: [greet, echo],
+ *   runtime: () => ({
+ *     onInvoke: async (ctx) => {
+ *       console.log(`Invoked with: ${ctx.prompt}`);
+ *     },
+ *     onTick: async (ctx) => {
+ *       console.log(`Tick at ${ctx.timestamp}`);
+ *     }
+ *   })
+ * });
+ * ```
+ */
+export function defineAgent(options) {
+    return {
+        path: options.path,
+        entrypoint: options.entrypoint,
+        config: options.config,
+        tools: options.tools ?? [],
+        runtime: options.runtime,
+        visibility: options.visibility,
+        allowedCallers: options.allowedCallers,
+    };
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2CH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CAKxB,OAAqD;IAErD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAkCD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,WAAW,CACzB,OAAqC;IAErC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Agents SDK
+ *
+ * SDK for building AI agents with tool definitions, JSON-RPC servers,
+ * and built-in OAuth2 authentication.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   defineAgent,
+ *   defineTool,
+ *   createAgentRegistry,
+ *   createAgentServer,
+ *   createAuthAgent,
+ * } from '@slashfi/agents-sdk';
+ *
+ * // Define a tool
+ * const greet = defineTool({
+ *   name: 'greet',
+ *   description: 'Greet a user',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       name: { type: 'string', description: 'Name to greet' }
+ *     },
+ *     required: ['name']
+ *   },
+ *   execute: async (input) => ({ message: `Hello, ${input.name}!` })
+ * });
+ *
+ * // Define an agent
+ * const agent = defineAgent({
+ *   path: '@my-agent',
+ *   entrypoint: 'You are a helpful assistant.',
+ *   tools: [greet]
+ * });
+ *
+ * // Create registry with auth
+ * const registry = createAgentRegistry();
+ * registry.register(createAuthAgent({ rootKey: process.env.ROOT_KEY! }));
+ * registry.register(agent);
+ *
+ * // Start server - auth auto-detected
+ * const server = createAgentServer(registry, { port: 3000 });
+ * await server.start();
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { AgentAction, AgentConfig, AgentDefinition, AgentRuntime, CallAgentAskRequest, CallAgentAskResponse, CallAgentDescribeToolsRequest, CallAgentDescribeToolsResponse, CallAgentErrorResponse, CallAgentExecuteToolRequest, CallAgentExecuteToolResponse, CallAgentInvokeRequest, CallAgentInvokeResponse, CallAgentLearnRequest, CallAgentLearnResponse, CallAgentLoadRequest, CallAgentLoadResponse, CallAgentRequest, CallAgentResponse, CallerType, CoreContext, InvokeContext, JsonSchema, LearnContext, MessageContext, StepContext, TickContext, ToolContext, ToolDefinition, ToolSchema, ToolSelectionContext, Visibility, } from "./types.js";
+export { defineAgent, defineTool } from "./define.js";
+export type { DefineAgentOptions, DefineToolOptions } from "./define.js";
+export { createAgentRegistry } from "./registry.js";
+export type { AgentRegistry, AgentRegistryOptions } from "./registry.js";
+export { createAgentServer } from "./server.js";
+export type { AgentServer, AgentServerOptions } from "./server.js";
+export { createAuthAgent, createMemoryAuthStore } from "./auth.js";
+export type { AuthClient, AuthIdentity, AuthStore, AuthToken, CreateAuthAgentOptions, } from "./auth.js";
+export { buildAgents } from "./build.js";
+export type { BuildAgentsOptions, BuildAgentsResult } from "./build.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAGH,YAAY,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EACV,UAAU,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,60 @@
+/**
+ * Agents SDK
+ *
+ * SDK for building AI agents with tool definitions, JSON-RPC servers,
+ * and built-in OAuth2 authentication.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   defineAgent,
+ *   defineTool,
+ *   createAgentRegistry,
+ *   createAgentServer,
+ *   createAuthAgent,
+ * } from '@slashfi/agents-sdk';
+ *
+ * // Define a tool
+ * const greet = defineTool({
+ *   name: 'greet',
+ *   description: 'Greet a user',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       name: { type: 'string', description: 'Name to greet' }
+ *     },
+ *     required: ['name']
+ *   },
+ *   execute: async (input) => ({ message: `Hello, ${input.name}!` })
+ * });
+ *
+ * // Define an agent
+ * const agent = defineAgent({
+ *   path: '@my-agent',
+ *   entrypoint: 'You are a helpful assistant.',
+ *   tools: [greet]
+ * });
+ *
+ * // Create registry with auth
+ * const registry = createAgentRegistry();
+ * registry.register(createAuthAgent({ rootKey: process.env.ROOT_KEY! }));
+ * registry.register(agent);
+ *
+ * // Start server - auth auto-detected
+ * const server = createAgentServer(registry, { port: 3000 });
+ * await server.start();
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Define functions
+export { defineAgent, defineTool } from "./define.js";
+// Registry
+export { createAgentRegistry } from "./registry.js";
+// Server
+export { createAgentServer } from "./server.js";
+// Auth
+export { createAuthAgent, createMemoryAuthStore } from "./auth.js";
+// Build
+export { buildAgents } from "./build.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAsCH,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGtD,WAAW;AACX,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO;AACP,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AASnE,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Agent Registry Implementation
+ *
+ * Manages registered agents and handles callAgent requests.
+ */
+import type { AgentDefinition, CallAgentRequest, CallAgentResponse, Visibility } from "./types.js";
+/**
+ * Options for creating an agent registry.
+ */
+export interface AgentRegistryOptions {
+    /** Default visibility for agents without explicit visibility */
+    defaultVisibility?: Visibility;
+}
+/**
+ * Agent registry interface.
+ */
+export interface AgentRegistry {
+    /** Register an agent */
+    register(agent: AgentDefinition): void;
+    /** Get an agent by path */
+    get(path: string): AgentDefinition | undefined;
+    /** Check if an agent exists */
+    has(path: string): boolean;
+    /** List all registered agents */
+    list(): AgentDefinition[];
+    /** List all registered agent paths */
+    listPaths(): string[];
+    /** Call an agent (execute action) */
+    call(request: CallAgentRequest): Promise<CallAgentResponse>;
+}
+/**
+ * Create an agent registry.
+ *
+ * @example
+ * ```typescript
+ * const registry = createAgentRegistry();
+ * registry.register(myAgent);
+ *
+ * const result = await registry.call({
+ *   action: 'execute_tool',
+ *   path: '@my-agent',
+ *   tool: 'greet',
+ *   params: { name: 'World' }
+ * });
+ * ```
+ */
+export declare function createAgentRegistry(options?: AgentRegistryOptions): AgentRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,eAAe,EAMf,gBAAgB,EAChB,iBAAiB,EAIjB,UAAU,EACX,MAAM,YAAY,CAAC;AAapB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,UAAU,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAEvC,2BAA2B;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAE/C,+BAA+B;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B,iCAAiC;IACjC,IAAI,IAAI,eAAe,EAAE,CAAC;IAE1B,sCAAsC;IACtC,SAAS,IAAI,MAAM,EAAE,CAAC;IAEtB,qCAAqC;IACrC,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7D;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,aAAa,CA4Tf"}

package/dist/registry.js

@@ -0,0 +1,274 @@
+/**
+ * Agent Registry Implementation
+ *
+ * Manages registered agents and handles callAgent requests.
+ */
+/** Default supported actions if not specified */
+const DEFAULT_SUPPORTED_ACTIONS = [
+    "execute_tool",
+    "describe_tools",
+    "load",
+];
+// ============================================
+// Create Registry
+// ============================================
+/**
+ * Create an agent registry.
+ *
+ * @example
+ * ```typescript
+ * const registry = createAgentRegistry();
+ * registry.register(myAgent);
+ *
+ * const result = await registry.call({
+ *   action: 'execute_tool',
+ *   path: '@my-agent',
+ *   tool: 'greet',
+ *   params: { name: 'World' }
+ * });
+ * ```
+ */
+export function createAgentRegistry(options = {}) {
+    const { defaultVisibility = "internal" } = options;
+    const agents = new Map();
+    /**
+     * Check if agent supports the requested action.
+     */
+    function checkActionSupported(agent, action) {
+        const supported = agent.config?.supportedActions ?? DEFAULT_SUPPORTED_ACTIONS;
+        return supported.includes(action);
+    }
+    /**
+     * Check if caller is allowed to access the agent.
+     */
+    function checkAgentAccess(agent, callerId, callerType) {
+        const visibility = agent.visibility ?? defaultVisibility;
+        // System callers can access everything
+        if (callerType === "system")
+            return true;
+        // Check explicit allowlist first
+        if (agent.allowedCallers && callerId) {
+            if (agent.allowedCallers.includes(callerId))
+                return true;
+        }
+        // Check visibility
+        switch (visibility) {
+            case "public":
+                return true;
+            case "internal":
+                // Authenticated callers (agents or users with a callerId) can access
+                return (callerType === "agent" || (callerType != null && callerId != null));
+            case "private":
+                // Only self can access
+                return callerId === agent.path;
+            default:
+                return false;
+        }
+    }
+    /**
+     * Check if caller is allowed to use a tool.
+     */
+    function checkToolAccess(agent, toolName, callerId, callerType) {
+        const tool = agent.tools.find((t) => t.name === toolName);
+        if (!tool)
+            return false;
+        const visibility = tool.visibility ?? "public";
+        // System callers can access everything
+        if (callerType === "system")
+            return true;
+        // Check explicit allowlist first
+        if (tool.allowedCallers && callerId) {
+            if (tool.allowedCallers.includes(callerId))
+                return true;
+        }
+        // Check visibility
+        switch (visibility) {
+            case "public":
+                return true;
+            case "internal":
+                return (callerType === "agent" || (callerType != null && callerId != null));
+            case "private":
+                return callerId === agent.path;
+            default:
+                return false;
+        }
+    }
+    const registry = {
+        register(agent) {
+            agents.set(agent.path, agent);
+        },
+        get(path) {
+            return agents.get(path);
+        },
+        has(path) {
+            return agents.has(path);
+        },
+        list() {
+            return Array.from(agents.values());
+        },
+        listPaths() {
+            return Array.from(agents.keys());
+        },
+        async call(request) {
+            const agent = agents.get(request.path);
+            if (!agent) {
+                return {
+                    success: false,
+                    error: `Agent not found: ${request.path}`,
+                    code: "AGENT_NOT_FOUND",
+                };
+            }
+            // Check agent access
+            if (!checkAgentAccess(agent, request.callerId, request.callerType)) {
+                return {
+                    success: false,
+                    error: `Access denied to agent: ${request.path}`,
+                    code: "ACCESS_DENIED",
+                };
+            }
+            // Check action is supported
+            if (!checkActionSupported(agent, request.action)) {
+                const supported = agent.config?.supportedActions ?? DEFAULT_SUPPORTED_ACTIONS;
+                return {
+                    success: false,
+                    error: `Action '${request.action}' not supported by agent. Supported: ${supported.join(", ")}`,
+                    code: "ACTION_NOT_SUPPORTED",
+                };
+            }
+            switch (request.action) {
+                case "invoke":
+                case "ask": {
+                    // Get runtime if available
+                    const runtime = agent.runtime?.();
+                    // Call onInvoke hook if defined
+                    if (runtime?.onInvoke) {
+                        await runtime.onInvoke({
+                            tenantId: "default",
+                            agentPath: request.path,
+                            prompt: request.prompt,
+                            sessionId: request.sessionId,
+                            callerId: request.callerId ?? "unknown",
+                            callerType: request.callerType ?? "system",
+                            metadata: request.metadata,
+                        });
+                    }
+                    // These actions require an LLM runtime which this SDK doesn't provide
+                    // Users can implement their own invoke/ask handlers or use a full runtime
+                    return {
+                        success: false,
+                        error: `Action '${request.action}' requires an LLM runtime. Use execute_tool for direct tool calls.`,
+                        code: "RUNTIME_REQUIRED",
+                    };
+                }
+                case "execute_tool": {
+                    const tool = agent.tools.find((t) => t.name === request.tool);
+                    if (!tool) {
+                        return {
+                            success: false,
+                            error: `Tool not found: ${request.tool}`,
+                            code: "TOOL_NOT_FOUND",
+                        };
+                    }
+                    // Check tool access
+                    if (!checkToolAccess(agent, request.tool, request.callerId, request.callerType)) {
+                        return {
+                            success: false,
+                            error: `Access denied to tool: ${request.tool}`,
+                            code: "ACCESS_DENIED",
+                        };
+                    }
+                    const ctx = {
+                        tenantId: "default",
+                        agentPath: agent.path,
+                        callerId: request.callerId ?? "unknown",
+                        callerType: request.callerType ?? "system",
+                        metadata: request.metadata,
+                    };
+                    try {
+                        const result = await tool.execute(request.params, ctx);
+                        return {
+                            success: true,
+                            result,
+                        };
+                    }
+                    catch (err) {
+                        return {
+                            success: false,
+                            error: err instanceof Error ? err.message : String(err),
+                            code: "TOOL_EXECUTION_ERROR",
+                        };
+                    }
+                }
+                case "describe_tools": {
+                    const toolSchemas = agent.tools
+                        .filter((t) => checkToolAccess(agent, t.name, request.callerId, request.callerType))
+                        .filter((t) => request.tools ? request.tools.includes(t.name) : true)
+                        .map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        inputSchema: t.inputSchema,
+                        ...(t.outputSchema && { outputSchema: t.outputSchema }),
+                    }));
+                    return {
+                        success: true,
+                        tools: toolSchemas,
+                    };
+                }
+                case "load": {
+                    const toolSchemas = agent.tools
+                        .filter((t) => checkToolAccess(agent, t.name, request.callerId, request.callerType))
+                        .map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        inputSchema: t.inputSchema,
+                        ...(t.outputSchema && { outputSchema: t.outputSchema }),
+                    }));
+                    return {
+                        success: true,
+                        result: {
+                            path: agent.path,
+                            entrypoint: agent.entrypoint,
+                            config: agent.config,
+                            tools: toolSchemas,
+                        },
+                    };
+                }
+                case "learn": {
+                    // Get runtime if available
+                    const runtime = agent.runtime?.();
+                    // Call onLearn hook if defined
+                    if (runtime?.onLearn) {
+                        await runtime.onLearn({
+                            tenantId: "default",
+                            agentPath: request.path,
+                            content: request.content,
+                            scope: request.scope ?? "session",
+                            category: request.category,
+                            callerId: request.callerId ?? "unknown",
+                        });
+                        return {
+                            success: true,
+                            action: "stored",
+                        };
+                    }
+                    // No runtime or no onLearn hook - ignore
+                    return {
+                        success: true,
+                        action: "ignored",
+                    };
+                }
+                default: {
+                    // TypeScript exhaustiveness check
+                    const _exhaustive = request;
+                    return {
+                        success: false,
+                        error: `Unknown action: ${_exhaustive.action}`,
+                        code: "UNKNOWN_ACTION",
+                    };
+                }
+            }
+        },
+    };
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Agent Server
+ *
+ * HTTP server that exposes the agent registry via JSON-RPC endpoints.
+ * Compatible with MCP (Model Context Protocol) over HTTP.
+ *
+ * Endpoints:
+ * - POST /call - Execute agent actions (execute_tool, describe_tools, load)
+ * - GET /list - List registered agents
+ * - POST /oauth/token - OAuth2 token endpoint (when @auth is registered)
+ *
+ * Auth Integration:
+ * When an `@auth` agent is registered, the server automatically:
+ * - Validates Bearer tokens on requests
+ * - Resolves tokens to identity + scopes
+ * - Populates callerId, callerType in the request context
+ * - Recognizes the root key for admin access
+ * - Mounts the /oauth/token endpoint
+ */
+import type { AgentRegistry } from "./registry.js";
+/**
+ * Server configuration options.
+ */
+export interface AgentServerOptions {
+    /** Port to listen on (default: 3000) */
+    port?: number;
+    /** Hostname to bind to (default: 'localhost') */
+    hostname?: string;
+    /** Base path for endpoints (default: '') */
+    basePath?: string;
+    /** Enable CORS (default: true) */
+    cors?: boolean;
+    /** Custom request handler for unmatched routes */
+    onNotFound?: (req: Request) => Response | Promise<Response>;
+}
+/**
+ * Agent server instance.
+ */
+export interface AgentServer {
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server */
+    stop(): Promise<void>;
+    /** Handle a request (for custom integrations) */
+    fetch(req: Request): Promise<Response>;
+    /** Get the server URL (only available after start) */
+    url: string | null;
+}
+/**
+ * Create an HTTP server for the agent registry.
+ *
+ * @example
+ * ```typescript
+ * const registry = createAgentRegistry();
+ * registry.register(createAuthAgent({ rootKey: 'rk_xxx' }));
+ * registry.register(myAgent);
+ *
+ * const server = createAgentServer(registry, { port: 3000 });
+ * await server.start();
+ * // POST /call - Execute agent actions
+ * // GET /list - List agents (filtered by auth)
+ * // POST /oauth/token - OAuth2 token endpoint
+ * ```
+ */
+export declare function createAgentServer(registry: AgentRegistry, options?: AgentServerOptions): AgentServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,kDAAkD;IAClD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,sBAAsB;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,iDAAiD;IACjD,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,sDAAsD;IACtD,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAqHD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAoQb"}