@contractspec/bundle.library 3.8.10 → 3.8.12

package/dist/node/application/mcp/docsMcp.prompts.js

@@ -1,521 +1,6 @@
-// src/application/mcp/docsMcp.data.ts
-import { defaultDocRegistry } from "@contractspec/lib.contracts-spec/docs";
-var DEFAULT_LIMIT = 20;
-var MAX_LIMIT = 100;
-function normalizeText(value) {
-  return value?.trim().toLowerCase() ?? "";
-}
-function normalizeRoute(route) {
-  const decoded = decodeURIComponent(route).trim();
-  if (!decoded)
-    return "/";
-  return decoded.startsWith("/") ? decoded : `/${decoded}`;
-}
-function normalizeTags(value) {
-  const tags = Array.isArray(value) ? value : value ? [value] : [];
-  return tags.map((tag) => normalizeText(tag)).filter(Boolean);
-}
-function clampLimit(limit) {
-  if (!limit || Number.isNaN(limit))
-    return DEFAULT_LIMIT;
-  return Math.min(Math.max(limit, 1), MAX_LIMIT);
-}
-function clampOffset(offset) {
-  if (!offset || Number.isNaN(offset))
-    return 0;
-  return Math.max(offset, 0);
-}
-function toDocSummary({ block, route }) {
-  return {
-    id: block.id,
-    title: block.title,
-    summary: block.summary ?? "",
-    route,
-    visibility: block.visibility ?? "public",
-    kind: block.kind ?? "reference",
-    version: block.version ?? "1.0.0",
-    tags: block.tags ?? []
-  };
-}
-function scoreDoc(route, query) {
-  if (!query)
-    return 1;
-  const tokens = query.split(/\s+/).filter(Boolean);
-  const title = normalizeText(route.block.title);
-  const id = normalizeText(route.block.id);
-  const summary = normalizeText(route.block.summary);
-  const body = normalizeText(route.block.body);
-  const path = normalizeText(route.route);
-  const tags = (route.block.tags ?? []).map((tag) => normalizeText(tag));
-  const haystack = [title, id, summary, body, path, ...tags].join(" ");
-  if (tokens.some((token) => !haystack.includes(token)))
-    return 0;
-  let score = 0;
-  for (const token of tokens) {
-    if (id.includes(token))
-      score += 8;
-    if (title.includes(token))
-      score += 7;
-    if (tags.some((tag) => tag.includes(token)))
-      score += 5;
-    if (summary.includes(token))
-      score += 4;
-    if (path.includes(token))
-      score += 3;
-    if (body.includes(token))
-      score += 2;
-  }
-  return score;
-}
-function searchDocs(routes, args) {
-  const query = normalizeText(typeof args.query === "string" ? args.query : undefined);
-  const tags = normalizeTags(args.tag);
-  const visibility = normalizeText(typeof args.visibility === "string" ? args.visibility : undefined);
-  const kind = normalizeText(typeof args.kind === "string" ? args.kind : undefined);
-  const limit = clampLimit(typeof args.limit === "number" ? args.limit : undefined);
-  const offset = clampOffset(typeof args.offset === "number" ? args.offset : undefined);
-  const ranked = routes.map((route) => ({
-    doc: toDocSummary(route),
-    score: scoreDoc(route, query)
-  })).filter(({ doc, score }) => {
-    const matchesQuery = query ? score > 0 : true;
-    const matchesTags = tags.length ? tags.every((tag) => doc.tags.some((docTag) => normalizeText(docTag).includes(tag))) : true;
-    const matchesVisibility = visibility ? normalizeText(doc.visibility) === visibility : true;
-    const matchesKind = kind ? normalizeText(doc.kind) === kind : true;
-    return matchesQuery && matchesTags && matchesVisibility && matchesKind;
-  }).sort((left, right) => {
-    if (right.score !== left.score)
-      return right.score - left.score;
-    return left.doc.title.localeCompare(right.doc.title);
-  });
-  const docs = ranked.slice(offset, offset + limit).map(({ doc }) => doc);
-  const nextOffset = offset + docs.length < ranked.length ? offset + docs.length : undefined;
-  return {
-    docs,
-    items: docs,
-    total: ranked.length,
-    ...nextOffset != null ? { nextOffset } : {}
-  };
-}
-function getDocById(id) {
-  const normalizedId = decodeURIComponent(id);
-  const found = defaultDocRegistry.get(normalizedId);
-  if (!found)
-    return;
-  return {
-    doc: toDocSummary(found),
-    content: String(found.block.body ?? "")
-  };
-}
-function getDocByRoute(routes, routePath) {
-  const normalizedPath = normalizeRoute(routePath);
-  const found = routes.find((route) => normalizeRoute(route.route) === normalizedPath);
-  if (!found)
-    return;
-  return {
-    doc: toDocSummary(found),
-    content: String(found.block.body ?? "")
-  };
-}
-function listDocFacets(routes) {
-  const tags = new Map;
-  const kinds = new Map;
-  const visibilities = new Map;
-  for (const route of routes) {
-    const kind = route.block.kind ?? "reference";
-    const visibility = route.block.visibility ?? "public";
-    kinds.set(kind, (kinds.get(kind) ?? 0) + 1);
-    visibilities.set(visibility, (visibilities.get(visibility) ?? 0) + 1);
-    for (const tag of route.block.tags ?? []) {
-      tags.set(tag, (tags.get(tag) ?? 0) + 1);
-    }
-  }
-  const toEntries = (values, key) => [...values.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0])).map(([value, count]) => ({ [key]: value, count }));
-  return {
-    totalDocs: routes.length,
-    tags: toEntries(tags, "tag"),
-    kinds: toEntries(kinds, "kind"),
-    visibilities: toEntries(visibilities, "visibility")
-  };
-}
-
-// src/features/contracts-registry.ts
-import {
-  EventRegistry,
-  OperationSpecRegistry
-} from "@contractspec/lib.contracts-spec";
-import {
-  DataViewRegistry
-} from "@contractspec/lib.contracts-spec/data-views";
-import {
-  ContractReferenceDataView,
-  ContractReferenceQuery,
-  DocsGenerateCommand,
-  DocsGeneratedEvent,
-  DocsIndexDataView,
-  DocsIndexQuery,
-  DocsLayoutPresentation,
-  DocsPublishCommand,
-  DocsPublishedEvent,
-  DocsReferencePagePresentation,
-  DocsSearchForm,
-  ExampleCatalogDataView
-} from "@contractspec/lib.contracts-spec/docs";
-import { FormRegistry } from "@contractspec/lib.contracts-spec/forms";
-import {
-  PresentationRegistry
-} from "@contractspec/lib.contracts-spec/presentations";
-import {
-  serializeDataViewSpec,
-  serializeEventSpec,
-  serializeFormSpec,
-  serializeOperationSpec,
-  serializePresentationSpec
-} from "@contractspec/lib.contracts-spec/serialization";
-var operationRegistry = null;
-function createContractSpecOperationRegistry() {
-  const registry = new OperationSpecRegistry;
-  registry.register(DocsIndexQuery).register(ContractReferenceQuery).register(DocsGenerateCommand).register(DocsPublishCommand);
-  return registry;
-}
-function getContractSpecOperationRegistry() {
-  if (!operationRegistry) {
-    operationRegistry = createContractSpecOperationRegistry();
-  }
-  return operationRegistry;
-}
-function resolveOperationSpec(key, version) {
-  return getContractSpecOperationRegistry().get(key, version);
-}
-var eventRegistry = null;
-function createContractSpecEventRegistry() {
-  const registry = new EventRegistry;
-  registry.register(DocsGeneratedEvent).register(DocsPublishedEvent);
-  return registry;
-}
-function getContractSpecEventRegistry() {
-  if (!eventRegistry) {
-    eventRegistry = createContractSpecEventRegistry();
-  }
-  return eventRegistry;
-}
-function resolveEventSpec(key, version) {
-  return getContractSpecEventRegistry().get(key, version);
-}
-var presentationRegistry = null;
-function createContractSpecPresentationRegistry() {
-  const registry = new PresentationRegistry;
-  registry.register(DocsLayoutPresentation).register(DocsReferencePagePresentation);
-  return registry;
-}
-function getContractSpecPresentationRegistry() {
-  if (!presentationRegistry) {
-    presentationRegistry = createContractSpecPresentationRegistry();
-  }
-  return presentationRegistry;
-}
-function resolvePresentationSpec(key, version) {
-  return getContractSpecPresentationRegistry().get(key, version);
-}
-var dataViewRegistry = null;
-function createContractSpecDataViewRegistry() {
-  const registry = new DataViewRegistry;
-  registry.register(DocsIndexDataView).register(ContractReferenceDataView).register(ExampleCatalogDataView);
-  return registry;
-}
-function getContractSpecDataViewRegistry() {
-  if (!dataViewRegistry) {
-    dataViewRegistry = createContractSpecDataViewRegistry();
-  }
-  return dataViewRegistry;
-}
-function resolveDataViewSpec(key, version) {
-  return getContractSpecDataViewRegistry().get(key, version);
-}
-var formRegistry = null;
-function createContractSpecFormRegistry() {
-  const registry = new FormRegistry;
-  registry.register(DocsSearchForm);
-  return registry;
-}
-function getContractSpecFormRegistry() {
-  if (!formRegistry) {
-    formRegistry = createContractSpecFormRegistry();
-  }
-  return formRegistry;
-}
-function resolveFormSpec(key, _version) {
-  return getContractSpecFormRegistry().get(key);
-}
-function resolveSerializedOperationSpec(key, version) {
-  const spec = resolveOperationSpec(key, version);
-  return serializeOperationSpec(spec) ?? undefined;
-}
-function resolveSerializedEventSpec(key, version) {
-  const spec = resolveEventSpec(key, version);
-  return serializeEventSpec(spec) ?? undefined;
-}
-function resolveSerializedPresentationSpec(key, version) {
-  const spec = resolvePresentationSpec(key, version);
-  return serializePresentationSpec(spec) ?? undefined;
-}
-function resolveSerializedDataViewSpec(key, version) {
-  const spec = resolveDataViewSpec(key, version);
-  return serializeDataViewSpec(spec) ?? undefined;
-}
-function resolveSerializedFormSpec(key, version) {
-  const spec = resolveFormSpec(key, version);
-  return serializeFormSpec(spec) ?? undefined;
-}
-function resetContractSpecOperationRegistry() {
-  operationRegistry = null;
-}
-function resetContractSpecEventRegistry() {
-  eventRegistry = null;
-}
-function resetContractSpecPresentationRegistry() {
-  presentationRegistry = null;
-}
-function resetContractSpecDataViewRegistry() {
-  dataViewRegistry = null;
-}
-function resetContractSpecFormRegistry() {
-  formRegistry = null;
-}
-function resetAllContractSpecRegistries() {
-  resetContractSpecOperationRegistry();
-  resetContractSpecEventRegistry();
-  resetContractSpecPresentationRegistry();
-  resetContractSpecDataViewRegistry();
-  resetContractSpecFormRegistry();
-}
-
-// src/application/mcp/docsMcp.reference.ts
-import { defaultDocRegistry as defaultDocRegistry2 } from "@contractspec/lib.contracts-spec/docs";
-function normalizeText2(value) {
-  return value?.trim().toLowerCase() ?? "";
-}
-function routeFromDocIds(docIds) {
-  for (const docId of docIds ?? []) {
-    const doc = defaultDocRegistry2.get(docId);
-    if (doc)
-      return doc.route;
-  }
-  return;
-}
-function toReference(spec, type, schema, policy) {
-  const title = spec.meta.title ?? spec.meta.key;
-  const route = routeFromDocIds(spec.meta.docId);
-  const description = spec.meta.description;
-  return {
-    key: spec.meta.key,
-    version: spec.meta.version,
-    type,
-    title,
-    description,
-    markdown: [
-      `# ${title}`,
-      `- Key: ${spec.meta.key}`,
-      `- Type: ${type}`,
-      `- Version: ${spec.meta.version}`,
-      route ? `- Docs route: ${route}` : "",
-      description ? `
-${description}` : ""
-    ].filter(Boolean).join(`
-`),
-    ...route ? { route } : {},
-    ...schema ? { schema } : {},
-    ...policy ? { policy } : {},
-    tags: spec.meta.tags ?? [],
-    owners: spec.meta.owners ?? [],
-    stability: spec.meta.stability
-  };
-}
-function resolveContractReference(args) {
-  const includeSchema = args.includeSchema ?? false;
-  const requestedType = normalizeText2(args.type);
-  const operation = resolveOperationSpec(args.key, args.version);
-  if (operation && (!requestedType || requestedType === "operation" || requestedType === operation.meta.kind)) {
-    return {
-      reference: toReference(operation, operation.meta.kind, includeSchema ? resolveSerializedOperationSpec(args.key, args.version) : undefined, operation.policy)
-    };
-  }
-  const resolvers = [
-    {
-      type: "data-view",
-      spec: resolveDataViewSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedDataViewSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "form",
-      spec: resolveFormSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedFormSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "presentation",
-      spec: resolvePresentationSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedPresentationSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "event",
-      spec: resolveEventSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedEventSpec(args.key, args.version) : undefined
-    }
-  ];
-  for (const candidate of resolvers) {
-    if (candidate.spec && (!requestedType || requestedType === candidate.type)) {
-      return {
-        reference: toReference(candidate.spec, candidate.type, candidate.schema)
-      };
-    }
-  }
-  throw new Error(`Contract reference not found: ${args.key}`);
-}
-
-// src/application/mcp/docsMcp.prompts.ts
-import { definePrompt, PromptRegistry } from "@contractspec/lib.contracts-spec";
-import z from "zod";
-var DOC_OWNERS = ["@contractspec"];
-var DOC_TAGS = ["docs", "mcp"];
-function buildDocPrompts(routes) {
-  const prompts = new PromptRegistry;
-  prompts.register(definePrompt({
-    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: DOC_TAGS,
-      stability: "beta",
-      owners: DOC_OWNERS
-    },
-    args: [
-      {
-        name: "topic",
-        description: "Goal or subject to search for.",
-        required: false,
-        schema: z.string().optional()
-      },
-      {
-        name: "kind",
-        description: "Optional doc kind filter.",
-        required: false,
-        schema: z.string().optional()
-      },
-      {
-        name: "tag",
-        description: "Optional tag filter.",
-        required: false,
-        schema: z.string().optional()
-      }
-    ],
-    input: z.object({
-      topic: z.string().optional(),
-      kind: z.string().optional(),
-      tag: z.string().optional()
-    }),
-    render: async ({ topic, kind, tag }) => {
-      const matches = searchDocs(routes, {
-        query: topic,
-        kind,
-        tag,
-        limit: 3
-      });
-      const suggestedDocs = matches.docs.length ? matches.docs.map((doc) => `- ${doc.title} (${doc.id}) -> ${doc.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.",
-            topic ? `Topic: ${topic}` : "",
-            kind ? `Kind: ${kind}` : "",
-            tag ? `Tag: ${tag}` : "",
-            "Suggested starting docs:",
-            suggestedDocs
-          ].filter(Boolean).join(`
-`)
-        },
-        {
-          type: "resource",
-          uri: "docs://index",
-          title: "DocBlocks index"
-        },
-        {
-          type: "resource",
-          uri: "docs://facets",
-          title: "Docs facets"
-        }
-      ];
-    }
-  }));
-  prompts.register(definePrompt({
-    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: DOC_TAGS,
-      stability: "beta",
-      owners: DOC_OWNERS
-    },
-    args: [
-      {
-        name: "key",
-        description: "ContractSpec key to resolve.",
-        required: true,
-        schema: z.string()
-      },
-      {
-        name: "version",
-        description: "Optional version override.",
-        required: false,
-        schema: z.string().optional()
-      },
-      {
-        name: "type",
-        description: "Optional surface type: command, query, form, data-view, presentation, event.",
-        required: false,
-        schema: z.string().optional()
-      }
-    ],
-    input: z.object({
-      key: z.string(),
-      version: z.string().optional(),
-      type: z.string().optional()
-    }),
-    render: async ({ key, version, type }) => {
-      const reference = resolveContractReference({
-        key,
-        version,
-        type,
-        includeSchema: true
-      }).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: ${reference.key}`,
-            `Resolved type: ${reference.type}`,
-            reference.route ? `Docs route: ${reference.route}` : "",
-            `Resource URI: docs://contract-reference/${encodeURIComponent(key)}`
-          ].filter(Boolean).join(`
-`)
-        },
-        {
-          type: "resource",
-          uri: `docs://contract-reference/${encodeURIComponent(key)}`,
-          title: "Contract reference"
-        }
-      ];
-    }
-  }));
-  return prompts;
-}
-export {
-  buildDocPrompts
-};
+import{defaultDocRegistry as n}from"@contractspec/lib.contracts-spec/docs";var g=20,c=100;function U(j){return j?.trim().toLowerCase()??""}function O(j){let w=decodeURIComponent(j).trim();if(!w)return"/";return w.startsWith("/")?w:`/${w}`}function i(j){return(Array.isArray(j)?j:j?[j]:[]).map((B)=>U(B)).filter(Boolean)}function a(j){if(!j||Number.isNaN(j))return g;return Math.min(Math.max(j,1),c)}function o(j){if(!j||Number.isNaN(j))return 0;return Math.max(j,0)}function C({block:j,route:w}){return{id:j.id,title:j.title,summary:j.summary??"",route:w,visibility:j.visibility??"public",kind:j.kind??"reference",version:j.version??"1.0.0",tags:j.tags??[]}}function t(j,w){if(!w)return 1;let B=w.split(/\s+/).filter(Boolean),J=U(j.block.title),Z=U(j.block.id),H=U(j.block.summary),F=U(j.block.body),$=U(j.route),K=(j.block.tags??[]).map((Y)=>U(Y)),G=[J,Z,H,F,$,...K].join(" ");if(B.some((Y)=>!G.includes(Y)))return 0;let V=0;for(let Y of B){if(Z.includes(Y))V+=8;if(J.includes(Y))V+=7;if(K.some((X)=>X.includes(Y)))V+=5;if(H.includes(Y))V+=4;if($.includes(Y))V+=3;if(F.includes(Y))V+=2}return V}function q(j,w){let B=U(typeof w.query==="string"?w.query:void 0),J=i(w.tag),Z=U(typeof w.visibility==="string"?w.visibility:void 0),H=U(typeof w.kind==="string"?w.kind:void 0),F=a(typeof w.limit==="number"?w.limit:void 0),$=o(typeof w.offset==="number"?w.offset:void 0),K=j.map((Y)=>({doc:C(Y),score:t(Y,B)})).filter(({doc:Y,score:X})=>{let k=B?X>0:!0,y=J.length?J.every((l)=>Y.tags.some((d)=>U(d).includes(l))):!0,p=Z?U(Y.visibility)===Z:!0,u=H?U(Y.kind)===H:!0;return k&&y&&p&&u}).sort((Y,X)=>{if(X.score!==Y.score)return X.score-Y.score;return Y.doc.title.localeCompare(X.doc.title)}),G=K.slice($,$+F).map(({doc:Y})=>Y),V=$+G.length<K.length?$+G.length:void 0;return{docs:G,items:G,total:K.length,...V!=null?{nextOffset:V}:{}}}function yj(j){let w=decodeURIComponent(j),B=n.get(w);if(!B)return;return{doc:C(B),content:String(B.block.body??"")}}function pj(j,w){let B=O(w),J=j.find((Z)=>O(Z.route)===B);if(!J)return;return{doc:C(J),content:String(J.block.body??"")}}function uj(j){let w=new Map,B=new Map,J=new Map;for(let H of j){let F=H.block.kind??"reference",$=H.block.visibility??"public";B.set(F,(B.get(F)??0)+1),J.set($,(J.get($)??0)+1);for(let K of H.block.tags??[])w.set(K,(w.get(K)??0)+1)}let Z=(H,F)=>[...H.entries()].sort(($,K)=>K[1]-$[1]||$[0].localeCompare(K[0])).map(([$,K])=>({[F]:$,count:K}));return{totalDocs:j.length,tags:Z(w,"tag"),kinds:Z(B,"kind"),visibilities:Z(J,"visibility")}}import{EventRegistry as s,OperationSpecRegistry as r}from"@contractspec/lib.contracts-spec";import{DataViewRegistry as e}from"@contractspec/lib.contracts-spec/data-views";import{ContractReferenceDataView as jj,ContractReferenceQuery as wj,DocsGenerateCommand as Bj,DocsGeneratedEvent as Hj,DocsIndexDataView as Jj,DocsIndexQuery as Yj,DocsLayoutPresentation as Zj,DocsPublishCommand as $j,DocsPublishedEvent as Fj,DocsReferencePagePresentation as Kj,DocsSearchForm as Qj,ExampleCatalogDataView as Uj}from"@contractspec/lib.contracts-spec/docs";import{FormRegistry as Vj}from"@contractspec/lib.contracts-spec/forms";import{PresentationRegistry as Xj}from"@contractspec/lib.contracts-spec/presentations";import{serializeDataViewSpec as Gj,serializeEventSpec as Nj,serializeFormSpec as Wj,serializeOperationSpec as Aj,serializePresentationSpec as Lj}from"@contractspec/lib.contracts-spec/serialization";var N=null;function Mj(){let j=new r;return j.register(Yj).register(wj).register(Bj).register($j),j}function Cj(){if(!N)N=Mj();return N}function _(j,w){return Cj().get(j,w)}var W=null;function _j(){let j=new s;return j.register(Hj).register(Fj),j}function Ej(){if(!W)W=_j();return W}function E(j,w){return Ej().get(j,w)}var A=null;function Ij(){let j=new Xj;return j.register(Zj).register(Kj),j}function Pj(){if(!A)A=Ij();return A}function I(j,w){return Pj().get(j,w)}var L=null;function Rj(){let j=new e;return j.register(Jj).register(jj).register(Uj),j}function Oj(){if(!L)L=Rj();return L}function P(j,w){return Oj().get(j,w)}var M=null;function qj(){let j=new Vj;return j.register(Qj),j}function Dj(){if(!M)M=qj();return M}function R(j,w){return Dj().get(j)}function D(j,w){let B=_(j,w);return Aj(B)??void 0}function x(j,w){let B=E(j,w);return Nj(B)??void 0}function S(j,w){let B=I(j,w);return Lj(B)??void 0}function b(j,w){let B=P(j,w);return Gj(B)??void 0}function T(j,w){let B=R(j,w);return Wj(B)??void 0}function xj(){N=null}function Sj(){W=null}function bj(){A=null}function Tj(){L=null}function hj(){M=null}function oj(){xj(),Sj(),bj(),Tj(),hj()}import{defaultDocRegistry as zj}from"@contractspec/lib.contracts-spec/docs";function vj(j){return j?.trim().toLowerCase()??""}function fj(j){for(let w of j??[]){let B=zj.get(w);if(B)return B.route}return}function h(j,w,B,J){let Z=j.meta.title??j.meta.key,H=fj(j.meta.docId),F=j.meta.description;return{key:j.meta.key,version:j.meta.version,type:w,title:Z,description:F,markdown:[`# ${Z}`,`- Key: ${j.meta.key}`,`- Type: ${w}`,`- Version: ${j.meta.version}`,H?`- Docs route: ${H}`:"",F?`
+${F}`:""].filter(Boolean).join(`
+`),...H?{route:H}:{},...B?{schema:B}:{},...J?{policy:J}:{},tags:j.meta.tags??[],owners:j.meta.owners??[],stability:j.meta.stability}}function z(j){let w=j.includeSchema??!1,B=vj(j.type),J=_(j.key,j.version);if(J&&(!B||B==="operation"||B===J.meta.kind))return{reference:h(J,J.meta.kind,w?D(j.key,j.version):void 0,J.policy)};let Z=[{type:"data-view",spec:P(j.key,j.version),schema:w?b(j.key,j.version):void 0},{type:"form",spec:R(j.key,j.version),schema:w?T(j.key,j.version):void 0},{type:"presentation",spec:I(j.key,j.version),schema:w?S(j.key,j.version):void 0},{type:"event",spec:E(j.key,j.version),schema:w?x(j.key,j.version):void 0}];for(let H of Z)if(H.spec&&(!B||B===H.type))return{reference:h(H.spec,H.type,H.schema)};throw Error(`Contract reference not found: ${j.key}`)}import{definePrompt as v,PromptRegistry as mj}from"@contractspec/lib.contracts-spec";import Q from"zod";var f=["@contractspec"],m=["docs","mcp"];function Jw(j){let w=new mj;return w.register(v({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:m,stability:"beta",owners:f},args:[{name:"topic",description:"Goal or subject to search for.",required:!1,schema:Q.string().optional()},{name:"kind",description:"Optional doc kind filter.",required:!1,schema:Q.string().optional()},{name:"tag",description:"Optional tag filter.",required:!1,schema:Q.string().optional()}],input:Q.object({topic:Q.string().optional(),kind:Q.string().optional(),tag:Q.string().optional()}),render:async({topic:B,kind:J,tag:Z})=>{let H=q(j,{query:B,kind:J,tag:Z,limit:3}),F=H.docs.length?H.docs.map(($)=>`- ${$.title} (${$.id}) -> ${$.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.",B?`Topic: ${B}`:"",J?`Kind: ${J}`:"",Z?`Tag: ${Z}`:"","Suggested starting docs:",F].filter(Boolean).join(`
+`)},{type:"resource",uri:"docs://index",title:"DocBlocks index"},{type:"resource",uri:"docs://facets",title:"Docs facets"}]}})),w.register(v({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:m,stability:"beta",owners:f},args:[{name:"key",description:"ContractSpec key to resolve.",required:!0,schema:Q.string()},{name:"version",description:"Optional version override.",required:!1,schema:Q.string().optional()},{name:"type",description:"Optional surface type: command, query, form, data-view, presentation, event.",required:!1,schema:Q.string().optional()}],input:Q.object({key:Q.string(),version:Q.string().optional(),type:Q.string().optional()}),render:async({key:B,version:J,type:Z})=>{let H=z({key:B,version:J,type:Z,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: ${H.key}`,`Resolved type: ${H.type}`,H.route?`Docs route: ${H.route}`:"",`Resource URI: docs://contract-reference/${encodeURIComponent(B)}`].filter(Boolean).join(`
+`)},{type:"resource",uri:`docs://contract-reference/${encodeURIComponent(B)}`,title:"Contract reference"}]}})),w}export{Jw as buildDocPrompts};