@ouispec/agent-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Closure Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# @ouispec/agent-mcp
+
+A Model Context Protocol server for a product's agent tools.
+
+```sh
+npm install @ouispec/agent-mcp
+```
+
+- `createMCPApiToolServer` serves the tools `@ouispec/agent-worker` generates from the product's OpenAPI document. Each call runs as the MCP client's own principal, with that user's permissions, and an operation's declared effect decides whether it is offered as a read or a write.
+- `handleMCPRequest` answers one MCP request over HTTP, for a product that hosts the server behind its own API.
+- `createMCPToolServer` and `registerOUISurfaces` serve a product's own tools and its OUI surfaces.
+- `createMCPServer` serves agent SDK intents.
+
+The server names itself from what the product passes; nothing defaults to another product's name. It releases with the rest of the agent SDK, under one version: see [VERSIONING.md](https://github.com/wesreid/oui/blob/main/VERSIONING.md).

package/dist/__tests__/fixtures.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Test fixtures for MCP server tests.
+ *
+ * Provides mock implementations of SchemaRegistry, AgentApiSurface, and
+ * UISurfaceSchema that carry realistic data for integration testing.
+ */
+import type { SchemaRegistry, AgentApiSurface, IntentResult, UISurfaceSchema } from '@ouispec/agent-core';
+export declare function createMockRegistry(): SchemaRegistry;
+export interface MockApiOptions {
+    executeResult?: IntentResult;
+    executeError?: Error;
+}
+export declare function createMockApi(options?: MockApiOptions): AgentApiSurface;
+export declare function createMockSurface(): UISurfaceSchema;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/__tests__/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/__tests__/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAOf,YAAY,EAIZ,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAwI7B,wBAAgB,kBAAkB,IAAI,cAAc,CAcnD;AAMD,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,eAAe,CA4B3E;AAMD,wBAAgB,iBAAiB,IAAI,eAAe,CAmGnD"}

package/dist/__tests__/fixtures.js

@@ -0,0 +1,250 @@
+/**
+ * Test fixtures for MCP server tests.
+ *
+ * Provides mock implementations of SchemaRegistry, AgentApiSurface, and
+ * UISurfaceSchema that carry realistic data for integration testing.
+ */
+// ---------------------------------------------------------------------------
+// Domain + Entities + Intents
+// ---------------------------------------------------------------------------
+const mockDomain = {
+    id: 'video',
+    name: 'Video Production',
+    description: 'Video production domain',
+    entities: [],
+    intents: [],
+    relationships: [],
+    entityIds: ['clip', 'project'],
+    intentIds: ['create_clip', 'list_clips', 'delete_clip'],
+};
+const mockClipEntity = {
+    id: 'clip',
+    domain: 'video',
+    description: 'A video clip',
+    properties: {
+        title: { type: 'string', description: 'Clip title', required: true, searchable: true },
+        duration: { type: 'number', description: 'Duration in seconds' },
+    },
+    display: { title: 'title' },
+    indexable: true,
+    domainRef: mockDomain,
+    incomingRelations: [],
+    outgoingRelations: [],
+    applicableIntents: ['create_clip', 'list_clips', 'delete_clip'],
+};
+const mockProjectEntity = {
+    id: 'project',
+    domain: 'video',
+    description: 'A video project',
+    properties: {
+        name: { type: 'string', description: 'Project name', required: true, searchable: true },
+    },
+    display: { title: 'name' },
+    indexable: true,
+    domainRef: mockDomain,
+    incomingRelations: [],
+    outgoingRelations: [],
+    applicableIntents: [],
+};
+function createMockIntent(id, description, params, outcome = {}) {
+    return {
+        id,
+        domain: 'video',
+        description,
+        parameters: Object.fromEntries(Object.entries(params).map(([key, val]) => [
+            key,
+            { type: val.type, description: val.description, required: true },
+        ])),
+        outcome,
+        domainRef: mockDomain,
+        resolvedPreconditions: [],
+        compositionChain: [],
+        toolDefinition: {
+            type: 'function',
+            function: {
+                name: id,
+                description,
+                parameters: {
+                    type: 'object',
+                    properties: Object.fromEntries(Object.entries(params).map(([key, val]) => [key, { type: val.type, description: val.description }])),
+                    required: Object.keys(params),
+                },
+            },
+        },
+    };
+}
+const createClipIntent = createMockIntent('create_clip', 'Create a new video clip', { title: { type: 'string', description: 'The clip title' }, duration: { type: 'number', description: 'Duration in seconds' } }, { produces: 'clip' });
+const listClipsIntent = createMockIntent('list_clips', 'List all video clips', {});
+const deleteClipIntent = createMockIntent('delete_clip', 'Delete a video clip', { clipId: { type: 'string', description: 'The ID of the clip to delete' } }, { deletes: 'clip' });
+// ---------------------------------------------------------------------------
+// SchemaRegistry
+// ---------------------------------------------------------------------------
+const intentsMap = new Map([
+    ['create_clip', createClipIntent],
+    ['list_clips', listClipsIntent],
+    ['delete_clip', deleteClipIntent],
+]);
+const entitiesMap = new Map([
+    ['clip', mockClipEntity],
+    ['project', mockProjectEntity],
+]);
+const domainsMap = new Map([
+    ['video', mockDomain],
+]);
+const mockEntityGraph = {
+    nodes: new Map([
+        ['clip', { entityId: 'clip', entity: mockClipEntity, depth: 0 }],
+        ['project', { entityId: 'project', entity: mockProjectEntity, depth: 0 }],
+    ]),
+    edges: [],
+    getNode: (id) => mockEntityGraph.nodes.get(id),
+    getEdgesFrom: () => [],
+    getEdgesTo: () => [],
+    getShortestPath: () => [],
+};
+export function createMockRegistry() {
+    return {
+        domains: domainsMap,
+        entities: entitiesMap,
+        intents: intentsMap,
+        entityGraph: mockEntityGraph,
+        getDomain: (id) => domainsMap.get(id),
+        getEntity: (id) => entitiesMap.get(id),
+        getIntent: (id) => intentsMap.get(id),
+        getIntentsForEntity: (entityId) => [...intentsMap.values()].filter(i => i.outcome.produces === entityId || i.outcome.deletes === entityId),
+        getRelatedEntities: () => [],
+        getIntentChain: () => [],
+    };
+}
+export function createMockApi(options = {}) {
+    const defaultResult = {
+        success: true,
+        data: { id: 'clip-001', title: 'Test Clip', duration: 30 },
+    };
+    return {
+        queryEntities: async () => [],
+        getEntity: async (_type, id) => ({
+            id,
+            type: _type,
+            properties: {},
+        }),
+        mutateEntity: async (_type, id) => ({
+            id,
+            type: _type,
+            properties: {},
+        }),
+        executeIntent: async (_intentId, _params) => {
+            if (options.executeError) {
+                throw options.executeError;
+            }
+            return options.executeResult ?? defaultResult;
+        },
+        getVisibleAnnotations: () => [],
+        getNavigationState: () => ({ route: '/dashboard' }),
+        navigate: async () => { },
+    };
+}
+// ---------------------------------------------------------------------------
+// UISurfaceSchema
+// ---------------------------------------------------------------------------
+export function createMockSurface() {
+    return {
+        pages: [
+            {
+                id: 'clip_editor',
+                route: '/clips/:clipId/edit',
+                title: 'Clip Editor',
+                description: 'Edit a video clip: trim, add effects, adjust audio',
+                entities: ['clip'],
+                actions: [
+                    {
+                        id: 'save_clip',
+                        label: 'Save',
+                        description: 'Save the current clip edits',
+                    },
+                    {
+                        id: 'render_clip',
+                        label: 'Render',
+                        description: 'Start rendering the clip for export',
+                        confirmRequired: true,
+                    },
+                ],
+                forms: [
+                    {
+                        id: 'clip_metadata',
+                        title: 'Clip Metadata',
+                        fields: [
+                            { id: 'title', label: 'Title', type: 'text', required: true },
+                            { id: 'description', label: 'Description', type: 'textarea' },
+                        ],
+                        submitAction: 'save_clip',
+                    },
+                ],
+                players: [
+                    {
+                        id: 'preview_player',
+                        type: 'video',
+                        commands: ['play', 'pause', 'seek', 'loop'],
+                        seekable: true,
+                    },
+                ],
+            },
+            {
+                id: 'project_dashboard',
+                route: '/projects/:projectId',
+                title: 'Project Dashboard',
+                description: 'Overview of all clips and assets in a project',
+                entities: ['project', 'clip'],
+                actions: [
+                    {
+                        id: 'new_clip',
+                        label: 'New Clip',
+                        description: 'Create a new clip in this project',
+                    },
+                ],
+                selectable: {
+                    entityType: 'clip',
+                    multi: true,
+                    bulkActions: ['delete_clip'],
+                },
+            },
+        ],
+        modals: [
+            {
+                id: 'confirm_delete',
+                title: 'Confirm Delete',
+                description: 'Confirmation dialog before deleting a clip',
+                actions: [
+                    {
+                        id: 'confirm',
+                        label: 'Delete',
+                        description: 'Confirm the deletion',
+                        destructive: true,
+                    },
+                    {
+                        id: 'cancel',
+                        label: 'Cancel',
+                        description: 'Cancel the deletion',
+                    },
+                ],
+            },
+        ],
+        globalActions: [
+            {
+                id: 'open_search',
+                label: 'Search',
+                description: 'Open the global search dialog',
+            },
+            {
+                id: 'toggle_theme',
+                label: 'Toggle Theme',
+                description: 'Switch between light and dark mode',
+            },
+        ],
+        entityRoutes: {
+            clip: '/clips/:id/edit',
+            project: '/projects/:id',
+        },
+    };
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/__tests__/fixtures.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createMCPServer } from './server/adapter.js';
+export type { MCPServerConfig } from './server/adapter.js';
+export { createMCPToolServer, registerOUISurfaces } from './server/tool-server.js';
+export type { MCPToolServerConfig, MCPToolServerResult, RegisterOUISurfacesConfig, RegisterOUISurfacesResult, } from './server/tool-server.js';
+export { createMCPApiToolServer } from './server/api-tool-server.js';
+export type { MCPApiToolServerConfig, MCPApiToolServerResult, MCPPrincipal } from './server/api-tool-server.js';
+export { handleMCPRequest } from './server/http.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,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnF,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { createMCPServer } from './server/adapter.js';
+export { createMCPToolServer, registerOUISurfaces } from './server/tool-server.js';
+// Generated API tools (ADR-0181 §2), each call as the MCP client's own principal
+export { createMCPApiToolServer } from './server/api-tool-server.js';
+export { handleMCPRequest } from './server/http.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,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAQnF,iFAAiF;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/server/adapter.d.ts

@@ -0,0 +1,50 @@
+import type { SchemaRegistry, AgentApiSurface } from '@ouispec/agent-core';
+export interface MCPServerConfig {
+    registry: SchemaRegistry;
+    api: AgentApiSurface;
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+}
+interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+interface MCPResource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+interface MCPToolCallResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Creates an MCP-compatible server from an Agent SDK schema registry.
+ * Maps: intents → MCP tools, entities → MCP resources.
+ */
+export declare function createMCPServer(config: MCPServerConfig): {
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+    listTools: () => MCPTool[];
+    listResources: () => MCPResource[];
+    callTool: (name: string, args: Record<string, unknown>) => Promise<MCPToolCallResult>;
+    readResource: (uri: string) => Promise<{
+        contents: Array<{
+            uri: string;
+            mimeType: string;
+            text: string;
+        }>;
+    }>;
+    handleRequest(method: string, params?: Record<string, unknown>): Promise<unknown>;
+};
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/server/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/server/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAkC,MAAM,qBAAqB,CAAC;AAG3G,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,EAAE,eAAe,CAAC;IACrB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,UAAU,WAAW;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,iBAAiB;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe;;;;;qBAI/B,OAAO,EAAE;yBAQL,WAAW,EAAE;qBAQT,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,iBAAiB,CAAC;wBAiB/D,MAAM,KAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;0BAyBzF,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;EAiB1F"}

package/dist/server/adapter.js

@@ -0,0 +1,92 @@
+import { toCallToolResult } from './results.js';
+import { DEFAULT_SERVER_INFO } from './server-info.js';
+/**
+ * Creates an MCP-compatible server from an Agent SDK schema registry.
+ * Maps: intents → MCP tools, entities → MCP resources.
+ */
+export function createMCPServer(config) {
+    const { registry, api } = config;
+    const serverInfo = config.serverInfo ?? DEFAULT_SERVER_INFO;
+    function listTools() {
+        const tools = [];
+        for (const intent of registry.intents.values()) {
+            tools.push(intentToMCPTool(intent));
+        }
+        return tools;
+    }
+    function listResources() {
+        const resources = [];
+        for (const entity of registry.entities.values()) {
+            resources.push(entityToMCPResource(entity));
+        }
+        return resources;
+    }
+    async function callTool(name, args) {
+        const intent = registry.getIntent(name);
+        if (!intent) {
+            return toCallToolResult({ success: false, error: `Unknown tool: ${name}` }, { bare: true });
+        }
+        try {
+            const result = await api.executeIntent(name, args);
+            return toCallToolResult(result.success ? { success: true, data: result.data } : { success: false, error: result.error?.message ?? 'Unknown error' });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return toCallToolResult({ success: false, error: `Execution error: ${message}` }, { bare: true });
+        }
+    }
+    async function readResource(uri) {
+        const match = uri.match(/^entity:\/\/(\w+)$/);
+        if (!match) {
+            throw new Error(`Invalid resource URI: ${uri}`);
+        }
+        const entityType = match[1];
+        const entities = await api.queryEntities(entityType, { limit: 50 });
+        return {
+            contents: [{
+                    uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(entities, null, 2),
+                }],
+        };
+    }
+    return {
+        serverInfo,
+        listTools,
+        listResources,
+        callTool,
+        readResource,
+        async handleRequest(method, params) {
+            switch (method) {
+                case 'initialize':
+                    return { protocolVersion: '2024-11-05', capabilities: { tools: {}, resources: {} }, serverInfo };
+                case 'tools/list':
+                    return { tools: listTools() };
+                case 'resources/list':
+                    return { resources: listResources() };
+                case 'tools/call':
+                    return callTool(params?.name, params?.arguments ?? {});
+                case 'resources/read':
+                    return readResource(params?.uri);
+                default:
+                    throw new Error(`Unknown method: ${method}`);
+            }
+        },
+    };
+}
+function intentToMCPTool(intent) {
+    return {
+        name: intent.id,
+        description: intent.description,
+        inputSchema: intent.toolDefinition.function.parameters,
+    };
+}
+function entityToMCPResource(entity) {
+    return {
+        uri: `entity://${entity.id}`,
+        name: `${entity.id} collection`,
+        description: entity.description ?? `All ${entity.id} entities`,
+        mimeType: 'application/json',
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/server/adapter.js.map

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

package/dist/server/api-tool-server.d.ts

@@ -0,0 +1,44 @@
+/**
+ * MCP API Tool Server — serves an agent SDK's generated API tools
+ * (`loadOpenApiTools`, ADR-0181 §2) over MCP, with the same exposure the worker has.
+ *
+ * Each MCP client acts as its own principal (ADR-0181 §4): the host resolves the
+ * credential the transport authenticated to a caller, and the tools call the API as
+ * that caller through their `actAs` seam. The API decides access, so a permission
+ * the caller lacks comes back as the route's own refusal. A call is validated
+ * against the tool's input schema before it runs, as the worker does.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import { type RegisteredTool } from '@ouispec/agent-worker/openapi';
+/** The caller an MCP client authenticated as. Other fields reach the tools' `actAs` in its context. */
+export interface MCPPrincipal {
+    userId: string;
+    accountId: string;
+    [key: string]: unknown;
+}
+export interface MCPApiToolServerConfig {
+    /** The generated API tools, loaded with an `actAs` that calls the API as the MCP client's principal. */
+    tools: RegisteredTool[];
+    /**
+     * Who the client is, from the credential its transport authenticated (for example
+     * the bearer token an HTTP transport verified). Return null to refuse the call.
+     * Required; there is no default.
+     */
+    principal: (auth: AuthInfo | undefined) => MCPPrincipal | null | Promise<MCPPrincipal | null>;
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+}
+export interface MCPApiToolServerResult {
+    /** The configured Server, ready for `server.connect(transport)`. */
+    server: Server;
+    toolCount: number;
+}
+/**
+ * Create an MCP server that lists and runs the given tools. It is not yet connected:
+ * call `server.connect(transport)`.
+ */
+export declare function createMCPApiToolServer(config: MCPApiToolServerConfig): MCPApiToolServerResult;
+//# sourceMappingURL=api-tool-server.d.ts.map

package/dist/server/api-tool-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-tool-server.d.ts","sourceRoot":"","sources":["../../src/server/api-tool-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC/E,OAAO,EAEL,KAAK,cAAc,EAGpB,MAAM,+BAA+B,CAAC;AAIvC,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,wGAAwG;IACxG,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,KAAK,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC9F,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAiCD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAoD7F"}

package/dist/server/api-tool-server.js

@@ -0,0 +1,93 @@
+/**
+ * MCP API Tool Server — serves an agent SDK's generated API tools
+ * (`loadOpenApiTools`, ADR-0181 §2) over MCP, with the same exposure the worker has.
+ *
+ * Each MCP client acts as its own principal (ADR-0181 §4): the host resolves the
+ * credential the transport authenticated to a caller, and the tools call the API as
+ * that caller through their `actAs` seam. The API decides access, so a permission
+ * the caller lacks comes back as the route's own refusal. A call is validated
+ * against the tool's input schema before it runs, as the worker does.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { createToolInputValidator, } from '@ouispec/agent-worker/openapi';
+import { effectAccess, effectKind } from '@ouispec/bindings';
+import { toCallToolResult } from './results.js';
+const NOT_AUTHENTICATED = 'Not authenticated: this server runs a tool only as the principal its client authenticated as';
+function annotationsOf(tool) {
+    const readOnly = effectAccess(tool.effect) === 'read';
+    const irreversible = tool.effect !== undefined && effectKind(tool.effect) === 'transaction';
+    const title = tool.operation?.title;
+    return {
+        ...(typeof title === 'string' ? { title } : {}),
+        readOnlyHint: readOnly,
+        // MCP assumes a write is destructive unless told otherwise.
+        destructiveHint: !readOnly && (tool.destructive === true || irreversible),
+    };
+}
+function listedTool(tool) {
+    // `sideEffects` is the worker's own flag, not JSON Schema.
+    const { sideEffects: _sideEffects, ...inputSchema } = tool.inputSchema;
+    return {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: inputSchema,
+        annotations: annotationsOf(tool),
+    };
+}
+/**
+ * Create an MCP server that lists and runs the given tools. It is not yet connected:
+ * call `server.connect(transport)`.
+ */
+export function createMCPApiToolServer(config) {
+    if (typeof config.principal !== 'function') {
+        throw new Error('createMCPApiToolServer: principal is required: it names who each call runs as, and has no default');
+    }
+    const info = config.serverInfo ?? { name: 'agent-sdk-api-tools', version: '1.0.0' };
+    const served = new Map();
+    for (const tool of config.tools) {
+        if (served.has(tool.name))
+            throw new Error(`createMCPApiToolServer: two tools are named "${tool.name}"`);
+        served.set(tool.name, { tool, listed: listedTool(tool), validate: createToolInputValidator(tool.inputSchema) });
+    }
+    const server = new Server({ name: info.name, version: info.version }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: [...served.values()].map((entry) => entry.listed),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+        const { name, arguments: args } = request.params;
+        const entry = served.get(name);
+        if (!entry)
+            return toCallToolResult({ success: false, error: `Unknown tool: ${name}` }, { bare: true });
+        let principal;
+        try {
+            principal = await config.principal(extra.authInfo);
+        }
+        catch {
+            principal = null;
+        }
+        if (!principal)
+            return toCallToolResult({ success: false, error: NOT_AUTHENTICATED }, { bare: true });
+        const validation = entry.validate(args ?? {});
+        if (!validation.ok) {
+            return toCallToolResult({ success: false, error: `Invalid input for "${name}": ${validation.errors.join('; ')}` });
+        }
+        const ctx = {
+            ...principal,
+            userId: principal.userId,
+            accountId: principal.accountId,
+            turnId: `mcp-${String(extra.requestId)}`,
+            conversationId: `mcp-${extra.sessionId ?? 'session'}`,
+            abortSignal: extra.signal,
+            toolCallId: String(extra.requestId),
+        };
+        try {
+            return toCallToolResult(await entry.tool.execute(validation.value, ctx));
+        }
+        catch (err) {
+            return toCallToolResult({ success: false, error: `Execution error: ${err instanceof Error ? err.message : String(err)}` }, { bare: true });
+        }
+    });
+    return { server, toolCount: served.size };
+}
+//# sourceMappingURL=api-tool-server.js.map

package/dist/server/api-tool-server.js.map

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

package/dist/server/http.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP's Streamable HTTP, stateless: each HTTP request gets its own server and
+ * transport, and is answered with JSON. This suits a host that keeps no state
+ * between requests, such as a Lambda behind an API gateway.
+ *
+ * The host authenticates the request itself and passes what it verified as
+ * `authInfo`; tools reach it as their principal (`createMCPApiToolServer`).
+ * There is no session and no server-sent stream: a GET is refused.
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+/**
+ * Answer one MCP HTTP request. `createServer` builds a fresh server for it, so no
+ * state is shared between requests or callers.
+ */
+export declare function handleMCPRequest(createServer: () => Server, request: Request, authInfo?: AuthInfo): Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/server/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAG/E;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkB3H"}

package/dist/server/http.js

@@ -0,0 +1,26 @@
+import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
+/**
+ * Answer one MCP HTTP request. `createServer` builds a fresh server for it, so no
+ * state is shared between requests or callers.
+ */
+export async function handleMCPRequest(createServer, request, authInfo) {
+    // No session to resume or end, and no stream a stateless host could hold open:
+    // MCP allows 405 for both.
+    if (request.method !== 'POST') {
+        return new Response(JSON.stringify({ jsonrpc: '2.0', error: { code: -32000, message: 'Method not allowed: this server answers POST only' }, id: null }), {
+            status: 405,
+            headers: { allow: 'POST', 'content-type': 'application/json' },
+        });
+    }
+    const server = createServer();
+    const transport = new WebStandardStreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
+    try {
+        await server.connect(transport);
+        return await transport.handleRequest(request, authInfo ? { authInfo } : undefined);
+    }
+    finally {
+        await transport.close();
+        await server.close();
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/server/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AAEzH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,YAA0B,EAAE,OAAgB,EAAE,QAAmB;IACtG,+EAA+E;IAC/E,2BAA2B;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YACvJ,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAC/D,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,wCAAwC,CAAC,EAAE,kBAAkB,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5H,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,MAAM,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrF,CAAC;YAAS,CAAC;QACT,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/server/results.d.ts

@@ -0,0 +1,24 @@
+/** A tool's outcome, as every tool server reports it. */
+export interface ToolOutcome {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+/** An MCP tool result made of text, as every tool server here returns. */
+export type TextToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+/**
+ * An MCP tool result from a tool's outcome: its data as JSON on success; on failure
+ * `Error: <message>`, followed by any data the failure carries (a refused call's
+ * status and body). `bare` reports the message as it is, for refusals the server
+ * itself makes.
+ */
+export declare function toCallToolResult(outcome: ToolOutcome, options?: {
+    bare?: boolean;
+}): TextToolResult;
+//# sourceMappingURL=results.d.ts.map

package/dist/server/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/server/results.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,cAAc,CAQvG"}

package/dist/server/results.js

@@ -0,0 +1,17 @@
+/**
+ * An MCP tool result from a tool's outcome: its data as JSON on success; on failure
+ * `Error: <message>`, followed by any data the failure carries (a refused call's
+ * status and body). `bare` reports the message as it is, for refusals the server
+ * itself makes.
+ */
+export function toCallToolResult(outcome, options = {}) {
+    if (outcome.success) {
+        return { content: [{ type: 'text', text: JSON.stringify(outcome.data ?? null, null, 2) }] };
+    }
+    const message = outcome.error ?? 'Unknown error';
+    const lines = [options.bare ? message : `Error: ${message}`];
+    if (outcome.data !== undefined)
+        lines.push(JSON.stringify(outcome.data, null, 2));
+    return { content: [{ type: 'text', text: lines.join('\n') }], isError: true };
+}
+//# sourceMappingURL=results.js.map

package/dist/server/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/server/results.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB,EAAE,UAA8B,EAAE;IACrF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvG,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC;IACjD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACzF,CAAC"}

package/dist/server/server-info.d.ts

@@ -0,0 +1,10 @@
+/**
+ * How an MCP server introduces itself when the product names nothing. The
+ * product's own name belongs in `serverInfo`; the platform has no default
+ * that names any one product (ADR-0227 §2.2).
+ */
+export declare const DEFAULT_SERVER_INFO: {
+    name: string;
+    version: string;
+};
+//# sourceMappingURL=server-info.d.ts.map

package/dist/server/server-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-info.d.ts","sourceRoot":"","sources":["../../src/server/server-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAgD,CAAC"}

package/dist/server/server-info.js

@@ -0,0 +1,7 @@
+/**
+ * How an MCP server introduces itself when the product names nothing. The
+ * product's own name belongs in `serverInfo`; the platform has no default
+ * that names any one product (ADR-0227 §2.2).
+ */
+export const DEFAULT_SERVER_INFO = { name: 'agent-sdk-mcp', version: '1.0.0' };
+//# sourceMappingURL=server-info.js.map

package/dist/server/server-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-info.js","sourceRoot":"","sources":["../../src/server/server-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/server/tool-server.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MCP Tool Server — exposes Agent SDK CompiledIntents as MCP tools via @modelcontextprotocol/sdk.
+ *
+ * Each CompiledIntent in the SchemaRegistry becomes an MCP tool whose input schema
+ * comes from the intent's toolDefinition.function.parameters (JSON Schema).
+ * When a client calls the tool, execution is delegated to AgentApiSurface.executeIntent().
+ *
+ * Uses the low-level Server class (not McpServer) because our intent schemas are
+ * JSON Schema objects, not Zod shapes. The low-level API gives us full control over
+ * the tools/list and tools/call protocol handlers.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SchemaRegistry, AgentApiSurface, UISurfaceSchema } from '@ouispec/agent-core';
+export interface MCPToolServerConfig {
+    /** The compiled schema registry containing intents to expose as MCP tools. */
+    registry: SchemaRegistry;
+    /** The API surface used to execute intents when tools are called. */
+    api: AgentApiSurface;
+    /** Server identification metadata. */
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+}
+export interface MCPToolServerResult {
+    /** The configured Server instance, ready for transport connection. */
+    server: Server;
+    /** Count of tools registered from the intent registry. */
+    toolCount: number;
+}
+/**
+ * Creates an MCP server with every CompiledIntent from the registry exposed as a tool.
+ *
+ * The returned server is not yet connected to any transport — call
+ * `server.connect(transport)` to start serving.
+ */
+export declare function createMCPToolServer(config: MCPToolServerConfig): MCPToolServerResult;
+export interface RegisterOUISurfacesConfig {
+    /** An already-instantiated Server (e.g. from createMCPToolServer). */
+    server: Server;
+    /** The UI surface schema describing the application's pages, modals, and actions. */
+    surface: UISurfaceSchema;
+}
+export interface RegisterOUISurfacesResult {
+    /** Total number of MCP resources registered. */
+    resourceCount: number;
+}
+/**
+ * Registers ListResources and ReadResource handlers on the given Server that
+ * expose every declarative element of a UISurfaceSchema as an MCP resource.
+ *
+ * Resource URI scheme:
+ *   surface://pages/{pageId}        — a single page declaration
+ *   surface://modals/{modalId}      — a single modal declaration
+ *   surface://global-actions        — the global actions list
+ *   surface://manifest              — the full surface manifest
+ *
+ * Call this after `createMCPToolServer` but before `server.connect(transport)`.
+ */
+export declare function registerOUISurfaces(config: RegisterOUISurfacesConfig): RegisterOUISurfacesResult;
+//# sourceMappingURL=tool-server.d.ts.map

package/dist/server/tool-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-server.d.ts","sourceRoot":"","sources":["../../src/server/tool-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAcnE,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,eAAe,EAGhB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,QAAQ,EAAE,cAAc,CAAC;IACzB,qEAAqE;IACrE,GAAG,EAAE,eAAe,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAuBpF;AAMD,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CA6BhG"}

package/dist/server/tool-server.js

@@ -0,0 +1,170 @@
+/**
+ * MCP Tool Server — exposes Agent SDK CompiledIntents as MCP tools via @modelcontextprotocol/sdk.
+ *
+ * Each CompiledIntent in the SchemaRegistry becomes an MCP tool whose input schema
+ * comes from the intent's toolDefinition.function.parameters (JSON Schema).
+ * When a client calls the tool, execution is delegated to AgentApiSurface.executeIntent().
+ *
+ * Uses the low-level Server class (not McpServer) because our intent schemas are
+ * JSON Schema objects, not Zod shapes. The low-level API gives us full control over
+ * the tools/list and tools/call protocol handlers.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { toCallToolResult } from './results.js';
+import { DEFAULT_SERVER_INFO } from './server-info.js';
+/**
+ * Creates an MCP server with every CompiledIntent from the registry exposed as a tool.
+ *
+ * The returned server is not yet connected to any transport — call
+ * `server.connect(transport)` to start serving.
+ */
+export function createMCPToolServer(config) {
+    const { registry, api } = config;
+    const info = config.serverInfo ?? DEFAULT_SERVER_INFO;
+    const toolIndex = buildToolIndex(registry);
+    const server = new Server({ name: info.name, version: info.version }, { capabilities: { tools: {}, resources: {} } });
+    // tools/list — return the full tool catalogue built from intents
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: [...toolIndex.values()].map(entry => entry.tool),
+    }));
+    // tools/call — look up the intent and execute via the API surface
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return executeIntentForMCP(api, name, args ?? {}, toolIndex);
+    });
+    return { server, toolCount: toolIndex.size };
+}
+/**
+ * Registers ListResources and ReadResource handlers on the given Server that
+ * expose every declarative element of a UISurfaceSchema as an MCP resource.
+ *
+ * Resource URI scheme:
+ *   surface://pages/{pageId}        — a single page declaration
+ *   surface://modals/{modalId}      — a single modal declaration
+ *   surface://global-actions        — the global actions list
+ *   surface://manifest              — the full surface manifest
+ *
+ * Call this after `createMCPToolServer` but before `server.connect(transport)`.
+ */
+export function registerOUISurfaces(config) {
+    const { server, surface } = config;
+    const resourceIndex = buildResourceIndex(surface);
+    server.setRequestHandler(ListResourcesRequestSchema, () => ({
+        resources: [...resourceIndex.values()].map(entry => ({
+            uri: entry.uri,
+            name: entry.name,
+            description: entry.description,
+            mimeType: 'application/json',
+        })),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, (request) => {
+        const { uri } = request.params;
+        const entry = resourceIndex.get(uri);
+        if (!entry) {
+            throw new Error(`Unknown resource URI: ${uri}`);
+        }
+        return {
+            contents: [{
+                    uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(entry.data, null, 2),
+                }],
+        };
+    });
+    return { resourceCount: resourceIndex.size };
+}
+function buildToolIndex(registry) {
+    const index = new Map();
+    for (const intent of registry.intents.values()) {
+        index.set(intent.id, {
+            intent,
+            tool: intentToMCPTool(intent),
+        });
+    }
+    return index;
+}
+function intentToMCPTool(intent) {
+    return {
+        name: intent.id,
+        description: intent.description,
+        inputSchema: intent.toolDefinition.function.parameters,
+        annotations: buildToolAnnotations(intent),
+    };
+}
+/**
+ * Derives MCP ToolAnnotations from intent metadata.
+ * Marks destructive intents (those that delete entities) as such.
+ */
+function buildToolAnnotations(intent) {
+    const isDestructive = intent.outcome.deletes !== undefined;
+    const isReadOnly = intent.outcome.produces === undefined &&
+        intent.outcome.mutates === undefined &&
+        intent.outcome.deletes === undefined;
+    return {
+        title: intent.id,
+        ...(isDestructive ? { destructiveHint: true } : {}),
+        ...(isReadOnly ? { readOnlyHint: true } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal: Intent Execution
+// ---------------------------------------------------------------------------
+async function executeIntentForMCP(api, intentId, args, toolIndex) {
+    if (!toolIndex.has(intentId)) {
+        return toCallToolResult({ success: false, error: `Unknown tool: ${intentId}` }, { bare: true });
+    }
+    try {
+        const result = await api.executeIntent(intentId, args);
+        return toCallToolResult(result.success ? { success: true, data: result.data } : { success: false, error: result.error?.message ?? 'Unknown error' });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown execution error';
+        return toCallToolResult({ success: false, error: `Execution error: ${message}` }, { bare: true });
+    }
+}
+function buildResourceIndex(surface) {
+    const index = new Map();
+    for (const page of surface.pages) {
+        const uri = pageURI(page);
+        index.set(uri, {
+            uri,
+            name: `page:${page.id}`,
+            description: page.description,
+            data: page,
+        });
+    }
+    for (const modal of surface.modals) {
+        const uri = modalURI(modal);
+        index.set(uri, {
+            uri,
+            name: `modal:${modal.id}`,
+            description: modal.description,
+            data: modal,
+        });
+    }
+    if (surface.globalActions.length > 0) {
+        const uri = 'surface://global-actions';
+        index.set(uri, {
+            uri,
+            name: 'global-actions',
+            description: 'Global actions available regardless of current page',
+            data: surface.globalActions,
+        });
+    }
+    const manifestURI = 'surface://manifest';
+    index.set(manifestURI, {
+        uri: manifestURI,
+        name: 'surface-manifest',
+        description: 'Complete OUI surface manifest: pages, modals, global actions, and entity routes',
+        data: surface,
+    });
+    return index;
+}
+function pageURI(page) {
+    return `surface://pages/${page.id}`;
+}
+function modalURI(modal) {
+    return `surface://modals/${modal.id}`;
+}
+//# sourceMappingURL=tool-server.js.map

package/dist/server/tool-server.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ouispec/agent-mcp",
+  "version": "0.1.0",
+  "description": "MCP server adapter — serves generated OpenAPI tools, each call as the client's own principal, and Agent SDK intents as MCP tools",
+  "homepage": "https://github.com/wesreid/oui/tree/main/packages/agent-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/wesreid/oui/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wesreid/oui.git",
+    "directory": "packages/agent-mcp"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@ouispec/agent-core": "^0.1.0",
+    "@ouispec/agent-worker": "^0.1.0",
+    "@ouispec/bindings": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}