@contractspec/bundle.library 2.9.1 → 3.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.library",
-  "version": "2.9.1",
+  "version": "3.1.1",
   "type": "module",
   "scripts": {
     "clean": "rm -rf dist",
@@ -30,6 +30,18 @@
       "node": "./dist/node/application/index.js",
       "default": "./dist/application/index.js"
     },
+    "./application/context-storage": {
+      "types": "./dist/application/context-storage/index.d.ts",
+      "bun": "./dist/application/context-storage/index.js",
+      "node": "./dist/node/application/context-storage/index.js",
+      "default": "./dist/application/context-storage/index.js"
+    },
+    "./application/context-storage/index": {
+      "types": "./dist/application/context-storage/index.d.ts",
+      "bun": "./dist/application/context-storage/index.js",
+      "node": "./dist/node/application/context-storage/index.js",
+      "default": "./dist/application/context-storage/index.js"
+    },
     "./application/index": {
       "types": "./dist/application/index.d.ts",
       "bun": "./dist/application/index.js",
@@ -54,6 +66,30 @@
       "node": "./dist/node/application/mcp/common.js",
       "default": "./dist/application/mcp/common.js"
     },
+    "./application/mcp/contractsMcp": {
+      "types": "./dist/application/mcp/contractsMcp.d.ts",
+      "bun": "./dist/application/mcp/contractsMcp.js",
+      "node": "./dist/node/application/mcp/contractsMcp.js",
+      "default": "./dist/application/mcp/contractsMcp.js"
+    },
+    "./application/mcp/contractsMcpResources": {
+      "types": "./dist/application/mcp/contractsMcpResources.d.ts",
+      "bun": "./dist/application/mcp/contractsMcpResources.js",
+      "node": "./dist/node/application/mcp/contractsMcpResources.js",
+      "default": "./dist/application/mcp/contractsMcpResources.js"
+    },
+    "./application/mcp/contractsMcpTools": {
+      "types": "./dist/application/mcp/contractsMcpTools.d.ts",
+      "bun": "./dist/application/mcp/contractsMcpTools.js",
+      "node": "./dist/node/application/mcp/contractsMcpTools.js",
+      "default": "./dist/application/mcp/contractsMcpTools.js"
+    },
+    "./application/mcp/contractsMcpTypes": {
+      "types": "./dist/application/mcp/contractsMcpTypes.d.ts",
+      "bun": "./dist/application/mcp/contractsMcpTypes.js",
+      "node": "./dist/node/application/mcp/contractsMcpTypes.js",
+      "default": "./dist/application/mcp/contractsMcpTypes.js"
+    },
     "./application/mcp/docsMcp": {
       "types": "./dist/application/mcp/docsMcp.d.ts",
       "bun": "./dist/application/mcp/docsMcp.js",
@@ -72,6 +108,12 @@
       "node": "./dist/node/application/mcp/internalMcp.js",
       "default": "./dist/application/mcp/internalMcp.js"
     },
+    "./application/mcp/providerRankingMcp": {
+      "types": "./dist/application/mcp/providerRankingMcp.d.ts",
+      "bun": "./dist/application/mcp/providerRankingMcp.js",
+      "node": "./dist/node/application/mcp/providerRankingMcp.js",
+      "default": "./dist/application/mcp/providerRankingMcp.js"
+    },
     "./components/docs": {
       "types": "./dist/components/docs/index.d.ts",
       "bun": "./dist/components/docs/index.js",
@@ -138,6 +180,12 @@
       "node": "./dist/node/components/docs/architecture/ArchitectureAppConfigPage.js",
       "default": "./dist/components/docs/architecture/ArchitectureAppConfigPage.js"
     },
+    "./components/docs/architecture/ArchitectureControlPlanePage": {
+      "types": "./dist/components/docs/architecture/ArchitectureControlPlanePage.d.ts",
+      "bun": "./dist/components/docs/architecture/ArchitectureControlPlanePage.js",
+      "node": "./dist/node/components/docs/architecture/ArchitectureControlPlanePage.js",
+      "default": "./dist/components/docs/architecture/ArchitectureControlPlanePage.js"
+    },
     "./components/docs/architecture/ArchitectureIntegrationBindingPage": {
       "types": "./dist/components/docs/architecture/ArchitectureIntegrationBindingPage.d.ts",
       "bun": "./dist/components/docs/architecture/ArchitectureIntegrationBindingPage.js",
@@ -474,6 +522,12 @@
       "node": "./dist/node/components/docs/integrations/IntegrationsElevenLabsPage.js",
       "default": "./dist/components/docs/integrations/IntegrationsElevenLabsPage.js"
     },
+    "./components/docs/integrations/IntegrationsGithubPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsGithubPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsGithubPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsGithubPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsGithubPage.js"
+    },
     "./components/docs/integrations/IntegrationsGmailPage": {
       "types": "./dist/components/docs/integrations/IntegrationsGmailPage.d.ts",
       "bun": "./dist/components/docs/integrations/IntegrationsGmailPage.js",
@@ -486,6 +540,18 @@
       "node": "./dist/node/components/docs/integrations/IntegrationsGoogleCalendarPage.js",
       "default": "./dist/components/docs/integrations/IntegrationsGoogleCalendarPage.js"
     },
+    "./components/docs/integrations/IntegrationsHealthRoutingPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsHealthRoutingPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.js"
+    },
+    "./components/docs/integrations/IntegrationsMistralPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsMistralPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsMistralPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsMistralPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsMistralPage.js"
+    },
     "./components/docs/integrations/IntegrationsOpenAIPage": {
       "types": "./dist/components/docs/integrations/IntegrationsOpenAIPage.d.ts",
       "bun": "./dist/components/docs/integrations/IntegrationsOpenAIPage.js",
@@ -528,6 +594,12 @@
       "node": "./dist/node/components/docs/integrations/IntegrationsS3Page.js",
       "default": "./dist/components/docs/integrations/IntegrationsS3Page.js"
     },
+    "./components/docs/integrations/IntegrationsSlackPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsSlackPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsSlackPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsSlackPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsSlackPage.js"
+    },
     "./components/docs/integrations/IntegrationsSpecModelPage": {
       "types": "./dist/components/docs/integrations/IntegrationsSpecModelPage.d.ts",
       "bun": "./dist/components/docs/integrations/IntegrationsSpecModelPage.js",
@@ -546,6 +618,18 @@
       "node": "./dist/node/components/docs/integrations/IntegrationsTwilioPage.js",
       "default": "./dist/components/docs/integrations/IntegrationsTwilioPage.js"
     },
+    "./components/docs/integrations/IntegrationsWhatsappMetaPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsWhatsappMetaPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js"
+    },
+    "./components/docs/integrations/IntegrationsWhatsappTwilioPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsWhatsappTwilioPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js"
+    },
     "./components/docs/intent": {
       "types": "./dist/components/docs/intent/index.d.ts",
       "bun": "./dist/components/docs/intent/index.js",
@@ -2053,41 +2137,43 @@
   },
   "dependencies": {
     "@apollo/client": "^4.1.6",
-    "@contractspec/lib.contracts-spec": "2.10.0",
-    "@contractspec/lib.contracts-library": "2.9.1",
-    "@contractspec/lib.contracts-runtime-server-mcp": "2.9.1",
-    "@contractspec/lib.design-system": "2.9.1",
-    "@contractspec/lib.example-shared-ui": "2.9.1",
-    "@contractspec/lib.logger": "2.9.0",
-    "@contractspec/lib.runtime-sandbox": "1.9.0",
-    "@contractspec/lib.schema": "2.9.0",
-    "@contractspec/lib.ui-kit-web": "2.9.0",
-    "@contractspec/lib.ui-link": "2.9.0",
-    "@contractspec/module.examples": "2.9.1",
+    "@contractspec/lib.contracts-spec": "3.1.1",
+    "@contractspec/lib.contracts-library": "3.1.1",
+    "@contractspec/lib.contracts-runtime-server-mcp": "3.1.1",
+    "@contractspec/lib.design-system": "3.1.1",
+    "@contractspec/lib.example-shared-ui": "3.1.1",
+    "@contractspec/lib.knowledge": "3.1.1",
+    "@contractspec/lib.logger": "3.1.0",
+    "@contractspec/lib.runtime-sandbox": "2.1.0",
+    "@contractspec/lib.schema": "3.1.0",
+    "@contractspec/lib.ui-kit-web": "3.1.0",
+    "@contractspec/lib.ui-link": "3.1.0",
+    "@contractspec/module.context-storage": "0.1.2",
+    "@contractspec/module.examples": "3.1.1",
     "@dnd-kit/core": "^6.1.0",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@electric-sql/pglite": "^0.3.14",
-    "@scaleway/sdk": "^3.2.1",
-    "@scaleway/sdk-client": "^2.1.0",
+    "@scaleway/sdk": "^3.3.1",
+    "@scaleway/sdk-client": "^2.2.1",
     "drizzle-orm": "^0.45.1",
-    "framer-motion": "^12.34.3",
-    "lucide-react": "^0.575.0",
-    "posthog-js": "^1.353.0",
-    "posthog-node": "^5.25.0",
-    "posthog-react-native": "^4.34.0",
+    "framer-motion": "^12.35.0",
+    "lucide-react": "^0.577.0",
+    "posthog-js": "^1.359.1",
+    "posthog-node": "^5.28.0",
+    "posthog-react-native": "^4.37.1",
     "react-hook-form": "^7.71.2",
     "zod": "^4.3.5",
-    "@contractspec/lib.contracts-integrations": "2.10.0",
-    "@contractspec/lib.contracts-runtime-server-rest": "2.9.1",
-    "@contractspec/lib.contracts-runtime-server-graphql": "2.9.1"
+    "@contractspec/lib.contracts-integrations": "3.1.1",
+    "@contractspec/lib.contracts-runtime-server-rest": "3.1.1",
+    "@contractspec/lib.contracts-runtime-server-graphql": "3.1.1"
   },
   "devDependencies": {
     "@types/react": "~19.2.14",
-    "@contractspec/tool.typescript": "2.9.0",
+    "@contractspec/tool.typescript": "3.1.0",
     "typescript": "^5.9.3",
-    "@types/bun": "~1.3.9",
-    "@contractspec/tool.bun": "2.9.0"
+    "@types/bun": "~1.3.10",
+    "@contractspec/tool.bun": "3.1.0"
   },
   "publishConfig": {
     "access": "public",
@@ -2105,6 +2191,18 @@
         "node": "./dist/node/application/index.js",
         "default": "./dist/application/index.js"
       },
+      "./application/context-storage": {
+        "types": "./dist/application/context-storage/index.d.ts",
+        "bun": "./dist/application/context-storage/index.js",
+        "node": "./dist/node/application/context-storage/index.js",
+        "default": "./dist/application/context-storage/index.js"
+      },
+      "./application/context-storage/index": {
+        "types": "./dist/application/context-storage/index.d.ts",
+        "bun": "./dist/application/context-storage/index.js",
+        "node": "./dist/node/application/context-storage/index.js",
+        "default": "./dist/application/context-storage/index.js"
+      },
       "./application/index": {
         "types": "./dist/application/index.d.ts",
         "bun": "./dist/application/index.js",
@@ -2129,6 +2227,30 @@
         "node": "./dist/node/application/mcp/common.js",
         "default": "./dist/application/mcp/common.js"
       },
+      "./application/mcp/contractsMcp": {
+        "types": "./dist/application/mcp/contractsMcp.d.ts",
+        "bun": "./dist/application/mcp/contractsMcp.js",
+        "node": "./dist/node/application/mcp/contractsMcp.js",
+        "default": "./dist/application/mcp/contractsMcp.js"
+      },
+      "./application/mcp/contractsMcpResources": {
+        "types": "./dist/application/mcp/contractsMcpResources.d.ts",
+        "bun": "./dist/application/mcp/contractsMcpResources.js",
+        "node": "./dist/node/application/mcp/contractsMcpResources.js",
+        "default": "./dist/application/mcp/contractsMcpResources.js"
+      },
+      "./application/mcp/contractsMcpTools": {
+        "types": "./dist/application/mcp/contractsMcpTools.d.ts",
+        "bun": "./dist/application/mcp/contractsMcpTools.js",
+        "node": "./dist/node/application/mcp/contractsMcpTools.js",
+        "default": "./dist/application/mcp/contractsMcpTools.js"
+      },
+      "./application/mcp/contractsMcpTypes": {
+        "types": "./dist/application/mcp/contractsMcpTypes.d.ts",
+        "bun": "./dist/application/mcp/contractsMcpTypes.js",
+        "node": "./dist/node/application/mcp/contractsMcpTypes.js",
+        "default": "./dist/application/mcp/contractsMcpTypes.js"
+      },
       "./application/mcp/docsMcp": {
         "types": "./dist/application/mcp/docsMcp.d.ts",
         "bun": "./dist/application/mcp/docsMcp.js",
@@ -2147,6 +2269,12 @@
         "node": "./dist/node/application/mcp/internalMcp.js",
         "default": "./dist/application/mcp/internalMcp.js"
       },
+      "./application/mcp/providerRankingMcp": {
+        "types": "./dist/application/mcp/providerRankingMcp.d.ts",
+        "bun": "./dist/application/mcp/providerRankingMcp.js",
+        "node": "./dist/node/application/mcp/providerRankingMcp.js",
+        "default": "./dist/application/mcp/providerRankingMcp.js"
+      },
       "./components/docs": {
         "types": "./dist/components/docs/index.d.ts",
         "bun": "./dist/components/docs/index.js",
@@ -2213,6 +2341,12 @@
         "node": "./dist/node/components/docs/architecture/ArchitectureAppConfigPage.js",
         "default": "./dist/components/docs/architecture/ArchitectureAppConfigPage.js"
       },
+      "./components/docs/architecture/ArchitectureControlPlanePage": {
+        "types": "./dist/components/docs/architecture/ArchitectureControlPlanePage.d.ts",
+        "bun": "./dist/components/docs/architecture/ArchitectureControlPlanePage.js",
+        "node": "./dist/node/components/docs/architecture/ArchitectureControlPlanePage.js",
+        "default": "./dist/components/docs/architecture/ArchitectureControlPlanePage.js"
+      },
       "./components/docs/architecture/ArchitectureIntegrationBindingPage": {
         "types": "./dist/components/docs/architecture/ArchitectureIntegrationBindingPage.d.ts",
         "bun": "./dist/components/docs/architecture/ArchitectureIntegrationBindingPage.js",
@@ -2549,6 +2683,12 @@
         "node": "./dist/node/components/docs/integrations/IntegrationsElevenLabsPage.js",
         "default": "./dist/components/docs/integrations/IntegrationsElevenLabsPage.js"
       },
+      "./components/docs/integrations/IntegrationsGithubPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsGithubPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsGithubPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsGithubPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsGithubPage.js"
+      },
       "./components/docs/integrations/IntegrationsGmailPage": {
         "types": "./dist/components/docs/integrations/IntegrationsGmailPage.d.ts",
         "bun": "./dist/components/docs/integrations/IntegrationsGmailPage.js",
@@ -2561,6 +2701,18 @@
         "node": "./dist/node/components/docs/integrations/IntegrationsGoogleCalendarPage.js",
         "default": "./dist/components/docs/integrations/IntegrationsGoogleCalendarPage.js"
       },
+      "./components/docs/integrations/IntegrationsHealthRoutingPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsHealthRoutingPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.js"
+      },
+      "./components/docs/integrations/IntegrationsMistralPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsMistralPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsMistralPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsMistralPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsMistralPage.js"
+      },
       "./components/docs/integrations/IntegrationsOpenAIPage": {
         "types": "./dist/components/docs/integrations/IntegrationsOpenAIPage.d.ts",
         "bun": "./dist/components/docs/integrations/IntegrationsOpenAIPage.js",
@@ -2603,6 +2755,12 @@
         "node": "./dist/node/components/docs/integrations/IntegrationsS3Page.js",
         "default": "./dist/components/docs/integrations/IntegrationsS3Page.js"
       },
+      "./components/docs/integrations/IntegrationsSlackPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsSlackPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsSlackPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsSlackPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsSlackPage.js"
+      },
       "./components/docs/integrations/IntegrationsSpecModelPage": {
         "types": "./dist/components/docs/integrations/IntegrationsSpecModelPage.d.ts",
         "bun": "./dist/components/docs/integrations/IntegrationsSpecModelPage.js",
@@ -2621,6 +2779,18 @@
         "node": "./dist/node/components/docs/integrations/IntegrationsTwilioPage.js",
         "default": "./dist/components/docs/integrations/IntegrationsTwilioPage.js"
       },
+      "./components/docs/integrations/IntegrationsWhatsappMetaPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsWhatsappMetaPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js"
+      },
+      "./components/docs/integrations/IntegrationsWhatsappTwilioPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsWhatsappTwilioPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js"
+      },
       "./components/docs/intent": {
         "types": "./dist/components/docs/intent/index.d.ts",
         "bun": "./dist/components/docs/intent/index.js",

package/src/application/context-storage/index.ts

@@ -0,0 +1,58 @@
+import type {
+  DatabaseProvider,
+  EmbeddingProvider,
+  VectorStoreProvider,
+} from '@contractspec/lib.contracts-integrations';
+import {
+  DocumentProcessor,
+  EmbeddingService,
+  VectorIndexer,
+  type VectorIndexConfig,
+} from '@contractspec/lib.knowledge/ingestion';
+import {
+  ContextSnapshotPipeline,
+  PostgresContextStorage,
+} from '@contractspec/module.context-storage';
+
+export interface ContextStorageServiceOptions {
+  database: DatabaseProvider;
+  schema?: string;
+  createTablesIfMissing?: boolean;
+  documentProcessor?: DocumentProcessor;
+  embeddingProvider?: EmbeddingProvider;
+  embeddingBatchSize?: number;
+  vectorStoreProvider?: VectorStoreProvider;
+  vectorIndex?: VectorIndexConfig;
+}
+
+export interface ContextStorageService {
+  store: PostgresContextStorage;
+  pipeline: ContextSnapshotPipeline;
+}
+
+export function createContextStorageService(
+  options: ContextStorageServiceOptions
+): ContextStorageService {
+  const store = new PostgresContextStorage({
+    database: options.database,
+    schema: options.schema,
+    createTablesIfMissing: options.createTablesIfMissing,
+  });
+  const embeddingService = options.embeddingProvider
+    ? new EmbeddingService(
+        options.embeddingProvider,
+        options.embeddingBatchSize
+      )
+    : undefined;
+  const vectorIndexer =
+    options.vectorStoreProvider && options.vectorIndex
+      ? new VectorIndexer(options.vectorStoreProvider, options.vectorIndex)
+      : undefined;
+  const pipeline = new ContextSnapshotPipeline({
+    store,
+    documentProcessor: options.documentProcessor,
+    embeddingService,
+    vectorIndexer,
+  });
+  return { store, pipeline };
+}

package/src/application/index.ts

@@ -1 +1,2 @@
 export * from './mcp';
+export * from './context-storage';

package/src/application/mcp/common.ts

@@ -11,6 +11,13 @@ import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/
 import { Elysia } from 'elysia';
 import { Logger } from '@contractspec/lib.logger';
 import { randomUUID } from 'node:crypto';
+import type { IntegrationAuthType } from '@contractspec/lib.contracts-integrations/integrations';
+
+export interface McpAuthValidationResult {
+  valid: boolean;
+  actor?: string;
+  reason?: string;
+}
 
 interface McpHttpHandlerConfig {
   path: string;
@@ -20,6 +27,10 @@ interface McpHttpHandlerConfig {
   prompts: PromptRegistry;
   presentations?: PresentationSpec[];
   logger: Logger;
+  /** Callback to validate auth credentials from the incoming request. */
+  validateAuth?: (request: Request) => Promise<McpAuthValidationResult>;
+  /** Auth methods this MCP handler requires callers to present. */
+  requiredAuthMethods?: IntegrationAuthType[];
 }
 
 const baseCtx = {
@@ -116,8 +127,12 @@ export function createMcpElysiaHandler({
   resources,
   prompts,
   presentations,
+  validateAuth,
+  requiredAuthMethods,
 }: McpHttpHandlerConfig) {
-  logger.info('Setting up MCP handler...');
+  logger.info('Setting up MCP handler...', {
+    requiredAuthMethods: requiredAuthMethods ?? [],
+  });
 
   const isStateful = process.env.CONTRACTSPEC_MCP_STATEFUL === '1';
   const sessions = new Map<string, McpSessionState>();
@@ -200,6 +215,18 @@ export function createMcpElysiaHandler({
     path,
     async ({ request }) => {
       try {
+        if (validateAuth) {
+          const authResult = await validateAuth(request);
+          if (!authResult.valid) {
+            return createJsonRpcErrorResponse(
+              401,
+              -32002,
+              'Authentication failed',
+              authResult.reason
+            );
+          }
+        }
+
         if (isStateful) {
           return await handleStateful(request);
         }

package/src/application/mcp/contractsMcp.ts

@@ -0,0 +1,34 @@
+/**
+ * Contracts MCP server.
+ *
+ * Exposes contract management operations (list, get, create, update,
+ * delete, validate, build) as MCP tools, resources, and prompts.
+ *
+ * Services are injected at creation time so this bundle stays
+ * decoupled from bundle.workspace — the app layer provides real impls.
+ */
+
+import { createMcpElysiaHandler } from './common';
+import { appLogger } from '../../infrastructure/elysia/logger';
+import { buildContractsOps } from './contractsMcpTools';
+import {
+  buildContractsResources,
+  buildContractsPrompts,
+} from './contractsMcpResources';
+import type { ContractsMcpServices } from './contractsMcpTypes';
+
+export type { ContractsMcpServices, ContractInfo } from './contractsMcpTypes';
+
+export function createContractsMcpHandler(
+  path = '/api/mcp/contracts',
+  services: ContractsMcpServices
+) {
+  return createMcpElysiaHandler({
+    logger: appLogger,
+    path,
+    serverName: 'contractspec-contracts-mcp',
+    ops: buildContractsOps(services),
+    resources: buildContractsResources(services),
+    prompts: buildContractsPrompts(),
+  });
+}

package/src/application/mcp/contractsMcpResources.ts

@@ -0,0 +1,142 @@
+/**
+ * Contract management MCP resource and prompt definitions.
+ */
+
+import {
+  definePrompt,
+  defineResourceTemplate,
+  PromptRegistry,
+  ResourceRegistry,
+} from '@contractspec/lib.contracts-spec';
+import z from 'zod';
+import type { ContractsMcpServices } from './contractsMcpTypes';
+
+const OWNERS = ['@contractspec'];
+const TAGS = ['contracts', 'mcp'];
+
+export function buildContractsResources(services: ContractsMcpServices) {
+  const resources = new ResourceRegistry();
+
+  resources.register(
+    defineResourceTemplate({
+      meta: {
+        uriTemplate: 'contracts://list',
+        title: 'Contract specs list',
+        description: 'JSON list of all contract specs in the workspace.',
+        mimeType: 'application/json',
+        tags: TAGS,
+      },
+      input: z.object({}),
+      resolve: async () => {
+        const specs = await services.listSpecs();
+        return {
+          uri: 'contracts://list',
+          mimeType: 'application/json',
+          data: JSON.stringify(specs, null, 2),
+        };
+      },
+    })
+  );
+
+  resources.register(
+    defineResourceTemplate({
+      meta: {
+        uriTemplate: 'contracts://spec/{path}',
+        title: 'Contract spec content',
+        description: 'Read a single contract spec file by path.',
+        mimeType: 'text/plain',
+        tags: TAGS,
+      },
+      input: z.object({ path: z.string() }),
+      resolve: async ({ path }) => {
+        const result = await services.getSpec(path);
+        if (!result) {
+          return {
+            uri: `contracts://spec/${encodeURIComponent(path)}`,
+            mimeType: 'text/plain',
+            data: `Spec not found: ${path}`,
+          };
+        }
+        return {
+          uri: `contracts://spec/${encodeURIComponent(path)}`,
+          mimeType: 'text/plain',
+          data: result.content,
+        };
+      },
+    })
+  );
+
+  resources.register(
+    defineResourceTemplate({
+      meta: {
+        uriTemplate: 'contracts://registry/manifest',
+        title: 'Remote registry manifest',
+        description: 'Contract registry manifest from the remote server.',
+        mimeType: 'application/json',
+        tags: TAGS,
+      },
+      input: z.object({}),
+      resolve: async () => {
+        const manifest = await services.fetchRegistryManifest();
+        return {
+          uri: 'contracts://registry/manifest',
+          mimeType: 'application/json',
+          data: JSON.stringify(manifest, null, 2),
+        };
+      },
+    })
+  );
+
+  return resources;
+}
+
+export function buildContractsPrompts() {
+  const prompts = new PromptRegistry();
+
+  prompts.register(
+    definePrompt({
+      meta: {
+        key: 'contracts.editor',
+        version: '1.0.0',
+        title: 'Contract editing guide',
+        description:
+          'Guide AI agents through reading, editing, and validating contracts.',
+        tags: TAGS,
+        stability: 'beta',
+        owners: OWNERS,
+      },
+      args: [
+        {
+          name: 'goal',
+          description: 'What the agent wants to achieve with the contract.',
+          required: false,
+          schema: z.string().optional(),
+        },
+      ],
+      input: z.object({ goal: z.string().optional() }),
+      render: async ({ goal }) => [
+        {
+          type: 'text' as const,
+          text: [
+            'Contract editing workflow:',
+            '1. Use contracts.list to discover specs',
+            '2. Use contracts.get to read a spec',
+            '3. Edit content and call contracts.update',
+            '4. Run contracts.validate to verify changes',
+            '5. Run contracts.build to regenerate artifacts',
+            goal ? `Agent goal: ${goal}` : '',
+          ]
+            .filter(Boolean)
+            .join('\n'),
+        },
+        {
+          type: 'resource' as const,
+          uri: 'contracts://list',
+          title: 'Available contracts',
+        },
+      ],
+    })
+  );
+
+  return prompts;
+}