@treeseed/sdk 0.13.0-rc.52 → 0.13.0-rc.54

package/dist/operator-contracts/canonical-command-tree.js

@@ -14,7 +14,11 @@ const operationBindings = {
   "auth logout": protocol("protocol.oauth.revoke"),
   "auth status": operation("accounts.current.show"),
   "users create": protocol("protocol.accounts.create"),
-  "send": operation("communications.send", [field("path", "teamId", "context", "team", true), field("path", "channel", "argument", "channel", true), field("body", "message", "argument", "message", true), field("body", "projectId", "context", "project", true), field("body", "recipients", "option", "to"), field("body", "timeoutSeconds", "option", "timeout", false, "integer")]),
+  "send": operation("communications.send", [field("path", "teamId", "context", "team", true), field("path", "channel", "argument", "channel"), field("body", "message", "argument", "message"), field("body", "recipients", "option", "to"), field("body", "timeoutSeconds", "option", "timeout", false, "integer")]),
+  "topics list": operation("communications.topics.list", [field("path", "teamId", "context", "team", true), ...page()]),
+  "topics show": operation("communications.topics.show", [field("path", "teamId", "context", "team", true), field("path", "channel", "argument", "topic", true)]),
+  "topics subscribe": operation("communications.topics.subscriptions.put", [field("path", "teamId", "context", "team", true), field("path", "channel", "argument", "topic", true), field("body", "agent", "argument", "agent", true)]),
+  "topics unsubscribe": operation("communications.topics.subscriptions.delete", [field("path", "teamId", "context", "team", true), field("path", "channel", "argument", "topic", true), field("body", "agent", "argument", "agent", true)]),
   "teams list": operation("teams.list", page()),
   "teams current": local("local.teams.current"),
   "teams use": local("local.teams.use"),
@@ -47,6 +51,10 @@ const operationBindings = {
   "host topology": local("local.host.topology"),
   "host connections": local("local.host.connections"),
   "host provider status": local("local.host.provider.status"),
+  "host storage status": local("local.host.storage.status"),
+  "host storage connect": local("local.host.storage.connect"),
+  "host storage reconcile": local("local.host.storage.reconcile"),
+  "host storage rotate": local("local.host.storage.rotate"),
   "host fleet status": local("local.host.fleet.status"),
   "host recovery status": local("local.host.recovery.status"),
   "host recovery retry": local("local.host.recovery.retry"),
@@ -92,8 +100,8 @@ const operationBindings = {
   "seeds verify": operation("seeds.verify", [field("path", "name", "argument", "seed", true)]),
   "plans list": operation("plans.list", [field("path", "decisionId", "option", "decision", true), ...page()]),
   "plans show": operation("plans.show", [field("path", "capacityPlanId", "argument", "plan", true)]),
-  "workdays plan": operation("workdays.plan", [field("path", "teamId", "context", "team", true), field("body", "profile", "option"), field("body", "projects", "option", "projects", false, "csv"), field("body", "start", "option"), field("body", "end", "option"), field("body", "duration", "option", "duration", false, "integer"), field("body", "objective", "option")]),
-  "workdays start": operation("workdays.start", [field("path", "teamId", "context", "team", true), field("body", "preflightId", "option", "preflight", true), field("body", "digest", "option", "digest", true)]),
+  "workdays plan": operation("workdays.plan", [field("path", "teamId", "context", "team", true), field("body", "profileId", "option", "profile"), field("body", "projects", "option", "projects", false, "csv"), field("body", "startsAt", "option", "start"), field("body", "endsAt", "option", "end"), field("body", "durationSeconds", "option", "duration", false, "integer"), field("body", "objectiveFilters", "option", "objective", false, "csv")]),
+  "workdays start": operation("workdays.start", [field("path", "teamId", "context", "team", true), field("body", "preflightId", "option", "preflight", true), field("body", "preflightDigest", "option", "digest", true)]),
   "workdays list": operation("workdays.list", [field("path", "teamId", "context", "team", true), ...page()]),
   "workdays show": operation("workdays.show", [field("path", "teamId", "context", "team", true), field("path", "runId", "argument", "workday", true)]),
   "workdays schedules list": operation("workdays.schedules.list", [field("path", "teamId", "context", "team", true)]),
@@ -166,7 +174,7 @@ function branch(segment, children) {
   return { nodeType: "branch", segment, description: `${segment[0].toUpperCase()}${segment.slice(1)} operations.`, children };
 }
 function configurationAdopt() {
-  const value = leaf("adopt", "mutation", "file", "authority");
+  const value = leaf("adopt", "mutation", "file", "destructive");
   if (value.nodeType !== "leaf") throw new Error("Configuration adoption must be a leaf command.");
   value.options = [...value.options ?? [], { name: "--confirm", description: "Confirm replacement of the installed configuration identity.", type: "boolean" }];
   return value;
@@ -246,7 +254,14 @@ const commandTree = {
   schemaVersion: "treeseed.command-tree/v1",
   executable: "trsd",
   commands: [
-    { nodeType: "leaf", segment: "send", description: "Send a message to addressed project agents in a team discussion topic.", kind: "mutation", arguments: [{ name: "channel", description: "Team discussion-topic channel.", required: true }, { name: "message", description: "Markdown message containing agent addresses.", required: true }], options: [planOption, { name: "--team", description: "One-command team override.", type: "string" }, { name: "--project", description: "Project for agent resolution and the topic stream.", type: "string", required: true }, { name: "--to", description: "Deprecated validation-only address list.", type: "string[]" }, { name: "--timeout", description: "Maximum seconds to wait for the complete response chain.", type: "number", defaultValue: 1800 }, { name: "--no-wait", description: "Return immediately after durable admission.", type: "boolean" }, { name: "--wait", description: "Deprecated wait duration in seconds.", type: "number" }], authorization: { capability: "agents.execute", confirmation: "never" }, resultSchemaId: "treeseed.communication-send-receipt/v2", execution: unavailable() },
+    { nodeType: "leaf", segment: "inbox", description: "Open the active team governance inbox.", kind: "read", options: [{ name: "--project", description: "Initial project filter.", type: "string" }, { name: "--type", description: "Initial proposal, question, or all filter.", type: "string" }, { name: "--all", description: "Include completed and decided items.", type: "boolean" }], resultSchemaId: "treeseed.inbox-session/v1", execution: local("local.inbox") },
+    { nodeType: "leaf", segment: "send", description: "Send a message or open the interactive team topic browser.", kind: "mutation", arguments: [{ name: "channel", description: "Optional team discussion topic to preselect.", required: false }, { name: "message", description: "Markdown message containing agent addresses.", required: false }], options: [planOption, { name: "--team", description: "One-command team override.", type: "string" }, { name: "--to", description: "Deprecated validation-only address list.", type: "string[]" }, { name: "--timeout", description: "Optional maximum seconds to listen for the complete response chain.", type: "number" }, { name: "--no-wait", description: "Return immediately after durable admission.", type: "boolean" }, { name: "--wait", description: "Deprecated wait duration in seconds.", type: "number" }, { name: "--json-stream", description: "Emit ordered communication events as NDJSON.", type: "boolean" }, { name: "--diagnostics", description: "Diagnostic detail: metadata or full.", type: "string" }], authorization: { capability: "agents.execute", confirmation: "never" }, resultSchemaId: "treeseed.communication-send-receipt/v4", execution: unavailable() },
+    branch("topics", [
+      { nodeType: "leaf", segment: "list", description: "List discussion topics and active listeners.", kind: "read", options: [{ name: "--status", description: "Topic status.", type: "string" }, { name: "--limit", description: "Maximum topics.", type: "number" }, { name: "--cursor", description: "Pagination cursor.", type: "string" }], resultSchemaId: "treeseed.communication-topic-page/v1", execution: unavailable() },
+      { nodeType: "leaf", segment: "show", description: "Show a discussion topic and its listeners.", kind: "read", arguments: [{ name: "topic", description: "Discussion topic.", required: true }], resultSchemaId: "treeseed.communication-topic/v1", execution: unavailable() },
+      { nodeType: "leaf", segment: "subscribe", description: "Subscribe an agent to a discussion topic.", kind: "mutation", arguments: [{ name: "topic", description: "Discussion topic.", required: true }, { name: "agent", description: "@project/agent handle.", required: true }], options: [planOption], authorization: { capability: "agents.execute", confirmation: "never" }, resultSchemaId: "treeseed.communication-topic-subscription-receipt/v1", execution: unavailable() },
+      { nodeType: "leaf", segment: "unsubscribe", description: "Remove an agent subscription from a discussion topic.", kind: "mutation", arguments: [{ name: "topic", description: "Discussion topic.", required: true }, { name: "agent", description: "@project/agent handle.", required: true }], options: [planOption], authorization: { capability: "agents.execute", confirmation: "never" }, resultSchemaId: "treeseed.communication-topic-subscription-receipt/v1", execution: unavailable() }
+    ]),
     branch("auth", [authLogin(), leaf("logout", "mutation"), leaf("status")]),
     branch("users", [userCreate()]),
     branch("teams", [leaf("list"), { nodeType: "leaf", segment: "current", description: "Show the active team for this authenticated server session.", kind: "read", resultSchemaId: "treeseed.command.teams.current/v1", execution: unavailable() }, { nodeType: "leaf", segment: "use", description: "Select the active team for this authenticated server session.", kind: "mutation", arguments: [{ name: "team", description: "Team UUID or unambiguous slug.", required: true }], options: [planOption], authorization: { capability: "teams.read", confirmation: "never" }, resultSchemaId: "treeseed.command.teams.use/v1", execution: unavailable() }]),
@@ -275,6 +290,12 @@ const commandTree = {
       leaf("topology"),
       leaf("connections"),
       branch("provider", [leaf("status")]),
+      branch("storage", [
+        leaf("status"),
+        addOptions(leaf("connect", "mutation", "backend", "credential"), [{ name: "--account-id", description: "Optional Cloudflare account ID when the bootstrap authority reaches multiple accounts.", type: "string" }]),
+        leaf("reconcile", "mutation", void 0, "authority"),
+        leaf("rotate", "mutation", "backend", "credential")
+      ]),
       branch("fleet", [leaf("status")]),
       branch("update", [leaf("status"), leaf("check", "mutation"), leaf("apply", "mutation", void 0, "authority"), leaf("channel", "mutation", "track", "authority"), leaf("pause", "mutation", void 0, "authority"), leaf("resume", "mutation", void 0, "authority")]),
       branch("component", [leaf("list"), leaf("status", "read", "component"), leaf("enable", "mutation", "component", "authority"), leaf("disable", "mutation", "component", "destructive")]),

package/dist/operator-contracts/catalog/communication-operations.d.ts

@@ -4,12 +4,11 @@ export declare function communicationOperations(): {
         channel: string;
     }, {}, {
         message: string;
-        projectId: string;
         timeoutSeconds?: number | undefined;
         recipients?: string[] | undefined;
     }, {
         status: "failed" | "running" | "partial" | "complete" | "queued";
-        schemaVersion: "treeseed.communication-send-receipt/v2";
+        schemaVersion: "treeseed.communication-send-receipt/v4";
         targets: {
             status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
             projectId: string;
@@ -28,6 +27,28 @@ export declare function communicationOperations(): {
                 returnedAt: string | null;
                 failedAt: string | null;
             };
+            diagnostics: {
+                resources: Record<string, unknown>;
+                reason: string | null;
+                provider: {
+                    providerId: string | null;
+                    executionProviderId: string | null;
+                    runtimeVersion: string | null;
+                };
+                selection: {
+                    parameters: Record<string, unknown>;
+                    capabilities: string[];
+                    model: string | null;
+                };
+                usage: Record<string, unknown>[];
+                availability: "available" | "unavailable" | "partial";
+                identityManifest: Record<string, unknown>;
+                contextManifest: Record<string, unknown>[];
+                timing: Record<string, unknown>;
+                traceEvents: Record<string, unknown>[];
+                fullPayload?: Record<string, unknown> | undefined;
+            };
+            invocationId: string | null;
             projectSlug: string;
             definitionRevision: string;
             revisions: {
@@ -36,7 +57,6 @@ export declare function communicationOperations(): {
                 agentDefinition: string;
                 chatProfile: string;
             };
-            invocationId: string | null;
             requirement: "required" | "optional";
             parentInvocationId: string | null;
             depth: number;
@@ -46,6 +66,8 @@ export declare function communicationOperations(): {
                 code: string;
                 message: string | null;
             } | null;
+            acknowledgedAt: string | null;
+            leaseAcceptedAt: string | null;
         }[];
         createdAt: string;
         responses: {
@@ -55,34 +77,55 @@ export declare function communicationOperations(): {
             agentSlug: string;
             assignmentId: string | null;
             invocationId: string;
+            projectSlug: string;
             requirement: "required" | "optional";
             messageRef: string;
             markdown: string;
         }[];
         teamId: string;
         channel: string;
-        updatedAt: string;
-        messageRef: string;
-        sendId: string;
         topic: {
             id: string;
             slug: string;
         };
-        projectStream: {
+        events: {
+            type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+            id: string;
+            actor: {
+                kind: "control-plane" | "provider" | "agent" | "user";
+                id: string;
+                handle: string | null;
+            };
+            summary: string;
+            teamId: string;
+            channel: string;
+            assignmentId: string | null;
+            sequence: number;
+            topicId: string;
+            occurredAt: string;
+            sendId: string | null;
+            invocationId: string | null;
+            payload: Record<string, unknown>;
+        }[];
+        sendId: string;
+        updatedAt: string;
+        projectStreams: {
             id: string;
             projectId: string;
             projectSlug: string;
-        };
-        discussionId: string;
-        sourceMessage: string;
+            messageRef: string;
+            discussionId: string;
+        }[];
         replayed: boolean;
     }>;
     sendStatus: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
         teamId: string;
         sendId: string;
-    }, {}, undefined, {
+    }, {
+        diagnostics?: "metadata" | "full" | undefined;
+    }, undefined, {
         status: "failed" | "running" | "partial" | "complete" | "queued";
-        schemaVersion: "treeseed.communication-send-receipt/v2";
+        schemaVersion: "treeseed.communication-send-receipt/v4";
         targets: {
             status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
             projectId: string;
@@ -101,6 +144,28 @@ export declare function communicationOperations(): {
                 returnedAt: string | null;
                 failedAt: string | null;
             };
+            diagnostics: {
+                resources: Record<string, unknown>;
+                reason: string | null;
+                provider: {
+                    providerId: string | null;
+                    executionProviderId: string | null;
+                    runtimeVersion: string | null;
+                };
+                selection: {
+                    parameters: Record<string, unknown>;
+                    capabilities: string[];
+                    model: string | null;
+                };
+                usage: Record<string, unknown>[];
+                availability: "available" | "unavailable" | "partial";
+                identityManifest: Record<string, unknown>;
+                contextManifest: Record<string, unknown>[];
+                timing: Record<string, unknown>;
+                traceEvents: Record<string, unknown>[];
+                fullPayload?: Record<string, unknown> | undefined;
+            };
+            invocationId: string | null;
             projectSlug: string;
             definitionRevision: string;
             revisions: {
@@ -109,7 +174,6 @@ export declare function communicationOperations(): {
                 agentDefinition: string;
                 chatProfile: string;
             };
-            invocationId: string | null;
             requirement: "required" | "optional";
             parentInvocationId: string | null;
             depth: number;
@@ -119,6 +183,8 @@ export declare function communicationOperations(): {
                 code: string;
                 message: string | null;
             } | null;
+            acknowledgedAt: string | null;
+            leaseAcceptedAt: string | null;
         }[];
         createdAt: string;
         responses: {
@@ -128,34 +194,205 @@ export declare function communicationOperations(): {
             agentSlug: string;
             assignmentId: string | null;
             invocationId: string;
+            projectSlug: string;
             requirement: "required" | "optional";
             messageRef: string;
             markdown: string;
         }[];
         teamId: string;
         channel: string;
-        updatedAt: string;
-        messageRef: string;
+        topic: {
+            id: string;
+            slug: string;
+        };
+        events: {
+            type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+            id: string;
+            actor: {
+                kind: "control-plane" | "provider" | "agent" | "user";
+                id: string;
+                handle: string | null;
+            };
+            summary: string;
+            teamId: string;
+            channel: string;
+            assignmentId: string | null;
+            sequence: number;
+            topicId: string;
+            occurredAt: string;
+            sendId: string | null;
+            invocationId: string | null;
+            payload: Record<string, unknown>;
+        }[];
         sendId: string;
+        updatedAt: string;
+        projectStreams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            messageRef: string;
+            discussionId: string;
+        }[];
+        replayed: boolean;
+    }>;
+    topicsList: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {
+        status?: "active" | "archived" | undefined;
+        cursor?: string | undefined;
+        limit?: number | undefined;
+    }, undefined, {
+        items: {
+            status: "active" | "archived";
+            id: string;
+            createdAt: string;
+            teamId: string;
+            updatedAt: string;
+            slug: string;
+            streams: {
+                id: string;
+                projectId: string;
+                projectSlug: string;
+                discussionId: string;
+            }[];
+            listeners: {
+                status: "active" | "removed";
+                projectId: string;
+                source: "operator" | "seed" | "mention";
+                agentSlug: string;
+                projectSlug: string;
+                updatedAt: string;
+                agentHandle: string;
+                subscribedAt: string;
+            }[];
+        }[];
+        cursor: string | null;
+    }>;
+    topicsShow: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        channel: string;
+    }, {}, undefined, {
+        status: "active" | "archived";
+        id: string;
+        createdAt: string;
+        teamId: string;
+        updatedAt: string;
+        slug: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "operator" | "seed" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }[];
+    }>;
+    topicsTimeline: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        channel: string;
+    }, {
+        limit?: number | undefined;
+        diagnostics?: "metadata" | "full" | undefined;
+        after?: string | undefined;
+        waitSeconds?: number | undefined;
+    }, undefined, {
+        cursor: string | null;
         topic: {
+            status: "active" | "archived";
             id: string;
+            createdAt: string;
+            teamId: string;
+            updatedAt: string;
             slug: string;
+            streams: {
+                id: string;
+                projectId: string;
+                projectSlug: string;
+                discussionId: string;
+            }[];
+            listeners: {
+                status: "active" | "removed";
+                projectId: string;
+                source: "operator" | "seed" | "mention";
+                agentSlug: string;
+                projectSlug: string;
+                updatedAt: string;
+                agentHandle: string;
+                subscribedAt: string;
+            }[];
         };
-        projectStream: {
+        events: {
+            type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
             id: string;
+            actor: {
+                kind: "control-plane" | "provider" | "agent" | "user";
+                id: string;
+                handle: string | null;
+            };
+            summary: string;
+            teamId: string;
+            channel: string;
+            assignmentId: string | null;
+            sequence: number;
+            topicId: string;
+            occurredAt: string;
+            sendId: string | null;
+            invocationId: string | null;
+            payload: Record<string, unknown>;
+        }[];
+    }>;
+    topicsSubscribe: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        channel: string;
+    }, {}, {
+        agent: string;
+    }, {
+        topicId: string;
+        replayed: boolean;
+        listener: {
+            status: "active" | "removed";
             projectId: string;
+            source: "operator" | "seed" | "mention";
+            agentSlug: string;
             projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
         };
-        discussionId: string;
-        sourceMessage: string;
+    }>;
+    topicsUnsubscribe: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        channel: string;
+    }, {}, {
+        agent: string;
+    }, {
+        topicId: string;
         replayed: boolean;
+        listener: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "operator" | "seed" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        };
     }>;
 };
 export declare function providerDiscussionResponseOperation(): import("../control-plane-operation.js").ControlPlaneOperationBinding<{
     assignmentId: string;
 }, {}, {
-    leaseToken: string;
     runnerId: string;
+    leaseToken: string;
     summary?: string | undefined;
     usage?: Record<string, unknown> | undefined;
     markdown?: string | undefined;
@@ -168,3 +405,33 @@ export declare function providerDiscussionResponseOperation(): import("../contro
     messageRef: string;
     settledAt: string;
 }>;
+export declare function providerCommunicationLifecycleOperations(): {
+    notificationAcknowledge: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        assignmentId: string;
+    }, {}, {
+        providerId: string;
+        runnerId: string;
+        observedAt: string;
+    }, {
+        assignmentId: string;
+        acknowledgedAt: string;
+        replayed: boolean;
+    }>;
+    traceEvent: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        assignmentId: string;
+    }, {}, {
+        type: string;
+        summary: string;
+        sequence: number;
+        occurredAt: string;
+        payload: Record<string, unknown>;
+        runnerId: string;
+        leaseToken: string;
+        protectedPayload?: Record<string, unknown> | undefined;
+    }, {
+        assignmentId: string;
+        sequence: number;
+        replayed: boolean;
+        acceptedAt: string;
+    }>;
+};

package/dist/operator-contracts/catalog/communication-operations.js

@@ -3,6 +3,13 @@ import { defineOperation } from "../operation-builder.js";
 import {
   communicationSendReceiptSchema,
   communicationSendRequestSchema,
+  communicationTopicPageSchema,
+  communicationTopicSchema,
+  communicationTopicSubscriptionReceiptSchema,
+  communicationTopicSubscriptionRequestSchema,
+  communicationTopicTimelineSchema,
+  providerCommunicationNotificationAcknowledgeRequestSchema,
+  providerCommunicationTraceEventRequestSchema,
   providerDiscussionResponseReceiptSchema,
   providerDiscussionResponseRequestSchema
 } from "../communication/contracts.js";
@@ -10,7 +17,7 @@ const empty = z.object({}).strict();
 const none = z.undefined();
 function communicationOperations() {
   return {
-    send: defineOperation({ operationId: "communications.send", description: "Post a team discussion-topic message and admit its addressed project agents to the communication lane.", rest: { method: "POST", path: "/v1/teams/{teamId}/discussion-topics/{channel}/messages" }, parameters: "treeseed.communications.send.parameters/v2", capability: "agents.execute", authentication: "oauth", oauthScopes: ["treeseed:execution"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, {
+    send: defineOperation({ operationId: "communications.send", description: "Post a team discussion-topic message and admit every addressed team agent to its project communication stream.", rest: { method: "POST", path: "/v1/teams/{teamId}/discussion-topics/{channel}/messages" }, parameters: "treeseed.communications.send.parameters/v3", capability: "agents.execute", authentication: "oauth", oauthScopes: ["treeseed:execution"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, {
       path: z.object({ teamId: z.string().min(1), channel: z.string().trim().min(1).max(120) }).strict(),
       query: empty,
       body: communicationSendRequestSchema,
@@ -18,9 +25,39 @@ function communicationOperations() {
     }),
     sendStatus: defineOperation({ operationId: "communications.sends.show", description: "Read a communication send and its durable agent responses.", rest: { method: "GET", path: "/v1/teams/{teamId}/communication-sends/{sendId}" }, parameters: "treeseed.communications.sends.show.parameters/v1", capability: "agents.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "mcp_tool", "mcp_resource"], cacheScope: "principal", pagination: "none" }, {
       path: z.object({ teamId: z.string().min(1), sendId: z.string().min(1) }).strict(),
-      query: empty,
+      query: z.object({ diagnostics: z.enum(["metadata", "full"]).optional() }).strict(),
       body: none,
       output: communicationSendReceiptSchema
+    }),
+    topicsList: defineOperation({ operationId: "communications.topics.list", description: "List team discussion topics and active listeners.", rest: { method: "GET", path: "/v1/teams/{teamId}/discussion-topics" }, parameters: "treeseed.communications.topics.list.parameters/v1", capability: "agents.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool", "mcp_resource"], cacheScope: "principal", pagination: "cursor" }, {
+      path: z.object({ teamId: z.string().min(1) }).strict(),
+      query: z.object({ status: z.enum(["active", "archived"]).optional(), limit: z.coerce.number().int().min(1).max(200).optional(), cursor: z.string().optional() }).strict(),
+      body: none,
+      output: communicationTopicPageSchema
+    }),
+    topicsShow: defineOperation({ operationId: "communications.topics.show", description: "Show one discussion topic, streams, and listeners.", rest: { method: "GET", path: "/v1/teams/{teamId}/discussion-topics/{channel}" }, parameters: "treeseed.communications.topics.show.parameters/v1", capability: "agents.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool", "mcp_resource"], cacheScope: "principal", pagination: "none" }, {
+      path: z.object({ teamId: z.string().min(1), channel: z.string().min(1) }).strict(),
+      query: empty,
+      body: none,
+      output: communicationTopicSchema
+    }),
+    topicsTimeline: defineOperation({ operationId: "communications.topics.timeline", description: "Read the ordered durable timeline for a discussion topic.", rest: { method: "GET", path: "/v1/teams/{teamId}/discussion-topics/{channel}/timeline" }, parameters: "treeseed.communications.topics.timeline.parameters/v1", capability: "agents.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "mcp_tool", "mcp_resource"], cacheScope: "principal", pagination: "cursor" }, {
+      path: z.object({ teamId: z.string().min(1), channel: z.string().min(1) }).strict(),
+      query: z.object({ after: z.string().optional(), waitSeconds: z.coerce.number().int().min(0).max(30).optional(), limit: z.coerce.number().int().min(1).max(500).optional(), diagnostics: z.enum(["metadata", "full"]).optional() }).strict(),
+      body: none,
+      output: communicationTopicTimelineSchema
+    }),
+    topicsSubscribe: defineOperation({ operationId: "communications.topics.subscriptions.put", description: "Subscribe an agent to a discussion topic.", rest: { method: "PUT", path: "/v1/teams/{teamId}/discussion-topics/{channel}/subscriptions" }, parameters: "treeseed.communications.topics.subscriptions.put.parameters/v1", capability: "agents.execute", authentication: "oauth", oauthScopes: ["treeseed:execution"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, {
+      path: z.object({ teamId: z.string().min(1), channel: z.string().min(1) }).strict(),
+      query: empty,
+      body: communicationTopicSubscriptionRequestSchema,
+      output: communicationTopicSubscriptionReceiptSchema
+    }),
+    topicsUnsubscribe: defineOperation({ operationId: "communications.topics.subscriptions.delete", description: "Remove an agent subscription from a discussion topic.", rest: { method: "DELETE", path: "/v1/teams/{teamId}/discussion-topics/{channel}/subscriptions" }, parameters: "treeseed.communications.topics.subscriptions.delete.parameters/v1", capability: "agents.execute", authentication: "oauth", oauthScopes: ["treeseed:execution"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, {
+      path: z.object({ teamId: z.string().min(1), channel: z.string().min(1) }).strict(),
+      query: empty,
+      body: communicationTopicSubscriptionRequestSchema,
+      output: communicationTopicSubscriptionReceiptSchema
     })
   };
 }
@@ -32,7 +69,24 @@ function providerDiscussionResponseOperation() {
     output: providerDiscussionResponseReceiptSchema
   });
 }
+function providerCommunicationLifecycleOperations() {
+  return {
+    notificationAcknowledge: defineOperation({ operationId: "providers.assignments.communication.acknowledge", description: "Acknowledge provider observation of an addressed communication mention.", rest: { method: "POST", path: "/v1/provider/assignments/{assignmentId}/communication-acknowledgement" }, parameters: "treeseed.providers.assignments.communication.acknowledge.parameters/v1", capability: "providers.execute", authentication: "provider", oauthScopes: [], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest"], cacheScope: "none", pagination: "none" }, {
+      path: z.object({ assignmentId: z.string().min(1) }).strict(),
+      query: empty,
+      body: providerCommunicationNotificationAcknowledgeRequestSchema,
+      output: z.object({ assignmentId: z.string(), acknowledgedAt: z.string().datetime(), replayed: z.boolean() }).strict()
+    }),
+    traceEvent: defineOperation({ operationId: "providers.assignments.communication.trace.create", description: "Append one provider-authored communication execution trace event.", rest: { method: "POST", path: "/v1/provider/assignments/{assignmentId}/communication-trace-events" }, parameters: "treeseed.providers.assignments.communication.trace.create.parameters/v1", capability: "providers.execute", authentication: "provider", oauthScopes: [], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest"], cacheScope: "none", pagination: "none" }, {
+      path: z.object({ assignmentId: z.string().min(1) }).strict(),
+      query: empty,
+      body: providerCommunicationTraceEventRequestSchema,
+      output: z.object({ assignmentId: z.string(), sequence: z.number().int().nonnegative(), acceptedAt: z.string().datetime(), replayed: z.boolean() }).strict()
+    })
+  };
+}
 export {
   communicationOperations,
+  providerCommunicationLifecycleOperations,
   providerDiscussionResponseOperation
 };