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

package/dist/content/validation/agent-operational-content-schemas.d.ts

@@ -141,7 +141,7 @@ export declare const agentInstructionTemplateContentSchema: z.ZodObject<{
     appliesToProfiles: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
 }, "strict", z.ZodTypeAny, {
     id: string;
-    kind: "message" | "summary" | "plan" | "status";
+    kind: "message" | "summary" | "status" | "plan";
     description: string;
     title: string;
     revision: number;
@@ -151,7 +151,7 @@ export declare const agentInstructionTemplateContentSchema: z.ZodObject<{
     outputSkeleton?: string | undefined;
 }, {
     id: string;
-    kind: "message" | "summary" | "plan" | "status";
+    kind: "message" | "summary" | "status" | "plan";
     description: string;
     title: string;
     revision: number;
@@ -470,8 +470,8 @@ export declare const assignmentSummaryContentSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     id: string;
     summary: string;
-    blockers: string[];
     status: "completed" | "cancelled" | "failed" | "suspended";
+    blockers: string[];
     projectId: string;
     teamId: string;
     title: string;
@@ -811,7 +811,7 @@ export declare const agentOperationalContentSchemas: {
         appliesToProfiles: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
     }, "strict", z.ZodTypeAny, {
         id: string;
-        kind: "message" | "summary" | "plan" | "status";
+        kind: "message" | "summary" | "status" | "plan";
         description: string;
         title: string;
         revision: number;
@@ -821,7 +821,7 @@ export declare const agentOperationalContentSchemas: {
         outputSkeleton?: string | undefined;
     }, {
         id: string;
-        kind: "message" | "summary" | "plan" | "status";
+        kind: "message" | "summary" | "status" | "plan";
         description: string;
         title: string;
         revision: number;
@@ -1140,8 +1140,8 @@ export declare const agentOperationalContentSchemas: {
     }, "strict", z.ZodTypeAny, {
         id: string;
         summary: string;
-        blockers: string[];
         status: "completed" | "cancelled" | "failed" | "suspended";
+        blockers: string[];
         projectId: string;
         teamId: string;
         title: string;

package/dist/content/validation/content-model-schemas.d.ts

@@ -144,7 +144,7 @@ declare const schemas: {
         appliesToProfiles: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
     }, "strict", z.ZodTypeAny, {
         id: string;
-        kind: "message" | "summary" | "plan" | "status";
+        kind: "message" | "summary" | "status" | "plan";
         description: string;
         title: string;
         revision: number;
@@ -154,7 +154,7 @@ declare const schemas: {
         outputSkeleton?: string | undefined;
     }, {
         id: string;
-        kind: "message" | "summary" | "plan" | "status";
+        kind: "message" | "summary" | "status" | "plan";
         description: string;
         title: string;
         revision: number;
@@ -473,8 +473,8 @@ declare const schemas: {
     }, "strict", z.ZodTypeAny, {
         id: string;
         summary: string;
-        blockers: string[];
         status: "completed" | "cancelled" | "failed" | "suspended";
+        blockers: string[];
         projectId: string;
         teamId: string;
         title: string;
@@ -9799,8 +9799,8 @@ declare const schemas: {
         description: string;
         slug: string;
         contract: "treeseed.group/v1";
-        aliases?: string[] | undefined;
         status?: "active" | "archived" | undefined;
+        aliases?: string[] | undefined;
     }, {
         id: string;
         classification: string;
@@ -9808,8 +9808,8 @@ declare const schemas: {
         description: string;
         slug: string;
         contract: "treeseed.group/v1";
-        aliases?: string[] | undefined;
         status?: "active" | "archived" | undefined;
+        aliases?: string[] | undefined;
     }>;
     group_edge: z.ZodObject<{
         contract: z.ZodLiteral<"treeseed.group-edge/v1">;
@@ -11561,7 +11561,7 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         mergePolicy: "replace" | "append";
     } | {
         id: string;
-        kind: "message" | "summary" | "plan" | "status";
+        kind: "message" | "summary" | "status" | "plan";
         description: string;
         title: string;
         revision: number;
@@ -11634,8 +11634,8 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
     } | {
         id: string;
         summary: string;
-        blockers: string[];
         status: "completed" | "cancelled" | "failed" | "suspended";
+        blockers: string[];
         projectId: string;
         teamId: string;
         title: string;
@@ -11896,8 +11896,8 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         description: string;
         slug: string;
         contract: "treeseed.group/v1";
-        aliases?: string[] | undefined;
         status?: "active" | "archived" | undefined;
+        aliases?: string[] | undefined;
     } | {
         id: string;
         contract: "treeseed.group-edge/v1";
@@ -20516,7 +20516,7 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     appliesToProfiles: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
 }, "strict", z.ZodTypeAny, {
     id: string;
-    kind: "message" | "summary" | "plan" | "status";
+    kind: "message" | "summary" | "status" | "plan";
     description: string;
     title: string;
     revision: number;
@@ -20526,7 +20526,7 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     outputSkeleton?: string | undefined;
 }, {
     id: string;
-    kind: "message" | "summary" | "plan" | "status";
+    kind: "message" | "summary" | "status" | "plan";
     description: string;
     title: string;
     revision: number;
@@ -20841,8 +20841,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
 }, "strict", z.ZodTypeAny, {
     id: string;
     summary: string;
-    blockers: string[];
     status: "completed" | "cancelled" | "failed" | "suspended";
+    blockers: string[];
     projectId: string;
     teamId: string;
     title: string;
@@ -21686,8 +21686,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     description: string;
     slug: string;
     contract: "treeseed.group/v1";
-    aliases?: string[] | undefined;
     status?: "active" | "archived" | undefined;
+    aliases?: string[] | undefined;
 }, {
     id: string;
     classification: string;
@@ -21695,8 +21695,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     description: string;
     slug: string;
     contract: "treeseed.group/v1";
-    aliases?: string[] | undefined;
     status?: "active" | "archived" | undefined;
+    aliases?: string[] | undefined;
 }> | z.ZodObject<{
     contract: z.ZodLiteral<"treeseed.group-edge/v1">;
     id: z.ZodString;

package/dist/content/validation/portable-content-data.d.ts

@@ -1743,7 +1743,7 @@ export declare function validatePortableContentData(model: string, value: unknow
         mergePolicy: "replace" | "append";
     } | {
         id: string;
-        kind: "message" | "summary" | "plan" | "status";
+        kind: "message" | "summary" | "status" | "plan";
         description: string;
         title: string;
         revision: number;
@@ -1816,8 +1816,8 @@ export declare function validatePortableContentData(model: string, value: unknow
     } | {
         id: string;
         summary: string;
-        blockers: string[];
         status: "completed" | "cancelled" | "failed" | "suspended";
+        blockers: string[];
         projectId: string;
         teamId: string;
         title: string;
@@ -2078,8 +2078,8 @@ export declare function validatePortableContentData(model: string, value: unknow
         description: string;
         slug: string;
         contract: "treeseed.group/v1";
-        aliases?: string[] | undefined;
         status?: "active" | "archived" | undefined;
+        aliases?: string[] | undefined;
     } | {
         id: string;
         contract: "treeseed.group-edge/v1";

package/dist/operator-contracts/mcp.d.ts

@@ -74,5 +74,9 @@ export interface McpCatalog {
         resourceSubscriptions: true;
     };
 }
+export declare const TREESEED_MCP_PROMPTS: readonly McpPromptDescriptor[];
+export declare function operationToMcpResource(operation: ControlPlaneOperationDescriptor): McpResourceDescriptor | null;
 export declare function operationToMcpTool(operation: ControlPlaneOperationDescriptor): McpToolDescriptor | null;
 export declare function buildMcpTools(operations: readonly ControlPlaneOperationDescriptor[]): McpToolDescriptor[];
+export declare function buildMcpResources(operations: readonly ControlPlaneOperationDescriptor[]): McpResourceDescriptor[];
+export declare function buildMcpCatalog(operations: readonly ControlPlaneOperationDescriptor[]): McpCatalog;

package/dist/operator-contracts/mcp.js

@@ -1,4 +1,38 @@
 const MCP_PROTOCOL_VERSION = "2026-07-28";
+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 +50,28 @@ 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,
+  operationToMcpResource,
   operationToMcpTool
 };

package/package.json

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