@treeseed/sdk 0.13.0-rc.16 → 0.13.0-rc.18

package/dist/operator-contracts/mcp.js

@@ -1,4 +1,44 @@
 const MCP_PROTOCOL_VERSION = "2026-07-28";
+function encodeConfirmationState(state) {
+  const bytes = new TextEncoder().encode(JSON.stringify(state));
+  let binary = "";
+  for (const byte of bytes) binary += String.fromCharCode(byte);
+  return btoa(binary).replace(/\+/gu, "-").replace(/\//gu, "_").replace(/=+$/gu, "");
+}
+const TREESEED_MCP_PROMPTS = [
+  { name: "operate", description: "Operate TreeSeed through currently discoverable capabilities.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] },
+  { name: "research", description: "Research a governed TreeSeed question and accumulate knowledge.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] },
+  { name: "governance-review", description: "Review a proposal or decision using current governance evidence.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] },
+  { name: "workday-planning", description: "Plan a time-based workday without bypassing API authority.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] },
+  { name: "project-agent-chat", description: "Prepare an explicit governed project-agent chat invocation.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] }
+];
+function resourcePath(restPath) {
+  const [root, version, ...segments] = restPath.split("/");
+  if (root !== "" || version !== "v1" || segments.length === 0) throw new Error(`MCP resource requires a versioned control-plane REST path: ${restPath}`);
+  const path = segments.join("/");
+  if (path === "me") return "accounts/current";
+  return path.replace(/^platform\/operations(?=\/|$)/u, "operations").replace(/^capacity-plans(?=\/|$)/u, "plans").replace(/\/workday-runs(?=\/|$)/u, "/workdays").replace(/\/capacity\/assignments(?=\/|$)/u, "/assignments");
+}
+function operationToMcpResource(operation) {
+  if (!operation.surfaces.includes("mcp_resource")) return null;
+  if (operation.kind !== "read" || operation.rest.method !== "GET") {
+    throw new Error(`MCP resource operation ${operation.operationId} must be a read-only GET operation.`);
+  }
+  const uriTemplate = `treeseed://${resourcePath(operation.rest.path)}`;
+  const parameters = (value) => [...value.matchAll(/\{([^}]+)\}/gu)].map((match) => match[1]).sort();
+  if (JSON.stringify(parameters(uriTemplate)) !== JSON.stringify(parameters(operation.rest.path))) {
+    throw new Error(`MCP resource ${operation.operationId} must preserve its REST path parameter names.`);
+  }
+  return {
+    uriTemplate,
+    name: operation.operationId,
+    description: operation.description,
+    mimeType: "application/json",
+    operationId: operation.operationId,
+    subscribable: true,
+    ...operation.operationId === "status.show" ? { cacheTtlSeconds: 10 } : {}
+  };
+}
 function operationToMcpTool(operation) {
   if (!operation.surfaces.includes("mcp_tool")) return null;
   return {
@@ -16,8 +56,29 @@ function operationToMcpTool(operation) {
 function buildMcpTools(operations) {
   return operations.map(operationToMcpTool).filter((tool) => tool !== null).sort((left, right) => left.name.localeCompare(right.name));
 }
+function buildMcpResources(operations) {
+  const resources = operations.map(operationToMcpResource).filter((resource) => resource !== null).sort((left, right) => left.uriTemplate.localeCompare(right.uriTemplate));
+  const uriTemplates = new Set(resources.map(({ uriTemplate }) => uriTemplate));
+  if (uriTemplates.size !== resources.length) throw new Error("MCP resource URI templates must be unique.");
+  return resources;
+}
+function buildMcpCatalog(operations) {
+  return {
+    schemaVersion: "treeseed.mcp-catalog/v1",
+    protocolVersion: MCP_PROTOCOL_VERSION,
+    tools: buildMcpTools(operations),
+    resources: buildMcpResources(operations),
+    prompts: [...TREESEED_MCP_PROMPTS],
+    capabilities: { completion: true, progress: true, cancellation: true, inputRequired: true, resourceSubscriptions: true }
+  };
+}
 export {
   MCP_PROTOCOL_VERSION,
+  TREESEED_MCP_PROMPTS,
+  buildMcpCatalog,
+  buildMcpResources,
   buildMcpTools,
+  encodeConfirmationState,
+  operationToMcpResource,
   operationToMcpTool
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.13.0-rc.16",
+  "version": "0.13.0-rc.18",
   "description": "Portable TreeSeed contracts, standards, and typed remote control-plane clients.",
   "license": "Apache-2.0",
   "repository": {