@zauso-ai/capstan-agent 0.1.2

package/dist/a2a.d.ts

@@ -0,0 +1,65 @@
+import type { AgentConfig, RouteRegistryEntry } from "./types.js";
+/** Agent Card served at `/.well-known/agent.json`. */
+export interface A2AAgentCard {
+    name: string;
+    description?: string;
+    url: string;
+    version: string;
+    capabilities: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+    };
+    skills: Array<{
+        id: string;
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+        outputSchema?: Record<string, unknown>;
+    }>;
+    authentication?: {
+        schemes: string[];
+    };
+}
+/** A2A task representing a unit of work submitted to an agent. */
+export interface A2ATask {
+    id: string;
+    status: "submitted" | "working" | "input-required" | "completed" | "failed" | "canceled";
+    skill: string;
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+}
+/** JSON-RPC response envelope. */
+interface A2AJsonRpcResponse {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * Generate an A2A Agent Card from the agent configuration and registered
+ * routes. Each route is mapped to an A2A "skill".
+ */
+export declare function generateA2AAgentCard(config: AgentConfig, routes: RouteRegistryEntry[]): A2AAgentCard;
+/**
+ * Create an A2A handler that processes JSON-RPC requests according to
+ * Google's Agent-to-Agent protocol.
+ *
+ * Supported methods:
+ * - `tasks/send`  — create a task, execute the matching skill, return result
+ * - `tasks/get`   — retrieve the current status of a task
+ * - `agent/card`  — return the agent card
+ *
+ * Tasks are tracked in an in-memory Map so callers can query status after
+ * submission.
+ */
+export declare function createA2AHandler(config: AgentConfig, routes: RouteRegistryEntry[], executeRoute: (method: string, path: string, input: unknown) => Promise<unknown>): {
+    handleRequest: (body: unknown) => Promise<A2AJsonRpcResponse>;
+    getAgentCard: () => A2AAgentCard;
+};
+export {};
+//# sourceMappingURL=a2a.d.ts.map

package/dist/a2a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.d.ts","sourceRoot":"","sources":["../src/a2a.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOlE,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE;QACZ,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,MAAM,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC,CAAC;IACH,cAAc,CAAC,EAAE;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED,kEAAkE;AAClE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EACF,WAAW,GACX,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,kCAAkC;AAClC,UAAU,kBAAkB;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAkBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,kBAAkB,EAAE,GAC3B,YAAY,CAkCd;AA4BD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,kBAAkB,EAAE,EAC5B,YAAY,EAAE,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,OAAO,CAAC,GACpB;IACD,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9D,YAAY,EAAE,MAAM,YAAY,CAAC;CAClC,CA8HA"}

package/dist/a2a.js

@@ -0,0 +1,173 @@
+import { routeToToolName } from "./mcp.js";
+// ---------------------------------------------------------------------------
+// Agent Card generation
+// ---------------------------------------------------------------------------
+/**
+ * Derive a human-readable skill name from a tool ID.
+ *
+ *   "get_tickets" -> "Get Tickets"
+ */
+function humanizeToolName(toolName) {
+    return toolName
+        .split("_")
+        .map((w) => (w.length > 0 ? w[0].toUpperCase() + w.slice(1) : w))
+        .join(" ");
+}
+/**
+ * Generate an A2A Agent Card from the agent configuration and registered
+ * routes. Each route is mapped to an A2A "skill".
+ */
+export function generateA2AAgentCard(config, routes) {
+    const skills = routes.map((route) => {
+        const id = routeToToolName(route.method, route.path);
+        return {
+            id,
+            name: route.description ?? humanizeToolName(id),
+            ...(route.description !== undefined
+                ? { description: route.description }
+                : {}),
+            ...(route.inputSchema !== undefined
+                ? { inputSchema: route.inputSchema }
+                : {}),
+            ...(route.outputSchema !== undefined
+                ? { outputSchema: route.outputSchema }
+                : {}),
+        };
+    });
+    return {
+        name: config.name,
+        ...(config.description !== undefined
+            ? { description: config.description }
+            : {}),
+        url: config.baseUrl ?? "http://localhost:3000",
+        version: "1.0.0",
+        capabilities: {
+            streaming: false,
+            pushNotifications: false,
+        },
+        skills,
+        authentication: {
+            schemes: ["bearer"],
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// A2A Handler
+// ---------------------------------------------------------------------------
+/** Generate a unique task ID. */
+function generateTaskId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).slice(2, 10);
+    return `task_${timestamp}_${random}`;
+}
+/**
+ * Resolve a skill ID to the corresponding route's method and path.
+ */
+function resolveSkill(skillId, routes) {
+    for (const route of routes) {
+        if (routeToToolName(route.method, route.path) === skillId) {
+            return { method: route.method, path: route.path };
+        }
+    }
+    return null;
+}
+/**
+ * Create an A2A handler that processes JSON-RPC requests according to
+ * Google's Agent-to-Agent protocol.
+ *
+ * Supported methods:
+ * - `tasks/send`  — create a task, execute the matching skill, return result
+ * - `tasks/get`   — retrieve the current status of a task
+ * - `agent/card`  — return the agent card
+ *
+ * Tasks are tracked in an in-memory Map so callers can query status after
+ * submission.
+ */
+export function createA2AHandler(config, routes, executeRoute) {
+    const tasks = new Map();
+    const agentCard = generateA2AAgentCard(config, routes);
+    function errorResponse(id, code, message, data) {
+        return {
+            jsonrpc: "2.0",
+            id: id ?? null,
+            error: { code, message, ...(data !== undefined ? { data } : {}) },
+        };
+    }
+    function successResponse(id, result) {
+        return {
+            jsonrpc: "2.0",
+            id: id ?? null,
+            result,
+        };
+    }
+    async function handleTasksSend(reqId, params) {
+        const skillId = params["skill"];
+        if (!skillId) {
+            return errorResponse(reqId, -32602, "Missing required parameter: skill");
+        }
+        const resolved = resolveSkill(skillId, routes);
+        if (!resolved) {
+            return errorResponse(reqId, -32602, `Unknown skill: ${skillId}`);
+        }
+        const taskId = generateTaskId();
+        const task = {
+            id: taskId,
+            status: "submitted",
+            skill: skillId,
+            input: params["input"],
+        };
+        tasks.set(taskId, task);
+        // Transition to working.
+        task.status = "working";
+        try {
+            const result = await executeRoute(resolved.method, resolved.path, params["input"]);
+            task.status = "completed";
+            task.output = result;
+        }
+        catch (err) {
+            task.status = "failed";
+            task.error =
+                err instanceof Error ? err.message : "Unknown error during execution";
+        }
+        return successResponse(reqId, task);
+    }
+    function handleTasksGet(reqId, params) {
+        const taskId = params["id"];
+        if (!taskId) {
+            return errorResponse(reqId, -32602, "Missing required parameter: id");
+        }
+        const task = tasks.get(taskId);
+        if (!task) {
+            return errorResponse(reqId, -32602, `Task not found: ${taskId}`);
+        }
+        return successResponse(reqId, task);
+    }
+    async function handleRequest(body) {
+        // Validate JSON-RPC envelope.
+        if (body === null ||
+            typeof body !== "object" ||
+            !("method" in body)) {
+            return errorResponse(null, -32600, "Invalid JSON-RPC request");
+        }
+        const rpc = body;
+        if (rpc.jsonrpc !== "2.0") {
+            return errorResponse(rpc.id, -32600, "Invalid JSON-RPC version");
+        }
+        const params = rpc.params ?? {};
+        switch (rpc.method) {
+            case "tasks/send":
+                return handleTasksSend(rpc.id, params);
+            case "tasks/get":
+                return handleTasksGet(rpc.id, params);
+            case "agent/card":
+                return successResponse(rpc.id, agentCard);
+            default:
+                return errorResponse(rpc.id, -32601, `Method not found: ${rpc.method}`);
+        }
+    }
+    return {
+        handleRequest,
+        getAgentCard: () => agentCard,
+    };
+}
+//# sourceMappingURL=a2a.js.map

package/dist/a2a.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { generateAgentManifest } from "./manifest.js";
+export { createMcpServer, serveMcpStdio, routeToToolName } from "./mcp.js";
+export { generateOpenApiSpec } from "./openapi.js";
+export { generateA2AAgentCard, createA2AHandler, } from "./a2a.js";
+export type { A2AAgentCard, A2ATask } from "./a2a.js";
+export { CapabilityRegistry } from "./registry.js";
+export type { AgentManifest, RouteRegistryEntry, AgentConfig } from "./types.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,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { generateAgentManifest } from "./manifest.js";
+export { createMcpServer, serveMcpStdio, routeToToolName } from "./mcp.js";
+export { generateOpenApiSpec } from "./openapi.js";
+export { generateA2AAgentCard, createA2AHandler, } from "./a2a.js";
+export { CapabilityRegistry } from "./registry.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,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,9 @@
+import type { AgentConfig, AgentManifest, RouteRegistryEntry } from "./types.js";
+/**
+ * Generate the Capstan agent manifest — a JSON document that describes
+ * all API capabilities of the application for AI agent consumption.
+ *
+ * This is served at `/.well-known/capstan.json`.
+ */
+export declare function generateAgentManifest(config: AgentConfig, routes: RouteRegistryEntry[]): AgentManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmFjF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,kBAAkB,EAAE,GAC3B,aAAa,CA8Cf"}

package/dist/manifest.js

@@ -0,0 +1,123 @@
+/**
+ * Derive a camelCase capability key from an HTTP method and URL path.
+ *
+ * Examples:
+ *   GET  /tickets        -> "listTickets"
+ *   GET  /tickets/:id    -> "getTicket"
+ *   POST /tickets        -> "createTicket"
+ *   PUT  /tickets/:id    -> "updateTicket"
+ *   DELETE /tickets/:id  -> "deleteTicket"
+ *   PATCH /tickets/:id   -> "patchTicket"
+ */
+function deriveCapabilityKey(method, path) {
+    // Extract the meaningful path segments, stripping parameter placeholders
+    const segments = path
+        .split("/")
+        .filter((s) => s.length > 0 && !s.startsWith(":") && !s.startsWith("{"));
+    const hasParam = path.includes(":") || path.includes("{");
+    // Build the base noun from the path segments
+    const noun = segments.map((s) => capitalize(s)).join("");
+    const upperMethod = method.toUpperCase();
+    if (upperMethod === "GET" && !hasParam) {
+        // Collection read: GET /tickets -> listTickets
+        return `list${noun}`;
+    }
+    if (upperMethod === "GET" && hasParam) {
+        // Single resource read: GET /tickets/:id -> getTicket
+        return `get${singularize(noun)}`;
+    }
+    if (upperMethod === "POST") {
+        return `create${singularize(noun)}`;
+    }
+    if (upperMethod === "PUT") {
+        return `update${singularize(noun)}`;
+    }
+    if (upperMethod === "DELETE") {
+        return `delete${singularize(noun)}`;
+    }
+    if (upperMethod === "PATCH") {
+        return `patch${singularize(noun)}`;
+    }
+    // Fallback: method + noun
+    return `${method.toLowerCase()}${noun}`;
+}
+/** Simple singularization: strip trailing "s" if present. */
+function singularize(word) {
+    if (word.endsWith("ies")) {
+        return word.slice(0, -3) + "y";
+    }
+    if (word.endsWith("ses") || word.endsWith("xes") || word.endsWith("zes")) {
+        return word.slice(0, -2);
+    }
+    if (word.endsWith("s") && !word.endsWith("ss")) {
+        return word.slice(0, -1);
+    }
+    return word;
+}
+/** Capitalize the first letter of a string. */
+function capitalize(s) {
+    if (s.length === 0)
+        return s;
+    return s[0].toUpperCase() + s.slice(1);
+}
+/**
+ * Convert a capability key to a human-readable title.
+ *
+ * "listTickets" -> "List Tickets"
+ */
+function humanize(key) {
+    // Insert spaces before uppercase letters and capitalize each word
+    const words = key.replace(/([A-Z])/g, " $1").trim();
+    return words[0].toUpperCase() + words.slice(1);
+}
+/**
+ * Generate the Capstan agent manifest — a JSON document that describes
+ * all API capabilities of the application for AI agent consumption.
+ *
+ * This is served at `/.well-known/capstan.json`.
+ */
+export function generateAgentManifest(config, routes) {
+    const capabilities = routes.map((route) => {
+        const key = deriveCapabilityKey(route.method, route.path);
+        return {
+            key,
+            title: route.description ?? humanize(key),
+            ...(route.description !== undefined ? { description: route.description } : {}),
+            mode: route.capability ?? "read",
+            ...(route.resource !== undefined ? { resource: route.resource } : {}),
+            endpoint: {
+                method: route.method.toUpperCase(),
+                path: route.path,
+                ...(route.inputSchema !== undefined ? { inputSchema: route.inputSchema } : {}),
+                ...(route.outputSchema !== undefined
+                    ? { outputSchema: route.outputSchema }
+                    : {}),
+            },
+            ...(route.policy !== undefined ? { policy: route.policy } : {}),
+        };
+    });
+    const manifest = {
+        capstan: "1.0",
+        name: config.name,
+        ...(config.description !== undefined ? { description: config.description } : {}),
+        ...(config.baseUrl !== undefined ? { baseUrl: config.baseUrl } : {}),
+        authentication: {
+            schemes: [
+                {
+                    type: "bearer",
+                    name: "API Key",
+                    header: "Authorization",
+                    description: "Bearer token for authenticating API requests. Include as: Authorization: Bearer <token>",
+                },
+            ],
+        },
+        resources: config.resources ?? [],
+        capabilities,
+        mcp: {
+            endpoint: "/.well-known/mcp",
+            transport: "stdio",
+        },
+    };
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,41 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentConfig, RouteRegistryEntry } from "./types.js";
+/**
+ * Convert an HTTP method + URL path into a snake_case MCP tool name.
+ *
+ * Examples:
+ *   GET  /tickets        -> "get_tickets"
+ *   POST /tickets        -> "post_tickets"
+ *   GET  /tickets/:id    -> "get_tickets_by_id"
+ *   PUT  /tickets/:id    -> "put_tickets_by_id"
+ *   DELETE /orgs/:orgId/members/:memberId -> "delete_orgs_by_orgId_members_by_memberId"
+ */
+export declare function routeToToolName(method: string, path: string): string;
+/**
+ * Create an MCP server that exposes all Capstan API routes as MCP tools.
+ *
+ * Each API route is registered as an MCP tool. Tool arguments sent by the
+ * client are forwarded to the `executeRoute` callback so the actual Capstan
+ * handler can process them.
+ *
+ * @param config - Application configuration.
+ * @param routes - Registered API routes.
+ * @param executeRoute - Callback that invokes the actual route handler.
+ * @returns The McpServer instance and a helper to inspect tool definitions.
+ */
+export declare function createMcpServer(config: AgentConfig, routes: RouteRegistryEntry[], executeRoute: (method: string, path: string, input: unknown) => Promise<unknown>): {
+    server: McpServer;
+    getToolDefinitions: () => Array<{
+        name: string;
+        description: string;
+        inputSchema: unknown;
+    }>;
+};
+/**
+ * Connect an MCP server to stdio transport and start serving.
+ *
+ * This is the standard way to run a Capstan MCP server as a subprocess
+ * that communicates over stdin/stdout.
+ */
+export declare function serveMcpStdio(server: McpServer): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkBpE;AAYD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,kBAAkB,EAAE,EAC5B,YAAY,EAAE,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,OAAO,CAAC,GACpB;IACD,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,EAAE,MAAM,KAAK,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC,CAAC;CACJ,CAyDA;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE"}

package/dist/mcp.js

@@ -0,0 +1,107 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+/**
+ * Convert an HTTP method + URL path into a snake_case MCP tool name.
+ *
+ * Examples:
+ *   GET  /tickets        -> "get_tickets"
+ *   POST /tickets        -> "post_tickets"
+ *   GET  /tickets/:id    -> "get_tickets_by_id"
+ *   PUT  /tickets/:id    -> "put_tickets_by_id"
+ *   DELETE /orgs/:orgId/members/:memberId -> "delete_orgs_by_orgId_members_by_memberId"
+ */
+export function routeToToolName(method, path) {
+    const prefix = method.toLowerCase();
+    const segments = path.split("/").filter((s) => s.length > 0);
+    const parts = [];
+    for (const segment of segments) {
+        if (segment.startsWith(":")) {
+            // Dynamic parameter: :id -> "by_id"
+            parts.push("by_" + segment.slice(1));
+        }
+        else if (segment.startsWith("{") && segment.endsWith("}")) {
+            // OpenAPI-style parameter: {id} -> "by_id"
+            parts.push("by_" + segment.slice(1, -1));
+        }
+        else {
+            parts.push(segment);
+        }
+    }
+    return `${prefix}_${parts.join("_")}`;
+}
+/**
+ * Build a tool description from a route.
+ */
+function buildToolDescription(route) {
+    if (route.description) {
+        return route.description;
+    }
+    return `${route.method.toUpperCase()} ${route.path}`;
+}
+/**
+ * Create an MCP server that exposes all Capstan API routes as MCP tools.
+ *
+ * Each API route is registered as an MCP tool. Tool arguments sent by the
+ * client are forwarded to the `executeRoute` callback so the actual Capstan
+ * handler can process them.
+ *
+ * @param config - Application configuration.
+ * @param routes - Registered API routes.
+ * @param executeRoute - Callback that invokes the actual route handler.
+ * @returns The McpServer instance and a helper to inspect tool definitions.
+ */
+export function createMcpServer(config, routes, executeRoute) {
+    const server = new McpServer({
+        name: config.name,
+        version: "1.0.0",
+    });
+    const toolDefinitions = [];
+    // A permissive Zod schema that accepts any object and passes all
+    // properties through. This lets the MCP SDK forward client-supplied
+    // arguments to our handler while avoiding the need to convert each
+    // route's JSON Schema into a Zod type at registration time.
+    const passthroughShape = { _input: z.unknown().optional() };
+    for (const route of routes) {
+        const toolName = routeToToolName(route.method, route.path);
+        const description = buildToolDescription(route);
+        // Record the definition for introspection
+        toolDefinitions.push({
+            name: toolName,
+            description,
+            inputSchema: route.inputSchema ?? { type: "object", properties: {} },
+        });
+        // Register the tool with the MCP server.
+        //
+        // We use the `tool(name, description, paramsSchema, callback)` overload
+        // with a minimal Zod shape so the SDK invokes `callback(args, extra)`.
+        // The `passthroughShape` ensures the SDK parses the incoming arguments
+        // as an object and hands them to us — we then forward them to the
+        // actual route handler via `executeRoute`.
+        server.tool(toolName, description, passthroughShape, async (args) => {
+            // Forward all arguments (minus our synthetic _input marker) to the
+            // route handler.  Agents will send the actual input properties
+            // directly in the tool arguments object.
+            const input = Object.keys(args).length > 0 ? args : undefined;
+            const result = await executeRoute(route.method, route.path, input);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+            };
+        });
+    }
+    return {
+        server,
+        getToolDefinitions: () => [...toolDefinitions],
+    };
+}
+/**
+ * Connect an MCP server to stdio transport and start serving.
+ *
+ * This is the standard way to run a Capstan MCP server as a subprocess
+ * that communicates over stdin/stdout.
+ */
+export async function serveMcpStdio(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/openapi.d.ts

@@ -0,0 +1,9 @@
+import type { AgentConfig, RouteRegistryEntry } from "./types.js";
+/**
+ * Generate an OpenAPI 3.1.0 specification from the agent configuration and
+ * registered routes.
+ *
+ * The returned object is a plain JSON-serializable OpenAPI document.
+ */
+export declare function generateOpenApiSpec(config: AgentConfig, routes: RouteRegistryEntry[]): Record<string, unknown>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgLlE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,kBAAkB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8EzB"}

package/dist/openapi.js

@@ -0,0 +1,218 @@
+/**
+ * HTTP methods where the request body carries the input payload.
+ */
+const BODY_METHODS = new Set(["POST", "PUT", "PATCH"]);
+/**
+ * Convert a Capstan route path (Express/Hono-style) to an OpenAPI path.
+ *
+ *   /tickets/:id  ->  /tickets/{id}
+ */
+function toOpenApiPath(path) {
+    return path.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, "{$1}");
+}
+/**
+ * Extract path parameter names from a route path.
+ *
+ *   /tickets/:id  ->  ["id"]
+ *   /orgs/:orgId/members/:memberId  ->  ["orgId", "memberId"]
+ */
+function extractPathParams(path) {
+    const params = [];
+    const regex = /:([a-zA-Z_][a-zA-Z0-9_]*)/g;
+    let match;
+    while ((match = regex.exec(path)) !== null) {
+        params.push(match[1]);
+    }
+    return params;
+}
+/**
+ * Build OpenAPI parameter objects for path parameters.
+ */
+function buildPathParameters(pathParams) {
+    return pathParams.map((name) => ({
+        name,
+        in: "path",
+        required: true,
+        schema: { type: "string" },
+    }));
+}
+/**
+ * Build OpenAPI query parameter objects from a JSON Schema input definition.
+ *
+ * For GET and DELETE requests, input properties are sent as query parameters.
+ */
+function buildQueryParameters(inputSchema, pathParams) {
+    if (!inputSchema)
+        return [];
+    const properties = (inputSchema["properties"] ?? {});
+    const required = new Set(inputSchema["required"] ?? []);
+    const pathParamSet = new Set(pathParams);
+    return Object.entries(properties)
+        .filter(([name]) => !pathParamSet.has(name))
+        .map(([name, schema]) => ({
+        name,
+        in: "query",
+        required: required.has(name),
+        schema,
+    }));
+}
+/**
+ * Build an OpenAPI operation object for a single route.
+ */
+function buildOperation(route, pathParams) {
+    const upperMethod = route.method.toUpperCase();
+    const operation = {};
+    // Operation ID derived from method + path (including param markers for uniqueness)
+    const allSegments = route.path.split("/").filter((s) => s.length > 0);
+    const idParts = [];
+    for (const seg of allSegments) {
+        if (seg.startsWith(":")) {
+            idParts.push("By" + seg[1].toUpperCase() + seg.slice(2));
+        }
+        else if (seg.startsWith("{") && seg.endsWith("}")) {
+            const name = seg.slice(1, -1);
+            idParts.push("By" + name[0].toUpperCase() + name.slice(1));
+        }
+        else {
+            idParts.push(seg[0].toUpperCase() + seg.slice(1));
+        }
+    }
+    operation["operationId"] = upperMethod.toLowerCase() + idParts.join("");
+    if (route.description) {
+        operation["summary"] = route.description;
+    }
+    // Tags: use the resource name if available, otherwise derive from first path segment
+    const staticSegments = allSegments.filter((s) => !s.startsWith(":") && !s.startsWith("{"));
+    if (route.resource) {
+        operation["tags"] = [route.resource];
+    }
+    else if (staticSegments.length > 0) {
+        operation["tags"] = [staticSegments[0]];
+    }
+    // Parameters: path params + query params for non-body methods
+    const parameters = [
+        ...buildPathParameters(pathParams),
+    ];
+    if (!BODY_METHODS.has(upperMethod)) {
+        parameters.push(...buildQueryParameters(route.inputSchema, pathParams));
+    }
+    if (parameters.length > 0) {
+        operation["parameters"] = parameters;
+    }
+    // Request body for POST/PUT/PATCH
+    if (BODY_METHODS.has(upperMethod) && route.inputSchema) {
+        operation["requestBody"] = {
+            required: true,
+            content: {
+                "application/json": {
+                    schema: route.inputSchema,
+                },
+            },
+        };
+    }
+    // Responses
+    const responses = {};
+    if (route.outputSchema) {
+        responses["200"] = {
+            description: "Successful response",
+            content: {
+                "application/json": {
+                    schema: route.outputSchema,
+                },
+            },
+        };
+    }
+    else {
+        responses["200"] = {
+            description: "Successful response",
+        };
+    }
+    responses["401"] = {
+        description: "Unauthorized — missing or invalid authentication",
+    };
+    if (route.policy) {
+        responses["403"] = {
+            description: `Forbidden — policy "${route.policy}" denied access`,
+        };
+    }
+    operation["responses"] = responses;
+    // Security requirement
+    operation["security"] = [{ bearerAuth: [] }];
+    return operation;
+}
+/**
+ * Generate an OpenAPI 3.1.0 specification from the agent configuration and
+ * registered routes.
+ *
+ * The returned object is a plain JSON-serializable OpenAPI document.
+ */
+export function generateOpenApiSpec(config, routes) {
+    // Build paths
+    const paths = {};
+    for (const route of routes) {
+        const openApiPath = toOpenApiPath(route.path);
+        const method = route.method.toLowerCase();
+        const pathParams = extractPathParams(route.path);
+        if (!paths[openApiPath]) {
+            paths[openApiPath] = {};
+        }
+        paths[openApiPath][method] = buildOperation(route, pathParams);
+    }
+    // Build component schemas from resources
+    const schemas = {};
+    if (config.resources) {
+        for (const resource of config.resources) {
+            const properties = {};
+            const required = [];
+            for (const [fieldName, fieldDef] of Object.entries(resource.fields)) {
+                const prop = { type: fieldDef.type };
+                if (fieldDef.enum) {
+                    prop["enum"] = fieldDef.enum;
+                }
+                properties[fieldName] = prop;
+                if (fieldDef.required) {
+                    required.push(fieldName);
+                }
+            }
+            const schema = {
+                type: "object",
+                properties,
+            };
+            if (required.length > 0) {
+                schema["required"] = required;
+            }
+            if (resource.description) {
+                schema["description"] = resource.description;
+            }
+            schemas[resource.key] = schema;
+        }
+    }
+    // Assemble the spec
+    const spec = {
+        openapi: "3.1.0",
+        info: {
+            title: config.name,
+            ...(config.description !== undefined
+                ? { description: config.description }
+                : {}),
+            version: "0.1.0",
+        },
+        ...(config.baseUrl !== undefined
+            ? { servers: [{ url: config.baseUrl }] }
+            : {}),
+        paths,
+        components: {
+            securitySchemes: {
+                bearerAuth: {
+                    type: "http",
+                    scheme: "bearer",
+                    bearerFormat: "JWT",
+                    description: "Bearer token for authenticating API requests",
+                },
+            },
+            ...(Object.keys(schemas).length > 0 ? { schemas } : {}),
+        },
+    };
+    return spec;
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,59 @@
+import type { AgentConfig, AgentManifest, RouteRegistryEntry } from "./types.js";
+import type { A2AAgentCard } from "./a2a.js";
+/**
+ * Unified capability registry — the central abstraction for Capstan's
+ * multi-protocol adapter layer.
+ *
+ * Register routes once, then project them to any supported protocol surface:
+ *
+ * - **Capstan manifest** (`/.well-known/capstan.json`)
+ * - **OpenAPI 3.1** (`/openapi.json`)
+ * - **MCP** (Model Context Protocol tools)
+ * - **A2A** (Google Agent-to-Agent protocol)
+ *
+ * One registry, four projections.
+ */
+export declare class CapabilityRegistry {
+    private routes;
+    private config;
+    constructor(config: AgentConfig);
+    /** Register a single route entry. */
+    register(route: RouteRegistryEntry): void;
+    /** Register multiple route entries at once. */
+    registerAll(routes: RouteRegistryEntry[]): void;
+    /** Get all registered routes (read-only view). */
+    getRoutes(): readonly RouteRegistryEntry[];
+    /** Get the agent configuration. */
+    getConfig(): Readonly<AgentConfig>;
+    /** Project to Capstan native agent manifest. */
+    toManifest(): AgentManifest;
+    /** Project to OpenAPI 3.1 specification. */
+    toOpenApi(): Record<string, unknown>;
+    /**
+     * Project to MCP server.
+     *
+     * @param executeRoute - Callback that invokes the actual route handler
+     *   given an HTTP method, path, and input payload.
+     * @returns The McpServer instance and a helper to list tool definitions.
+     */
+    toMcp(executeRoute: (method: string, path: string, input: unknown) => Promise<unknown>): {
+        server: InstanceType<typeof import("@modelcontextprotocol/sdk/server/mcp.js").McpServer>;
+        getToolDefinitions: () => Array<{
+            name: string;
+            description: string;
+            inputSchema: unknown;
+        }>;
+    };
+    /**
+     * Project to A2A agent card and JSON-RPC handler.
+     *
+     * @param executeRoute - Callback that invokes the actual route handler
+     *   given an HTTP method, path, and input payload.
+     * @returns The A2A request handler and agent card accessor.
+     */
+    toA2A(executeRoute: (method: string, path: string, input: unknown) => Promise<unknown>): {
+        handleRequest: (body: unknown) => Promise<unknown>;
+        getAgentCard: () => A2AAgentCard;
+    };
+}
+//# 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,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAM7C;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAQ/B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAIzC,+CAA+C;IAC/C,WAAW,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAM/C,kDAAkD;IAClD,SAAS,IAAI,SAAS,kBAAkB,EAAE;IAI1C,mCAAmC;IACnC,SAAS,IAAI,QAAQ,CAAC,WAAW,CAAC;IAQlC,gDAAgD;IAChD,UAAU,IAAI,aAAa;IAI3B,4CAA4C;IAC5C,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpC;;;;;;OAMG;IACH,KAAK,CACH,YAAY,EAAE,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,OAAO,CAAC,GACpB;QACD,MAAM,EAAE,YAAY,CAAC,cAAc,yCAAyC,EAAE,SAAS,CAAC,CAAC;QACzF,kBAAkB,EAAE,MAAM,KAAK,CAAC;YAC9B,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,OAAO,CAAC;SACtB,CAAC,CAAC;KACJ;IAID;;;;;;OAMG;IACH,KAAK,CACH,YAAY,EAAE,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,OAAO,CAAC,GACpB;QACD,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QACnD,YAAY,EAAE,MAAM,YAAY,CAAC;KAClC;CAGF"}

package/dist/registry.js

@@ -0,0 +1,77 @@
+import { generateAgentManifest } from "./manifest.js";
+import { generateOpenApiSpec } from "./openapi.js";
+import { createMcpServer } from "./mcp.js";
+import { createA2AHandler } from "./a2a.js";
+/**
+ * Unified capability registry — the central abstraction for Capstan's
+ * multi-protocol adapter layer.
+ *
+ * Register routes once, then project them to any supported protocol surface:
+ *
+ * - **Capstan manifest** (`/.well-known/capstan.json`)
+ * - **OpenAPI 3.1** (`/openapi.json`)
+ * - **MCP** (Model Context Protocol tools)
+ * - **A2A** (Google Agent-to-Agent protocol)
+ *
+ * One registry, four projections.
+ */
+export class CapabilityRegistry {
+    routes = [];
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // -------------------------------------------------------------------------
+    // Registration
+    // -------------------------------------------------------------------------
+    /** Register a single route entry. */
+    register(route) {
+        this.routes.push(route);
+    }
+    /** Register multiple route entries at once. */
+    registerAll(routes) {
+        for (const route of routes) {
+            this.routes.push(route);
+        }
+    }
+    /** Get all registered routes (read-only view). */
+    getRoutes() {
+        return this.routes;
+    }
+    /** Get the agent configuration. */
+    getConfig() {
+        return this.config;
+    }
+    // -------------------------------------------------------------------------
+    // Projections
+    // -------------------------------------------------------------------------
+    /** Project to Capstan native agent manifest. */
+    toManifest() {
+        return generateAgentManifest(this.config, this.routes);
+    }
+    /** Project to OpenAPI 3.1 specification. */
+    toOpenApi() {
+        return generateOpenApiSpec(this.config, this.routes);
+    }
+    /**
+     * Project to MCP server.
+     *
+     * @param executeRoute - Callback that invokes the actual route handler
+     *   given an HTTP method, path, and input payload.
+     * @returns The McpServer instance and a helper to list tool definitions.
+     */
+    toMcp(executeRoute) {
+        return createMcpServer(this.config, this.routes, executeRoute);
+    }
+    /**
+     * Project to A2A agent card and JSON-RPC handler.
+     *
+     * @param executeRoute - Callback that invokes the actual route handler
+     *   given an HTTP method, path, and input payload.
+     * @returns The A2A request handler and agent card accessor.
+     */
+    toA2A(executeRoute) {
+        return createA2AHandler(this.config, this.routes, executeRoute);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAyB,EAAE,CAAC;IAClC,MAAM,CAAc;IAE5B,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAE5E,qCAAqC;IACrC,QAAQ,CAAC,KAAyB;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,+CAA+C;IAC/C,WAAW,CAAC,MAA4B;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,mCAAmC;IACnC,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,4EAA4E;IAC5E,cAAc;IACd,4EAA4E;IAE5E,gDAAgD;IAChD,UAAU;QACR,OAAO,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,4CAA4C;IAC5C,SAAS;QACP,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CACH,YAIqB;QASrB,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CACH,YAIqB;QAKrB,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+/** Agent manifest describing all capabilities of a Capstan application for AI consumption. */
+export interface AgentManifest {
+    /** Manifest format version, e.g. "1.0". */
+    capstan: string;
+    /** Application name. */
+    name: string;
+    /** Optional human-readable description of the application. */
+    description?: string;
+    /** Base URL where the application is served. */
+    baseUrl?: string;
+    /** Authentication schemes the application accepts. */
+    authentication: {
+        schemes: Array<{
+            type: "bearer";
+            name: string;
+            header: string;
+            description: string;
+        }>;
+    };
+    /** Domain resources the application manages. */
+    resources: Array<{
+        key: string;
+        title: string;
+        description?: string;
+        fields: Record<string, {
+            type: string;
+            required?: boolean;
+            enum?: string[];
+        }>;
+    }>;
+    /** API capabilities (tools) exposed by the application. */
+    capabilities: Array<{
+        key: string;
+        title: string;
+        description?: string;
+        mode: "read" | "write" | "external";
+        resource?: string;
+        endpoint: {
+            method: string;
+            path: string;
+            inputSchema?: Record<string, unknown>;
+            outputSchema?: Record<string, unknown>;
+        };
+        policy?: string;
+    }>;
+    /** MCP server configuration, if enabled. */
+    mcp?: {
+        endpoint: string;
+        transport: string;
+    };
+}
+/** An entry in the route registry used to generate agent surfaces. */
+export interface RouteRegistryEntry {
+    method: string;
+    path: string;
+    description?: string;
+    capability?: "read" | "write" | "external";
+    resource?: string;
+    policy?: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+/** Configuration for the agent surface layer. */
+export interface AgentConfig {
+    name: string;
+    description?: string;
+    baseUrl?: string;
+    resources?: Array<{
+        key: string;
+        title: string;
+        description?: string;
+        fields: Record<string, {
+            type: string;
+            required?: boolean;
+            enum?: string[];
+        }>;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,cAAc,EAAE;QACd,OAAO,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,QAAQ,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACJ,CAAC;IACF,gDAAgD;IAChD,SAAS,EAAE,KAAK,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CACtD,CAAC;KACH,CAAC,CAAC;IACH,2DAA2D;IAC3D,YAAY,EAAE,KAAK,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE;YACR,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACxC,CAAC;QACF,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,4CAA4C;IAC5C,GAAG,CAAC,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CACtD,CAAC;KACH,CAAC,CAAC;CACJ"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@zauso-ai/capstan-agent",
+  "version": "0.1.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "description": "Multi-protocol agent surface for Capstan — MCP server, A2A adapter, OpenAPI, manifest",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/barry3406/capstan.git",
+    "directory": "packages/agent"
+  },
+  "license": "MIT",
+  "author": "barry3406",
+  "homepage": "https://github.com/barry3406/capstan",
+  "keywords": [
+    "capstan",
+    "ai-agent",
+    "full-stack",
+    "framework",
+    "mcp",
+    "a2a",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}