@contractspec/bundle.library 3.8.11 → 3.9.0

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # @contractspec/bundle.library
 
+## 3.9.0
+
+### Minor Changes
+
+- Add a family-aware ContractSpec Adoption Engine, expand contract authoring targets across CLI and VS Code tooling, and refresh release-facing schema and policy artifacts for downstream workspaces.
+  - Packages: @contractspec/lib.contracts-spec (minor), @contractspec/module.workspace (minor), @contractspec/bundle.workspace (minor), @contractspec/bundle.library (minor), @contractspec/app.cli-contractspec (minor), vscode-contractspec (minor), contractspec (patch), @contractspec/lib.knowledge (patch), @contractspec/biome-config (patch), @contractspec/app.cursor-marketplace (patch)
+  - Migration: ContractSpec workspaces can now opt into family-aware reuse guidance and local catalog sync through `connect.adoption`.; Shared workspace discovery and IDE/CLI create flows now recognize additional contract families beyond the original core set.
+- Add a CLI-first onboarding workflow that reuses Connect adoption guidance, models guided onboarding through the surface runtime, generates managed AGENTS/USAGE guides, and exposes the same onboarding tracks through the CLI MCP surface and docs entrypoints.
+  - Packages: @contractspec/app.cli-contractspec (minor), @contractspec/bundle.workspace (minor), @contractspec/bundle.library (minor)
+  - Migration: The CLI now provides a first-class onboarding command that should replace ad hoc “quickstart + create one spec” repo bootstraps.; `contractspec init` can now create or merge a managed `USAGE.md` section in addition to `AGENTS.md`.
+
+### Patch Changes
+
+- Refresh root, package, website, and LLM-facing docs so Connect, Builder, release capsules, and the current contracts-spec export surface stay aligned.
+  - Packages: contractspec (patch), @contractspec/lib.contracts-spec (patch), @contractspec/bundle.library (patch), @contractspec/app.web-landing (patch)
+- Unify example preview metadata so templates and docs derive inline preview support from shared example registry data instead of hand-maintained lists.
+  - Packages: @contractspec/module.examples (minor), @contractspec/bundle.marketing (patch), @contractspec/bundle.library (patch), @contractspec/app.web-landing (patch), @contractspec/example.agent-console (patch), @contractspec/example.ai-chat-assistant (patch), @contractspec/example.analytics-dashboard (patch), @contractspec/example.crm-pipeline (patch), @contractspec/example.integration-hub (patch), @contractspec/example.learning-journey-registry (patch), @contractspec/example.marketplace (patch), @contractspec/example.policy-safe-knowledge-assistant (patch), @contractspec/example.saas-boilerplate (patch), @contractspec/example.workflow-system (patch)
+  - Migration: Any published example that exports `./ui` should also advertise that UI surface in its `ExampleSpec` entrypoints so preview tooling can discover it.
+- Updated dependencies because of Add a family-aware ContractSpec Adoption Engine, expand contract authoring targets across CLI and VS Code tooling, and refresh release-facing schema and policy artifacts for downstream workspaces.
+- Updated dependencies because of chore: auto-bump internal dependents
+- Updated dependencies because of Fix Builder local onboarding so setup writes usable control-plane defaults and the CLI resolves Builder API settings from workspace config.
+- Updated dependencies because of Unify release authoring around guided capsules, canonical generated artifacts, and manifest-backed changelog surfaces.
+- Updated dependencies because of Add a CLI-first onboarding workflow that reuses Connect adoption guidance, models guided onboarding through the surface runtime, generates managed AGENTS/USAGE guides, and exposes the same onboarding tracks through the CLI MCP surface and docs entrypoints.
+- Updated dependencies because of Improve app-config, theme, and feature authoring with explicit validation APIs, first-class theme discovery and scaffolding, and key-based app-config generation across contracts, workspace tooling, and the CLI.
+- Updated dependencies because of Harden the shared data-table stack and add a first-class composed toolbar for search, filter chips, selection summary, and hidden-column recovery.
+- Updated dependencies because of Refresh root, package, website, and LLM-facing docs so Connect, Builder, release capsules, and the current contracts-spec export surface stay aligned.
+- Updated dependencies because of Persist canonical knowledge payload text during indexing and align the retrieval/query docs with the corrected behavior.
+- Updated dependencies because of Redesign the learning system around the adaptive journey runtime and repair shared learning sandbox presentation wiring.
+- Updated dependencies because of Unify example preview metadata so templates and docs derive inline preview support from shared example registry data instead of hand-maintained lists.
+  - @contractspec/lib.contracts-spec@5.4.0
+  - @contractspec/bundle.workspace@4.5.0
+  - @contractspec/lib.knowledge@3.7.20
+  - @contractspec/lib.content-gen@3.7.20
+  - @contractspec/lib.contracts-integrations@3.8.12
+  - @contractspec/lib.contracts-library@3.7.20
+  - @contractspec/lib.contracts-runtime-client-react@3.9.1
+  - @contractspec/lib.contracts-runtime-server-graphql@3.7.20
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.20
+  - @contractspec/lib.contracts-runtime-server-rest@3.7.20
+  - @contractspec/lib.example-shared-ui@6.0.20
+  - @contractspec/lib.surface-runtime@0.5.20
+  - @contractspec/module.context-storage@0.7.19
+  - @contractspec/lib.design-system@3.10.0
+  - @contractspec/lib.ui-kit-web@3.10.1
+  - @contractspec/module.examples@3.9.0
+
+## 3.8.12
+
+### Patch Changes
+
+- Updated dependencies because of Expand ContractSpec authoring with preset-driven workspace setup, shell completion, packaged workspace schema artifacts, and richer form and UI surfaces across the CLI, editors, and shared runtimes.
+  - @contractspec/lib.contracts-spec@5.3.0
+  - @contractspec/lib.contracts-runtime-client-react@3.9.0
+  - @contractspec/lib.design-system@3.9.0
+  - @contractspec/lib.ui-kit-web@3.10.0
+  - @contractspec/lib.content-gen@3.7.19
+  - @contractspec/lib.contracts-integrations@3.8.11
+  - @contractspec/lib.contracts-library@3.7.19
+  - @contractspec/lib.contracts-runtime-server-graphql@3.7.19
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.19
+  - @contractspec/lib.contracts-runtime-server-rest@3.7.19
+  - @contractspec/lib.example-shared-ui@6.0.19
+  - @contractspec/lib.knowledge@3.7.19
+  - @contractspec/lib.surface-runtime@0.5.19
+  - @contractspec/module.examples@3.8.11
+  - @contractspec/lib.ui-link@3.7.15
+  - @contractspec/module.context-storage@0.7.18
+
 ## 3.8.11
 
 ### Patch Changes

package/dist/application/index.js

@@ -1,17 +1,17 @@
 // @bun
-import{EmbeddingService as sj,VectorIndexer as rj}from"@contractspec/lib.knowledge/ingestion";import{ContextSnapshotPipeline as ej,PostgresContextStorage as jY}from"@contractspec/module.context-storage";function xJ(j){let Y=new jY({database:j.database,schema:j.schema,createTablesIfMissing:j.createTablesIfMissing}),J=j.embeddingProvider?new sj(j.embeddingProvider,j.embeddingBatchSize):void 0,Q=j.vectorStoreProvider&&j.vectorIndex?new rj(j.vectorStoreProvider,j.vectorIndex):void 0,$=new ej({store:Y,documentProcessor:j.documentProcessor,embeddingService:J,vectorIndexer:Q});return{store:Y,pipeline:$}}import{Logger as Wj,LogLevel as xj}from"@contractspec/lib.logger";function Pj(){return"production"}var YY=()=>new Wj({level:xj.INFO,environment:Pj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),M=YY(),LJ=new Wj({level:xj.WARN,environment:Pj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),GJ=new Wj({level:xj.INFO,environment:Pj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});var Ij=["application/json","text/event-stream"];function JY(j){return!j||j.includes("*/*")||j.includes("application/*")||Ij.some((Y)=>j.includes(Y))}function qj(j){if(j.method!=="POST")return j;let Y=j.headers.get("accept");if(!JY(Y))return j;let J=Ij.filter(($)=>!Y?.includes($));if(J.length===0)return j;let Q=new Headers(j.headers);return Q.set("accept",[Y,...J].filter(Boolean).join(", ")),new Request(j,{headers:Q})}import{createMcpServer as QY}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as ZY}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as $Y}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as XY}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as UY}from"crypto";import{Elysia as VY}from"elysia";var HY={actor:"anonymous",decide:async()=>({effect:"allow"})};function Lj(j,Y,J,Q){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:Y,message:J,...Q?{data:Q}:{}},id:null}),{status:j,headers:{"content-type":"application/json"}})}function Ej({logger:j,serverName:Y,ops:J,resources:Q,prompts:$,presentations:Z,stateful:X}){let U=new $Y({name:Y,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),QY(U,J,Q,$,{logger:j,toolCtx:()=>HY,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new ZY(Z)});let K=new XY({sessionIdGenerator:X?()=>UY():void 0,enableJsonResponse:!0});return U.connect(K).then(()=>({server:U,transport:K}))}async function t(j){await Promise.allSettled([j.transport.close(),j.server.close()])}function KY(j){return j instanceof Error?j.stack??j.message:String(j)}function b({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,validateAuth:U,requiredAuthMethods:K}){j.info("Setting up MCP handler...",{requiredAuthMethods:K??[]});let P=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",V=new Map;async function H(F){let W=await Ej({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,stateful:!1});try{return await W.transport.handleRequest(qj(F))}finally{await t(W)}}async function G(F){let W=V.get(F);if(!W)return;V.delete(F),await t(W)}async function Fj(F){let W=F.headers.get("mcp-session-id"),D,u=!1;if(W){let N=V.get(W);if(!N)return Lj(404,-32001,"Session not found");D=N}else D=await Ej({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,stateful:!0}),u=!0;try{let N=await D.transport.handleRequest(qj(F)),O=D.transport.sessionId;if(O&&!V.has(O))V.set(O,D);if(F.method==="DELETE"&&O)await G(O);else if(!O&&u)await t(D);return N}catch(N){if(u)await t(D);throw N}}return new VY({name:`mcp-${J}`}).all(Y,async({request:F})=>{try{if(U){let W=await U(F);if(!W.valid)return Lj(401,-32002,"Authentication failed",W.reason)}if(P)return await Fj(F);return await H(F)}catch(W){return j.error("Error handling MCP request",{path:Y,method:F.method,error:KY(W)}),Lj(500,-32000,"Internal error")}})}import BY from"fs/promises";import{defineCommand as wY,definePrompt as FY,defineResourceTemplate as zj,installOp as WY,OperationSpecRegistry as xY,PromptRegistry as PY,ResourceRegistry as qY}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as Oj,ScalarTypeEnum as d}from"@contractspec/lib.schema";import l from"path";import k from"zod";var __dirname="/home/runner/work/contractspec/contractspec/packages/bundles/library/src/application/mcp",LY={quickstart:"packages/apps/cli-contractspec/QUICK_START.md",reference:"packages/apps/cli-contractspec/QUICK_REFERENCE.md",readme:"packages/apps/cli-contractspec/README.md"},GY={quickstart:`# ContractSpec CLI quickstart
+import{EmbeddingService as LY,VectorIndexer as qY}from"@contractspec/lib.knowledge/ingestion";import{ContextSnapshotPipeline as _Y,PostgresContextStorage as MY}from"@contractspec/module.context-storage";function yJ(j){let Y=new MY({database:j.database,schema:j.schema,createTablesIfMissing:j.createTablesIfMissing}),J=j.embeddingProvider?new LY(j.embeddingProvider,j.embeddingBatchSize):void 0,Q=j.vectorStoreProvider&&j.vectorIndex?new qY(j.vectorStoreProvider,j.vectorIndex):void 0,$=new _Y({store:Y,documentProcessor:j.documentProcessor,embeddingService:J,vectorIndexer:Q});return{store:Y,pipeline:$}}import{Logger as Dj,LogLevel as Cj}from"@contractspec/lib.logger";function Aj(){return"production"}var bY=()=>new Dj({level:Cj.INFO,environment:Aj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),D=bY(),uJ=new Dj({level:Cj.WARN,environment:Aj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),dJ=new Dj({level:Cj.INFO,environment:Aj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});import{createNodeAdapters as GY,onboarding as Ej}from"@contractspec/bundle.workspace";import{defineCommand as Nj,definePrompt as DY,defineResourceTemplate as Ij,installOp as zj}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as o,ScalarTypeEnum as q}from"@contractspec/lib.schema";import C from"zod";var E=["cli","mcp","onboarding"],Zj=["@contractspec"];function CY(j){return j?.split(",").map((Y)=>Y.trim()).filter(Boolean)}async function $j(j={}){let Y=GY({cwd:process.cwd(),silent:!0});return Ej.buildOnboardingPlan(Y,{forcedExampleKey:j.example,selectedTracks:CY(j.tracks)})}function pj(j){j.register(Ij({meta:{uriTemplate:"onboarding://tracks",title:"Onboarding tracks",description:"Primary ContractSpec onboarding tracks exposed by the CLI.",mimeType:"application/json",tags:E},input:C.object({}),resolve:async()=>({uri:"onboarding://tracks",mimeType:"application/json",data:JSON.stringify(Ej.listOnboardingTracks(),null,2)})})),j.register(Ij({meta:{uriTemplate:"onboarding://track/{id}",title:"Onboarding track",description:"Track-specific onboarding metadata and recommended commands.",mimeType:"application/json",tags:E},input:C.object({id:C.string()}),resolve:async({id:Y})=>({uri:`onboarding://track/${Y}`,mimeType:"application/json",data:JSON.stringify(Ej.getOnboardingTrack(Y)??null,null,2)})})),j.register(Ij({meta:{uriTemplate:"onboarding://artifacts/{id}{?tracks,example}",title:"Rendered onboarding artifact",description:"Render AGENTS.md or USAGE.md content for the current repo.",mimeType:"text/markdown",tags:E},input:C.object({example:C.string().optional(),id:C.enum(["agent-guide","human-guide"]),tracks:C.string().optional()}),resolve:async({example:Y,id:J,tracks:Q})=>{let $=await $j({example:Y,tracks:Q});return{uri:`onboarding://artifacts/${J}`,mimeType:"text/markdown",data:J==="agent-guide"?$.guides.agentGuide:$.guides.humanGuide}}}))}function lj(j){j.register(DY({meta:{key:"cli.onboarding",version:"1.0.0",title:"Plan a ContractSpec onboarding flow",description:"Suggest the right onboarding track and artifacts for a repo.",tags:E,stability:"beta",owners:Zj},args:[{name:"goal",description:"Repository onboarding goal or focus area.",required:!1,schema:C.string().optional()}],input:C.object({goal:C.string().optional()}),render:async({goal:Y})=>[{type:"text",text:`Use onboarding://tracks and onboarding_suggestTracks-v1_0_0 before recommending repo-local ContractSpec adoption steps.${Y?` Goal: ${Y}.`:""}`},{type:"resource",uri:"onboarding://tracks",title:"Tracks"}]}))}function nj(j){let Y=o({name:"OnboardingSuggestTracksInput",fields:{example:{type:q.String_unsecure(),isOptional:!0},tracks:{type:q.String_unsecure(),isOptional:!0}}}),J=o({name:"OnboardingSuggestTracksOutput",fields:{nextCommands:{type:q.String_unsecure(),isArray:!0,isOptional:!1},primaryTrack:{type:q.String_unsecure(),isOptional:!1},reason:{type:q.String_unsecure(),isOptional:!1},tracks:{type:q.String_unsecure(),isArray:!0,isOptional:!1}}}),Q=o({name:"OnboardingRenderArtifactOutput",fields:{content:{type:q.String_unsecure(),isOptional:!1},primaryTrack:{type:q.String_unsecure(),isOptional:!1}}}),$=o({name:"OnboardingNextCommandOutput",fields:{nextCommand:{type:q.String_unsecure(),isOptional:!1},primaryTrack:{type:q.String_unsecure(),isOptional:!1}}});zj(j,Nj({meta:{key:"onboarding.suggestTracks",version:"1.0.0",stability:"stable",owners:Zj,tags:E,description:"Suggest the recommended ContractSpec onboarding tracks.",goal:"Help agents choose the right onboarding track before editing repo-local guides.",context:"Used inside the CLI MCP server."},io:{input:Y,output:J},policy:{auth:"anonymous"}}),async({example:Z,tracks:X})=>{let U=await $j({example:Z,tracks:X});return{nextCommands:U.nextCommands,primaryTrack:U.primaryTrack.id,reason:U.recommendations[0]?.reason??U.primaryTrack.summary,tracks:U.recommendations.map((V)=>V.track.id)}}),zj(j,Nj({meta:{key:"onboarding.renderArtifacts",version:"1.0.0",stability:"stable",owners:Zj,tags:E,description:"Render onboarding artifacts for the current repo.",goal:"Provide AGENTS.md or USAGE.md content without mutating the repo.",context:"Used inside the CLI MCP server."},io:{input:o({name:"OnboardingRenderArtifactInput",fields:{artifact:{type:q.String_unsecure(),isOptional:!1},example:{type:q.String_unsecure(),isOptional:!0},tracks:{type:q.String_unsecure(),isOptional:!0}}}),output:Q},policy:{auth:"anonymous"}}),async({artifact:Z,example:X,tracks:U})=>{let V=await $j({example:X,tracks:U});return{content:Z==="agent-guide"?V.guides.agentGuide:V.guides.humanGuide,primaryTrack:V.primaryTrack.id}}),zj(j,Nj({meta:{key:"onboarding.nextCommand",version:"1.0.0",stability:"stable",owners:Zj,tags:E,description:"Return the next recommended CLI command for onboarding.",goal:"Help agents choose the next onboarding command without mutating the repo.",context:"Used inside the CLI MCP server."},io:{input:Y,output:$},policy:{auth:"anonymous"}}),async({example:Z,tracks:X})=>{let U=await $j({example:Z,tracks:X});return{nextCommand:U.nextCommands[0]??"contractspec onboard",primaryTrack:U.primaryTrack.id}})}var cj=["application/json","text/event-stream"];function AY(j){return!j||j.includes("*/*")||j.includes("application/*")||cj.some((Y)=>j.includes(Y))}function kj(j){if(j.method!=="POST")return j;let Y=j.headers.get("accept");if(!AY(Y))return j;let J=cj.filter(($)=>!Y?.includes($));if(J.length===0)return j;let Q=new Headers(j.headers);return Q.set("accept",[Y,...J].filter(Boolean).join(", ")),new Request(j,{headers:Q})}import{createMcpServer as NY}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as IY}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as zY}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as EY}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as kY}from"crypto";import{Elysia as vY}from"elysia";var OY={actor:"anonymous",decide:async()=>({effect:"allow"})};function vj(j,Y,J,Q){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:Y,message:J,...Q?{data:Q}:{}},id:null}),{status:j,headers:{"content-type":"application/json"}})}function ij({logger:j,serverName:Y,ops:J,resources:Q,prompts:$,presentations:Z,stateful:X}){let U=new zY({name:Y,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),NY(U,J,Q,$,{logger:j,toolCtx:()=>OY,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new IY(Z)});let V=new EY({sessionIdGenerator:X?()=>kY():void 0,enableJsonResponse:!0});return U.connect(V).then(()=>({server:U,transport:V}))}async function Xj(j){await Promise.allSettled([j.transport.close(),j.server.close()])}function RY(j){return j instanceof Error?j.stack??j.message:String(j)}function A({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,validateAuth:U,requiredAuthMethods:V}){j.info("Setting up MCP handler...",{requiredAuthMethods:V??[]});let B=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",H=new Map;async function K(W){let x=await ij({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,stateful:!1});try{return await x.transport.handleRequest(kj(W))}finally{await Xj(x)}}async function P(W){let x=H.get(W);if(!x)return;H.delete(W),await Xj(x)}async function Gj(W){let x=W.headers.get("mcp-session-id"),I,i=!1;if(x){let z=H.get(x);if(!z)return vj(404,-32001,"Session not found");I=z}else I=await ij({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,stateful:!0}),i=!0;try{let z=await I.transport.handleRequest(kj(W)),h=I.transport.sessionId;if(h&&!H.has(h))H.set(h,I);if(W.method==="DELETE"&&h)await P(h);else if(!h&&i)await Xj(I);return z}catch(z){if(i)await Xj(I);throw z}}return new vY({name:`mcp-${J}`}).all(Y,async({request:W})=>{try{if(U){let x=await U(W);if(!x.valid)return vj(401,-32002,"Authentication failed",x.reason)}if(B)return await Gj(W);return await K(W)}catch(x){return j.error("Error handling MCP request",{path:Y,method:W.method,error:RY(x)}),vj(500,-32000,"Internal error")}})}import hY from"fs/promises";import{defineCommand as TY,definePrompt as fY,defineResourceTemplate as oj,installOp as SY,OperationSpecRegistry as yY,PromptRegistry as mY,ResourceRegistry as gY}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as aj,ScalarTypeEnum as a}from"@contractspec/lib.schema";import t from"path";import T from"zod";var __dirname="/home/runner/work/contractspec/contractspec/packages/bundles/library/src/application/mcp",uY={quickstart:"packages/apps/cli-contractspec/QUICK_START.md",reference:"packages/apps/cli-contractspec/QUICK_REFERENCE.md",readme:"packages/apps/cli-contractspec/README.md"},dY={quickstart:`# ContractSpec CLI quickstart
 
-contractspec create
-contractspec build <spec>
-contractspec validate <spec>`,reference:`# ContractSpec CLI reference
+contractspec quickstart
+contractspec onboard
+contractspec validate`,reference:`# ContractSpec CLI reference
 
-Key commands: create, build, validate. See README for full options.`,readme:`# ContractSpec CLI
+Key commands: onboard, create, generate, validate. See README for full options.`,readme:`# ContractSpec CLI
 
-Stabilize AI-generated code across API, DB, UI, events. Use create/build/validate commands.`},r=["cli","mcp"],kj=["@contractspec"],_Y=(()=>{let j=new Set([process.cwd(),l.resolve(process.cwd(),".."),l.resolve(process.cwd(),"../.."),l.resolve(process.cwd(),"../../..")]);if(typeof __dirname==="string")j.add(l.resolve(__dirname,"../../../../.."));return[...j]})(),s=new Map;async function MY(j){if(s.has(j))return s.get(j);let Y=LY[j];for(let Q of _Y){let $=l.resolve(Q,Y);try{let Z=await BY.readFile($,"utf8");return s.set(j,Z),Z}catch{}}let J=GY[j];return s.set(j,J),J}function bY(){let j=new qY;return j.register(zj({meta:{uriTemplate:"cli://doc/{slug}",title:"CLI documentation",description:"Quickstart, reference, and README for the CLI.",mimeType:"text/markdown",tags:r},input:k.object({slug:k.enum(["quickstart","reference","readme"])}),resolve:async({slug:Y})=>{let J=await MY(Y);return{uri:`cli://doc/${Y}`,mimeType:"text/markdown",data:J}}})),j.register(zj({meta:{uriTemplate:"cli://commands",title:"CLI commands summary",description:"Key ContractSpec CLI commands and when to use them.",mimeType:"application/json",tags:r},input:k.object({}),resolve:async()=>{return{uri:"cli://commands",mimeType:"application/json",data:JSON.stringify([{command:"contractspec create",summary:"Interactive wizard to author specs (with optional AI).",doc:"cli://doc/quickstart"},{command:"contractspec build <specPath>",summary:"Generate implementation code from a ContractSpec (agents + templates).",doc:"cli://doc/reference"},{command:"contractspec validate <specPath>",summary:"Validate specs and optionally check implementations against them.",doc:"cli://doc/reference"}],null,2)}}})),j}function DY(){let j=new PY;return j.register(FY({meta:{key:"cli.usage",version:"1.0.0",title:"Use ContractSpec CLI safely",description:"Remind agents to read CLI docs and pick commands from the canonical list.",tags:r,stability:"beta",owners:kj},args:[{name:"goal",description:"Task the user wants to achieve.",required:!1,schema:k.string().optional()}],input:k.object({goal:k.string().optional()}),render:async({goal:Y})=>[{type:"text",text:`Use CLI commands only from cli://commands. Prefer quickstart for newcomers and reference for options.${Y?` Goal: ${Y}.`:""}`},{type:"resource",uri:"cli://commands",title:"Commands"},{type:"resource",uri:"cli://doc/quickstart",title:"Quickstart"}]})),j}function NY(){let j=new xY,Y=Oj({name:"CliSuggestInput",fields:{goal:{type:d.String_unsecure(),isOptional:!1},prefersAi:{type:d.Boolean(),isOptional:!0}}}),J=Oj({name:"CliSuggestOutput",fields:{command:{type:d.String_unsecure(),isOptional:!1},docUri:{type:d.String_unsecure(),isOptional:!1},reason:{type:d.String_unsecure(),isOptional:!1}}}),Q=wY({meta:{key:"cli_suggestCommand",version:"1.0.0",stability:"stable",owners:kj,tags:r,description:"Recommend a CLI command for the requested goal.",goal:"Help AI agents choose the correct CLI entrypoint quickly.",context:"Used inside the CLI MCP server."},io:{input:Y,output:J},policy:{auth:"anonymous"}});return WY(j,Q,async({goal:$,prefersAi:Z})=>{let X=$.toLowerCase();if(X.includes("create")||X.includes("new"))return{command:Z?"contractspec create --ai":"contractspec create",docUri:"cli://doc/quickstart",reason:"Creates a new ContractSpec interactively (optionally with AI)."};if(X.includes("build")||X.includes("generate"))return{command:"contractspec build <path-to-spec>",docUri:"cli://doc/reference",reason:"Builds implementation code from a spec using agents + templates."};if(X.includes("validate")||X.includes("check"))return{command:"contractspec validate <path-to-spec>",docUri:"cli://doc/reference",reason:"Validates a spec and optionally checks its implementation for drift."};return{command:"contractspec --help",docUri:"cli://doc/readme",reason:"Fallback when the goal is unclear; read README for options."}}),j}function SJ(j="/api/mcp/cli"){return b({logger:M,path:j,serverName:"contractspec-cli-mcp",ops:NY(),resources:bY(),prompts:DY()})}import{definePrompt as AY,defineResourceTemplate as Gj,PromptRegistry as CY,ResourceRegistry as IY}from"@contractspec/lib.contracts-spec";import A from"zod";var EY=["@contractspec"],e=["contracts","mcp"];function Rj(j){let Y=new IY;return Y.register(Gj({meta:{uriTemplate:"contracts://list",title:"Contract specs list",description:"JSON list of all contract specs in the workspace.",mimeType:"application/json",tags:e},input:A.object({}),resolve:async()=>{let J=await j.listSpecs();return{uri:"contracts://list",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),Y.register(Gj({meta:{uriTemplate:"contracts://spec/{path}",title:"Contract spec content",description:"Read a single contract spec file by path.",mimeType:"text/plain",tags:e},input:A.object({path:A.string()}),resolve:async({path:J})=>{let Q=await j.getSpec(J);if(!Q)return{uri:`contracts://spec/${encodeURIComponent(J)}`,mimeType:"text/plain",data:`Spec not found: ${J}`};return{uri:`contracts://spec/${encodeURIComponent(J)}`,mimeType:"text/plain",data:Q.content}}})),Y.register(Gj({meta:{uriTemplate:"contracts://registry/manifest",title:"Remote registry manifest",description:"Contract registry manifest from the remote server.",mimeType:"application/json",tags:e},input:A.object({}),resolve:async()=>{let J=await j.fetchRegistryManifest();return{uri:"contracts://registry/manifest",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),Y}function vj(){let j=new CY;return j.register(AY({meta:{key:"contracts.editor",version:"1.0.0",title:"Contract editing guide",description:"Guide AI agents through reading, editing, and validating contracts.",tags:e,stability:"beta",owners:EY},args:[{name:"goal",description:"What the agent wants to achieve with the contract.",required:!1,schema:A.string().optional()}],input:A.object({goal:A.string().optional()}),render:async({goal:Y})=>[{type:"text",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",Y?`Agent goal: ${Y}`:""].filter(Boolean).join(`
-`)},{type:"resource",uri:"contracts://list",title:"Available contracts"}]})),j}import{defineCommand as R,installOp as v,OperationSpecRegistry as zY}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as _,ScalarTypeEnum as B}from"@contractspec/lib.schema";var T=["@contractspec"],f=["contracts","mcp"];function Tj(j){let Y=new zY,J=_({name:"ContractsListInput",fields:{pattern:{type:B.String_unsecure(),isOptional:!0},type:{type:B.String_unsecure(),isOptional:!0}}}),Q=_({name:"ContractsListOutput",fields:{specs:{type:B.JSON(),isOptional:!1},total:{type:B.Int_unsecure(),isOptional:!1}}});v(Y,R({meta:{key:"contracts.list",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"List contract specs in the workspace.",goal:"Discover available contracts by type, pattern, or owner.",context:"Contracts MCP server."},io:{input:J,output:Q},policy:{auth:"anonymous"}}),async({pattern:V,type:H})=>{let G=await j.listSpecs({pattern:V,type:H});return{specs:G,total:G.length}});let $=_({name:"ContractsGetInput",fields:{path:{type:B.String_unsecure(),isOptional:!1}}}),Z=_({name:"ContractsGetOutput",fields:{content:{type:B.String_unsecure(),isOptional:!1},info:{type:B.JSON(),isOptional:!1}}});v(Y,R({meta:{key:"contracts.get",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Read a single contract spec file.",goal:"Fetch spec content and parsed metadata.",context:"Contracts MCP server."},io:{input:$,output:Z},policy:{auth:"anonymous"}}),async({path:V})=>{let H=await j.getSpec(V);if(!H)throw Error(`Spec not found: ${V}`);return H});let X=_({name:"ContractsValidateInput",fields:{path:{type:B.String_unsecure(),isOptional:!1}}}),U=_({name:"ContractsValidateOutput",fields:{valid:{type:B.Boolean(),isOptional:!1},errors:{type:B.JSON(),isOptional:!1},warnings:{type:B.JSON(),isOptional:!1}}});v(Y,R({meta:{key:"contracts.validate",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Validate a contract spec structure.",goal:"Check spec for structural or policy issues.",context:"Contracts MCP server."},io:{input:X,output:U},policy:{auth:"anonymous"}}),async({path:V})=>j.validateSpec(V));let K=_({name:"ContractsBuildInput",fields:{path:{type:B.String_unsecure(),isOptional:!1},dryRun:{type:B.Boolean(),isOptional:!0}}}),P=_({name:"ContractsBuildOutput",fields:{results:{type:B.JSON(),isOptional:!1}}});return v(Y,R({meta:{key:"contracts.build",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Generate implementation code from a contract spec.",goal:"Produce handler, component, or test skeletons.",context:"Contracts MCP server."},io:{input:K,output:P},policy:{auth:"user"}}),async({path:V,dryRun:H})=>j.buildSpec(V,{dryRun:H})),OY(Y,j),Y}function OY(j,Y){let J=_({name:"ContractsUpdateInput",fields:{path:{type:B.String_unsecure(),isOptional:!1},content:{type:B.String_unsecure(),isOptional:!0},fields:{type:B.JSON(),isOptional:!0}}}),Q=_({name:"ContractsUpdateOutput",fields:{updated:{type:B.Boolean(),isOptional:!1},errors:{type:B.JSON(),isOptional:!1},warnings:{type:B.JSON(),isOptional:!1}}});v(j,R({meta:{key:"contracts.update",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Update an existing contract spec.",goal:"Modify spec content or individual fields with validation.",context:"Contracts MCP server."},io:{input:J,output:Q},policy:{auth:"user"}}),async({path:X,content:U,fields:K})=>Y.updateSpec(X,{content:U,fields:Array.isArray(K)?K:void 0}));let $=_({name:"ContractsDeleteInput",fields:{path:{type:B.String_unsecure(),isOptional:!1},clean:{type:B.Boolean(),isOptional:!0}}}),Z=_({name:"ContractsDeleteOutput",fields:{deleted:{type:B.Boolean(),isOptional:!1},cleanedFiles:{type:B.JSON(),isOptional:!1},errors:{type:B.JSON(),isOptional:!1}}});v(j,R({meta:{key:"contracts.delete",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Delete a contract spec and optionally its artifacts.",goal:"Remove a spec file and clean generated handlers/tests.",context:"Contracts MCP server."},io:{input:$,output:Z},policy:{auth:"user"}}),async({path:X,clean:U})=>Y.deleteSpec(X,{clean:U}))}function oJ(j="/api/mcp/contracts",Y){return b({logger:M,path:j,serverName:"contractspec-contracts-mcp",ops:Tj(Y),resources:Rj(Y),prompts:vj()})}import{defaultDocRegistry as kY}from"@contractspec/lib.contracts-spec/docs";var RY=20,vY=100;function q(j){return j?.trim().toLowerCase()??""}function fj(j){let Y=decodeURIComponent(j).trim();if(!Y)return"/";return Y.startsWith("/")?Y:`/${Y}`}function TY(j){return(Array.isArray(j)?j:j?[j]:[]).map((J)=>q(J)).filter(Boolean)}function fY(j){if(!j||Number.isNaN(j))return RY;return Math.min(Math.max(j,1),vY)}function hY(j){if(!j||Number.isNaN(j))return 0;return Math.max(j,0)}function _j({block:j,route:Y}){return{id:j.id,title:j.title,summary:j.summary??"",route:Y,visibility:j.visibility??"public",kind:j.kind??"reference",version:j.version??"1.0.0",tags:j.tags??[]}}function SY(j,Y){if(!Y)return 1;let J=Y.split(/\s+/).filter(Boolean),Q=q(j.block.title),$=q(j.block.id),Z=q(j.block.summary),X=q(j.block.body),U=q(j.route),K=(j.block.tags??[]).map((H)=>q(H)),P=[Q,$,Z,X,U,...K].join(" ");if(J.some((H)=>!P.includes(H)))return 0;let V=0;for(let H of J){if($.includes(H))V+=8;if(Q.includes(H))V+=7;if(K.some((G)=>G.includes(H)))V+=5;if(Z.includes(H))V+=4;if(U.includes(H))V+=3;if(X.includes(H))V+=2}return V}function h(j,Y){let J=q(typeof Y.query==="string"?Y.query:void 0),Q=TY(Y.tag),$=q(typeof Y.visibility==="string"?Y.visibility:void 0),Z=q(typeof Y.kind==="string"?Y.kind:void 0),X=fY(typeof Y.limit==="number"?Y.limit:void 0),U=hY(typeof Y.offset==="number"?Y.offset:void 0),K=j.map((H)=>({doc:_j(H),score:SY(H,J)})).filter(({doc:H,score:G})=>{let Fj=J?G>0:!0,F=Q.length?Q.every((u)=>H.tags.some((N)=>q(N).includes(u))):!0,W=$?q(H.visibility)===$:!0,D=Z?q(H.kind)===Z:!0;return Fj&&F&&W&&D}).sort((H,G)=>{if(G.score!==H.score)return G.score-H.score;return H.doc.title.localeCompare(G.doc.title)}),P=K.slice(U,U+X).map(({doc:H})=>H),V=U+P.length<K.length?U+P.length:void 0;return{docs:P,items:P,total:K.length,...V!=null?{nextOffset:V}:{}}}function jj(j){let Y=decodeURIComponent(j),J=kY.get(Y);if(!J)return;return{doc:_j(J),content:String(J.block.body??"")}}function Yj(j,Y){let J=fj(Y),Q=j.find(($)=>fj($.route)===J);if(!Q)return;return{doc:_j(Q),content:String(Q.block.body??"")}}function Jj(j){let Y=new Map,J=new Map,Q=new Map;for(let Z of j){let X=Z.block.kind??"reference",U=Z.block.visibility??"public";J.set(X,(J.get(X)??0)+1),Q.set(U,(Q.get(U)??0)+1);for(let K of Z.block.tags??[])Y.set(K,(Y.get(K)??0)+1)}let $=(Z,X)=>[...Z.entries()].sort((U,K)=>K[1]-U[1]||U[0].localeCompare(K[0])).map(([U,K])=>({[X]:U,count:K}));return{totalDocs:j.length,tags:$(Y,"tag"),kinds:$(J,"kind"),visibilities:$(Q,"visibility")}}import{EventRegistry as yY,OperationSpecRegistry as mY}from"@contractspec/lib.contracts-spec";import{DataViewRegistry as gY}from"@contractspec/lib.contracts-spec/data-views";import{ContractReferenceDataView as uY,ContractReferenceQuery as dY,DocsGenerateCommand as lY,DocsGeneratedEvent as pY,DocsIndexDataView as nY,DocsIndexQuery as cY,DocsLayoutPresentation as iY,DocsPublishCommand as aY,DocsPublishedEvent as oY,DocsReferencePagePresentation as tY,DocsSearchForm as sY,ExampleCatalogDataView as rY}from"@contractspec/lib.contracts-spec/docs";import{FormRegistry as eY}from"@contractspec/lib.contracts-spec/forms";import{PresentationRegistry as j0}from"@contractspec/lib.contracts-spec/presentations";import{serializeDataViewSpec as Y0,serializeEventSpec as J0,serializeFormSpec as Q0,serializeOperationSpec as Z0,serializePresentationSpec as $0}from"@contractspec/lib.contracts-spec/serialization";var Qj=null;function X0(){let j=new mY;return j.register(cY).register(dY).register(lY).register(aY),j}function U0(){if(!Qj)Qj=X0();return Qj}function Mj(j,Y){return U0().get(j,Y)}var Zj=null;function V0(){let j=new yY;return j.register(pY).register(oY),j}function H0(){if(!Zj)Zj=V0();return Zj}function bj(j,Y){return H0().get(j,Y)}var $j=null;function K0(){let j=new j0;return j.register(iY).register(tY),j}function B0(){if(!$j)$j=K0();return $j}function Dj(j,Y){return B0().get(j,Y)}var Xj=null;function w0(){let j=new gY;return j.register(nY).register(uY).register(rY),j}function F0(){if(!Xj)Xj=w0();return Xj}function Nj(j,Y){return F0().get(j,Y)}var Uj=null;function W0(){let j=new eY;return j.register(sY),j}function x0(){if(!Uj)Uj=W0();return Uj}function Aj(j,Y){return x0().get(j)}function hj(j,Y){let J=Mj(j,Y);return Z0(J)??void 0}function Sj(j,Y){let J=bj(j,Y);return J0(J)??void 0}function yj(j,Y){let J=Dj(j,Y);return $0(J)??void 0}function mj(j,Y){let J=Nj(j,Y);return Y0(J)??void 0}function gj(j,Y){let J=Aj(j,Y);return Q0(J)??void 0}function P0(){Qj=null}function q0(){Zj=null}function L0(){$j=null}function G0(){Xj=null}function _0(){Uj=null}function $Q(){P0(),q0(),L0(),G0(),_0()}import{defaultDocRegistry as M0}from"@contractspec/lib.contracts-spec/docs";function b0(j){return j?.trim().toLowerCase()??""}function D0(j){for(let Y of j??[]){let J=M0.get(Y);if(J)return J.route}return}function uj(j,Y,J,Q){let $=j.meta.title??j.meta.key,Z=D0(j.meta.docId),X=j.meta.description;return{key:j.meta.key,version:j.meta.version,type:Y,title:$,description:X,markdown:[`# ${$}`,`- Key: ${j.meta.key}`,`- Type: ${Y}`,`- Version: ${j.meta.version}`,Z?`- Docs route: ${Z}`:"",X?`
+Stabilize AI-generated code across API, DB, UI, events. Use onboard/create/generate/validate commands.`},Vj=["cli","mcp"],tj=["@contractspec"],pY=(()=>{let j=new Set([process.cwd(),t.resolve(process.cwd(),".."),t.resolve(process.cwd(),"../.."),t.resolve(process.cwd(),"../../..")]);if(typeof __dirname==="string")j.add(t.resolve(__dirname,"../../../../.."));return[...j]})(),Uj=new Map;async function lY(j){if(Uj.has(j))return Uj.get(j);let Y=uY[j];for(let Q of pY){let $=t.resolve(Q,Y);try{let Z=await hY.readFile($,"utf8");return Uj.set(j,Z),Z}catch{}}let J=dY[j];return Uj.set(j,J),J}function nY(){let j=new gY;return j.register(oj({meta:{uriTemplate:"cli://doc/{slug}",title:"CLI documentation",description:"Quickstart, reference, and README for the CLI.",mimeType:"text/markdown",tags:Vj},input:T.object({slug:T.enum(["quickstart","reference","readme"])}),resolve:async({slug:Y})=>{let J=await lY(Y);return{uri:`cli://doc/${Y}`,mimeType:"text/markdown",data:J}}})),j.register(oj({meta:{uriTemplate:"cli://commands",title:"CLI commands summary",description:"Key ContractSpec CLI commands and when to use them.",mimeType:"application/json",tags:Vj},input:T.object({}),resolve:async()=>{return{uri:"cli://commands",mimeType:"application/json",data:JSON.stringify([{command:"contractspec onboard",summary:"Generate repo-local AGENTS.md and USAGE.md guidance plus recommended tracks.",doc:"cli://doc/quickstart"},{command:"contractspec create",summary:"Interactive wizard to author specs (with optional AI).",doc:"cli://doc/quickstart"},{command:"contractspec build <specPath>",summary:"Generate implementation code from a ContractSpec (agents + templates).",doc:"cli://doc/reference"},{command:"contractspec validate <specPath>",summary:"Validate specs and optionally check implementations against them.",doc:"cli://doc/reference"}],null,2)}}})),pj(j),j}function cY(){let j=new mY;return j.register(fY({meta:{key:"cli.usage",version:"1.0.0",title:"Use ContractSpec CLI safely",description:"Remind agents to read CLI docs and pick commands from the canonical list.",tags:Vj,stability:"beta",owners:tj},args:[{name:"goal",description:"Task the user wants to achieve.",required:!1,schema:T.string().optional()}],input:T.object({goal:T.string().optional()}),render:async({goal:Y})=>[{type:"text",text:`Use CLI commands only from cli://commands. Prefer quickstart for newcomers and reference for options.${Y?` Goal: ${Y}.`:""}`},{type:"resource",uri:"cli://commands",title:"Commands"},{type:"resource",uri:"cli://doc/quickstart",title:"Quickstart"}]})),lj(j),j}function iY(){let j=new yY,Y=aj({name:"CliSuggestInput",fields:{goal:{type:a.String_unsecure(),isOptional:!1},prefersAi:{type:a.Boolean(),isOptional:!0}}}),J=aj({name:"CliSuggestOutput",fields:{command:{type:a.String_unsecure(),isOptional:!1},docUri:{type:a.String_unsecure(),isOptional:!1},reason:{type:a.String_unsecure(),isOptional:!1}}}),Q=TY({meta:{key:"cli_suggestCommand",version:"1.0.0",stability:"stable",owners:tj,tags:Vj,description:"Recommend a CLI command for the requested goal.",goal:"Help AI agents choose the correct CLI entrypoint quickly.",context:"Used inside the CLI MCP server."},io:{input:Y,output:J},policy:{auth:"anonymous"}});return SY(j,Q,async({goal:$,prefersAi:Z})=>{let X=$.toLowerCase();if(X.includes("onboard")||X.includes("start")||X.includes("guide")||X.includes("install"))return{command:"contractspec onboard",docUri:"cli://doc/quickstart",reason:"Starts the CLI-first onboarding flow for the current repo."};if(X.includes("create")||X.includes("new"))return{command:Z?"contractspec create --ai":"contractspec create",docUri:"cli://doc/quickstart",reason:"Creates a new ContractSpec interactively (optionally with AI)."};if(X.includes("build")||X.includes("generate"))return{command:"contractspec build <path-to-spec>",docUri:"cli://doc/reference",reason:"Builds implementation code from a spec using agents + templates."};if(X.includes("validate")||X.includes("check"))return{command:"contractspec validate <path-to-spec>",docUri:"cli://doc/reference",reason:"Validates a spec and optionally checks its implementation for drift."};return{command:"contractspec --help",docUri:"cli://doc/readme",reason:"Fallback when the goal is unclear; read README for options."}}),nj(j),j}function FQ(j="/api/mcp/cli"){return A({logger:D,path:j,serverName:"contractspec-cli-mcp",ops:iY(),resources:nY(),prompts:cY()})}import{definePrompt as oY,defineResourceTemplate as s,PromptRegistry as aY,ResourceRegistry as tY}from"@contractspec/lib.contracts-spec";import N from"zod";var sY=["@contractspec"],f=["contracts","mcp"];function sj(j){let Y=new tY;return Y.register(s({meta:{uriTemplate:"contracts://list",title:"Contract specs list",description:"JSON list of all contract specs in the workspace.",mimeType:"application/json",tags:f},input:N.object({}),resolve:async()=>{let J=await j.listSpecs();return{uri:"contracts://list",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),Y.register(s({meta:{uriTemplate:"contracts://spec/{path}",title:"Contract spec content",description:"Read a single contract spec file by path.",mimeType:"text/plain",tags:f},input:N.object({path:N.string()}),resolve:async({path:J})=>{let Q=await j.getSpec(J);if(!Q)return{uri:`contracts://spec/${encodeURIComponent(J)}`,mimeType:"text/plain",data:`Spec not found: ${J}`};return{uri:`contracts://spec/${encodeURIComponent(J)}`,mimeType:"text/plain",data:Q.content}}})),Y.register(s({meta:{uriTemplate:"contracts://registry/manifest",title:"Remote registry manifest",description:"Contract registry manifest from the remote server.",mimeType:"application/json",tags:f},input:N.object({}),resolve:async()=>{let J=await j.fetchRegistryManifest();return{uri:"contracts://registry/manifest",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),Y.register(s({meta:{uriTemplate:"adoption://catalog",title:"ContractSpec adoption catalog",description:"Bundled ContractSpec adoption catalog used by Connect and MCP.",mimeType:"application/json",tags:f},input:N.object({}),resolve:async()=>{let J=await j.searchAdoptionCatalog({query:"contractspec"});return{uri:"adoption://catalog",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),Y.register(s({meta:{uriTemplate:"adoption://policy/{family}",title:"ContractSpec adoption policy",description:"Family-aware adoption recommendation and verdict policy.",mimeType:"application/json",tags:f},input:N.object({family:N.string()}),resolve:async({family:J})=>{let Q=await j.resolveAdoption({family:J,query:J});return{uri:`adoption://policy/${encodeURIComponent(J)}`,mimeType:"application/json",data:JSON.stringify(Q,null,2)}}})),Y}function rj(){let j=new aY;return j.register(oY({meta:{key:"contracts.editor",version:"1.0.0",title:"Contract editing guide",description:"Guide AI agents through reading, editing, and validating contracts.",tags:f,stability:"beta",owners:sY},args:[{name:"goal",description:"What the agent wants to achieve with the contract.",required:!1,schema:N.string().optional()}],input:N.object({goal:N.string().optional()}),render:async({goal:Y})=>[{type:"text",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","6. Use adoption.resolve to prefer existing workspace or ContractSpec surfaces before inventing new ones",Y?`Agent goal: ${Y}`:""].filter(Boolean).join(`
+`)},{type:"resource",uri:"contracts://list",title:"Available contracts"}]})),j}import{defineCommand as Oj,installOp as Rj}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as S,ScalarTypeEnum as b}from"@contractspec/lib.schema";var hj=["@contractspec"],Tj=["contracts","mcp","adoption"];function ej(j,Y){let J=S({name:"AdoptionCatalogSearchInput",fields:{query:{type:b.String_unsecure(),isOptional:!1},family:{type:b.String_unsecure(),isOptional:!0},platform:{type:b.String_unsecure(),isOptional:!0}}}),Q=S({name:"AdoptionCatalogSearchOutput",fields:{results:{type:b.JSON(),isOptional:!1}}});Rj(j,Oj({meta:{key:"adoption.catalog_search",version:"1.0.0",stability:"beta",owners:hj,tags:Tj,description:"Search the local ContractSpec adoption catalog.",goal:"Find relevant ContractSpec reuse candidates for a query.",context:"Contracts MCP server."},io:{input:J,output:Q},policy:{auth:"anonymous"}}),async({family:V,platform:B,query:H})=>({results:await Y.searchAdoptionCatalog({family:V,platform:B,query:H})}));let $=S({name:"AdoptionResolveInput",fields:{family:{type:b.String_unsecure(),isOptional:!1},query:{type:b.String_unsecure(),isOptional:!1},paths:{type:b.JSON(),isOptional:!0},platform:{type:b.String_unsecure(),isOptional:!0},runtime:{type:b.String_unsecure(),isOptional:!0}}}),Z=S({name:"AdoptionResolveOutput",fields:{resolution:{type:b.JSON(),isOptional:!1}}});Rj(j,Oj({meta:{key:"adoption.resolve",version:"1.0.0",stability:"beta",owners:hj,tags:Tj,description:"Resolve the best adoption candidate for one family.",goal:"Provide one ordered recommendation that matches Connect.",context:"Contracts MCP server."},io:{input:$,output:Z},policy:{auth:"anonymous"}}),async({family:V,paths:B,platform:H,query:K,runtime:P})=>({resolution:await Y.resolveAdoption({family:V,paths:Array.isArray(B)?B:void 0,platform:H,query:K,runtime:P})}));let X=S({name:"AdoptionSyncInput",fields:{}}),U=S({name:"AdoptionSyncOutput",fields:{catalogPath:{type:b.String_unsecure(),isOptional:!1},total:{type:b.Int_unsecure(),isOptional:!1}}});Rj(j,Oj({meta:{key:"adoption.sync",version:"1.0.0",stability:"beta",owners:hj,tags:Tj,description:"Mirror the bundled ContractSpec adoption catalog locally.",goal:"Refresh the local adoption catalog used by Connect and MCP.",context:"Contracts MCP server."},io:{input:X,output:U},policy:{auth:"user"}}),async()=>Y.syncAdoptionCatalog())}import{defineCommand as y,installOp as m,OperationSpecRegistry as rY}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as G,ScalarTypeEnum as w}from"@contractspec/lib.schema";var g=["@contractspec"],u=["contracts","mcp"];function jY(j){let Y=new rY,J=G({name:"ContractsListInput",fields:{pattern:{type:w.String_unsecure(),isOptional:!0},type:{type:w.String_unsecure(),isOptional:!0}}}),Q=G({name:"ContractsListOutput",fields:{specs:{type:w.JSON(),isOptional:!1},total:{type:w.Int_unsecure(),isOptional:!1}}});m(Y,y({meta:{key:"contracts.list",version:"1.0.0",stability:"beta",owners:g,tags:u,description:"List contract specs in the workspace.",goal:"Discover available contracts by type, pattern, or owner.",context:"Contracts MCP server."},io:{input:J,output:Q},policy:{auth:"anonymous"}}),async({pattern:H,type:K})=>{let P=await j.listSpecs({pattern:H,type:K});return{specs:P,total:P.length}});let $=G({name:"ContractsGetInput",fields:{path:{type:w.String_unsecure(),isOptional:!1}}}),Z=G({name:"ContractsGetOutput",fields:{content:{type:w.String_unsecure(),isOptional:!1},info:{type:w.JSON(),isOptional:!1}}});m(Y,y({meta:{key:"contracts.get",version:"1.0.0",stability:"beta",owners:g,tags:u,description:"Read a single contract spec file.",goal:"Fetch spec content and parsed metadata.",context:"Contracts MCP server."},io:{input:$,output:Z},policy:{auth:"anonymous"}}),async({path:H})=>{let K=await j.getSpec(H);if(!K)throw Error(`Spec not found: ${H}`);return K});let X=G({name:"ContractsValidateInput",fields:{path:{type:w.String_unsecure(),isOptional:!1}}}),U=G({name:"ContractsValidateOutput",fields:{valid:{type:w.Boolean(),isOptional:!1},errors:{type:w.JSON(),isOptional:!1},warnings:{type:w.JSON(),isOptional:!1}}});m(Y,y({meta:{key:"contracts.validate",version:"1.0.0",stability:"beta",owners:g,tags:u,description:"Validate a contract spec structure.",goal:"Check spec for structural or policy issues.",context:"Contracts MCP server."},io:{input:X,output:U},policy:{auth:"anonymous"}}),async({path:H})=>j.validateSpec(H));let V=G({name:"ContractsBuildInput",fields:{path:{type:w.String_unsecure(),isOptional:!1},dryRun:{type:w.Boolean(),isOptional:!0}}}),B=G({name:"ContractsBuildOutput",fields:{results:{type:w.JSON(),isOptional:!1}}});return m(Y,y({meta:{key:"contracts.build",version:"1.0.0",stability:"beta",owners:g,tags:u,description:"Generate implementation code from a contract spec.",goal:"Produce handler, component, or test skeletons.",context:"Contracts MCP server."},io:{input:V,output:B},policy:{auth:"user"}}),async({path:H,dryRun:K})=>j.buildSpec(H,{dryRun:K})),eY(Y,j),ej(Y,j),Y}function eY(j,Y){let J=G({name:"ContractsUpdateInput",fields:{path:{type:w.String_unsecure(),isOptional:!1},content:{type:w.String_unsecure(),isOptional:!0},fields:{type:w.JSON(),isOptional:!0}}}),Q=G({name:"ContractsUpdateOutput",fields:{updated:{type:w.Boolean(),isOptional:!1},errors:{type:w.JSON(),isOptional:!1},warnings:{type:w.JSON(),isOptional:!1}}});m(j,y({meta:{key:"contracts.update",version:"1.0.0",stability:"beta",owners:g,tags:u,description:"Update an existing contract spec.",goal:"Modify spec content or individual fields with validation.",context:"Contracts MCP server."},io:{input:J,output:Q},policy:{auth:"user"}}),async({path:X,content:U,fields:V})=>Y.updateSpec(X,{content:U,fields:Array.isArray(V)?V:void 0}));let $=G({name:"ContractsDeleteInput",fields:{path:{type:w.String_unsecure(),isOptional:!1},clean:{type:w.Boolean(),isOptional:!0}}}),Z=G({name:"ContractsDeleteOutput",fields:{deleted:{type:w.Boolean(),isOptional:!1},cleanedFiles:{type:w.JSON(),isOptional:!1},errors:{type:w.JSON(),isOptional:!1}}});m(j,y({meta:{key:"contracts.delete",version:"1.0.0",stability:"beta",owners:g,tags:u,description:"Delete a contract spec and optionally its artifacts.",goal:"Remove a spec file and clean generated handlers/tests.",context:"Contracts MCP server."},io:{input:$,output:Z},policy:{auth:"user"}}),async({path:X,clean:U})=>Y.deleteSpec(X,{clean:U}))}function zQ(j="/api/mcp/contracts",Y){return A({logger:D,path:j,serverName:"contractspec-contracts-mcp",ops:jY(Y),resources:sj(Y),prompts:rj()})}import{defaultDocRegistry as j0}from"@contractspec/lib.contracts-spec/docs";var Y0=20,J0=100;function _(j){return j?.trim().toLowerCase()??""}function YY(j){let Y=decodeURIComponent(j).trim();if(!Y)return"/";return Y.startsWith("/")?Y:`/${Y}`}function Q0(j){return(Array.isArray(j)?j:j?[j]:[]).map((J)=>_(J)).filter(Boolean)}function Z0(j){if(!j||Number.isNaN(j))return Y0;return Math.min(Math.max(j,1),J0)}function $0(j){if(!j||Number.isNaN(j))return 0;return Math.max(j,0)}function fj({block:j,route:Y}){return{id:j.id,title:j.title,summary:j.summary??"",route:Y,visibility:j.visibility??"public",kind:j.kind??"reference",version:j.version??"1.0.0",tags:j.tags??[]}}function X0(j,Y){if(!Y)return 1;let J=Y.split(/\s+/).filter(Boolean),Q=_(j.block.title),$=_(j.block.id),Z=_(j.block.summary),X=_(j.block.body),U=_(j.route),V=(j.block.tags??[]).map((K)=>_(K)),B=[Q,$,Z,X,U,...V].join(" ");if(J.some((K)=>!B.includes(K)))return 0;let H=0;for(let K of J){if($.includes(K))H+=8;if(Q.includes(K))H+=7;if(V.some((P)=>P.includes(K)))H+=5;if(Z.includes(K))H+=4;if(U.includes(K))H+=3;if(X.includes(K))H+=2}return H}function d(j,Y){let J=_(typeof Y.query==="string"?Y.query:void 0),Q=Q0(Y.tag),$=_(typeof Y.visibility==="string"?Y.visibility:void 0),Z=_(typeof Y.kind==="string"?Y.kind:void 0),X=Z0(typeof Y.limit==="number"?Y.limit:void 0),U=$0(typeof Y.offset==="number"?Y.offset:void 0),V=j.map((K)=>({doc:fj(K),score:X0(K,J)})).filter(({doc:K,score:P})=>{let Gj=J?P>0:!0,W=Q.length?Q.every((i)=>K.tags.some((z)=>_(z).includes(i))):!0,x=$?_(K.visibility)===$:!0,I=Z?_(K.kind)===Z:!0;return Gj&&W&&x&&I}).sort((K,P)=>{if(P.score!==K.score)return P.score-K.score;return K.doc.title.localeCompare(P.doc.title)}),B=V.slice(U,U+X).map(({doc:K})=>K),H=U+B.length<V.length?U+B.length:void 0;return{docs:B,items:B,total:V.length,...H!=null?{nextOffset:H}:{}}}function Hj(j){let Y=decodeURIComponent(j),J=j0.get(Y);if(!J)return;return{doc:fj(J),content:String(J.block.body??"")}}function Kj(j,Y){let J=YY(Y),Q=j.find(($)=>YY($.route)===J);if(!Q)return;return{doc:fj(Q),content:String(Q.block.body??"")}}function wj(j){let Y=new Map,J=new Map,Q=new Map;for(let Z of j){let X=Z.block.kind??"reference",U=Z.block.visibility??"public";J.set(X,(J.get(X)??0)+1),Q.set(U,(Q.get(U)??0)+1);for(let V of Z.block.tags??[])Y.set(V,(Y.get(V)??0)+1)}let $=(Z,X)=>[...Z.entries()].sort((U,V)=>V[1]-U[1]||U[0].localeCompare(V[0])).map(([U,V])=>({[X]:U,count:V}));return{totalDocs:j.length,tags:$(Y,"tag"),kinds:$(J,"kind"),visibilities:$(Q,"visibility")}}import{EventRegistry as U0,OperationSpecRegistry as V0}from"@contractspec/lib.contracts-spec";import{DataViewRegistry as H0}from"@contractspec/lib.contracts-spec/data-views";import{ContractReferenceDataView as K0,ContractReferenceQuery as w0,DocsGenerateCommand as F0,DocsGeneratedEvent as B0,DocsIndexDataView as W0,DocsIndexQuery as x0,DocsLayoutPresentation as P0,DocsPublishCommand as L0,DocsPublishedEvent as q0,DocsReferencePagePresentation as _0,DocsSearchForm as M0,ExampleCatalogDataView as b0}from"@contractspec/lib.contracts-spec/docs";import{FormRegistry as G0}from"@contractspec/lib.contracts-spec/forms";import{PresentationRegistry as D0}from"@contractspec/lib.contracts-spec/presentations";import{serializeDataViewSpec as C0,serializeEventSpec as A0,serializeFormSpec as N0,serializeOperationSpec as I0,serializePresentationSpec as z0}from"@contractspec/lib.contracts-spec/serialization";var Fj=null;function E0(){let j=new V0;return j.register(x0).register(w0).register(F0).register(L0),j}function k0(){if(!Fj)Fj=E0();return Fj}function Sj(j,Y){return k0().get(j,Y)}var Bj=null;function v0(){let j=new U0;return j.register(B0).register(q0),j}function O0(){if(!Bj)Bj=v0();return Bj}function yj(j,Y){return O0().get(j,Y)}var Wj=null;function R0(){let j=new D0;return j.register(P0).register(_0),j}function h0(){if(!Wj)Wj=R0();return Wj}function mj(j,Y){return h0().get(j,Y)}var xj=null;function T0(){let j=new H0;return j.register(W0).register(K0).register(b0),j}function f0(){if(!xj)xj=T0();return xj}function gj(j,Y){return f0().get(j,Y)}var Pj=null;function S0(){let j=new G0;return j.register(M0),j}function y0(){if(!Pj)Pj=S0();return Pj}function uj(j,Y){return y0().get(j)}function JY(j,Y){let J=Sj(j,Y);return I0(J)??void 0}function QY(j,Y){let J=yj(j,Y);return A0(J)??void 0}function ZY(j,Y){let J=mj(j,Y);return z0(J)??void 0}function $Y(j,Y){let J=gj(j,Y);return C0(J)??void 0}function XY(j,Y){let J=uj(j,Y);return N0(J)??void 0}function m0(){Fj=null}function g0(){Bj=null}function u0(){Wj=null}function d0(){xj=null}function p0(){Pj=null}function yQ(){m0(),g0(),u0(),d0(),p0()}import{defaultDocRegistry as l0}from"@contractspec/lib.contracts-spec/docs";function n0(j){return j?.trim().toLowerCase()??""}function c0(j){for(let Y of j??[]){let J=l0.get(Y);if(J)return J.route}return}function UY(j,Y,J,Q){let $=j.meta.title??j.meta.key,Z=c0(j.meta.docId),X=j.meta.description;return{key:j.meta.key,version:j.meta.version,type:Y,title:$,description:X,markdown:[`# ${$}`,`- Key: ${j.meta.key}`,`- Type: ${Y}`,`- Version: ${j.meta.version}`,Z?`- Docs route: ${Z}`:"",X?`
 ${X}`:""].filter(Boolean).join(`
-`),...Z?{route:Z}:{},...J?{schema:J}:{},...Q?{policy:Q}:{},tags:j.meta.tags??[],owners:j.meta.owners??[],stability:j.meta.stability}}function S(j){let Y=j.includeSchema??!1,J=b0(j.type),Q=Mj(j.key,j.version);if(Q&&(!J||J==="operation"||J===Q.meta.kind))return{reference:uj(Q,Q.meta.kind,Y?hj(j.key,j.version):void 0,Q.policy)};let $=[{type:"data-view",spec:Nj(j.key,j.version),schema:Y?mj(j.key,j.version):void 0},{type:"form",spec:Aj(j.key,j.version),schema:Y?gj(j.key,j.version):void 0},{type:"presentation",spec:Dj(j.key,j.version),schema:Y?yj(j.key,j.version):void 0},{type:"event",spec:bj(j.key,j.version),schema:Y?Sj(j.key,j.version):void 0}];for(let Z of $)if(Z.spec&&(!J||J===Z.type))return{reference:uj(Z.spec,Z.type,Z.schema)};throw Error(`Contract reference not found: ${j.key}`)}import{definePrompt as dj,PromptRegistry as N0}from"@contractspec/lib.contracts-spec";import x from"zod";var lj=["@contractspec"],pj=["docs","mcp"];function nj(j){let Y=new N0;return Y.register(dj({meta:{key:"docs.navigator",version:"1.0.0",title:"Find relevant ContractSpec docs",description:"Guide agents to search, filter, and open the right ContractSpec docs.",tags:pj,stability:"beta",owners:lj},args:[{name:"topic",description:"Goal or subject to search for.",required:!1,schema:x.string().optional()},{name:"kind",description:"Optional doc kind filter.",required:!1,schema:x.string().optional()},{name:"tag",description:"Optional tag filter.",required:!1,schema:x.string().optional()}],input:x.object({topic:x.string().optional(),kind:x.string().optional(),tag:x.string().optional()}),render:async({topic:J,kind:Q,tag:$})=>{let Z=h(j,{query:J,kind:Q,tag:$,limit:3}),X=Z.docs.length?Z.docs.map((U)=>`- ${U.title} (${U.id}) -> ${U.route}`).join(`
+`),...Z?{route:Z}:{},...J?{schema:J}:{},...Q?{policy:Q}:{},tags:j.meta.tags??[],owners:j.meta.owners??[],stability:j.meta.stability}}function p(j){let Y=j.includeSchema??!1,J=n0(j.type),Q=Sj(j.key,j.version);if(Q&&(!J||J==="operation"||J===Q.meta.kind))return{reference:UY(Q,Q.meta.kind,Y?JY(j.key,j.version):void 0,Q.policy)};let $=[{type:"data-view",spec:gj(j.key,j.version),schema:Y?$Y(j.key,j.version):void 0},{type:"form",spec:uj(j.key,j.version),schema:Y?XY(j.key,j.version):void 0},{type:"presentation",spec:mj(j.key,j.version),schema:Y?ZY(j.key,j.version):void 0},{type:"event",spec:yj(j.key,j.version),schema:Y?QY(j.key,j.version):void 0}];for(let Z of $)if(Z.spec&&(!J||J===Z.type))return{reference:UY(Z.spec,Z.type,Z.schema)};throw Error(`Contract reference not found: ${j.key}`)}import{definePrompt as VY,PromptRegistry as i0}from"@contractspec/lib.contracts-spec";import L from"zod";var HY=["@contractspec"],KY=["docs","mcp"];function wY(j){let Y=new i0;return Y.register(VY({meta:{key:"docs.navigator",version:"1.0.0",title:"Find relevant ContractSpec docs",description:"Guide agents to search, filter, and open the right ContractSpec docs.",tags:KY,stability:"beta",owners:HY},args:[{name:"topic",description:"Goal or subject to search for.",required:!1,schema:L.string().optional()},{name:"kind",description:"Optional doc kind filter.",required:!1,schema:L.string().optional()},{name:"tag",description:"Optional tag filter.",required:!1,schema:L.string().optional()}],input:L.object({topic:L.string().optional(),kind:L.string().optional(),tag:L.string().optional()}),render:async({topic:J,kind:Q,tag:$})=>{let Z=d(j,{query:J,kind:Q,tag:$,limit:3}),X=Z.docs.length?Z.docs.map((U)=>`- ${U.title} (${U.id}) -> ${U.route}`).join(`
 `):"- No direct pre-match. Use docs_list_facets-v1_0_0 to browse tags and kinds.";return[{type:"text",text:["Use docs_search-v1_0_0 first, then read docs://doc/{id} for the strongest matches.","Use docs_resolve_route-v1_0_0 when the user already gives you a docs URL or route.","Use docs_list_facets-v1_0_0 or docs://facets to browse the docs taxonomy before guessing.",J?`Topic: ${J}`:"",Q?`Kind: ${Q}`:"",$?`Tag: ${$}`:"","Suggested starting docs:",X].filter(Boolean).join(`
-`)},{type:"resource",uri:"docs://index",title:"DocBlocks index"},{type:"resource",uri:"docs://facets",title:"Docs facets"}]}})),Y.register(dj({meta:{key:"docs.reference.guide",version:"1.0.0",title:"Resolve a ContractSpec reference",description:"Guide agents to fetch the canonical reference payload for a ContractSpec surface.",tags:pj,stability:"beta",owners:lj},args:[{name:"key",description:"ContractSpec key to resolve.",required:!0,schema:x.string()},{name:"version",description:"Optional version override.",required:!1,schema:x.string().optional()},{name:"type",description:"Optional surface type: command, query, form, data-view, presentation, event.",required:!1,schema:x.string().optional()}],input:x.object({key:x.string(),version:x.string().optional(),type:x.string().optional()}),render:async({key:J,version:Q,type:$})=>{let Z=S({key:J,version:Q,type:$,includeSchema:!0}).reference;return[{type:"text",text:["Use docs_contract_reference-v1_0_0 when you need the canonical docs payload for a ContractSpec surface.","Use docs_get-v1_0_0 only when you already know the exact DocBlock id and need raw markdown.",`Resolved key: ${Z.key}`,`Resolved type: ${Z.type}`,Z.route?`Docs route: ${Z.route}`:"",`Resource URI: docs://contract-reference/${encodeURIComponent(J)}`].filter(Boolean).join(`
-`)},{type:"resource",uri:`docs://contract-reference/${encodeURIComponent(J)}`,title:"Contract reference"}]}})),Y}import{defineResourceTemplate as C,ResourceRegistry as A0}from"@contractspec/lib.contracts-spec";import w from"zod";var I=["docs","mcp"];function cj(j){let Y=new A0,J=(Q)=>h(j,Q);return Y.register(C({meta:{uriTemplate:"docs://index",title:"DocBlocks index",description:"Default ContractSpec docs index resource.",mimeType:"application/json",tags:I},input:w.object({}),resolve:async()=>({uri:"docs://index",mimeType:"application/json",data:JSON.stringify(J({}),null,2)})})),Y.register(C({meta:{uriTemplate:"docs://index{?query,tag,kind,visibility,limit,offset}",title:"DocBlocks index",description:"Search and paginate ContractSpec docs by query, tag, kind, or visibility.",mimeType:"application/json",tags:I},input:w.object({query:w.string().optional(),tag:w.string().optional(),kind:w.string().optional(),visibility:w.string().optional(),limit:w.coerce.number().optional(),offset:w.coerce.number().optional()}),resolve:async(Q)=>({uri:"docs://index",mimeType:"application/json",data:JSON.stringify(J(Q),null,2)})})),Y.register(C({meta:{uriTemplate:"docs://list",title:"DocBlocks index (legacy alias)",description:"Compatibility alias for the docs index resource.",mimeType:"application/json",tags:I},input:w.object({}),resolve:async()=>({uri:"docs://list",mimeType:"application/json",data:JSON.stringify(J({}),null,2)})})),Y.register(C({meta:{uriTemplate:"docs://doc/{id}",title:"Doc markdown",description:"Fetch a single DocBlock body by id as markdown.",mimeType:"text/markdown",tags:I},input:w.object({id:w.string()}),resolve:async({id:Q})=>{let $=jj(Q);if(!$)return{uri:`docs://doc/${encodeURIComponent(Q)}`,mimeType:"text/plain",data:`DocBlock not found: ${Q}`};return{uri:`docs://doc/${encodeURIComponent(Q)}`,mimeType:"text/markdown",data:$.content}}})),Y.register(C({meta:{uriTemplate:"docs://route/{routePath}",title:"Doc by route",description:"Resolve a docs route to the matching DocBlock summary and body.",mimeType:"application/json",tags:I},input:w.object({routePath:w.string()}),resolve:async({routePath:Q})=>({uri:`docs://route/${encodeURIComponent(Q)}`,mimeType:"application/json",data:JSON.stringify(Yj(j,Q)??{error:"not_found",route:Q},null,2)})})),Y.register(C({meta:{uriTemplate:"docs://facets",title:"Docs facets",description:"Counts of available tags, kinds, and visibilities across docs.",mimeType:"application/json",tags:I},input:w.object({}),resolve:async()=>({uri:"docs://facets",mimeType:"application/json",data:JSON.stringify(Jj(j),null,2)})})),Y.register(C({meta:{uriTemplate:"docs://contract-reference/{key}{?version,type,includeSchema}",title:"Contract reference",description:"Resolve a ContractSpec surface into a docs-ready reference payload.",mimeType:"application/json",tags:I},input:w.object({key:w.string(),version:w.string().optional(),type:w.string().optional(),includeSchema:w.coerce.boolean().optional()}),resolve:async({key:Q,version:$,type:Z,includeSchema:X})=>({uri:`docs://contract-reference/${encodeURIComponent(Q)}`,mimeType:"application/json",data:JSON.stringify(S({key:Q,version:$,type:Z,includeSchema:X}),null,2)})})),Y}import{defineCommand as p,defineSchemaModel as y,installOp as n,OperationSpecRegistry as C0}from"@contractspec/lib.contracts-spec";import{ContractReferenceInput as I0,ContractReferenceOutput as E0,DocsIndexInput as z0,DocsIndexOutput as O0}from"@contractspec/lib.contracts-spec/docs";import{ScalarTypeEnum as E}from"@contractspec/lib.schema";var c=["@contractspec"],i=["docs","mcp"],k0=y({name:"DocsGetInput",fields:{id:{type:E.String_unsecure(),isOptional:!1}}}),R0=y({name:"DocsGetOutput",fields:{doc:{type:E.JSON(),isOptional:!1},content:{type:E.String_unsecure(),isOptional:!1}}}),v0=y({name:"DocsResolveRouteInput",fields:{route:{type:E.String_unsecure(),isOptional:!1}}}),T0=y({name:"DocsResolveRouteOutput",fields:{doc:{type:E.JSON(),isOptional:!1},content:{type:E.String_unsecure(),isOptional:!1}}}),f0=y({name:"DocsFacetsInput",fields:{}}),h0=y({name:"DocsFacetsOutput",fields:{facets:{type:E.JSON(),isOptional:!1}}});function ij(j){let Y=new C0;return n(Y,p({meta:{key:"docs.search",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"Search ContractSpec docs by query, tag, kind, or visibility.",goal:"Find the most relevant DocBlocks without browsing the full corpus.",context:"Read-only docs MCP search surface."},io:{input:z0,output:O0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_search-v1_0_0"}}}),async(J)=>h(j,J)),n(Y,p({meta:{key:"docs.get",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"Read a single DocBlock by id.",goal:"Fetch the exact markdown content and metadata for a known doc id.",context:"Read-only docs MCP surface."},io:{input:k0,output:R0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_get-v1_0_0"}}}),async({id:J})=>{let Q=jj(J);if(!Q)throw Error(`DocBlock not found: ${J}`);return Q}),n(Y,p({meta:{key:"docs.resolveRoute",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"Resolve a docs route to the matching DocBlock.",goal:"Turn a route or URL path into a canonical doc id and markdown body.",context:"Read-only docs MCP surface."},io:{input:v0,output:T0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_resolve_route-v1_0_0"}}}),async({route:J})=>{let Q=Yj(j,J);if(!Q)throw Error(`Doc route not found: ${J}`);return Q}),n(Y,p({meta:{key:"docs.contract.lookup",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"Resolve a ContractSpec surface into a docs-ready reference payload.",goal:"Get canonical docs metadata, route, and optional schema for a spec key.",context:"Read-only docs MCP surface."},io:{input:I0,output:E0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_contract_reference-v1_0_0"}}}),async(J)=>S(J)),n(Y,p({meta:{key:"docs.list.facets",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"List docs taxonomy facets such as tags, kinds, and visibilities.",goal:"Help agents browse the docs corpus before making targeted reads.",context:"Read-only docs MCP surface."},io:{input:f0,output:h0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_list_facets-v1_0_0"}}}),async()=>({facets:Jj(j)})),Y}import{defaultDocRegistry as S0}from"@contractspec/lib.contracts-spec/docs";function RQ(j="/api/mcp/docs",Y={}){let J=S0.list();return b({logger:M,path:j,serverName:"contractspec-docs-mcp",ops:ij(J),resources:cj(J),prompts:nj(J),presentations:Y.includePresentations?J.map(({descriptor:Q})=>Q):void 0})}import{defineCommand as y0,definePrompt as m0,defineResourceTemplate as Vj,installOp as g0,OperationSpecRegistry as u0,PromptRegistry as d0,ResourceRegistry as l0}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as aj,ScalarTypeEnum as oj}from"@contractspec/lib.schema";import{getExample as p0,listExamples as n0,searchExamples as c0}from"@contractspec/module.examples";import z from"zod";var m=["internal","mcp"],tj=["@contractspec"],a={docs:"/api/mcp/docs",cli:"/api/mcp/cli",internal:"/api/mcp/internal",graphql:"/graphql",health:"/health"};function i0(){let j=new l0;return j.register(Vj({meta:{uriTemplate:"examples://list{?q}",title:"ContractSpec examples registry",description:"List available examples (templates, integrations, knowledge, scripts). Optional query `q` filters results.",mimeType:"application/json",tags:["examples",...m]},input:z.object({q:z.string().optional()}),resolve:async({q:Y})=>{let J=Y?c0(Y):[...n0()];return{uri:Y?`examples://list?q=${encodeURIComponent(Y)}`:"examples://list",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j.register(Vj({meta:{uriTemplate:"examples://example/{id}",title:"ContractSpec example (by id)",description:"Fetch a single example manifest by id.",mimeType:"application/json",tags:["examples",...m]},input:z.object({id:z.string().min(1)}),resolve:async({id:Y})=>{let J=p0(Y);if(!J)return{uri:`examples://example/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify({error:"not_found",id:Y,message:`Unknown example id: ${Y}`},null,2)};return{uri:`examples://example/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j.register(Vj({meta:{uriTemplate:"internal://endpoints",title:"ContractSpec MCP endpoints",description:"Endpoints for docs, CLI, internal MCP servers.",mimeType:"application/json",tags:m},input:z.object({}),resolve:async()=>({uri:"internal://endpoints",mimeType:"application/json",data:JSON.stringify(a,null,2)})})),j.register(Vj({meta:{uriTemplate:"internal://playbook",title:"Internal MCP usage playbook",description:"How internal agents should discover docs, CLI usage, and endpoints.",mimeType:"text/markdown",tags:m},input:z.object({}),resolve:async()=>({uri:"internal://playbook",mimeType:"text/markdown",data:["# Internal MCP playbook","- Connect to docs MCP first for canonical specs.","- Use CLI MCP to surface quickstart/reference before running commands.","- Keep calls read-only unless explicitly approved.",`- Endpoints: ${a.docs}, ${a.cli}, ${a.internal}.`,"- For API work, GraphQL at /graphql; health at /health."].join(`
-`)})})),j}function a0(){let j=new d0;return j.register(m0({meta:{key:"internal_bootstrap",version:"1.0.0",title:"Bootstrap internal ContractSpec agent",description:"Points agents to the correct MCP endpoints and guardrails.",tags:m,owners:tj,stability:"beta"},args:[],input:z.object({}),render:async()=>[{type:"text",text:"Start with internal://endpoints to pick the right MCP. Use docs MCP for specifications and CLI MCP for commands. Keep actions read-only unless explicitly approved."},{type:"resource",uri:"internal://endpoints",title:"Endpoints"}]})),j}function o0(){let j=new u0,Y=aj({name:"InternalDescribeOutput",fields:{endpoints:{type:oj.JSONObject(),isOptional:!1},notes:{type:oj.String_unsecure(),isOptional:!1}}}),J=y0({meta:{key:"internal_describe",version:"1.0.0",stability:"stable",owners:tj,tags:m,description:"Return MCP endpoints and guidance for internal ContractSpec agents.",goal:"Speed up internal development with the correct MCP entrypoints.",context:"Used by internal MCP surface; read-only."},io:{input:aj({name:"InternalDescribeInput",fields:{}}),output:Y},policy:{auth:"anonymous"}});return g0(j,J,async()=>({endpoints:a,notes:"Use docs MCP for canonical specs, CLI MCP for contractspec commands, and keep side-effecting actions gated behind human review."})),j}function gQ(j="/api/mcp/internal"){return b({logger:M,path:j,serverName:"contractspec-internal-mcp",ops:o0(),resources:i0(),prompts:a0()})}import{getModelInfo as t0}from"@contractspec/lib.ai-providers/models";import{definePrompt as s0,defineResourceTemplate as Hj,installOp as Cj,OperationSpecRegistry as r0,PromptRegistry as e0,ResourceRegistry as jJ}from"@contractspec/lib.contracts-spec";import{BenchmarkIngestCommand as YJ,BenchmarkRunCustomCommand as JJ,RankingRefreshCommand as QJ}from"@contractspec/lib.contracts-spec/provider-ranking";import{InMemoryProviderRankingStore as ZJ}from"@contractspec/lib.provider-ranking/in-memory-store";import{createDefaultIngesterRegistry as $J}from"@contractspec/lib.provider-ranking/ingesters";import{computeModelRankings as XJ,normalizeBenchmarkResults as UJ}from"@contractspec/lib.provider-ranking/scoring";import L from"zod";var Bj=L.enum(["rest","mcp","webhook","sdk"]).optional(),wj=L.enum(["api-key","oauth2","bearer","header","basic","webhook-signing","service-account"]).optional(),o=["ranking","mcp","ai"],VJ=["platform.ai"],Kj=null;function g(){if(!Kj)Kj=new ZJ;return Kj}function HJ(){let j=new jJ;return j.register(Hj({meta:{uriTemplate:"ranking://leaderboard",title:"AI Model Leaderboard",description:"Current ranked list of AI models by composite score. Supports optional transport and authMethod query filters.",mimeType:"application/json",tags:o},input:L.object({transport:Bj,authMethod:wj}),resolve:async({transport:Y,authMethod:J})=>{let $=await g().listModelRankings({limit:100,requiredTransport:Y,requiredAuthMethod:J});return{uri:"ranking://leaderboard",mimeType:"application/json",data:JSON.stringify($,null,2)}}})),j.register(Hj({meta:{uriTemplate:"ranking://leaderboard/{dimension}",title:"AI Model Leaderboard by Dimension",description:"Ranked list of AI models filtered by a specific dimension. Supports optional transport and authMethod query filters.",mimeType:"application/json",tags:o},input:L.object({dimension:L.string(),transport:Bj,authMethod:wj}),resolve:async({dimension:Y,transport:J,authMethod:Q})=>{let Z=await g().listModelRankings({dimension:Y,limit:100,requiredTransport:J,requiredAuthMethod:Q});return{uri:`ranking://leaderboard/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify(Z,null,2)}}})),j.register(Hj({meta:{uriTemplate:"ranking://model/{modelId}",title:"AI Model Profile",description:"Detailed profile for a specific AI model including scores and benchmarks.",mimeType:"application/json",tags:o},input:L.object({modelId:L.string()}),resolve:async({modelId:Y})=>{let Q=await g().getModelProfile(Y);if(!Q)return{uri:`ranking://model/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify({error:"not_found",modelId:Y})};let $=Q.costPerMillion==null?(()=>{let Z=t0(Q.modelId);return Z?.costPerMillion?{...Q,costPerMillion:Z.costPerMillion,displayName:Z.name,contextWindow:Z.contextWindow,capabilities:[...Z.capabilities.vision?["vision"]:[],...Z.capabilities.tools?["tools"]:[],...Z.capabilities.reasoning?["reasoning"]:[],...Z.capabilities.streaming?["streaming"]:[]]}:Q})():Q;return{uri:`ranking://model/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify($,null,2)}}})),j.register(Hj({meta:{uriTemplate:"ranking://results",title:"Benchmark Results",description:"List of raw benchmark results from all ingested sources.",mimeType:"application/json",tags:o},input:L.object({}),resolve:async()=>{let J=await g().listBenchmarkResults({limit:200});return{uri:"ranking://results",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j}function KJ(){let j=new e0;return j.register(s0({meta:{key:"ranking.advisor",version:"1.0.0",title:"AI Model Advisor",description:"Which AI model is best for a given task? Uses the leaderboard to recommend.",tags:o,stability:"beta",owners:VJ},args:[{name:"task",description:"The task or use case to recommend a model for.",required:!0,schema:L.string()},{name:"priority",description:"Priority dimension (coding, reasoning, cost, latency, etc.).",required:!1,schema:L.string().optional()},{name:"transport",description:"Required transport type (rest, mcp, webhook, sdk).",required:!1,schema:Bj},{name:"authMethod",description:"Required auth method (api-key, oauth2, bearer, etc.).",required:!1,schema:wj}],input:L.object({task:L.string(),priority:L.string().optional(),transport:Bj,authMethod:wj}),render:async({task:Y,priority:J,transport:Q,authMethod:$})=>{let Z=[];if(J)Z.push(`Prioritize: ${J}.`);if(Q)Z.push(`Required transport: ${Q}.`);if($)Z.push(`Required auth: ${$}.`);return[{type:"text",text:`Recommend the best AI model for: "${Y}".${Z.length?` ${Z.join(" ")}`:""} Use the leaderboard data to justify your recommendation.`},{type:"resource",uri:J?`ranking://leaderboard/${J}`:"ranking://leaderboard",title:"Leaderboard"}]}})),j}function BJ(){let j=new r0,Y=$J();return Cj(j,YJ,async(J)=>{let Q=g(),$=J.source,Z=Y.get($);if(!Z)throw Error(`No ingester registered for source: ${$}`);let X=await Z.ingest({sourceUrl:J.sourceUrl,dimensions:J.dimensions}),U=UJ(X);for(let K of U)await Q.upsertBenchmarkResult(K);return{ingestionId:`ingest-${$}-${Date.now()}`,source:$,resultsCount:U.length,status:"completed",ingestedAt:new Date}}),Cj(j,JJ,async(J)=>{return{runId:`custom-${Date.now()}`,evalSuiteKey:J.evalSuiteKey,modelId:J.modelId,status:"started",startedAt:new Date}}),Cj(j,QJ,async(J)=>{let Q=g(),$=[],Z=0,X=500;while(!0){let V=await Q.listBenchmarkResults({limit:X,offset:Z});if($.push(...V.results),$.length>=V.total||V.results.length<X)break;Z+=X}let U=new Map((await Q.listModelRankings({limit:1e4})).rankings.map((V)=>[V.modelId,V])),K=J.weightOverrides?Array.isArray(J.weightOverrides)?J.weightOverrides:[J.weightOverrides]:void 0,P=XJ($,K?{weightOverrides:K}:void 0,U);for(let V of P)await Q.upsertModelRanking(V);return{modelsRanked:P.length,updatedAt:new Date,status:"completed"}}),j}function sQ(j="/api/mcp/ranking"){return b({logger:M,path:j,serverName:"contractspec-ranking-mcp",ops:BJ(),resources:HJ(),prompts:KJ()})}function rQ(j){Kj=j}export{rQ as setProviderRankingStore,sQ as createProviderRankingMcpHandler,gQ as createInternalMcpHandler,RQ as createDocsMcpHandler,oJ as createContractsMcpHandler,xJ as createContextStorageService,SJ as createCliMcpHandler};
+`)},{type:"resource",uri:"docs://index",title:"DocBlocks index"},{type:"resource",uri:"docs://facets",title:"Docs facets"}]}})),Y.register(VY({meta:{key:"docs.reference.guide",version:"1.0.0",title:"Resolve a ContractSpec reference",description:"Guide agents to fetch the canonical reference payload for a ContractSpec surface.",tags:KY,stability:"beta",owners:HY},args:[{name:"key",description:"ContractSpec key to resolve.",required:!0,schema:L.string()},{name:"version",description:"Optional version override.",required:!1,schema:L.string().optional()},{name:"type",description:"Optional surface type: command, query, form, data-view, presentation, event.",required:!1,schema:L.string().optional()}],input:L.object({key:L.string(),version:L.string().optional(),type:L.string().optional()}),render:async({key:J,version:Q,type:$})=>{let Z=p({key:J,version:Q,type:$,includeSchema:!0}).reference;return[{type:"text",text:["Use docs_contract_reference-v1_0_0 when you need the canonical docs payload for a ContractSpec surface.","Use docs_get-v1_0_0 only when you already know the exact DocBlock id and need raw markdown.",`Resolved key: ${Z.key}`,`Resolved type: ${Z.type}`,Z.route?`Docs route: ${Z.route}`:"",`Resource URI: docs://contract-reference/${encodeURIComponent(J)}`].filter(Boolean).join(`
+`)},{type:"resource",uri:`docs://contract-reference/${encodeURIComponent(J)}`,title:"Contract reference"}]}})),Y}import{defineResourceTemplate as k,ResourceRegistry as o0}from"@contractspec/lib.contracts-spec";import F from"zod";var v=["docs","mcp"];function FY(j){let Y=new o0,J=(Q)=>d(j,Q);return Y.register(k({meta:{uriTemplate:"docs://index",title:"DocBlocks index",description:"Default ContractSpec docs index resource.",mimeType:"application/json",tags:v},input:F.object({}),resolve:async()=>({uri:"docs://index",mimeType:"application/json",data:JSON.stringify(J({}),null,2)})})),Y.register(k({meta:{uriTemplate:"docs://index{?query,tag,kind,visibility,limit,offset}",title:"DocBlocks index",description:"Search and paginate ContractSpec docs by query, tag, kind, or visibility.",mimeType:"application/json",tags:v},input:F.object({query:F.string().optional(),tag:F.string().optional(),kind:F.string().optional(),visibility:F.string().optional(),limit:F.coerce.number().optional(),offset:F.coerce.number().optional()}),resolve:async(Q)=>({uri:"docs://index",mimeType:"application/json",data:JSON.stringify(J(Q),null,2)})})),Y.register(k({meta:{uriTemplate:"docs://list",title:"DocBlocks index (legacy alias)",description:"Compatibility alias for the docs index resource.",mimeType:"application/json",tags:v},input:F.object({}),resolve:async()=>({uri:"docs://list",mimeType:"application/json",data:JSON.stringify(J({}),null,2)})})),Y.register(k({meta:{uriTemplate:"docs://doc/{id}",title:"Doc markdown",description:"Fetch a single DocBlock body by id as markdown.",mimeType:"text/markdown",tags:v},input:F.object({id:F.string()}),resolve:async({id:Q})=>{let $=Hj(Q);if(!$)return{uri:`docs://doc/${encodeURIComponent(Q)}`,mimeType:"text/plain",data:`DocBlock not found: ${Q}`};return{uri:`docs://doc/${encodeURIComponent(Q)}`,mimeType:"text/markdown",data:$.content}}})),Y.register(k({meta:{uriTemplate:"docs://route/{routePath}",title:"Doc by route",description:"Resolve a docs route to the matching DocBlock summary and body.",mimeType:"application/json",tags:v},input:F.object({routePath:F.string()}),resolve:async({routePath:Q})=>({uri:`docs://route/${encodeURIComponent(Q)}`,mimeType:"application/json",data:JSON.stringify(Kj(j,Q)??{error:"not_found",route:Q},null,2)})})),Y.register(k({meta:{uriTemplate:"docs://facets",title:"Docs facets",description:"Counts of available tags, kinds, and visibilities across docs.",mimeType:"application/json",tags:v},input:F.object({}),resolve:async()=>({uri:"docs://facets",mimeType:"application/json",data:JSON.stringify(wj(j),null,2)})})),Y.register(k({meta:{uriTemplate:"docs://contract-reference/{key}{?version,type,includeSchema}",title:"Contract reference",description:"Resolve a ContractSpec surface into a docs-ready reference payload.",mimeType:"application/json",tags:v},input:F.object({key:F.string(),version:F.string().optional(),type:F.string().optional(),includeSchema:F.coerce.boolean().optional()}),resolve:async({key:Q,version:$,type:Z,includeSchema:X})=>({uri:`docs://contract-reference/${encodeURIComponent(Q)}`,mimeType:"application/json",data:JSON.stringify(p({key:Q,version:$,type:Z,includeSchema:X}),null,2)})})),Y}import{defineCommand as r,defineSchemaModel as l,installOp as e,OperationSpecRegistry as a0}from"@contractspec/lib.contracts-spec";import{ContractReferenceInput as t0,ContractReferenceOutput as s0,DocsIndexInput as r0,DocsIndexOutput as e0}from"@contractspec/lib.contracts-spec/docs";import{ScalarTypeEnum as O}from"@contractspec/lib.schema";var jj=["@contractspec"],Yj=["docs","mcp"],jJ=l({name:"DocsGetInput",fields:{id:{type:O.String_unsecure(),isOptional:!1}}}),YJ=l({name:"DocsGetOutput",fields:{doc:{type:O.JSON(),isOptional:!1},content:{type:O.String_unsecure(),isOptional:!1}}}),JJ=l({name:"DocsResolveRouteInput",fields:{route:{type:O.String_unsecure(),isOptional:!1}}}),QJ=l({name:"DocsResolveRouteOutput",fields:{doc:{type:O.JSON(),isOptional:!1},content:{type:O.String_unsecure(),isOptional:!1}}}),ZJ=l({name:"DocsFacetsInput",fields:{}}),$J=l({name:"DocsFacetsOutput",fields:{facets:{type:O.JSON(),isOptional:!1}}});function BY(j){let Y=new a0;return e(Y,r({meta:{key:"docs.search",version:"1.0.0",stability:"beta",owners:jj,tags:Yj,description:"Search ContractSpec docs by query, tag, kind, or visibility.",goal:"Find the most relevant DocBlocks without browsing the full corpus.",context:"Read-only docs MCP search surface."},io:{input:r0,output:e0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_search-v1_0_0"}}}),async(J)=>d(j,J)),e(Y,r({meta:{key:"docs.get",version:"1.0.0",stability:"beta",owners:jj,tags:Yj,description:"Read a single DocBlock by id.",goal:"Fetch the exact markdown content and metadata for a known doc id.",context:"Read-only docs MCP surface."},io:{input:jJ,output:YJ},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_get-v1_0_0"}}}),async({id:J})=>{let Q=Hj(J);if(!Q)throw Error(`DocBlock not found: ${J}`);return Q}),e(Y,r({meta:{key:"docs.resolveRoute",version:"1.0.0",stability:"beta",owners:jj,tags:Yj,description:"Resolve a docs route to the matching DocBlock.",goal:"Turn a route or URL path into a canonical doc id and markdown body.",context:"Read-only docs MCP surface."},io:{input:JJ,output:QJ},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_resolve_route-v1_0_0"}}}),async({route:J})=>{let Q=Kj(j,J);if(!Q)throw Error(`Doc route not found: ${J}`);return Q}),e(Y,r({meta:{key:"docs.contract.lookup",version:"1.0.0",stability:"beta",owners:jj,tags:Yj,description:"Resolve a ContractSpec surface into a docs-ready reference payload.",goal:"Get canonical docs metadata, route, and optional schema for a spec key.",context:"Read-only docs MCP surface."},io:{input:t0,output:s0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_contract_reference-v1_0_0"}}}),async(J)=>p(J)),e(Y,r({meta:{key:"docs.list.facets",version:"1.0.0",stability:"beta",owners:jj,tags:Yj,description:"List docs taxonomy facets such as tags, kinds, and visibilities.",goal:"Help agents browse the docs corpus before making targeted reads.",context:"Read-only docs MCP surface."},io:{input:ZJ,output:$J},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_list_facets-v1_0_0"}}}),async()=>({facets:wj(j)})),Y}import{defaultDocRegistry as XJ}from"@contractspec/lib.contracts-spec/docs";function wZ(j="/api/mcp/docs",Y={}){let J=XJ.list();return A({logger:D,path:j,serverName:"contractspec-docs-mcp",ops:BY(J),resources:FY(J),prompts:wY(J),presentations:Y.includePresentations?J.map(({descriptor:Q})=>Q):void 0})}import{defineCommand as UJ,definePrompt as VJ,defineResourceTemplate as Lj,installOp as HJ,OperationSpecRegistry as KJ,PromptRegistry as wJ,ResourceRegistry as FJ}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as WY,ScalarTypeEnum as xY}from"@contractspec/lib.schema";import{getExample as BJ,listExamples as WJ,searchExamples as xJ}from"@contractspec/module.examples";import R from"zod";var n=["internal","mcp"],PY=["@contractspec"],Jj={docs:"/api/mcp/docs",cli:"/api/mcp/cli",internal:"/api/mcp/internal",graphql:"/graphql",health:"/health"};function PJ(){let j=new FJ;return j.register(Lj({meta:{uriTemplate:"examples://list{?q}",title:"ContractSpec examples registry",description:"List available examples (templates, integrations, knowledge, scripts). Optional query `q` filters results.",mimeType:"application/json",tags:["examples",...n]},input:R.object({q:R.string().optional()}),resolve:async({q:Y})=>{let J=Y?xJ(Y):[...WJ()];return{uri:Y?`examples://list?q=${encodeURIComponent(Y)}`:"examples://list",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j.register(Lj({meta:{uriTemplate:"examples://example/{id}",title:"ContractSpec example (by id)",description:"Fetch a single example manifest by id.",mimeType:"application/json",tags:["examples",...n]},input:R.object({id:R.string().min(1)}),resolve:async({id:Y})=>{let J=BJ(Y);if(!J)return{uri:`examples://example/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify({error:"not_found",id:Y,message:`Unknown example id: ${Y}`},null,2)};return{uri:`examples://example/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j.register(Lj({meta:{uriTemplate:"internal://endpoints",title:"ContractSpec MCP endpoints",description:"Endpoints for docs, CLI, internal MCP servers.",mimeType:"application/json",tags:n},input:R.object({}),resolve:async()=>({uri:"internal://endpoints",mimeType:"application/json",data:JSON.stringify(Jj,null,2)})})),j.register(Lj({meta:{uriTemplate:"internal://playbook",title:"Internal MCP usage playbook",description:"How internal agents should discover docs, CLI usage, and endpoints.",mimeType:"text/markdown",tags:n},input:R.object({}),resolve:async()=>({uri:"internal://playbook",mimeType:"text/markdown",data:["# Internal MCP playbook","- Connect to docs MCP first for canonical specs.","- Use CLI MCP to surface quickstart/reference before running commands.","- Keep calls read-only unless explicitly approved.",`- Endpoints: ${Jj.docs}, ${Jj.cli}, ${Jj.internal}.`,"- For API work, GraphQL at /graphql; health at /health."].join(`
+`)})})),j}function LJ(){let j=new wJ;return j.register(VJ({meta:{key:"internal_bootstrap",version:"1.0.0",title:"Bootstrap internal ContractSpec agent",description:"Points agents to the correct MCP endpoints and guardrails.",tags:n,owners:PY,stability:"beta"},args:[],input:R.object({}),render:async()=>[{type:"text",text:"Start with internal://endpoints to pick the right MCP. Use docs MCP for specifications and CLI MCP for commands. Keep actions read-only unless explicitly approved."},{type:"resource",uri:"internal://endpoints",title:"Endpoints"}]})),j}function qJ(){let j=new KJ,Y=WY({name:"InternalDescribeOutput",fields:{endpoints:{type:xY.JSONObject(),isOptional:!1},notes:{type:xY.String_unsecure(),isOptional:!1}}}),J=UJ({meta:{key:"internal_describe",version:"1.0.0",stability:"stable",owners:PY,tags:n,description:"Return MCP endpoints and guidance for internal ContractSpec agents.",goal:"Speed up internal development with the correct MCP entrypoints.",context:"Used by internal MCP surface; read-only."},io:{input:WY({name:"InternalDescribeInput",fields:{}}),output:Y},policy:{auth:"anonymous"}});return HJ(j,J,async()=>({endpoints:Jj,notes:"Use docs MCP for canonical specs, CLI MCP for contractspec commands, and keep side-effecting actions gated behind human review."})),j}function _Z(j="/api/mcp/internal"){return A({logger:D,path:j,serverName:"contractspec-internal-mcp",ops:qJ(),resources:PJ(),prompts:LJ()})}import{getModelInfo as _J}from"@contractspec/lib.ai-providers/models";import{definePrompt as MJ,defineResourceTemplate as qj,installOp as dj,OperationSpecRegistry as bJ,PromptRegistry as GJ,ResourceRegistry as DJ}from"@contractspec/lib.contracts-spec";import{BenchmarkIngestCommand as CJ,BenchmarkRunCustomCommand as AJ,RankingRefreshCommand as NJ}from"@contractspec/lib.contracts-spec/provider-ranking";import{InMemoryProviderRankingStore as IJ}from"@contractspec/lib.provider-ranking/in-memory-store";import{createDefaultIngesterRegistry as zJ}from"@contractspec/lib.provider-ranking/ingesters";import{computeModelRankings as EJ,normalizeBenchmarkResults as kJ}from"@contractspec/lib.provider-ranking/scoring";import M from"zod";var Mj=M.enum(["rest","mcp","webhook","sdk"]).optional(),bj=M.enum(["api-key","oauth2","bearer","header","basic","webhook-signing","service-account"]).optional(),Qj=["ranking","mcp","ai"],vJ=["platform.ai"],_j=null;function c(){if(!_j)_j=new IJ;return _j}function OJ(){let j=new DJ;return j.register(qj({meta:{uriTemplate:"ranking://leaderboard",title:"AI Model Leaderboard",description:"Current ranked list of AI models by composite score. Supports optional transport and authMethod query filters.",mimeType:"application/json",tags:Qj},input:M.object({transport:Mj,authMethod:bj}),resolve:async({transport:Y,authMethod:J})=>{let $=await c().listModelRankings({limit:100,requiredTransport:Y,requiredAuthMethod:J});return{uri:"ranking://leaderboard",mimeType:"application/json",data:JSON.stringify($,null,2)}}})),j.register(qj({meta:{uriTemplate:"ranking://leaderboard/{dimension}",title:"AI Model Leaderboard by Dimension",description:"Ranked list of AI models filtered by a specific dimension. Supports optional transport and authMethod query filters.",mimeType:"application/json",tags:Qj},input:M.object({dimension:M.string(),transport:Mj,authMethod:bj}),resolve:async({dimension:Y,transport:J,authMethod:Q})=>{let Z=await c().listModelRankings({dimension:Y,limit:100,requiredTransport:J,requiredAuthMethod:Q});return{uri:`ranking://leaderboard/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify(Z,null,2)}}})),j.register(qj({meta:{uriTemplate:"ranking://model/{modelId}",title:"AI Model Profile",description:"Detailed profile for a specific AI model including scores and benchmarks.",mimeType:"application/json",tags:Qj},input:M.object({modelId:M.string()}),resolve:async({modelId:Y})=>{let Q=await c().getModelProfile(Y);if(!Q)return{uri:`ranking://model/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify({error:"not_found",modelId:Y})};let $=Q.costPerMillion==null?(()=>{let Z=_J(Q.modelId);return Z?.costPerMillion?{...Q,costPerMillion:Z.costPerMillion,displayName:Z.name,contextWindow:Z.contextWindow,capabilities:[...Z.capabilities.vision?["vision"]:[],...Z.capabilities.tools?["tools"]:[],...Z.capabilities.reasoning?["reasoning"]:[],...Z.capabilities.streaming?["streaming"]:[]]}:Q})():Q;return{uri:`ranking://model/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify($,null,2)}}})),j.register(qj({meta:{uriTemplate:"ranking://results",title:"Benchmark Results",description:"List of raw benchmark results from all ingested sources.",mimeType:"application/json",tags:Qj},input:M.object({}),resolve:async()=>{let J=await c().listBenchmarkResults({limit:200});return{uri:"ranking://results",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j}function RJ(){let j=new GJ;return j.register(MJ({meta:{key:"ranking.advisor",version:"1.0.0",title:"AI Model Advisor",description:"Which AI model is best for a given task? Uses the leaderboard to recommend.",tags:Qj,stability:"beta",owners:vJ},args:[{name:"task",description:"The task or use case to recommend a model for.",required:!0,schema:M.string()},{name:"priority",description:"Priority dimension (coding, reasoning, cost, latency, etc.).",required:!1,schema:M.string().optional()},{name:"transport",description:"Required transport type (rest, mcp, webhook, sdk).",required:!1,schema:Mj},{name:"authMethod",description:"Required auth method (api-key, oauth2, bearer, etc.).",required:!1,schema:bj}],input:M.object({task:M.string(),priority:M.string().optional(),transport:Mj,authMethod:bj}),render:async({task:Y,priority:J,transport:Q,authMethod:$})=>{let Z=[];if(J)Z.push(`Prioritize: ${J}.`);if(Q)Z.push(`Required transport: ${Q}.`);if($)Z.push(`Required auth: ${$}.`);return[{type:"text",text:`Recommend the best AI model for: "${Y}".${Z.length?` ${Z.join(" ")}`:""} Use the leaderboard data to justify your recommendation.`},{type:"resource",uri:J?`ranking://leaderboard/${J}`:"ranking://leaderboard",title:"Leaderboard"}]}})),j}function hJ(){let j=new bJ,Y=zJ();return dj(j,CJ,async(J)=>{let Q=c(),$=J.source,Z=Y.get($);if(!Z)throw Error(`No ingester registered for source: ${$}`);let X=await Z.ingest({sourceUrl:J.sourceUrl,dimensions:J.dimensions}),U=kJ(X);for(let V of U)await Q.upsertBenchmarkResult(V);return{ingestionId:`ingest-${$}-${Date.now()}`,source:$,resultsCount:U.length,status:"completed",ingestedAt:new Date}}),dj(j,AJ,async(J)=>{return{runId:`custom-${Date.now()}`,evalSuiteKey:J.evalSuiteKey,modelId:J.modelId,status:"started",startedAt:new Date}}),dj(j,NJ,async(J)=>{let Q=c(),$=[],Z=0,X=500;while(!0){let H=await Q.listBenchmarkResults({limit:X,offset:Z});if($.push(...H.results),$.length>=H.total||H.results.length<X)break;Z+=X}let U=new Map((await Q.listModelRankings({limit:1e4})).rankings.map((H)=>[H.modelId,H])),V=J.weightOverrides?Array.isArray(J.weightOverrides)?J.weightOverrides:[J.weightOverrides]:void 0,B=EJ($,V?{weightOverrides:V}:void 0,U);for(let H of B)await Q.upsertModelRanking(H);return{modelsRanked:B.length,updatedAt:new Date,status:"completed"}}),j}function kZ(j="/api/mcp/ranking"){return A({logger:D,path:j,serverName:"contractspec-ranking-mcp",ops:hJ(),resources:OJ(),prompts:RJ()})}function vZ(j){_j=j}export{vZ as setProviderRankingStore,kZ as createProviderRankingMcpHandler,_Z as createInternalMcpHandler,wZ as createDocsMcpHandler,zQ as createContractsMcpHandler,yJ as createContextStorageService,FQ as createCliMcpHandler};

package/dist/application/mcp/cliMcp.js

@@ -1,10 +1,10 @@
 // @bun
-import{Logger as E,LogLevel as b}from"@contractspec/lib.logger";function f(){return"production"}var v=()=>new E({level:b.INFO,environment:f(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),N=v(),$j=new E({level:b.WARN,environment:f(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),xj=new E({level:b.INFO,environment:f(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});var _=["application/json","text/event-stream"];function S(j){return!j||j.includes("*/*")||j.includes("application/*")||_.some((Q)=>j.includes(Q))}function O(j){if(j.method!=="POST")return j;let Q=j.headers.get("accept");if(!S(Q))return j;let U=_.filter((X)=>!Q?.includes(X));if(U.length===0)return j;let Y=new Headers(j.headers);return Y.set("accept",[Q,...U].filter(Boolean).join(", ")),new Request(j,{headers:Y})}import{createMcpServer as c}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as n}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as d}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as i}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as u}from"crypto";import{Elysia as p}from"elysia";var g={actor:"anonymous",decide:async()=>({effect:"allow"})};function T(j,Q,U,Y){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:Q,message:U,...Y?{data:Y}:{}},id:null}),{status:j,headers:{"content-type":"application/json"}})}function k({logger:j,serverName:Q,ops:U,resources:Y,prompts:X,presentations:Z,stateful:V}){let x=new d({name:Q,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),c(x,U,Y,X,{logger:j,toolCtx:()=>g,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new n(Z)});let G=new i({sessionIdGenerator:V?()=>u():void 0,enableJsonResponse:!0});return x.connect(G).then(()=>({server:x,transport:G}))}async function w(j){await Promise.allSettled([j.transport.close(),j.server.close()])}function l(j){return j instanceof Error?j.stack??j.message:String(j)}function A({logger:j,path:Q,serverName:U,ops:Y,resources:X,prompts:Z,presentations:V,validateAuth:x,requiredAuthMethods:G}){j.info("Setting up MCP handler...",{requiredAuthMethods:G??[]});let C=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",H=new Map;async function L(B){let J=await k({logger:j,path:Q,serverName:U,ops:Y,resources:X,prompts:Z,presentations:V,stateful:!1});try{return await J.transport.handleRequest(O(B))}finally{await w(J)}}async function h(B){let J=H.get(B);if(!J)return;H.delete(B),await w(J)}async function m(B){let J=B.headers.get("mcp-session-id"),$,R=!1;if(J){let F=H.get(J);if(!F)return T(404,-32001,"Session not found");$=F}else $=await k({logger:j,path:Q,serverName:U,ops:Y,resources:X,prompts:Z,presentations:V,stateful:!0}),R=!0;try{let F=await $.transport.handleRequest(O(B)),K=$.transport.sessionId;if(K&&!H.has(K))H.set(K,$);if(B.method==="DELETE"&&K)await h(K);else if(!K&&R)await w($);return F}catch(F){if(R)await w($);throw F}}return new p({name:`mcp-${U}`}).all(Q,async({request:B})=>{try{if(x){let J=await x(B);if(!J.valid)return T(401,-32002,"Authentication failed",J.reason)}if(C)return await m(B);return await L(B)}catch(J){return j.error("Error handling MCP request",{path:Q,method:B.method,error:l(J)}),T(500,-32000,"Internal error")}})}import o from"fs/promises";import{defineCommand as a,definePrompt as t,defineResourceTemplate as I,installOp as r,OperationSpecRegistry as s,PromptRegistry as e,ResourceRegistry as jj}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as q,ScalarTypeEnum as W}from"@contractspec/lib.schema";import z from"path";import P from"zod";var __dirname="/home/runner/work/contractspec/contractspec/packages/bundles/library/src/application/mcp",Qj={quickstart:"packages/apps/cli-contractspec/QUICK_START.md",reference:"packages/apps/cli-contractspec/QUICK_REFERENCE.md",readme:"packages/apps/cli-contractspec/README.md"},Uj={quickstart:`# ContractSpec CLI quickstart
+import{Logger as k,LogLevel as C}from"@contractspec/lib.logger";function v(){return"production"}var s=()=>new k({level:C.INFO,environment:v(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),O=s(),Ej=new k({level:C.WARN,environment:v(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),Lj=new k({level:C.INFO,environment:v(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});import{createNodeAdapters as r,onboarding as T}from"@contractspec/bundle.workspace";import{defineCommand as I,definePrompt as e,defineResourceTemplate as A,installOp as h}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as D,ScalarTypeEnum as K}from"@contractspec/lib.schema";import W from"zod";var w=["cli","mcp","onboarding"],q=["@contractspec"];function jj(j){return j?.split(",").map((Q)=>Q.trim()).filter(Boolean)}async function _(j={}){let Q=r({cwd:process.cwd(),silent:!0});return T.buildOnboardingPlan(Q,{forcedExampleKey:j.example,selectedTracks:jj(j.tracks)})}function S(j){j.register(A({meta:{uriTemplate:"onboarding://tracks",title:"Onboarding tracks",description:"Primary ContractSpec onboarding tracks exposed by the CLI.",mimeType:"application/json",tags:w},input:W.object({}),resolve:async()=>({uri:"onboarding://tracks",mimeType:"application/json",data:JSON.stringify(T.listOnboardingTracks(),null,2)})})),j.register(A({meta:{uriTemplate:"onboarding://track/{id}",title:"Onboarding track",description:"Track-specific onboarding metadata and recommended commands.",mimeType:"application/json",tags:w},input:W.object({id:W.string()}),resolve:async({id:Q})=>({uri:`onboarding://track/${Q}`,mimeType:"application/json",data:JSON.stringify(T.getOnboardingTrack(Q)??null,null,2)})})),j.register(A({meta:{uriTemplate:"onboarding://artifacts/{id}{?tracks,example}",title:"Rendered onboarding artifact",description:"Render AGENTS.md or USAGE.md content for the current repo.",mimeType:"text/markdown",tags:w},input:W.object({example:W.string().optional(),id:W.enum(["agent-guide","human-guide"]),tracks:W.string().optional()}),resolve:async({example:Q,id:U,tracks:J})=>{let X=await _({example:Q,tracks:J});return{uri:`onboarding://artifacts/${U}`,mimeType:"text/markdown",data:U==="agent-guide"?X.guides.agentGuide:X.guides.humanGuide}}}))}function m(j){j.register(e({meta:{key:"cli.onboarding",version:"1.0.0",title:"Plan a ContractSpec onboarding flow",description:"Suggest the right onboarding track and artifacts for a repo.",tags:w,stability:"beta",owners:q},args:[{name:"goal",description:"Repository onboarding goal or focus area.",required:!1,schema:W.string().optional()}],input:W.object({goal:W.string().optional()}),render:async({goal:Q})=>[{type:"text",text:`Use onboarding://tracks and onboarding_suggestTracks-v1_0_0 before recommending repo-local ContractSpec adoption steps.${Q?` Goal: ${Q}.`:""}`},{type:"resource",uri:"onboarding://tracks",title:"Tracks"}]}))}function g(j){let Q=D({name:"OnboardingSuggestTracksInput",fields:{example:{type:K.String_unsecure(),isOptional:!0},tracks:{type:K.String_unsecure(),isOptional:!0}}}),U=D({name:"OnboardingSuggestTracksOutput",fields:{nextCommands:{type:K.String_unsecure(),isArray:!0,isOptional:!1},primaryTrack:{type:K.String_unsecure(),isOptional:!1},reason:{type:K.String_unsecure(),isOptional:!1},tracks:{type:K.String_unsecure(),isArray:!0,isOptional:!1}}}),J=D({name:"OnboardingRenderArtifactOutput",fields:{content:{type:K.String_unsecure(),isOptional:!1},primaryTrack:{type:K.String_unsecure(),isOptional:!1}}}),X=D({name:"OnboardingNextCommandOutput",fields:{nextCommand:{type:K.String_unsecure(),isOptional:!1},primaryTrack:{type:K.String_unsecure(),isOptional:!1}}});h(j,I({meta:{key:"onboarding.suggestTracks",version:"1.0.0",stability:"stable",owners:q,tags:w,description:"Suggest the recommended ContractSpec onboarding tracks.",goal:"Help agents choose the right onboarding track before editing repo-local guides.",context:"Used inside the CLI MCP server."},io:{input:Q,output:U},policy:{auth:"anonymous"}}),async({example:Z,tracks:Y})=>{let V=await _({example:Z,tracks:Y});return{nextCommands:V.nextCommands,primaryTrack:V.primaryTrack.id,reason:V.recommendations[0]?.reason??V.primaryTrack.summary,tracks:V.recommendations.map((H)=>H.track.id)}}),h(j,I({meta:{key:"onboarding.renderArtifacts",version:"1.0.0",stability:"stable",owners:q,tags:w,description:"Render onboarding artifacts for the current repo.",goal:"Provide AGENTS.md or USAGE.md content without mutating the repo.",context:"Used inside the CLI MCP server."},io:{input:D({name:"OnboardingRenderArtifactInput",fields:{artifact:{type:K.String_unsecure(),isOptional:!1},example:{type:K.String_unsecure(),isOptional:!0},tracks:{type:K.String_unsecure(),isOptional:!0}}}),output:J},policy:{auth:"anonymous"}}),async({artifact:Z,example:Y,tracks:V})=>{let H=await _({example:Y,tracks:V});return{content:Z==="agent-guide"?H.guides.agentGuide:H.guides.humanGuide,primaryTrack:H.primaryTrack.id}}),h(j,I({meta:{key:"onboarding.nextCommand",version:"1.0.0",stability:"stable",owners:q,tags:w,description:"Return the next recommended CLI command for onboarding.",goal:"Help agents choose the next onboarding command without mutating the repo.",context:"Used inside the CLI MCP server."},io:{input:Q,output:X},policy:{auth:"anonymous"}}),async({example:Z,tracks:Y})=>{let V=await _({example:Z,tracks:Y});return{nextCommand:V.nextCommands[0]??"contractspec onboard",primaryTrack:V.primaryTrack.id}})}var u=["application/json","text/event-stream"];function Qj(j){return!j||j.includes("*/*")||j.includes("application/*")||u.some((Q)=>j.includes(Q))}function N(j){if(j.method!=="POST")return j;let Q=j.headers.get("accept");if(!Qj(Q))return j;let U=u.filter((X)=>!Q?.includes(X));if(U.length===0)return j;let J=new Headers(j.headers);return J.set("accept",[Q,...U].filter(Boolean).join(", ")),new Request(j,{headers:J})}import{createMcpServer as Uj}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as Yj}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as Jj}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as Vj}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as Xj}from"crypto";import{Elysia as Zj}from"elysia";var $j={actor:"anonymous",decide:async()=>({effect:"allow"})};function y(j,Q,U,J){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:Q,message:U,...J?{data:J}:{}},id:null}),{status:j,headers:{"content-type":"application/json"}})}function c({logger:j,serverName:Q,ops:U,resources:J,prompts:X,presentations:Z,stateful:Y}){let V=new Jj({name:Q,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),Uj(V,U,J,X,{logger:j,toolCtx:()=>$j,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new Yj(Z)});let H=new Vj({sessionIdGenerator:Y?()=>Xj():void 0,enableJsonResponse:!0});return V.connect(H).then(()=>({server:V,transport:H}))}async function f(j){await Promise.allSettled([j.transport.close(),j.server.close()])}function Fj(j){return j instanceof Error?j.stack??j.message:String(j)}function d({logger:j,path:Q,serverName:U,ops:J,resources:X,prompts:Z,presentations:Y,validateAuth:V,requiredAuthMethods:H}){j.info("Setting up MCP handler...",{requiredAuthMethods:H??[]});let l=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",z=new Map;async function o($){let F=await c({logger:j,path:Q,serverName:U,ops:J,resources:X,prompts:Z,presentations:Y,stateful:!1});try{return await F.transport.handleRequest(N($))}finally{await f(F)}}async function t($){let F=z.get($);if(!F)return;z.delete($),await f(F)}async function a($){let F=$.headers.get("mcp-session-id"),P,R=!1;if(F){let x=z.get(F);if(!x)return y(404,-32001,"Session not found");P=x}else P=await c({logger:j,path:Q,serverName:U,ops:J,resources:X,prompts:Z,presentations:Y,stateful:!0}),R=!0;try{let x=await P.transport.handleRequest(N($)),B=P.transport.sessionId;if(B&&!z.has(B))z.set(B,P);if($.method==="DELETE"&&B)await t(B);else if(!B&&R)await f(P);return x}catch(x){if(R)await f(P);throw x}}return new Zj({name:`mcp-${U}`}).all(Q,async({request:$})=>{try{if(V){let F=await V($);if(!F.valid)return y(401,-32002,"Authentication failed",F.reason)}if(l)return await a($);return await o($)}catch(F){return j.error("Error handling MCP request",{path:Q,method:$.method,error:Fj(F)}),y(500,-32000,"Internal error")}})}import Kj from"fs/promises";import{defineCommand as Hj,definePrompt as Wj,defineResourceTemplate as i,installOp as Pj,OperationSpecRegistry as wj,PromptRegistry as xj,ResourceRegistry as Bj}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as n,ScalarTypeEnum as b}from"@contractspec/lib.schema";import G from"path";import M from"zod";var __dirname="/home/runner/work/contractspec/contractspec/packages/bundles/library/src/application/mcp",Mj={quickstart:"packages/apps/cli-contractspec/QUICK_START.md",reference:"packages/apps/cli-contractspec/QUICK_REFERENCE.md",readme:"packages/apps/cli-contractspec/README.md"},zj={quickstart:`# ContractSpec CLI quickstart
 
-contractspec create
-contractspec build <spec>
-contractspec validate <spec>`,reference:`# ContractSpec CLI reference
+contractspec quickstart
+contractspec onboard
+contractspec validate`,reference:`# ContractSpec CLI reference
 
-Key commands: create, build, validate. See README for full options.`,readme:`# ContractSpec CLI
+Key commands: onboard, create, generate, validate. See README for full options.`,readme:`# ContractSpec CLI
 
-Stabilize AI-generated code across API, DB, UI, events. Use create/build/validate commands.`},D=["cli","mcp"],y=["@contractspec"],Yj=(()=>{let j=new Set([process.cwd(),z.resolve(process.cwd(),".."),z.resolve(process.cwd(),"../.."),z.resolve(process.cwd(),"../../..")]);if(typeof __dirname==="string")j.add(z.resolve(__dirname,"../../../../.."));return[...j]})(),M=new Map;async function Bj(j){if(M.has(j))return M.get(j);let Q=Qj[j];for(let Y of Yj){let X=z.resolve(Y,Q);try{let Z=await o.readFile(X,"utf8");return M.set(j,Z),Z}catch{}}let U=Uj[j];return M.set(j,U),U}function Jj(){let j=new jj;return j.register(I({meta:{uriTemplate:"cli://doc/{slug}",title:"CLI documentation",description:"Quickstart, reference, and README for the CLI.",mimeType:"text/markdown",tags:D},input:P.object({slug:P.enum(["quickstart","reference","readme"])}),resolve:async({slug:Q})=>{let U=await Bj(Q);return{uri:`cli://doc/${Q}`,mimeType:"text/markdown",data:U}}})),j.register(I({meta:{uriTemplate:"cli://commands",title:"CLI commands summary",description:"Key ContractSpec CLI commands and when to use them.",mimeType:"application/json",tags:D},input:P.object({}),resolve:async()=>{return{uri:"cli://commands",mimeType:"application/json",data:JSON.stringify([{command:"contractspec create",summary:"Interactive wizard to author specs (with optional AI).",doc:"cli://doc/quickstart"},{command:"contractspec build <specPath>",summary:"Generate implementation code from a ContractSpec (agents + templates).",doc:"cli://doc/reference"},{command:"contractspec validate <specPath>",summary:"Validate specs and optionally check implementations against them.",doc:"cli://doc/reference"}],null,2)}}})),j}function Vj(){let j=new e;return j.register(t({meta:{key:"cli.usage",version:"1.0.0",title:"Use ContractSpec CLI safely",description:"Remind agents to read CLI docs and pick commands from the canonical list.",tags:D,stability:"beta",owners:y},args:[{name:"goal",description:"Task the user wants to achieve.",required:!1,schema:P.string().optional()}],input:P.object({goal:P.string().optional()}),render:async({goal:Q})=>[{type:"text",text:`Use CLI commands only from cli://commands. Prefer quickstart for newcomers and reference for options.${Q?` Goal: ${Q}.`:""}`},{type:"resource",uri:"cli://commands",title:"Commands"},{type:"resource",uri:"cli://doc/quickstart",title:"Quickstart"}]})),j}function Xj(){let j=new s,Q=q({name:"CliSuggestInput",fields:{goal:{type:W.String_unsecure(),isOptional:!1},prefersAi:{type:W.Boolean(),isOptional:!0}}}),U=q({name:"CliSuggestOutput",fields:{command:{type:W.String_unsecure(),isOptional:!1},docUri:{type:W.String_unsecure(),isOptional:!1},reason:{type:W.String_unsecure(),isOptional:!1}}}),Y=a({meta:{key:"cli_suggestCommand",version:"1.0.0",stability:"stable",owners:y,tags:D,description:"Recommend a CLI command for the requested goal.",goal:"Help AI agents choose the correct CLI entrypoint quickly.",context:"Used inside the CLI MCP server."},io:{input:Q,output:U},policy:{auth:"anonymous"}});return r(j,Y,async({goal:X,prefersAi:Z})=>{let V=X.toLowerCase();if(V.includes("create")||V.includes("new"))return{command:Z?"contractspec create --ai":"contractspec create",docUri:"cli://doc/quickstart",reason:"Creates a new ContractSpec interactively (optionally with AI)."};if(V.includes("build")||V.includes("generate"))return{command:"contractspec build <path-to-spec>",docUri:"cli://doc/reference",reason:"Builds implementation code from a spec using agents + templates."};if(V.includes("validate")||V.includes("check"))return{command:"contractspec validate <path-to-spec>",docUri:"cli://doc/reference",reason:"Validates a spec and optionally checks its implementation for drift."};return{command:"contractspec --help",docUri:"cli://doc/readme",reason:"Fallback when the goal is unclear; read README for options."}}),j}function _j(j="/api/mcp/cli"){return A({logger:N,path:j,serverName:"contractspec-cli-mcp",ops:Xj(),resources:Jj(),prompts:Vj()})}export{_j as createCliMcpHandler};
+Stabilize AI-generated code across API, DB, UI, events. Use onboard/create/generate/validate commands.`},L=["cli","mcp"],p=["@contractspec"],Dj=(()=>{let j=new Set([process.cwd(),G.resolve(process.cwd(),".."),G.resolve(process.cwd(),"../.."),G.resolve(process.cwd(),"../../..")]);if(typeof __dirname==="string")j.add(G.resolve(__dirname,"../../../../.."));return[...j]})(),E=new Map;async function bj(j){if(E.has(j))return E.get(j);let Q=Mj[j];for(let J of Dj){let X=G.resolve(J,Q);try{let Z=await Kj.readFile(X,"utf8");return E.set(j,Z),Z}catch{}}let U=zj[j];return E.set(j,U),U}function Gj(){let j=new Bj;return j.register(i({meta:{uriTemplate:"cli://doc/{slug}",title:"CLI documentation",description:"Quickstart, reference, and README for the CLI.",mimeType:"text/markdown",tags:L},input:M.object({slug:M.enum(["quickstart","reference","readme"])}),resolve:async({slug:Q})=>{let U=await bj(Q);return{uri:`cli://doc/${Q}`,mimeType:"text/markdown",data:U}}})),j.register(i({meta:{uriTemplate:"cli://commands",title:"CLI commands summary",description:"Key ContractSpec CLI commands and when to use them.",mimeType:"application/json",tags:L},input:M.object({}),resolve:async()=>{return{uri:"cli://commands",mimeType:"application/json",data:JSON.stringify([{command:"contractspec onboard",summary:"Generate repo-local AGENTS.md and USAGE.md guidance plus recommended tracks.",doc:"cli://doc/quickstart"},{command:"contractspec create",summary:"Interactive wizard to author specs (with optional AI).",doc:"cli://doc/quickstart"},{command:"contractspec build <specPath>",summary:"Generate implementation code from a ContractSpec (agents + templates).",doc:"cli://doc/reference"},{command:"contractspec validate <specPath>",summary:"Validate specs and optionally check implementations against them.",doc:"cli://doc/reference"}],null,2)}}})),S(j),j}function qj(){let j=new xj;return j.register(Wj({meta:{key:"cli.usage",version:"1.0.0",title:"Use ContractSpec CLI safely",description:"Remind agents to read CLI docs and pick commands from the canonical list.",tags:L,stability:"beta",owners:p},args:[{name:"goal",description:"Task the user wants to achieve.",required:!1,schema:M.string().optional()}],input:M.object({goal:M.string().optional()}),render:async({goal:Q})=>[{type:"text",text:`Use CLI commands only from cli://commands. Prefer quickstart for newcomers and reference for options.${Q?` Goal: ${Q}.`:""}`},{type:"resource",uri:"cli://commands",title:"Commands"},{type:"resource",uri:"cli://doc/quickstart",title:"Quickstart"}]})),m(j),j}function _j(){let j=new wj,Q=n({name:"CliSuggestInput",fields:{goal:{type:b.String_unsecure(),isOptional:!1},prefersAi:{type:b.Boolean(),isOptional:!0}}}),U=n({name:"CliSuggestOutput",fields:{command:{type:b.String_unsecure(),isOptional:!1},docUri:{type:b.String_unsecure(),isOptional:!1},reason:{type:b.String_unsecure(),isOptional:!1}}}),J=Hj({meta:{key:"cli_suggestCommand",version:"1.0.0",stability:"stable",owners:p,tags:L,description:"Recommend a CLI command for the requested goal.",goal:"Help AI agents choose the correct CLI entrypoint quickly.",context:"Used inside the CLI MCP server."},io:{input:Q,output:U},policy:{auth:"anonymous"}});return Pj(j,J,async({goal:X,prefersAi:Z})=>{let Y=X.toLowerCase();if(Y.includes("onboard")||Y.includes("start")||Y.includes("guide")||Y.includes("install"))return{command:"contractspec onboard",docUri:"cli://doc/quickstart",reason:"Starts the CLI-first onboarding flow for the current repo."};if(Y.includes("create")||Y.includes("new"))return{command:Z?"contractspec create --ai":"contractspec create",docUri:"cli://doc/quickstart",reason:"Creates a new ContractSpec interactively (optionally with AI)."};if(Y.includes("build")||Y.includes("generate"))return{command:"contractspec build <path-to-spec>",docUri:"cli://doc/reference",reason:"Builds implementation code from a spec using agents + templates."};if(Y.includes("validate")||Y.includes("check"))return{command:"contractspec validate <path-to-spec>",docUri:"cli://doc/reference",reason:"Validates a spec and optionally checks its implementation for drift."};return{command:"contractspec --help",docUri:"cli://doc/readme",reason:"Fallback when the goal is unclear; read README for options."}}),g(j),j}function aj(j="/api/mcp/cli"){return d({logger:O,path:j,serverName:"contractspec-cli-mcp",ops:_j(),resources:Gj(),prompts:qj()})}export{aj as createCliMcpHandler};

package/dist/application/mcp/cliMcp.onboarding.d.ts

@@ -0,0 +1,4 @@
+import { type OperationSpecRegistry, type PromptRegistry, type ResourceRegistry } from '@contractspec/lib.contracts-spec';
+export declare function registerCliOnboardingResources(resources: ResourceRegistry): void;
+export declare function registerCliOnboardingPrompts(prompts: PromptRegistry): void;
+export declare function registerCliOnboardingOps(registry: OperationSpecRegistry): void;

package/dist/application/mcp/cliMcp.onboarding.js

@@ -0,0 +1,2 @@
+// @bun
+import{createNodeAdapters as P,onboarding as M}from"@contractspec/bundle.workspace";import{defineCommand as $,definePrompt as h,defineResourceTemplate as C,installOp as W}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as Q,ScalarTypeEnum as v}from"@contractspec/lib.schema";import F from"zod";var H=["cli","mcp","onboarding"],X=["@contractspec"];function b(j){return j?.split(",").map((q)=>q.trim()).filter(Boolean)}async function Y(j={}){let q=P({cwd:process.cwd(),silent:!0});return M.buildOnboardingPlan(q,{forcedExampleKey:j.example,selectedTracks:b(j.tracks)})}function _(j){j.register(C({meta:{uriTemplate:"onboarding://tracks",title:"Onboarding tracks",description:"Primary ContractSpec onboarding tracks exposed by the CLI.",mimeType:"application/json",tags:H},input:F.object({}),resolve:async()=>({uri:"onboarding://tracks",mimeType:"application/json",data:JSON.stringify(M.listOnboardingTracks(),null,2)})})),j.register(C({meta:{uriTemplate:"onboarding://track/{id}",title:"Onboarding track",description:"Track-specific onboarding metadata and recommended commands.",mimeType:"application/json",tags:H},input:F.object({id:F.string()}),resolve:async({id:q})=>({uri:`onboarding://track/${q}`,mimeType:"application/json",data:JSON.stringify(M.getOnboardingTrack(q)??null,null,2)})})),j.register(C({meta:{uriTemplate:"onboarding://artifacts/{id}{?tracks,example}",title:"Rendered onboarding artifact",description:"Render AGENTS.md or USAGE.md content for the current repo.",mimeType:"text/markdown",tags:H},input:F.object({example:F.string().optional(),id:F.enum(["agent-guide","human-guide"]),tracks:F.string().optional()}),resolve:async({example:q,id:U,tracks:Z})=>{let V=await Y({example:q,tracks:Z});return{uri:`onboarding://artifacts/${U}`,mimeType:"text/markdown",data:U==="agent-guide"?V.guides.agentGuide:V.guides.humanGuide}}}))}function I(j){j.register(h({meta:{key:"cli.onboarding",version:"1.0.0",title:"Plan a ContractSpec onboarding flow",description:"Suggest the right onboarding track and artifacts for a repo.",tags:H,stability:"beta",owners:X},args:[{name:"goal",description:"Repository onboarding goal or focus area.",required:!1,schema:F.string().optional()}],input:F.object({goal:F.string().optional()}),render:async({goal:q})=>[{type:"text",text:`Use onboarding://tracks and onboarding_suggestTracks-v1_0_0 before recommending repo-local ContractSpec adoption steps.${q?` Goal: ${q}.`:""}`},{type:"resource",uri:"onboarding://tracks",title:"Tracks"}]}))}function f(j){let q=Q({name:"OnboardingSuggestTracksInput",fields:{example:{type:v.String_unsecure(),isOptional:!0},tracks:{type:v.String_unsecure(),isOptional:!0}}}),U=Q({name:"OnboardingSuggestTracksOutput",fields:{nextCommands:{type:v.String_unsecure(),isArray:!0,isOptional:!1},primaryTrack:{type:v.String_unsecure(),isOptional:!1},reason:{type:v.String_unsecure(),isOptional:!1},tracks:{type:v.String_unsecure(),isArray:!0,isOptional:!1}}}),Z=Q({name:"OnboardingRenderArtifactOutput",fields:{content:{type:v.String_unsecure(),isOptional:!1},primaryTrack:{type:v.String_unsecure(),isOptional:!1}}}),V=Q({name:"OnboardingNextCommandOutput",fields:{nextCommand:{type:v.String_unsecure(),isOptional:!1},primaryTrack:{type:v.String_unsecure(),isOptional:!1}}});W(j,$({meta:{key:"onboarding.suggestTracks",version:"1.0.0",stability:"stable",owners:X,tags:H,description:"Suggest the recommended ContractSpec onboarding tracks.",goal:"Help agents choose the right onboarding track before editing repo-local guides.",context:"Used inside the CLI MCP server."},io:{input:q,output:U},policy:{auth:"anonymous"}}),async({example:J,tracks:K})=>{let w=await Y({example:J,tracks:K});return{nextCommands:w.nextCommands,primaryTrack:w.primaryTrack.id,reason:w.recommendations[0]?.reason??w.primaryTrack.summary,tracks:w.recommendations.map((L)=>L.track.id)}}),W(j,$({meta:{key:"onboarding.renderArtifacts",version:"1.0.0",stability:"stable",owners:X,tags:H,description:"Render onboarding artifacts for the current repo.",goal:"Provide AGENTS.md or USAGE.md content without mutating the repo.",context:"Used inside the CLI MCP server."},io:{input:Q({name:"OnboardingRenderArtifactInput",fields:{artifact:{type:v.String_unsecure(),isOptional:!1},example:{type:v.String_unsecure(),isOptional:!0},tracks:{type:v.String_unsecure(),isOptional:!0}}}),output:Z},policy:{auth:"anonymous"}}),async({artifact:J,example:K,tracks:w})=>{let L=await Y({example:K,tracks:w});return{content:J==="agent-guide"?L.guides.agentGuide:L.guides.humanGuide,primaryTrack:L.primaryTrack.id}}),W(j,$({meta:{key:"onboarding.nextCommand",version:"1.0.0",stability:"stable",owners:X,tags:H,description:"Return the next recommended CLI command for onboarding.",goal:"Help agents choose the next onboarding command without mutating the repo.",context:"Used inside the CLI MCP server."},io:{input:q,output:V},policy:{auth:"anonymous"}}),async({example:J,tracks:K})=>{let w=await Y({example:J,tracks:K});return{nextCommand:w.nextCommands[0]??"contractspec onboard",primaryTrack:w.primaryTrack.id}})}export{_ as registerCliOnboardingResources,I as registerCliOnboardingPrompts,f as registerCliOnboardingOps};

package/dist/application/mcp/cliMcp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/application/mcp/contractsMcp.js

@@ -1,3 +1,3 @@
 // @bun
-import{Logger as N,LogLevel as M}from"@contractspec/lib.logger";function O(){return"production"}var u=()=>new N({level:M.INFO,environment:O(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),T=u(),kj=new N({level:M.WARN,environment:O(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),Fj=new N({level:M.INFO,environment:O(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});var y=["application/json","text/event-stream"];function l(j){return!j||j.includes("*/*")||j.includes("application/*")||y.some((_)=>j.includes(_))}function q(j){if(j.method!=="POST")return j;let _=j.headers.get("accept");if(!l(_))return j;let Q=y.filter((Z)=>!_?.includes(Z));if(Q.length===0)return j;let Y=new Headers(j.headers);return Y.set("accept",[_,...Q].filter(Boolean).join(", ")),new Request(j,{headers:Y})}import{createMcpServer as n}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as c}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as i}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as p}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as o}from"crypto";import{Elysia as a}from"elysia";var t={actor:"anonymous",decide:async()=>({effect:"allow"})};function f(j,_,Q,Y){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:_,message:Q,...Y?{data:Y}:{}},id:null}),{status:j,headers:{"content-type":"application/json"}})}function h({logger:j,serverName:_,ops:Q,resources:Y,prompts:Z,presentations:B,stateful:$}){let K=new i({name:_,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),n(K,Q,Y,Z,{logger:j,toolCtx:()=>t,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new c(B)});let x=new p({sessionIdGenerator:$?()=>o():void 0,enableJsonResponse:!0});return K.connect(x).then(()=>({server:K,transport:x}))}async function R(j){await Promise.allSettled([j.transport.close(),j.server.close()])}function r(j){return j instanceof Error?j.stack??j.message:String(j)}function v({logger:j,path:_,serverName:Q,ops:Y,resources:Z,prompts:B,presentations:$,validateAuth:K,requiredAuthMethods:x}){j.info("Setting up MCP handler...",{requiredAuthMethods:x??[]});let I=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",k=new Map;async function D(F){let J=await h({logger:j,path:_,serverName:Q,ops:Y,resources:Z,prompts:B,presentations:$,stateful:!1});try{return await J.transport.handleRequest(q(F))}finally{await R(J)}}async function G(F){let J=k.get(F);if(!J)return;k.delete(F),await R(J)}async function d(F){let J=F.headers.get("mcp-session-id"),P,L=!1;if(J){let H=k.get(J);if(!H)return f(404,-32001,"Session not found");P=H}else P=await h({logger:j,path:_,serverName:Q,ops:Y,resources:Z,prompts:B,presentations:$,stateful:!0}),L=!0;try{let H=await P.transport.handleRequest(q(F)),V=P.transport.sessionId;if(V&&!k.has(V))k.set(V,P);if(F.method==="DELETE"&&V)await G(V);else if(!V&&L)await R(P);return H}catch(H){if(L)await R(P);throw H}}return new a({name:`mcp-${Q}`}).all(_,async({request:F})=>{try{if(K){let J=await K(F);if(!J.valid)return f(401,-32002,"Authentication failed",J.reason)}if(I)return await d(F);return await D(F)}catch(J){return j.error("Error handling MCP request",{path:_,method:F.method,error:r(J)}),f(500,-32000,"Internal error")}})}import{definePrompt as s,defineResourceTemplate as E,PromptRegistry as e,ResourceRegistry as jj}from"@contractspec/lib.contracts-spec";import U from"zod";var _j=["@contractspec"],A=["contracts","mcp"];function g(j){let _=new jj;return _.register(E({meta:{uriTemplate:"contracts://list",title:"Contract specs list",description:"JSON list of all contract specs in the workspace.",mimeType:"application/json",tags:A},input:U.object({}),resolve:async()=>{let Q=await j.listSpecs();return{uri:"contracts://list",mimeType:"application/json",data:JSON.stringify(Q,null,2)}}})),_.register(E({meta:{uriTemplate:"contracts://spec/{path}",title:"Contract spec content",description:"Read a single contract spec file by path.",mimeType:"text/plain",tags:A},input:U.object({path:U.string()}),resolve:async({path:Q})=>{let Y=await j.getSpec(Q);if(!Y)return{uri:`contracts://spec/${encodeURIComponent(Q)}`,mimeType:"text/plain",data:`Spec not found: ${Q}`};return{uri:`contracts://spec/${encodeURIComponent(Q)}`,mimeType:"text/plain",data:Y.content}}})),_.register(E({meta:{uriTemplate:"contracts://registry/manifest",title:"Remote registry manifest",description:"Contract registry manifest from the remote server.",mimeType:"application/json",tags:A},input:U.object({}),resolve:async()=>{let Q=await j.fetchRegistryManifest();return{uri:"contracts://registry/manifest",mimeType:"application/json",data:JSON.stringify(Q,null,2)}}})),_}function S(){let j=new e;return j.register(s({meta:{key:"contracts.editor",version:"1.0.0",title:"Contract editing guide",description:"Guide AI agents through reading, editing, and validating contracts.",tags:A,stability:"beta",owners:_j},args:[{name:"goal",description:"What the agent wants to achieve with the contract.",required:!1,schema:U.string().optional()}],input:U.object({goal:U.string().optional()}),render:async({goal:_})=>[{type:"text",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",_?`Agent goal: ${_}`:""].filter(Boolean).join(`
-`)},{type:"resource",uri:"contracts://list",title:"Available contracts"}]})),j}import{defineCommand as z,installOp as C,OperationSpecRegistry as wj}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as X,ScalarTypeEnum as w}from"@contractspec/lib.schema";var W=["@contractspec"],b=["contracts","mcp"];function m(j){let _=new wj,Q=X({name:"ContractsListInput",fields:{pattern:{type:w.String_unsecure(),isOptional:!0},type:{type:w.String_unsecure(),isOptional:!0}}}),Y=X({name:"ContractsListOutput",fields:{specs:{type:w.JSON(),isOptional:!1},total:{type:w.Int_unsecure(),isOptional:!1}}});C(_,z({meta:{key:"contracts.list",version:"1.0.0",stability:"beta",owners:W,tags:b,description:"List contract specs in the workspace.",goal:"Discover available contracts by type, pattern, or owner.",context:"Contracts MCP server."},io:{input:Q,output:Y},policy:{auth:"anonymous"}}),async({pattern:k,type:D})=>{let G=await j.listSpecs({pattern:k,type:D});return{specs:G,total:G.length}});let Z=X({name:"ContractsGetInput",fields:{path:{type:w.String_unsecure(),isOptional:!1}}}),B=X({name:"ContractsGetOutput",fields:{content:{type:w.String_unsecure(),isOptional:!1},info:{type:w.JSON(),isOptional:!1}}});C(_,z({meta:{key:"contracts.get",version:"1.0.0",stability:"beta",owners:W,tags:b,description:"Read a single contract spec file.",goal:"Fetch spec content and parsed metadata.",context:"Contracts MCP server."},io:{input:Z,output:B},policy:{auth:"anonymous"}}),async({path:k})=>{let D=await j.getSpec(k);if(!D)throw Error(`Spec not found: ${k}`);return D});let $=X({name:"ContractsValidateInput",fields:{path:{type:w.String_unsecure(),isOptional:!1}}}),K=X({name:"ContractsValidateOutput",fields:{valid:{type:w.Boolean(),isOptional:!1},errors:{type:w.JSON(),isOptional:!1},warnings:{type:w.JSON(),isOptional:!1}}});C(_,z({meta:{key:"contracts.validate",version:"1.0.0",stability:"beta",owners:W,tags:b,description:"Validate a contract spec structure.",goal:"Check spec for structural or policy issues.",context:"Contracts MCP server."},io:{input:$,output:K},policy:{auth:"anonymous"}}),async({path:k})=>j.validateSpec(k));let x=X({name:"ContractsBuildInput",fields:{path:{type:w.String_unsecure(),isOptional:!1},dryRun:{type:w.Boolean(),isOptional:!0}}}),I=X({name:"ContractsBuildOutput",fields:{results:{type:w.JSON(),isOptional:!1}}});return C(_,z({meta:{key:"contracts.build",version:"1.0.0",stability:"beta",owners:W,tags:b,description:"Generate implementation code from a contract spec.",goal:"Produce handler, component, or test skeletons.",context:"Contracts MCP server."},io:{input:x,output:I},policy:{auth:"user"}}),async({path:k,dryRun:D})=>j.buildSpec(k,{dryRun:D})),Qj(_,j),_}function Qj(j,_){let Q=X({name:"ContractsUpdateInput",fields:{path:{type:w.String_unsecure(),isOptional:!1},content:{type:w.String_unsecure(),isOptional:!0},fields:{type:w.JSON(),isOptional:!0}}}),Y=X({name:"ContractsUpdateOutput",fields:{updated:{type:w.Boolean(),isOptional:!1},errors:{type:w.JSON(),isOptional:!1},warnings:{type:w.JSON(),isOptional:!1}}});C(j,z({meta:{key:"contracts.update",version:"1.0.0",stability:"beta",owners:W,tags:b,description:"Update an existing contract spec.",goal:"Modify spec content or individual fields with validation.",context:"Contracts MCP server."},io:{input:Q,output:Y},policy:{auth:"user"}}),async({path:$,content:K,fields:x})=>_.updateSpec($,{content:K,fields:Array.isArray(x)?x:void 0}));let Z=X({name:"ContractsDeleteInput",fields:{path:{type:w.String_unsecure(),isOptional:!1},clean:{type:w.Boolean(),isOptional:!0}}}),B=X({name:"ContractsDeleteOutput",fields:{deleted:{type:w.Boolean(),isOptional:!1},cleanedFiles:{type:w.JSON(),isOptional:!1},errors:{type:w.JSON(),isOptional:!1}}});C(j,z({meta:{key:"contracts.delete",version:"1.0.0",stability:"beta",owners:W,tags:b,description:"Delete a contract spec and optionally its artifacts.",goal:"Remove a spec file and clean generated handlers/tests.",context:"Contracts MCP server."},io:{input:Z,output:B},policy:{auth:"user"}}),async({path:$,clean:K})=>_.deleteSpec($,{clean:K}))}function Lj(j="/api/mcp/contracts",_){return v({logger:T,path:j,serverName:"contractspec-contracts-mcp",ops:m(_),resources:g(_),prompts:S()})}export{Lj as createContractsMcpHandler};
+import{Logger as O,LogLevel as E}from"@contractspec/lib.logger";function f(){return"production"}var a=()=>new O({level:E.INFO,environment:f(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),d=a(),xj=new O({level:E.WARN,environment:f(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),Bj=new O({level:E.INFO,environment:f(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});var m=["application/json","text/event-stream"];function t(j){return!j||j.includes("*/*")||j.includes("application/*")||m.some((_)=>j.includes(_))}function T(j){if(j.method!=="POST")return j;let _=j.headers.get("accept");if(!t(_))return j;let w=m.filter((Z)=>!_?.includes(Z));if(w.length===0)return j;let Y=new Headers(j.headers);return Y.set("accept",[_,...w].filter(Boolean).join(", ")),new Request(j,{headers:Y})}import{createMcpServer as r}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as s}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as e}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as jj}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as _j}from"crypto";import{Elysia as wj}from"elysia";var Qj={actor:"anonymous",decide:async()=>({effect:"allow"})};function h(j,_,w,Y){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:_,message:w,...Y?{data:Y}:{}},id:null}),{status:j,headers:{"content-type":"application/json"}})}function u({logger:j,serverName:_,ops:w,resources:Y,prompts:Z,presentations:D,stateful:$}){let F=new e({name:_,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),r(F,w,Y,Z,{logger:j,toolCtx:()=>Qj,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new s(D)});let J=new jj({sessionIdGenerator:$?()=>_j():void 0,enableJsonResponse:!0});return F.connect(J).then(()=>({server:F,transport:J}))}async function M(j){await Promise.allSettled([j.transport.close(),j.server.close()])}function Yj(j){return j instanceof Error?j.stack??j.message:String(j)}function l({logger:j,path:_,serverName:w,ops:Y,resources:Z,prompts:D,presentations:$,validateAuth:F,requiredAuthMethods:J}){j.info("Setting up MCP handler...",{requiredAuthMethods:J??[]});let H=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",k=new Map;async function P(K){let X=await u({logger:j,path:_,serverName:w,ops:Y,resources:Z,prompts:D,presentations:$,stateful:!1});try{return await X.transport.handleRequest(T(K))}finally{await M(X)}}async function z(K){let X=k.get(K);if(!X)return;k.delete(K),await M(X)}async function o(K){let X=K.headers.get("mcp-session-id"),V,q=!1;if(X){let C=k.get(X);if(!C)return h(404,-32001,"Session not found");V=C}else V=await u({logger:j,path:_,serverName:w,ops:Y,resources:Z,prompts:D,presentations:$,stateful:!0}),q=!0;try{let C=await V.transport.handleRequest(T(K)),W=V.transport.sessionId;if(W&&!k.has(W))k.set(W,V);if(K.method==="DELETE"&&W)await z(W);else if(!W&&q)await M(V);return C}catch(C){if(q)await M(V);throw C}}return new wj({name:`mcp-${w}`}).all(_,async({request:K})=>{try{if(F){let X=await F(K);if(!X.valid)return h(401,-32002,"Authentication failed",X.reason)}if(H)return await o(K);return await P(K)}catch(X){return j.error("Error handling MCP request",{path:_,method:K.method,error:Yj(X)}),h(500,-32000,"Internal error")}})}import{definePrompt as kj,defineResourceTemplate as A,PromptRegistry as Fj,ResourceRegistry as Jj}from"@contractspec/lib.contracts-spec";import U from"zod";var Kj=["@contractspec"],b=["contracts","mcp"];function n(j){let _=new Jj;return _.register(A({meta:{uriTemplate:"contracts://list",title:"Contract specs list",description:"JSON list of all contract specs in the workspace.",mimeType:"application/json",tags:b},input:U.object({}),resolve:async()=>{let w=await j.listSpecs();return{uri:"contracts://list",mimeType:"application/json",data:JSON.stringify(w,null,2)}}})),_.register(A({meta:{uriTemplate:"contracts://spec/{path}",title:"Contract spec content",description:"Read a single contract spec file by path.",mimeType:"text/plain",tags:b},input:U.object({path:U.string()}),resolve:async({path:w})=>{let Y=await j.getSpec(w);if(!Y)return{uri:`contracts://spec/${encodeURIComponent(w)}`,mimeType:"text/plain",data:`Spec not found: ${w}`};return{uri:`contracts://spec/${encodeURIComponent(w)}`,mimeType:"text/plain",data:Y.content}}})),_.register(A({meta:{uriTemplate:"contracts://registry/manifest",title:"Remote registry manifest",description:"Contract registry manifest from the remote server.",mimeType:"application/json",tags:b},input:U.object({}),resolve:async()=>{let w=await j.fetchRegistryManifest();return{uri:"contracts://registry/manifest",mimeType:"application/json",data:JSON.stringify(w,null,2)}}})),_.register(A({meta:{uriTemplate:"adoption://catalog",title:"ContractSpec adoption catalog",description:"Bundled ContractSpec adoption catalog used by Connect and MCP.",mimeType:"application/json",tags:b},input:U.object({}),resolve:async()=>{let w=await j.searchAdoptionCatalog({query:"contractspec"});return{uri:"adoption://catalog",mimeType:"application/json",data:JSON.stringify(w,null,2)}}})),_.register(A({meta:{uriTemplate:"adoption://policy/{family}",title:"ContractSpec adoption policy",description:"Family-aware adoption recommendation and verdict policy.",mimeType:"application/json",tags:b},input:U.object({family:U.string()}),resolve:async({family:w})=>{let Y=await j.resolveAdoption({family:w,query:w});return{uri:`adoption://policy/${encodeURIComponent(w)}`,mimeType:"application/json",data:JSON.stringify(Y,null,2)}}})),_}function c(){let j=new Fj;return j.register(kj({meta:{key:"contracts.editor",version:"1.0.0",title:"Contract editing guide",description:"Guide AI agents through reading, editing, and validating contracts.",tags:b,stability:"beta",owners:Kj},args:[{name:"goal",description:"What the agent wants to achieve with the contract.",required:!1,schema:U.string().optional()}],input:U.object({goal:U.string().optional()}),render:async({goal:_})=>[{type:"text",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","6. Use adoption.resolve to prefer existing workspace or ContractSpec surfaces before inventing new ones",_?`Agent goal: ${_}`:""].filter(Boolean).join(`
+`)},{type:"resource",uri:"contracts://list",title:"Available contracts"}]})),j}import{defineCommand as v,installOp as g}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as G,ScalarTypeEnum as x}from"@contractspec/lib.schema";var y=["@contractspec"],S=["contracts","mcp","adoption"];function i(j,_){let w=G({name:"AdoptionCatalogSearchInput",fields:{query:{type:x.String_unsecure(),isOptional:!1},family:{type:x.String_unsecure(),isOptional:!0},platform:{type:x.String_unsecure(),isOptional:!0}}}),Y=G({name:"AdoptionCatalogSearchOutput",fields:{results:{type:x.JSON(),isOptional:!1}}});g(j,v({meta:{key:"adoption.catalog_search",version:"1.0.0",stability:"beta",owners:y,tags:S,description:"Search the local ContractSpec adoption catalog.",goal:"Find relevant ContractSpec reuse candidates for a query.",context:"Contracts MCP server."},io:{input:w,output:Y},policy:{auth:"anonymous"}}),async({family:J,platform:H,query:k})=>({results:await _.searchAdoptionCatalog({family:J,platform:H,query:k})}));let Z=G({name:"AdoptionResolveInput",fields:{family:{type:x.String_unsecure(),isOptional:!1},query:{type:x.String_unsecure(),isOptional:!1},paths:{type:x.JSON(),isOptional:!0},platform:{type:x.String_unsecure(),isOptional:!0},runtime:{type:x.String_unsecure(),isOptional:!0}}}),D=G({name:"AdoptionResolveOutput",fields:{resolution:{type:x.JSON(),isOptional:!1}}});g(j,v({meta:{key:"adoption.resolve",version:"1.0.0",stability:"beta",owners:y,tags:S,description:"Resolve the best adoption candidate for one family.",goal:"Provide one ordered recommendation that matches Connect.",context:"Contracts MCP server."},io:{input:Z,output:D},policy:{auth:"anonymous"}}),async({family:J,paths:H,platform:k,query:P,runtime:z})=>({resolution:await _.resolveAdoption({family:J,paths:Array.isArray(H)?H:void 0,platform:k,query:P,runtime:z})}));let $=G({name:"AdoptionSyncInput",fields:{}}),F=G({name:"AdoptionSyncOutput",fields:{catalogPath:{type:x.String_unsecure(),isOptional:!1},total:{type:x.Int_unsecure(),isOptional:!1}}});g(j,v({meta:{key:"adoption.sync",version:"1.0.0",stability:"beta",owners:y,tags:S,description:"Mirror the bundled ContractSpec adoption catalog locally.",goal:"Refresh the local adoption catalog used by Connect and MCP.",context:"Contracts MCP server."},io:{input:$,output:F},policy:{auth:"user"}}),async()=>_.syncAdoptionCatalog())}import{defineCommand as L,installOp as I,OperationSpecRegistry as Xj}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as B,ScalarTypeEnum as Q}from"@contractspec/lib.schema";var N=["@contractspec"],R=["contracts","mcp"];function p(j){let _=new Xj,w=B({name:"ContractsListInput",fields:{pattern:{type:Q.String_unsecure(),isOptional:!0},type:{type:Q.String_unsecure(),isOptional:!0}}}),Y=B({name:"ContractsListOutput",fields:{specs:{type:Q.JSON(),isOptional:!1},total:{type:Q.Int_unsecure(),isOptional:!1}}});I(_,L({meta:{key:"contracts.list",version:"1.0.0",stability:"beta",owners:N,tags:R,description:"List contract specs in the workspace.",goal:"Discover available contracts by type, pattern, or owner.",context:"Contracts MCP server."},io:{input:w,output:Y},policy:{auth:"anonymous"}}),async({pattern:k,type:P})=>{let z=await j.listSpecs({pattern:k,type:P});return{specs:z,total:z.length}});let Z=B({name:"ContractsGetInput",fields:{path:{type:Q.String_unsecure(),isOptional:!1}}}),D=B({name:"ContractsGetOutput",fields:{content:{type:Q.String_unsecure(),isOptional:!1},info:{type:Q.JSON(),isOptional:!1}}});I(_,L({meta:{key:"contracts.get",version:"1.0.0",stability:"beta",owners:N,tags:R,description:"Read a single contract spec file.",goal:"Fetch spec content and parsed metadata.",context:"Contracts MCP server."},io:{input:Z,output:D},policy:{auth:"anonymous"}}),async({path:k})=>{let P=await j.getSpec(k);if(!P)throw Error(`Spec not found: ${k}`);return P});let $=B({name:"ContractsValidateInput",fields:{path:{type:Q.String_unsecure(),isOptional:!1}}}),F=B({name:"ContractsValidateOutput",fields:{valid:{type:Q.Boolean(),isOptional:!1},errors:{type:Q.JSON(),isOptional:!1},warnings:{type:Q.JSON(),isOptional:!1}}});I(_,L({meta:{key:"contracts.validate",version:"1.0.0",stability:"beta",owners:N,tags:R,description:"Validate a contract spec structure.",goal:"Check spec for structural or policy issues.",context:"Contracts MCP server."},io:{input:$,output:F},policy:{auth:"anonymous"}}),async({path:k})=>j.validateSpec(k));let J=B({name:"ContractsBuildInput",fields:{path:{type:Q.String_unsecure(),isOptional:!1},dryRun:{type:Q.Boolean(),isOptional:!0}}}),H=B({name:"ContractsBuildOutput",fields:{results:{type:Q.JSON(),isOptional:!1}}});return I(_,L({meta:{key:"contracts.build",version:"1.0.0",stability:"beta",owners:N,tags:R,description:"Generate implementation code from a contract spec.",goal:"Produce handler, component, or test skeletons.",context:"Contracts MCP server."},io:{input:J,output:H},policy:{auth:"user"}}),async({path:k,dryRun:P})=>j.buildSpec(k,{dryRun:P})),Zj(_,j),i(_,j),_}function Zj(j,_){let w=B({name:"ContractsUpdateInput",fields:{path:{type:Q.String_unsecure(),isOptional:!1},content:{type:Q.String_unsecure(),isOptional:!0},fields:{type:Q.JSON(),isOptional:!0}}}),Y=B({name:"ContractsUpdateOutput",fields:{updated:{type:Q.Boolean(),isOptional:!1},errors:{type:Q.JSON(),isOptional:!1},warnings:{type:Q.JSON(),isOptional:!1}}});I(j,L({meta:{key:"contracts.update",version:"1.0.0",stability:"beta",owners:N,tags:R,description:"Update an existing contract spec.",goal:"Modify spec content or individual fields with validation.",context:"Contracts MCP server."},io:{input:w,output:Y},policy:{auth:"user"}}),async({path:$,content:F,fields:J})=>_.updateSpec($,{content:F,fields:Array.isArray(J)?J:void 0}));let Z=B({name:"ContractsDeleteInput",fields:{path:{type:Q.String_unsecure(),isOptional:!1},clean:{type:Q.Boolean(),isOptional:!0}}}),D=B({name:"ContractsDeleteOutput",fields:{deleted:{type:Q.Boolean(),isOptional:!1},cleanedFiles:{type:Q.JSON(),isOptional:!1},errors:{type:Q.JSON(),isOptional:!1}}});I(j,L({meta:{key:"contracts.delete",version:"1.0.0",stability:"beta",owners:N,tags:R,description:"Delete a contract spec and optionally its artifacts.",goal:"Remove a spec file and clean generated handlers/tests.",context:"Contracts MCP server."},io:{input:Z,output:D},policy:{auth:"user"}}),async({path:$,clean:F})=>_.deleteSpec($,{clean:F}))}function yj(j="/api/mcp/contracts",_){return l({logger:d,path:j,serverName:"contractspec-contracts-mcp",ops:p(_),resources:n(_),prompts:c()})}export{yj as createContractsMcpHandler};

package/dist/application/mcp/contractsMcp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/application/mcp/contractsMcpAdoptionTools.d.ts

@@ -0,0 +1,3 @@
+import { type OperationSpecRegistry } from '@contractspec/lib.contracts-spec';
+import type { ContractsMcpServices } from './contractsMcpTypes';
+export declare function registerAdoptionOps(registry: OperationSpecRegistry, services: ContractsMcpServices): void;

package/dist/application/mcp/contractsMcpAdoptionTools.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineCommand as F,installOp as H}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as k,ScalarTypeEnum as j}from"@contractspec/lib.schema";var J=["@contractspec"],K=["contracts","mcp","adoption"];function b(x,z){let L=k({name:"AdoptionCatalogSearchInput",fields:{query:{type:j.String_unsecure(),isOptional:!1},family:{type:j.String_unsecure(),isOptional:!0},platform:{type:j.String_unsecure(),isOptional:!0}}}),P=k({name:"AdoptionCatalogSearchOutput",fields:{results:{type:j.JSON(),isOptional:!1}}});H(x,F({meta:{key:"adoption.catalog_search",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"Search the local ContractSpec adoption catalog.",goal:"Find relevant ContractSpec reuse candidates for a query.",context:"Contracts MCP server."},io:{input:L,output:P},policy:{auth:"anonymous"}}),async({family:B,platform:w,query:D})=>({results:await z.searchAdoptionCatalog({family:B,platform:w,query:D})}));let Q=k({name:"AdoptionResolveInput",fields:{family:{type:j.String_unsecure(),isOptional:!1},query:{type:j.String_unsecure(),isOptional:!1},paths:{type:j.JSON(),isOptional:!0},platform:{type:j.String_unsecure(),isOptional:!0},runtime:{type:j.String_unsecure(),isOptional:!0}}}),U=k({name:"AdoptionResolveOutput",fields:{resolution:{type:j.JSON(),isOptional:!1}}});H(x,F({meta:{key:"adoption.resolve",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"Resolve the best adoption candidate for one family.",goal:"Provide one ordered recommendation that matches Connect.",context:"Contracts MCP server."},io:{input:Q,output:U},policy:{auth:"anonymous"}}),async({family:B,paths:w,platform:D,query:Y,runtime:Z})=>({resolution:await z.resolveAdoption({family:B,paths:Array.isArray(w)?w:void 0,platform:D,query:Y,runtime:Z})}));let V=k({name:"AdoptionSyncInput",fields:{}}),X=k({name:"AdoptionSyncOutput",fields:{catalogPath:{type:j.String_unsecure(),isOptional:!1},total:{type:j.Int_unsecure(),isOptional:!1}}});H(x,F({meta:{key:"adoption.sync",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"Mirror the bundled ContractSpec adoption catalog locally.",goal:"Refresh the local adoption catalog used by Connect and MCP.",context:"Contracts MCP server."},io:{input:V,output:X},policy:{auth:"user"}}),async()=>z.syncAdoptionCatalog())}export{b as registerAdoptionOps};