@contractspec/bundle.library 3.8.10 → 3.8.12

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

@@ -1,518 +1,3 @@
-// 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.tools.ts
-import {
-  defineCommand,
-  defineSchemaModel,
-  installOp,
-  OperationSpecRegistry as OperationSpecRegistry2
-} from "@contractspec/lib.contracts-spec";
-import {
-  ContractReferenceInput,
-  ContractReferenceOutput,
-  DocsIndexInput,
-  DocsIndexOutput
-} from "@contractspec/lib.contracts-spec/docs";
-import { ScalarTypeEnum } from "@contractspec/lib.schema";
-var DOC_OWNERS = ["@contractspec"];
-var DOC_TAGS = ["docs", "mcp"];
-var DocsGetInput = defineSchemaModel({
-  name: "DocsGetInput",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var DocsGetOutput = defineSchemaModel({
-  name: "DocsGetOutput",
-  fields: {
-    doc: { type: ScalarTypeEnum.JSON(), isOptional: false },
-    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var DocsResolveRouteInput = defineSchemaModel({
-  name: "DocsResolveRouteInput",
-  fields: {
-    route: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var DocsResolveRouteOutput = defineSchemaModel({
-  name: "DocsResolveRouteOutput",
-  fields: {
-    doc: { type: ScalarTypeEnum.JSON(), isOptional: false },
-    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var DocsFacetsInput = defineSchemaModel({
-  name: "DocsFacetsInput",
-  fields: {}
-});
-var DocsFacetsOutput = defineSchemaModel({
-  name: "DocsFacetsOutput",
-  fields: {
-    facets: { type: ScalarTypeEnum.JSON(), isOptional: false }
-  }
-});
-function buildDocOps(routes) {
-  const registry = new OperationSpecRegistry2;
-  installOp(registry, defineCommand({
-    meta: {
-      key: "docs.search",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS,
-      tags: DOC_TAGS,
-      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: DocsIndexInput, output: DocsIndexOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_search-v1_0_0" } }
-  }), async (args) => searchDocs(routes, args));
-  installOp(registry, defineCommand({
-    meta: {
-      key: "docs.get",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS,
-      tags: DOC_TAGS,
-      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: DocsGetInput, output: DocsGetOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_get-v1_0_0" } }
-  }), async ({ id }) => {
-    const found = getDocById(id);
-    if (!found)
-      throw new Error(`DocBlock not found: ${id}`);
-    return found;
-  });
-  installOp(registry, defineCommand({
-    meta: {
-      key: "docs.resolveRoute",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS,
-      tags: DOC_TAGS,
-      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: DocsResolveRouteInput, output: DocsResolveRouteOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_resolve_route-v1_0_0" } }
-  }), async ({ route }) => {
-    const found = getDocByRoute(routes, route);
-    if (!found)
-      throw new Error(`Doc route not found: ${route}`);
-    return found;
-  });
-  installOp(registry, defineCommand({
-    meta: {
-      key: "docs.contract.lookup",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS,
-      tags: DOC_TAGS,
-      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: ContractReferenceInput, output: ContractReferenceOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_contract_reference-v1_0_0" } }
-  }), async (args) => resolveContractReference(args));
-  installOp(registry, defineCommand({
-    meta: {
-      key: "docs.list.facets",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS,
-      tags: DOC_TAGS,
-      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: DocsFacetsInput, output: DocsFacetsOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_list_facets-v1_0_0" } }
-  }), async () => ({ facets: listDocFacets(routes) }));
-  return registry;
-}
-export {
-  buildDocOps
-};
+import{defaultDocRegistry as o}from"@contractspec/lib.contracts-spec/docs";var s=20,t=100;function V(j){return j?.trim().toLowerCase()??""}function O(j){let w=decodeURIComponent(j).trim();if(!w)return"/";return w.startsWith("/")?w:`/${w}`}function r(j){return(Array.isArray(j)?j:j?[j]:[]).map((H)=>V(H)).filter(Boolean)}function e(j){if(!j||Number.isNaN(j))return s;return Math.min(Math.max(j,1),t)}function jj(j){if(!j||Number.isNaN(j))return 0;return Math.max(j,0)}function E({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 wj(j,w){if(!w)return 1;let H=w.split(/\s+/).filter(Boolean),J=V(j.block.title),$=V(j.block.id),Z=V(j.block.summary),U=V(j.block.body),K=V(j.route),Q=(j.block.tags??[]).map((Y)=>V(Y)),L=[J,$,Z,U,K,...Q].join(" ");if(H.some((Y)=>!L.includes(Y)))return 0;let X=0;for(let Y of H){if($.includes(Y))X+=8;if(J.includes(Y))X+=7;if(Q.some((B)=>B.includes(Y)))X+=5;if(Z.includes(Y))X+=4;if(K.includes(Y))X+=3;if(U.includes(Y))X+=2}return X}function S(j,w){let H=V(typeof w.query==="string"?w.query:void 0),J=r(w.tag),$=V(typeof w.visibility==="string"?w.visibility:void 0),Z=V(typeof w.kind==="string"?w.kind:void 0),U=e(typeof w.limit==="number"?w.limit:void 0),K=jj(typeof w.offset==="number"?w.offset:void 0),Q=j.map((Y)=>({doc:E(Y),score:wj(Y,H)})).filter(({doc:Y,score:B})=>{let g=H?B>0:!0,u=J.length?J.every((i)=>Y.tags.some((a)=>V(a).includes(i))):!0,n=$?V(Y.visibility)===$:!0,c=Z?V(Y.kind)===Z:!0;return g&&u&&n&&c}).sort((Y,B)=>{if(B.score!==Y.score)return B.score-Y.score;return Y.doc.title.localeCompare(B.doc.title)}),L=Q.slice(K,K+U).map(({doc:Y})=>Y),X=K+L.length<Q.length?K+L.length:void 0;return{docs:L,items:L,total:Q.length,...X!=null?{nextOffset:X}:{}}}function h(j){let w=decodeURIComponent(j),H=o.get(w);if(!H)return;return{doc:E(H),content:String(H.block.body??"")}}function T(j,w){let H=O(w),J=j.find(($)=>O($.route)===H);if(!J)return;return{doc:E(J),content:String(J.block.body??"")}}function v(j){let w=new Map,H=new Map,J=new Map;for(let Z of j){let U=Z.block.kind??"reference",K=Z.block.visibility??"public";H.set(U,(H.get(U)??0)+1),J.set(K,(J.get(K)??0)+1);for(let Q of Z.block.tags??[])w.set(Q,(w.get(Q)??0)+1)}let $=(Z,U)=>[...Z.entries()].sort((K,Q)=>Q[1]-K[1]||K[0].localeCompare(Q[0])).map(([K,Q])=>({[U]:K,count:Q}));return{totalDocs:j.length,tags:$(w,"tag"),kinds:$(H,"kind"),visibilities:$(J,"visibility")}}import{EventRegistry as Hj,OperationSpecRegistry as Jj}from"@contractspec/lib.contracts-spec";import{DataViewRegistry as Yj}from"@contractspec/lib.contracts-spec/data-views";import{ContractReferenceDataView as Zj,ContractReferenceQuery as $j,DocsGenerateCommand as Kj,DocsGeneratedEvent as Qj,DocsIndexDataView as Uj,DocsIndexQuery as Vj,DocsLayoutPresentation as Xj,DocsPublishCommand as Bj,DocsPublishedEvent as Fj,DocsReferencePagePresentation as Lj,DocsSearchForm as Nj,ExampleCatalogDataView as Pj}from"@contractspec/lib.contracts-spec/docs";import{FormRegistry as Wj}from"@contractspec/lib.contracts-spec/forms";import{PresentationRegistry as Aj}from"@contractspec/lib.contracts-spec/presentations";import{serializeDataViewSpec as Gj,serializeEventSpec as qj,serializeFormSpec as Mj,serializeOperationSpec as _j,serializePresentationSpec as Ij}from"@contractspec/lib.contracts-spec/serialization";var q=null;function xj(){let j=new Jj;return j.register(Vj).register($j).register(Kj).register(Bj),j}function Ej(){if(!q)q=xj();return q}function R(j,w){return Ej().get(j,w)}var M=null;function Rj(){let j=new Hj;return j.register(Qj).register(Fj),j}function zj(){if(!M)M=Rj();return M}function z(j,w){return zj().get(j,w)}var _=null;function Cj(){let j=new Aj;return j.register(Xj).register(Lj),j}function bj(){if(!_)_=Cj();return _}function C(j,w){return bj().get(j,w)}var I=null;function Dj(){let j=new Yj;return j.register(Uj).register(Zj).register(Pj),j}function Oj(){if(!I)I=Dj();return I}function b(j,w){return Oj().get(j,w)}var x=null;function Sj(){let j=new Wj;return j.register(Nj),j}function hj(){if(!x)x=Sj();return x}function D(j,w){return hj().get(j)}function k(j,w){let H=R(j,w);return _j(H)??void 0}function f(j,w){let H=z(j,w);return qj(H)??void 0}function m(j,w){let H=C(j,w);return Ij(H)??void 0}function y(j,w){let H=b(j,w);return Gj(H)??void 0}function p(j,w){let H=D(j,w);return Mj(H)??void 0}function Tj(){q=null}function vj(){M=null}function kj(){_=null}function fj(){I=null}function mj(){x=null}function Kw(){Tj(),vj(),kj(),fj(),mj()}import{defaultDocRegistry as yj}from"@contractspec/lib.contracts-spec/docs";function pj(j){return j?.trim().toLowerCase()??""}function dj(j){for(let w of j??[]){let H=yj.get(w);if(H)return H.route}return}function d(j,w,H,J){let $=j.meta.title??j.meta.key,Z=dj(j.meta.docId),U=j.meta.description;return{key:j.meta.key,version:j.meta.version,type:w,title:$,description:U,markdown:[`# ${$}`,`- Key: ${j.meta.key}`,`- Type: ${w}`,`- Version: ${j.meta.version}`,Z?`- Docs route: ${Z}`:"",U?`
+${U}`:""].filter(Boolean).join(`
+`),...Z?{route:Z}:{},...H?{schema:H}:{},...J?{policy:J}:{},tags:j.meta.tags??[],owners:j.meta.owners??[],stability:j.meta.stability}}function l(j){let w=j.includeSchema??!1,H=pj(j.type),J=R(j.key,j.version);if(J&&(!H||H==="operation"||H===J.meta.kind))return{reference:d(J,J.meta.kind,w?k(j.key,j.version):void 0,J.policy)};let $=[{type:"data-view",spec:b(j.key,j.version),schema:w?y(j.key,j.version):void 0},{type:"form",spec:D(j.key,j.version),schema:w?p(j.key,j.version):void 0},{type:"presentation",spec:C(j.key,j.version),schema:w?m(j.key,j.version):void 0},{type:"event",spec:z(j.key,j.version),schema:w?f(j.key,j.version):void 0}];for(let Z of $)if(Z.spec&&(!H||H===Z.type))return{reference:d(Z.spec,Z.type,Z.schema)};throw Error(`Contract reference not found: ${j.key}`)}import{defineCommand as P,defineSchemaModel as N,installOp as W,OperationSpecRegistry as lj}from"@contractspec/lib.contracts-spec";import{ContractReferenceInput as gj,ContractReferenceOutput as uj,DocsIndexInput as nj,DocsIndexOutput as cj}from"@contractspec/lib.contracts-spec/docs";import{ScalarTypeEnum as F}from"@contractspec/lib.schema";var A=["@contractspec"],G=["docs","mcp"],ij=N({name:"DocsGetInput",fields:{id:{type:F.String_unsecure(),isOptional:!1}}}),aj=N({name:"DocsGetOutput",fields:{doc:{type:F.JSON(),isOptional:!1},content:{type:F.String_unsecure(),isOptional:!1}}}),oj=N({name:"DocsResolveRouteInput",fields:{route:{type:F.String_unsecure(),isOptional:!1}}}),sj=N({name:"DocsResolveRouteOutput",fields:{doc:{type:F.JSON(),isOptional:!1},content:{type:F.String_unsecure(),isOptional:!1}}}),tj=N({name:"DocsFacetsInput",fields:{}}),rj=N({name:"DocsFacetsOutput",fields:{facets:{type:F.JSON(),isOptional:!1}}});function Ww(j){let w=new lj;return W(w,P({meta:{key:"docs.search",version:"1.0.0",stability:"beta",owners:A,tags:G,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:nj,output:cj},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_search-v1_0_0"}}}),async(H)=>S(j,H)),W(w,P({meta:{key:"docs.get",version:"1.0.0",stability:"beta",owners:A,tags:G,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:ij,output:aj},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_get-v1_0_0"}}}),async({id:H})=>{let J=h(H);if(!J)throw Error(`DocBlock not found: ${H}`);return J}),W(w,P({meta:{key:"docs.resolveRoute",version:"1.0.0",stability:"beta",owners:A,tags:G,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:oj,output:sj},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_resolve_route-v1_0_0"}}}),async({route:H})=>{let J=T(j,H);if(!J)throw Error(`Doc route not found: ${H}`);return J}),W(w,P({meta:{key:"docs.contract.lookup",version:"1.0.0",stability:"beta",owners:A,tags:G,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:gj,output:uj},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_contract_reference-v1_0_0"}}}),async(H)=>l(H)),W(w,P({meta:{key:"docs.list.facets",version:"1.0.0",stability:"beta",owners:A,tags:G,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:tj,output:rj},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_list_facets-v1_0_0"}}}),async()=>({facets:v(j)})),w}export{Ww as buildDocOps};