@contractspec/bundle.library 3.8.12 → 3.9.2

package/CHANGELOG.md

@@ -1,5 +1,102 @@
 # @contractspec/bundle.library
 
+## 3.9.2
+
+### Patch Changes
+
+- Restore the public web-landing templates and examples surfaces so non-internal examples render in the templates catalog, docs routes, sitemap, and sandbox fallback previews.
+  - Packages: @contractspec/module.examples (minor), @contractspec/bundle.marketing (patch), @contractspec/bundle.library (patch), @contractspec/app.web-landing (patch)
+- Updated dependencies because of chore: auto-bump internal dependents
+- Updated dependencies because of Add focused design-system subpaths and harden ThemeSpec runtime, Tailwind bridge, form-control helpers, and form renderer internals without changing root-import compatibility.
+- Updated dependencies because of Add a ThemeSpec-aware and TranslationSpec-aware design-system form/control layer with stack primitives, exported control wrappers, and FormSpec renderer alignment.
+- Updated dependencies because of Add FormSpec layout hints, semantic field rendering, and portable text/textarea input-group addons.
+- Updated dependencies because of Keep design-system FormRender mobile-safe by preserving shared renderer imports for Metro aliases and hardening generated package artifacts.
+- Updated dependencies because of Restore the public web-landing templates and examples surfaces so non-internal examples render in the templates catalog, docs routes, sitemap, and sandbox fallback previews.
+- Updated dependencies because of Add ThemeSpec light/dark modes and a design-system Tailwind bridge for CSS variables, presets, CSS text, and OKLCH color pass-through.
+- Updated dependencies because of Add a canonical typed result system for ContractSpec success and failure propagation across operations, workflows, jobs, server adapters, MCP, GraphQL, and React clients.
+  - @contractspec/bundle.workspace@4.5.1
+  - @contractspec/lib.ai-providers@3.7.14
+  - @contractspec/lib.content-gen@3.7.21
+  - @contractspec/lib.contracts-integrations@3.8.13
+  - @contractspec/lib.contracts-library@3.7.21
+  - @contractspec/lib.example-shared-ui@6.0.22
+  - @contractspec/lib.knowledge@3.7.21
+  - @contractspec/lib.logger@3.7.14
+  - @contractspec/lib.provider-ranking@0.7.14
+  - @contractspec/lib.runtime-sandbox@2.7.15
+  - @contractspec/lib.surface-runtime@0.5.21
+  - @contractspec/lib.ui-link@3.7.16
+  - @contractspec/module.context-storage@0.7.20
+  - @contractspec/lib.design-system@3.11.0
+  - @contractspec/lib.contracts-spec@5.5.0
+  - @contractspec/lib.contracts-runtime-client-react@3.10.0
+  - @contractspec/lib.ui-kit-web@3.10.3
+  - @contractspec/module.examples@3.10.0
+  - @contractspec/lib.contracts-runtime-server-rest@3.8.0
+  - @contractspec/lib.contracts-runtime-server-graphql@3.8.0
+  - @contractspec/lib.contracts-runtime-server-mcp@3.8.0
+  - @contractspec/lib.schema@3.7.14
+
+## 3.9.1
+
+### Patch Changes
+
+- Add a dedicated cross-platform UI docs page that explains how the React, React Native, runtime, primitive UI, and design-system layers stay compatible.
+  - Packages: @contractspec/bundle.library (patch)
+- Updated dependencies because of chore: auto-bump internal dependents
+  - @contractspec/lib.contracts-runtime-client-react@3.9.2
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.21
+  - @contractspec/lib.design-system@3.10.1
+  - @contractspec/lib.example-shared-ui@6.0.21
+  - @contractspec/lib.ui-kit-web@3.10.2
+  - @contractspec/module.examples@3.9.1
+
+## 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

package/dist/application/context-storage/index.js

@@ -1,2 +1,2 @@
 // @bun
-import{EmbeddingService as y,VectorIndexer as z}from"@contractspec/lib.knowledge/ingestion";import{ContextSnapshotPipeline as A,PostgresContextStorage as B}from"@contractspec/module.context-storage";function H(f){let j=new B({database:f.database,schema:f.schema,createTablesIfMissing:f.createTablesIfMissing}),k=f.embeddingProvider?new y(f.embeddingProvider,f.embeddingBatchSize):void 0,q=f.vectorStoreProvider&&f.vectorIndex?new z(f.vectorStoreProvider,f.vectorIndex):void 0,w=new A({store:j,documentProcessor:f.documentProcessor,embeddingService:k,vectorIndexer:q});return{store:j,pipeline:w}}export{H as createContextStorageService};
+var y=Object.defineProperty;var z=(f)=>f;function A(f,j){this[f]=z.bind(null,j)}var H=(f,j)=>{for(var k in j)y(f,k,{get:j[k],enumerable:!0,configurable:!0,set:A.bind(j,k)})};var J=(f,j)=>()=>(f&&(j=f(f=0)),j);import{EmbeddingService as B,VectorIndexer as D}from"@contractspec/lib.knowledge/ingestion";import{ContextSnapshotPipeline as F,PostgresContextStorage as G}from"@contractspec/module.context-storage";function O(f){let j=new G({database:f.database,schema:f.schema,createTablesIfMissing:f.createTablesIfMissing}),k=f.embeddingProvider?new B(f.embeddingProvider,f.embeddingBatchSize):void 0,q=f.vectorStoreProvider&&f.vectorIndex?new D(f.vectorStoreProvider,f.vectorIndex):void 0,w=new F({store:j,documentProcessor:f.documentProcessor,embeddingService:k,vectorIndexer:q});return{store:j,pipeline:w}}export{O as createContextStorageService};

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
+var LY=Object.defineProperty;var qY=(j)=>j;function _Y(j,Y){this[j]=qY.bind(null,Y)}var yJ=(j,Y)=>{for(var J in Y)LY(j,J,{get:Y[J],enumerable:!0,configurable:!0,set:_Y.bind(Y,J)})};var mJ=(j,Y)=>()=>(j&&(Y=j(j=0)),Y);import{EmbeddingService as MY,VectorIndexer as bY}from"@contractspec/lib.knowledge/ingestion";import{ContextSnapshotPipeline as GY,PostgresContextStorage as DY}from"@contractspec/module.context-storage";function lJ(j){let Y=new DY({database:j.database,schema:j.schema,createTablesIfMissing:j.createTablesIfMissing}),J=j.embeddingProvider?new MY(j.embeddingProvider,j.embeddingBatchSize):void 0,Q=j.vectorStoreProvider&&j.vectorIndex?new bY(j.vectorStoreProvider,j.vectorIndex):void 0,$=new GY({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 CY=()=>new Dj({level:Cj.INFO,environment:Aj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),D=CY(),iJ=new Dj({level:Cj.WARN,environment:Aj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),oJ=new Dj({level:Cj.INFO,environment:Aj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});import{createNodeAdapters as AY,onboarding as Ej}from"@contractspec/bundle.workspace";import{defineCommand as Nj,definePrompt as NY,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 IY(j){return j?.split(",").map((Y)=>Y.trim()).filter(Boolean)}async function $j(j={}){let Y=AY({cwd:process.cwd(),silent:!0});return Ej.buildOnboardingPlan(Y,{forcedExampleKey:j.example,selectedTracks:IY(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(NY({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 zY(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(!zY(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 EY}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as kY}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as vY}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as OY}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as RY}from"crypto";import{Elysia as hY}from"elysia";var TY={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 vY({name:Y,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),EY(U,J,Q,$,{logger:j,toolCtx:()=>TY,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new kY(Z)});let V=new OY({sessionIdGenerator:X?()=>RY():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 fY(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 hY({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:fY(x)}),vj(500,-32000,"Internal error")}})}import SY from"fs/promises";import{defineCommand as yY,definePrompt as mY,defineResourceTemplate as oj,installOp as gY,OperationSpecRegistry as uY,PromptRegistry as dY,ResourceRegistry as pY}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",lY={quickstart:"packages/apps/cli-contractspec/QUICK_START.md",reference:"packages/apps/cli-contractspec/QUICK_REFERENCE.md",readme:"packages/apps/cli-contractspec/README.md"},nY={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"],cY=(()=>{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 iY(j){if(Uj.has(j))return Uj.get(j);let Y=lY[j];for(let Q of cY){let $=t.resolve(Q,Y);try{let Z=await SY.readFile($,"utf8");return Uj.set(j,Z),Z}catch{}}let J=nY[j];return Uj.set(j,J),J}function oY(){let j=new pY;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 iY(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 aY(){let j=new dY;return j.register(mY({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 tY(){let j=new uY,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=yY({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 gY(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 qQ(j="/api/mcp/cli"){return A({logger:D,path:j,serverName:"contractspec-cli-mcp",ops:tY(),resources:oY(),prompts:aY()})}import{definePrompt as sY,defineResourceTemplate as s,PromptRegistry as rY,ResourceRegistry as eY}from"@contractspec/lib.contracts-spec";import N from"zod";var j0=["@contractspec"],f=["contracts","mcp"];function sj(j){let Y=new eY;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 rY;return j.register(sY({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:j0},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 Y0}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 Y0,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})),J0(Y,j),ej(Y,j),Y}function J0(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 hQ(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 Q0}from"@contractspec/lib.contracts-spec/docs";var Z0=20,$0=100;function _(j){return j?.trim().toLowerCase()??""}function YY(j){let Y=decodeURIComponent(j).trim();if(!Y)return"/";return Y.startsWith("/")?Y:`/${Y}`}function X0(j){return(Array.isArray(j)?j:j?[j]:[]).map((J)=>_(J)).filter(Boolean)}function U0(j){if(!j||Number.isNaN(j))return Z0;return Math.min(Math.max(j,1),$0)}function V0(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 H0(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=X0(Y.tag),$=_(typeof Y.visibility==="string"?Y.visibility:void 0),Z=_(typeof Y.kind==="string"?Y.kind:void 0),X=U0(typeof Y.limit==="number"?Y.limit:void 0),U=V0(typeof Y.offset==="number"?Y.offset:void 0),V=j.map((K)=>({doc:fj(K),score:H0(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=Q0.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 K0,OperationSpecRegistry as w0}from"@contractspec/lib.contracts-spec";import{DataViewRegistry as F0}from"@contractspec/lib.contracts-spec/data-views";import{ContractReferenceDataView as B0,ContractReferenceQuery as W0,DocsGenerateCommand as x0,DocsGeneratedEvent as P0,DocsIndexDataView as L0,DocsIndexQuery as q0,DocsLayoutPresentation as _0,DocsPublishCommand as M0,DocsPublishedEvent as b0,DocsReferencePagePresentation as G0,DocsSearchForm as D0,ExampleCatalogDataView as C0}from"@contractspec/lib.contracts-spec/docs";import{FormRegistry as A0}from"@contractspec/lib.contracts-spec/forms";import{PresentationRegistry as N0}from"@contractspec/lib.contracts-spec/presentations";import{serializeDataViewSpec as I0,serializeEventSpec as z0,serializeFormSpec as E0,serializeOperationSpec as k0,serializePresentationSpec as v0}from"@contractspec/lib.contracts-spec/serialization";var Fj=null;function O0(){let j=new w0;return j.register(q0).register(W0).register(x0).register(M0),j}function R0(){if(!Fj)Fj=O0();return Fj}function Sj(j,Y){return R0().get(j,Y)}var Bj=null;function h0(){let j=new K0;return j.register(P0).register(b0),j}function T0(){if(!Bj)Bj=h0();return Bj}function yj(j,Y){return T0().get(j,Y)}var Wj=null;function f0(){let j=new N0;return j.register(_0).register(G0),j}function S0(){if(!Wj)Wj=f0();return Wj}function mj(j,Y){return S0().get(j,Y)}var xj=null;function y0(){let j=new F0;return j.register(L0).register(B0).register(C0),j}function m0(){if(!xj)xj=y0();return xj}function gj(j,Y){return m0().get(j,Y)}var Pj=null;function g0(){let j=new A0;return j.register(D0),j}function u0(){if(!Pj)Pj=g0();return Pj}function uj(j,Y){return u0().get(j)}function JY(j,Y){let J=Sj(j,Y);return k0(J)??void 0}function QY(j,Y){let J=yj(j,Y);return z0(J)??void 0}function ZY(j,Y){let J=mj(j,Y);return v0(J)??void 0}function $Y(j,Y){let J=gj(j,Y);return I0(J)??void 0}function XY(j,Y){let J=uj(j,Y);return E0(J)??void 0}function d0(){Fj=null}function p0(){Bj=null}function l0(){Wj=null}function n0(){xj=null}function c0(){Pj=null}function lQ(){d0(),p0(),l0(),n0(),c0()}import{defaultDocRegistry as i0}from"@contractspec/lib.contracts-spec/docs";function o0(j){return j?.trim().toLowerCase()??""}function a0(j){for(let Y of j??[]){let J=i0.get(Y);if(J)return J.route}return}function UY(j,Y,J,Q){let $=j.meta.title??j.meta.key,Z=a0(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=o0(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 t0}from"@contractspec/lib.contracts-spec";import L from"zod";var HY=["@contractspec"],KY=["docs","mcp"];function wY(j){let Y=new t0;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 s0}from"@contractspec/lib.contracts-spec";import F from"zod";var v=["docs","mcp"];function FY(j){let Y=new s0,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 r0}from"@contractspec/lib.contracts-spec";import{ContractReferenceInput as e0,ContractReferenceOutput as jJ,DocsIndexInput as YJ,DocsIndexOutput as JJ}from"@contractspec/lib.contracts-spec/docs";import{ScalarTypeEnum as O}from"@contractspec/lib.schema";var jj=["@contractspec"],Yj=["docs","mcp"],QJ=l({name:"DocsGetInput",fields:{id:{type:O.String_unsecure(),isOptional:!1}}}),ZJ=l({name:"DocsGetOutput",fields:{doc:{type:O.JSON(),isOptional:!1},content:{type:O.String_unsecure(),isOptional:!1}}}),$J=l({name:"DocsResolveRouteInput",fields:{route:{type:O.String_unsecure(),isOptional:!1}}}),XJ=l({name:"DocsResolveRouteOutput",fields:{doc:{type:O.JSON(),isOptional:!1},content:{type:O.String_unsecure(),isOptional:!1}}}),UJ=l({name:"DocsFacetsInput",fields:{}}),VJ=l({name:"DocsFacetsOutput",fields:{facets:{type:O.JSON(),isOptional:!1}}});function BY(j){let Y=new r0;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:YJ,output:JJ},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:QJ,output:ZJ},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:$J,output:XJ},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:e0,output:jJ},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:UJ,output:VJ},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_list_facets-v1_0_0"}}}),async()=>({facets:wj(j)})),Y}import{defaultDocRegistry as HJ}from"@contractspec/lib.contracts-spec/docs";function LZ(j="/api/mcp/docs",Y={}){let J=HJ.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 KJ,definePrompt as wJ,defineResourceTemplate as Lj,installOp as FJ,OperationSpecRegistry as BJ,PromptRegistry as WJ,ResourceRegistry as xJ}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as WY,ScalarTypeEnum as xY}from"@contractspec/lib.schema";import{getExample as PJ,listExamples as LJ,searchExamples as qJ}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 _J(){let j=new xJ;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?qJ(Y):[...LJ()];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=PJ(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 MJ(){let j=new WJ;return j.register(wJ({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 bJ(){let j=new BJ,Y=WY({name:"InternalDescribeOutput",fields:{endpoints:{type:xY.JSONObject(),isOptional:!1},notes:{type:xY.String_unsecure(),isOptional:!1}}}),J=KJ({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 FJ(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 AZ(j="/api/mcp/internal"){return A({logger:D,path:j,serverName:"contractspec-internal-mcp",ops:bJ(),resources:_J(),prompts:MJ()})}import{getModelInfo as GJ}from"@contractspec/lib.ai-providers/models";import{definePrompt as DJ,defineResourceTemplate as qj,installOp as dj,OperationSpecRegistry as CJ,PromptRegistry as AJ,ResourceRegistry as NJ}from"@contractspec/lib.contracts-spec";import{BenchmarkIngestCommand as IJ,BenchmarkRunCustomCommand as zJ,RankingRefreshCommand as EJ}from"@contractspec/lib.contracts-spec/provider-ranking";import{InMemoryProviderRankingStore as kJ}from"@contractspec/lib.provider-ranking/in-memory-store";import{createDefaultIngesterRegistry as vJ}from"@contractspec/lib.provider-ranking/ingesters";import{computeModelRankings as OJ,normalizeBenchmarkResults as RJ}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"],hJ=["platform.ai"],_j=null;function c(){if(!_j)_j=new kJ;return _j}function TJ(){let j=new NJ;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=GJ(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 fJ(){let j=new AJ;return j.register(DJ({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:hJ},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 SJ(){let j=new CJ,Y=vJ();return dj(j,IJ,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=RJ(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,zJ,async(J)=>{return{runId:`custom-${Date.now()}`,evalSuiteKey:J.evalSuiteKey,modelId:J.modelId,status:"started",startedAt:new Date}}),dj(j,EJ,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=OJ($,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 fZ(j="/api/mcp/ranking"){return A({logger:D,path:j,serverName:"contractspec-ranking-mcp",ops:SJ(),resources:TJ(),prompts:fJ()})}function SZ(j){_j=j}export{SZ as setProviderRankingStore,fZ as createProviderRankingMcpHandler,AZ as createInternalMcpHandler,LZ as createDocsMcpHandler,hQ as createContractsMcpHandler,lJ as createContextStorageService,qQ 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
+var s=Object.defineProperty;var r=(j)=>j;function e(j,Q){this[j]=r.bind(null,Q)}var Rj=(j,Q)=>{for(var U in Q)s(j,U,{get:Q[U],enumerable:!0,configurable:!0,set:e.bind(Q,U)})};var kj=(j,Q)=>()=>(j&&(Q=j(j=0)),Q);import{Logger as k,LogLevel as C}from"@contractspec/lib.logger";function v(){return"production"}var jj=()=>new k({level:C.INFO,environment:v(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),O=jj(),Ij=new k({level:C.WARN,environment:v(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),Aj=new k({level:C.INFO,environment:v(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});import{createNodeAdapters as Qj,onboarding as T}from"@contractspec/bundle.workspace";import{defineCommand as I,definePrompt as Uj,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 Yj(j){return j?.split(",").map((Q)=>Q.trim()).filter(Boolean)}async function _(j={}){let Q=Qj({cwd:process.cwd(),silent:!0});return T.buildOnboardingPlan(Q,{forcedExampleKey:j.example,selectedTracks:Yj(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(Uj({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 Jj(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(!Jj(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 Vj}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as Xj}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as Zj}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as $j}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as Fj}from"crypto";import{Elysia as Kj}from"elysia";var Hj={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 Zj({name:Q,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),Vj(V,U,J,X,{logger:j,toolCtx:()=>Hj,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new Xj(Z)});let H=new $j({sessionIdGenerator:Y?()=>Fj():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 Wj(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 Kj({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:Wj(F)}),y(500,-32000,"Internal error")}})}import Pj from"fs/promises";import{defineCommand as wj,definePrompt as xj,defineResourceTemplate as i,installOp as Bj,OperationSpecRegistry as Mj,PromptRegistry as zj,ResourceRegistry as Dj}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",bj={quickstart:"packages/apps/cli-contractspec/QUICK_START.md",reference:"packages/apps/cli-contractspec/QUICK_REFERENCE.md",readme:"packages/apps/cli-contractspec/README.md"},Gj={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"],qj=(()=>{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 _j(j){if(E.has(j))return E.get(j);let Q=bj[j];for(let J of qj){let X=G.resolve(J,Q);try{let Z=await Pj.readFile(X,"utf8");return E.set(j,Z),Z}catch{}}let U=Gj[j];return E.set(j,U),U}function fj(){let j=new Dj;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 _j(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 Ej(){let j=new zj;return j.register(xj({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 Lj(){let j=new Mj,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=wj({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 Bj(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 UQ(j="/api/mcp/cli"){return d({logger:O,path:j,serverName:"contractspec-cli-mcp",ops:Lj(),resources:fj(),prompts:Ej()})}export{UQ 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
+var P=Object.defineProperty;var h=(j)=>j;function b(j,q){this[j]=h.bind(null,q)}var D=(j,q)=>{for(var H in q)P(j,H,{get:q[H],enumerable:!0,configurable:!0,set:b.bind(q,H)})};var _=(j,q)=>()=>(j&&(q=j(j=0)),q);import{createNodeAdapters as x,onboarding as M}from"@contractspec/bundle.workspace";import{defineCommand as $,definePrompt as z,defineResourceTemplate as C,installOp as W}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as U,ScalarTypeEnum as v}from"@contractspec/lib.schema";import F from"zod";var J=["cli","mcp","onboarding"],X=["@contractspec"];function B(j){return j?.split(",").map((q)=>q.trim()).filter(Boolean)}async function Y(j={}){let q=x({cwd:process.cwd(),silent:!0});return M.buildOnboardingPlan(q,{forcedExampleKey:j.example,selectedTracks:B(j.tracks)})}function y(j){j.register(C({meta:{uriTemplate:"onboarding://tracks",title:"Onboarding tracks",description:"Primary ContractSpec onboarding tracks exposed by the CLI.",mimeType:"application/json",tags:J},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:J},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:J},input:F.object({example:F.string().optional(),id:F.enum(["agent-guide","human-guide"]),tracks:F.string().optional()}),resolve:async({example:q,id:H,tracks:Z})=>{let V=await Y({example:q,tracks:Z});return{uri:`onboarding://artifacts/${H}`,mimeType:"text/markdown",data:H==="agent-guide"?V.guides.agentGuide:V.guides.humanGuide}}}))}function R(j){j.register(z({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:J,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 A(j){let q=U({name:"OnboardingSuggestTracksInput",fields:{example:{type:v.String_unsecure(),isOptional:!0},tracks:{type:v.String_unsecure(),isOptional:!0}}}),H=U({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=U({name:"OnboardingRenderArtifactOutput",fields:{content:{type:v.String_unsecure(),isOptional:!1},primaryTrack:{type:v.String_unsecure(),isOptional:!1}}}),V=U({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:J,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:H},policy:{auth:"anonymous"}}),async({example:K,tracks:L})=>{let w=await Y({example:K,tracks:L});return{nextCommands:w.nextCommands,primaryTrack:w.primaryTrack.id,reason:w.recommendations[0]?.reason??w.primaryTrack.summary,tracks:w.recommendations.map((Q)=>Q.track.id)}}),W(j,$({meta:{key:"onboarding.renderArtifacts",version:"1.0.0",stability:"stable",owners:X,tags:J,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:U({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:K,example:L,tracks:w})=>{let Q=await Y({example:L,tracks:w});return{content:K==="agent-guide"?Q.guides.agentGuide:Q.guides.humanGuide,primaryTrack:Q.primaryTrack.id}}),W(j,$({meta:{key:"onboarding.nextCommand",version:"1.0.0",stability:"stable",owners:X,tags:J,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:K,tracks:L})=>{let w=await Y({example:K,tracks:L});return{nextCommand:w.nextCommands[0]??"contractspec onboard",primaryTrack:w.primaryTrack.id}})}export{y as registerCliOnboardingResources,R as registerCliOnboardingPrompts,A as registerCliOnboardingOps};

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

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

package/dist/application/mcp/common.js

@@ -1,2 +1,2 @@
 // @bun
-var G=["application/json","text/event-stream"];function Z(f){return!f||f.includes("*/*")||f.includes("application/*")||G.some((E)=>f.includes(E))}function k(f){if(f.method!=="POST")return f;let E=f.headers.get("accept");if(!Z(E))return f;let w=G.filter((_)=>!E?.includes(_));if(w.length===0)return f;let z=new Headers(f.headers);return z.set("accept",[E,...w].filter(Boolean).join(", ")),new Request(f,{headers:z})}import{createMcpServer as $}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as x}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as H}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as W}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as c}from"crypto";import{Elysia as M}from"elysia";var b={actor:"anonymous",decide:async()=>({effect:"allow"})};function F(f,E,w,z){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:E,message:w,...z?{data:z}:{}},id:null}),{status:f,headers:{"content-type":"application/json"}})}function J({logger:f,serverName:E,ops:w,resources:z,prompts:_,presentations:O,stateful:Q}){let y=new H({name:E,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});f.info("Setting up MCP server..."),$(y,w,z,_,{logger:f,toolCtx:()=>b,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new x(O)});let T=new W({sessionIdGenerator:Q?()=>c():void 0,enableJsonResponse:!0});return y.connect(T).then(()=>({server:y,transport:T}))}async function U(f){await Promise.allSettled([f.transport.close(),f.server.close()])}function A(f){return f instanceof Error?f.stack??f.message:String(f)}function v({logger:f,path:E,serverName:w,ops:z,resources:_,prompts:O,presentations:Q,validateAuth:y,requiredAuthMethods:T}){f.info("Setting up MCP handler...",{requiredAuthMethods:T??[]});let K=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",D=new Map;async function L(R){let j=await J({logger:f,path:E,serverName:w,ops:z,resources:_,prompts:O,presentations:Q,stateful:!1});try{return await j.transport.handleRequest(k(R))}finally{await U(j)}}async function V(R){let j=D.get(R);if(!j)return;D.delete(R),await U(j)}async function X(R){let j=R.headers.get("mcp-session-id"),P,Y=!1;if(j){let B=D.get(j);if(!B)return F(404,-32001,"Session not found");P=B}else P=await J({logger:f,path:E,serverName:w,ops:z,resources:_,prompts:O,presentations:Q,stateful:!0}),Y=!0;try{let B=await P.transport.handleRequest(k(R)),C=P.transport.sessionId;if(C&&!D.has(C))D.set(C,P);if(R.method==="DELETE"&&C)await V(C);else if(!C&&Y)await U(P);return B}catch(B){if(Y)await U(P);throw B}}return new M({name:`mcp-${w}`}).all(E,async({request:R})=>{try{if(y){let j=await y(R);if(!j.valid)return F(401,-32002,"Authentication failed",j.reason)}if(K)return await X(R);return await L(R)}catch(j){return f.error("Error handling MCP request",{path:E,method:R.method,error:A(j)}),F(500,-32000,"Internal error")}})}export{v as createMcpElysiaHandler};
+var Z=Object.defineProperty;var $=(f)=>f;function x(f,E){this[f]=$.bind(null,E)}var I=(f,E)=>{for(var R in E)Z(f,R,{get:E[R],enumerable:!0,configurable:!0,set:x.bind(E,R)})};var l=(f,E)=>()=>(f&&(E=f(f=0)),E);var G=["application/json","text/event-stream"];function H(f){return!f||f.includes("*/*")||f.includes("application/*")||G.some((E)=>f.includes(E))}function k(f){if(f.method!=="POST")return f;let E=f.headers.get("accept");if(!H(E))return f;let R=G.filter((_)=>!E?.includes(_));if(R.length===0)return f;let z=new Headers(f.headers);return z.set("accept",[E,...R].filter(Boolean).join(", ")),new Request(f,{headers:z})}import{createMcpServer as W}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as c}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as M}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as b}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as A}from"crypto";import{Elysia as N}from"elysia";var n={actor:"anonymous",decide:async()=>({effect:"allow"})};function F(f,E,R,z){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:E,message:R,...z?{data:z}:{}},id:null}),{status:f,headers:{"content-type":"application/json"}})}function J({logger:f,serverName:E,ops:R,resources:z,prompts:_,presentations:O,stateful:Q}){let y=new M({name:E,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});f.info("Setting up MCP server..."),W(y,R,z,_,{logger:f,toolCtx:()=>n,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new c(O)});let T=new b({sessionIdGenerator:Q?()=>A():void 0,enableJsonResponse:!0});return y.connect(T).then(()=>({server:y,transport:T}))}async function U(f){await Promise.allSettled([f.transport.close(),f.server.close()])}function m(f){return f instanceof Error?f.stack??f.message:String(f)}function o({logger:f,path:E,serverName:R,ops:z,resources:_,prompts:O,presentations:Q,validateAuth:y,requiredAuthMethods:T}){f.info("Setting up MCP handler...",{requiredAuthMethods:T??[]});let K=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",D=new Map;async function L(j){let w=await J({logger:f,path:E,serverName:R,ops:z,resources:_,prompts:O,presentations:Q,stateful:!1});try{return await w.transport.handleRequest(k(j))}finally{await U(w)}}async function V(j){let w=D.get(j);if(!w)return;D.delete(j),await U(w)}async function X(j){let w=j.headers.get("mcp-session-id"),P,Y=!1;if(w){let B=D.get(w);if(!B)return F(404,-32001,"Session not found");P=B}else P=await J({logger:f,path:E,serverName:R,ops:z,resources:_,prompts:O,presentations:Q,stateful:!0}),Y=!0;try{let B=await P.transport.handleRequest(k(j)),C=P.transport.sessionId;if(C&&!D.has(C))D.set(C,P);if(j.method==="DELETE"&&C)await V(C);else if(!C&&Y)await U(P);return B}catch(B){if(Y)await U(P);throw B}}return new N({name:`mcp-${R}`}).all(E,async({request:j})=>{try{if(y){let w=await y(j);if(!w.valid)return F(401,-32002,"Authentication failed",w.reason)}if(K)return await X(j);return await L(j)}catch(w){return f.error("Error handling MCP request",{path:E,method:j.method,error:m(w)}),F(500,-32000,"Internal error")}})}export{o as createMcpElysiaHandler};