@treeseed/sdk 0.13.0-rc.15 → 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;
@@ -1679,7 +1679,7 @@ declare const schemas: {
         related_proposals?: string[] | undefined;
         related_decisions?: string[] | undefined;
         related_books?: string[] | undefined;
-        question_type?: "evaluation" | "research" | "implementation" | "knowledge-gap" | "strategy" | undefined;
+        question_type?: "research" | "evaluation" | "implementation" | "knowledge-gap" | "strategy" | undefined;
         motivation?: string | undefined;
         primary_contributor?: string | undefined;
     }, {
@@ -1701,7 +1701,7 @@ declare const schemas: {
         related_proposals?: string[] | undefined;
         related_decisions?: string[] | undefined;
         related_books?: string[] | undefined;
-        question_type?: "evaluation" | "research" | "implementation" | "knowledge-gap" | "strategy" | undefined;
+        question_type?: "research" | "evaluation" | "implementation" | "knowledge-gap" | "strategy" | undefined;
         motivation?: string | undefined;
         primary_contributor?: string | undefined;
     }>;
@@ -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;
@@ -11744,7 +11744,7 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         related_proposals?: string[] | undefined;
         related_decisions?: string[] | undefined;
         related_books?: string[] | undefined;
-        question_type?: "evaluation" | "research" | "implementation" | "knowledge-gap" | "strategy" | undefined;
+        question_type?: "research" | "evaluation" | "implementation" | "knowledge-gap" | "strategy" | undefined;
         motivation?: string | undefined;
         primary_contributor?: string | undefined;
     } | {
@@ -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;
@@ -21187,7 +21187,7 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     related_proposals?: string[] | undefined;
     related_decisions?: string[] | undefined;
     related_books?: string[] | undefined;
-    question_type?: "evaluation" | "research" | "implementation" | "knowledge-gap" | "strategy" | undefined;
+    question_type?: "research" | "evaluation" | "implementation" | "knowledge-gap" | "strategy" | undefined;
     motivation?: string | undefined;
     primary_contributor?: string | undefined;
 }, {
@@ -21209,7 +21209,7 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     related_proposals?: string[] | undefined;
     related_decisions?: string[] | undefined;
     related_books?: string[] | undefined;
-    question_type?: "evaluation" | "research" | "implementation" | "knowledge-gap" | "strategy" | undefined;
+    question_type?: "research" | "evaluation" | "implementation" | "knowledge-gap" | "strategy" | undefined;
     motivation?: string | undefined;
     primary_contributor?: string | undefined;
 }> | z.ZodObject<{
@@ -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;
@@ -1926,7 +1926,7 @@ export declare function validatePortableContentData(model: string, value: unknow
         related_proposals?: string[] | undefined;
         related_decisions?: string[] | undefined;
         related_books?: string[] | undefined;
-        question_type?: "evaluation" | "research" | "implementation" | "knowledge-gap" | "strategy" | undefined;
+        question_type?: "research" | "evaluation" | "implementation" | "knowledge-gap" | "strategy" | undefined;
         motivation?: string | undefined;
         primary_contributor?: string | undefined;
     } | {
@@ -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/control-plane-operations.d.ts

@@ -255,6 +255,79 @@ export declare const CONTROL_PLANE_OPERATIONS: {
             approvalId: string;
         }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
     };
+    readonly planning: {
+        readonly status: ControlPlaneOperationBinding<{
+            decisionId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly requestInput: ControlPlaneOperationBinding<{
+            decisionId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly executionInputs: ControlPlaneOperationBinding<{
+            decisionId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly createExecutionInput: ControlPlaneOperationBinding<{
+            decisionId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly acceptExecutionInput: ControlPlaneOperationBinding<{
+            inputId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly requestExecutionInputRevision: ControlPlaneOperationBinding<{
+            inputId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    };
+    readonly estimates: {
+        readonly create: ControlPlaneOperationBinding<{
+            decisionId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly list: ControlPlaneOperationBinding<{
+            decisionId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly accept: ControlPlaneOperationBinding<{
+            estimateId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly reject: ControlPlaneOperationBinding<{
+            estimateId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    };
+    readonly assignmentGraphs: {
+        readonly validateAuthority: ControlPlaneOperationBinding<{}, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly compile: ControlPlaneOperationBinding<{
+            decisionId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly list: ControlPlaneOperationBinding<{
+            decisionId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly show: ControlPlaneOperationBinding<{
+            graphId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly manifest: ControlPlaneOperationBinding<{
+            manifestId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly createManifest: ControlPlaneOperationBinding<{
+            contractId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly approveContract: ControlPlaneOperationBinding<{
+            contractId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly rejectContract: ControlPlaneOperationBinding<{
+            contractId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    };
+    readonly research: {
+        readonly createWorkflow: ControlPlaneOperationBinding<{
+            projectId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly workflows: ControlPlaneOperationBinding<{
+            projectId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly workflow: ControlPlaneOperationBinding<{
+            workflowId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly completeStage: ControlPlaneOperationBinding<{
+            stage: string;
+            workflowId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    };
     readonly repositories: {
         readonly githubSetup: ControlPlaneOperationBinding<{
             kind: string;
@@ -367,6 +440,28 @@ export declare const CONTROL_PLANE_OPERATIONS: {
             artifactId: string;
         }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
     };
+    readonly communications: {
+        readonly invocations: ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly invocation: ControlPlaneOperationBinding<{
+            teamId: string;
+            invocationId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly status: ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly handoffs: ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly clientActions: ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly cancelInvocation: ControlPlaneOperationBinding<{
+            teamId: string;
+            invocationId: string;
+        }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    };
     readonly capacity: {
         readonly availability: ControlPlaneOperationBinding<{
             teamId: string;

package/dist/operator-contracts/control-plane-operations.js

@@ -221,6 +221,36 @@ const CONTROL_PLANE_OPERATIONS = {
     approval: resource("governance.approvals.show", "GET", "/v1/projects/{projectId}/approvals/{approvalId}", { projectId: z.string().min(1), approvalId: z.string().min(1) }, { capability: "governance.read" }),
     decideApproval: resource("governance.approvals.decide", "POST", "/v1/projects/{projectId}/approvals/{approvalId}/decision", { projectId: z.string().min(1), approvalId: z.string().min(1) }, { capability: "governance.decide", scopes: ["treeseed:governance:write"], risk: "authority", concurrency: true })
   },
+  planning: {
+    status: resource("planning.status.show", "GET", "/v1/decisions/{decisionId}/planning-status", { decisionId: z.string().min(1) }, { capability: "planning.read", surfaces: ["rest", "mcp_resource"] }),
+    requestInput: resource("planning.input.requests.create", "POST", "/v1/decisions/{decisionId}/planning-input-requests", { decisionId: z.string().min(1) }, { capability: "planning.write", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    executionInputs: resource("planning.execution.inputs.list", "GET", "/v1/decisions/{decisionId}/execution-inputs", { decisionId: z.string().min(1) }, { capability: "planning.read", surfaces: ["rest", "mcp_tool", "mcp_resource"], pagination: "cursor" }),
+    createExecutionInput: resource("planning.execution.inputs.create", "POST", "/v1/decisions/{decisionId}/execution-inputs", { decisionId: z.string().min(1) }, { capability: "planning.write", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    acceptExecutionInput: resource("planning.execution.inputs.accept", "POST", "/v1/decision-execution-inputs/{inputId}/accept", { inputId: z.string().min(1) }, { capability: "planning.decide", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    requestExecutionInputRevision: resource("planning.execution.inputs.revision.request", "POST", "/v1/decision-execution-inputs/{inputId}/request-revision", { inputId: z.string().min(1) }, { capability: "planning.decide", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] })
+  },
+  estimates: {
+    create: resource("estimates.create", "POST", "/v1/decisions/{decisionId}/estimates", { decisionId: z.string().min(1) }, { capability: "estimates.write", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    list: resource("estimates.list", "GET", "/v1/decisions/{decisionId}/estimates", { decisionId: z.string().min(1) }, { capability: "estimates.read", surfaces: ["rest", "mcp_tool", "mcp_resource"], pagination: "cursor" }),
+    accept: resource("estimates.accept", "POST", "/v1/structured-agent-estimates/{estimateId}/accept", { estimateId: z.string().min(1) }, { capability: "estimates.decide", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    reject: resource("estimates.reject", "POST", "/v1/structured-agent-estimates/{estimateId}/reject", { estimateId: z.string().min(1) }, { capability: "estimates.decide", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] })
+  },
+  assignmentGraphs: {
+    validateAuthority: resource("assignment.graphs.authority.validate", "POST", "/v1/governance/execution-authorities/validate", {}, { capability: "assignments.read", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    compile: resource("assignment.graphs.compile", "POST", "/v1/decisions/{decisionId}/assignment-graphs/compile", { decisionId: z.string().min(1) }, { capability: "assignments.execute", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    list: resource("assignment.graphs.list", "GET", "/v1/decisions/{decisionId}/assignment-graphs", { decisionId: z.string().min(1) }, { capability: "assignments.read", surfaces: ["rest", "mcp_tool", "mcp_resource"], pagination: "cursor" }),
+    show: resource("assignment.graphs.show", "GET", "/v1/decision-assignment-graphs/{graphId}", { graphId: z.string().min(1) }, { capability: "assignments.read", surfaces: ["rest", "mcp_resource"] }),
+    manifest: resource("assignment.deliverable.manifests.show", "GET", "/v1/deliverable-manifests/{manifestId}", { manifestId: z.string().min(1) }, { capability: "assignments.read", surfaces: ["rest", "mcp_resource"] }),
+    createManifest: resource("assignment.deliverable.manifests.create", "POST", "/v1/deliverable-contracts/{contractId}/manifests", { contractId: z.string().min(1) }, { capability: "assignments.execute", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    approveContract: resource("assignment.deliverable.contracts.approve", "POST", "/v1/deliverable-contracts/{contractId}/approve", { contractId: z.string().min(1) }, { capability: "assignments.decide", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] }),
+    rejectContract: resource("assignment.deliverable.contracts.reject", "POST", "/v1/deliverable-contracts/{contractId}/reject", { contractId: z.string().min(1) }, { capability: "assignments.decide", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"] })
+  },
+  research: {
+    createWorkflow: resource("research.workflows.create", "POST", "/v1/projects/{projectId}/research-workflows", { projectId: z.string().min(1) }, { capability: "research.write", scopes: ["treeseed:knowledge:write"], surfaces: ["rest", "mcp_tool"] }),
+    workflows: resource("research.workflows.list", "GET", "/v1/projects/{projectId}/research-workflows", { projectId: z.string().min(1) }, { capability: "research.read", surfaces: ["rest", "mcp_tool", "mcp_resource"], pagination: "cursor" }),
+    workflow: resource("research.workflows.show", "GET", "/v1/research-workflows/{workflowId}", { workflowId: z.string().min(1) }, { capability: "research.read", surfaces: ["rest", "mcp_resource"] }),
+    completeStage: resource("research.workflows.stages.complete", "POST", "/v1/research-workflows/{workflowId}/stages/{stage}/complete", { workflowId: z.string().min(1), stage: z.string().min(1) }, { capability: "research.write", scopes: ["treeseed:knowledge:write"], surfaces: ["rest", "mcp_tool"], concurrency: true })
+  },
   repositories: {
     githubSetup: resource("repositories.github.setup", "POST", "/v1/provider-connectors/github/{kind}/setup", { kind: z.string().min(1) }, { capability: "repositories.connect", scopes: ["treeseed:projects:write"], risk: "authority" }),
     githubCallback: resource("repositories.github.callback", "GET", "/v1/provider-connectors/github/{kind}/callback", { kind: z.string().min(1) }, { capability: "repositories.connect", scopes: [], authentication: "signed_request" }),
@@ -258,6 +288,14 @@ const CONTROL_PLANE_OPERATIONS = {
     artifacts: resource("agents.artifacts.list", "GET", "/v1/projects/{projectId}/agent-artifacts", { projectId: z.string().min(1) }, { capability: "agents.read", pagination: "cursor" }),
     artifact: resource("agents.artifacts.show", "GET", "/v1/projects/{projectId}/agent-artifacts/{artifactId}", { projectId: z.string().min(1), artifactId: z.string().min(1) }, { capability: "agents.read" })
   },
+  communications: {
+    invocations: resource("communications.invocations.list", "GET", "/v1/teams/{teamId}/agent-invocations", { teamId: z.string().min(1) }, { capability: "agents.read", surfaces: ["rest", "mcp_tool", "mcp_resource"], pagination: "cursor" }),
+    invocation: resource("communications.invocations.show", "GET", "/v1/teams/{teamId}/agent-invocations/{invocationId}", { teamId: z.string().min(1), invocationId: z.string().min(1) }, { capability: "agents.read", surfaces: ["rest", "mcp_resource"] }),
+    status: resource("communications.status.show", "GET", "/v1/teams/{teamId}/communication-status", { teamId: z.string().min(1) }, { capability: "agents.read", surfaces: ["rest", "mcp_tool", "mcp_resource"] }),
+    handoffs: resource("communications.handoffs.list", "GET", "/v1/teams/{teamId}/operation-handoffs", { teamId: z.string().min(1) }, { capability: "agents.read", surfaces: ["rest", "mcp_resource"], pagination: "cursor" }),
+    clientActions: resource("communications.client.actions.list", "GET", "/v1/teams/{teamId}/client-actions", { teamId: z.string().min(1) }, { capability: "agents.read", surfaces: ["rest", "mcp_resource"], pagination: "cursor" }),
+    cancelInvocation: resource("communications.invocations.cancel", "POST", "/v1/teams/{teamId}/agent-invocations/{invocationId}/cancel", { teamId: z.string().min(1), invocationId: z.string().min(1) }, { capability: "agents.execute", scopes: ["treeseed:execution"], surfaces: ["rest", "mcp_tool"], risk: "destructive", concurrency: true })
+  },
   capacity: {
     availability: resource("capacity.status", "GET", "/v1/teams/{teamId}/capacity/availability-sessions", { teamId: z.string().min(1) }, { capability: "capacity.read", surfaces: ["rest", "cli", "mcp_tool"], pagination: "cursor" }),
     usage: resource("capacity.usage", "GET", "/v1/teams/{teamId}/capacity/usage", { teamId: z.string().min(1) }, { capability: "capacity.read", surfaces: ["rest", "cli", "mcp_tool"] }),

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.15",
+  "version": "0.13.0-rc.17",
   "description": "Portable TreeSeed contracts, standards, and typed remote control-plane clients.",
   "license": "Apache-2.0",
   "repository": {