@treeseed/sdk 0.13.0-rc.53 → 0.13.0-rc.55

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

@@ -11,20 +11,158 @@ export declare const communicationRecipientSchema: z.ZodObject<{
 }>;
 export declare const communicationSendRequestSchema: z.ZodObject<{
     message: z.ZodString;
-    projectId: z.ZodString;
     recipients: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     timeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
     message: string;
-    projectId: string;
     timeoutSeconds?: number | undefined;
     recipients?: string[] | undefined;
 }, {
     message: string;
-    projectId: string;
     timeoutSeconds?: number | undefined;
     recipients?: string[] | undefined;
 }>;
+export declare const communicationTopicEventTypeSchema: z.ZodEnum<["message.posted", "mention.acknowledged", "response_lease.accepted", "agent.progress", "agent.response", "agent.abstained", "agent.failed"]>;
+export declare const communicationTopicEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    sequence: z.ZodNumber;
+    teamId: z.ZodString;
+    topicId: z.ZodString;
+    channel: z.ZodString;
+    type: z.ZodEnum<["message.posted", "mention.acknowledged", "response_lease.accepted", "agent.progress", "agent.response", "agent.abstained", "agent.failed"]>;
+    occurredAt: z.ZodString;
+    sendId: z.ZodNullable<z.ZodString>;
+    invocationId: z.ZodNullable<z.ZodString>;
+    assignmentId: z.ZodNullable<z.ZodString>;
+    actor: z.ZodObject<{
+        kind: z.ZodEnum<["user", "agent", "provider", "control-plane"]>;
+        id: z.ZodString;
+        handle: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "control-plane" | "provider" | "agent" | "user";
+        id: string;
+        handle: string | null;
+    }, {
+        kind: "control-plane" | "provider" | "agent" | "user";
+        id: string;
+        handle: string | null;
+    }>;
+    summary: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    teamId: string;
+    topicId: string;
+    sendId: string | null;
+    invocationId: string | null;
+    assignmentId: string | null;
+    sequence: number;
+    type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+    payload: Record<string, unknown>;
+    id: string;
+    actor: {
+        kind: "control-plane" | "provider" | "agent" | "user";
+        id: string;
+        handle: string | null;
+    };
+    summary: string;
+    channel: string;
+    occurredAt: string;
+}, {
+    teamId: string;
+    topicId: string;
+    sendId: string | null;
+    invocationId: string | null;
+    assignmentId: string | null;
+    sequence: number;
+    type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+    payload: Record<string, unknown>;
+    id: string;
+    actor: {
+        kind: "control-plane" | "provider" | "agent" | "user";
+        id: string;
+        handle: string | null;
+    };
+    summary: string;
+    channel: string;
+    occurredAt: string;
+}>;
+export declare const communicationDiagnosticSchema: z.ZodObject<{
+    availability: z.ZodEnum<["available", "partial", "unavailable"]>;
+    reason: z.ZodNullable<z.ZodString>;
+    provider: z.ZodObject<{
+        providerId: z.ZodNullable<z.ZodString>;
+        executionProviderId: z.ZodNullable<z.ZodString>;
+        runtimeVersion: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        providerId: string | null;
+        executionProviderId: string | null;
+        runtimeVersion: string | null;
+    }, {
+        providerId: string | null;
+        executionProviderId: string | null;
+        runtimeVersion: string | null;
+    }>;
+    selection: z.ZodObject<{
+        model: z.ZodNullable<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString, "many">;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        parameters: Record<string, unknown>;
+        capabilities: string[];
+        model: string | null;
+    }, {
+        parameters: Record<string, unknown>;
+        capabilities: string[];
+        model: string | null;
+    }>;
+    identityManifest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    contextManifest: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    usage: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    timing: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    resources: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    traceEvents: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    fullPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    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;
+}, {
+    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;
+}>;
 export declare const communicationTargetSchema: z.ZodObject<{
     projectId: z.ZodString;
     agentSlug: z.ZodString;
@@ -78,10 +216,10 @@ export declare const communicationTargetSchema: z.ZodObject<{
         returnedAt: z.ZodNullable<z.ZodString>;
         failedAt: z.ZodNullable<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        assignmentId: string | null;
         status: string | null;
         completedAt: string | null;
         providerId: string | null;
-        assignmentId: string | null;
         executionProviderId: string | null;
         laneId: string | null;
         lanePurpose: string | null;
@@ -90,10 +228,10 @@ export declare const communicationTargetSchema: z.ZodObject<{
         returnedAt: string | null;
         failedAt: string | null;
     }, {
+        assignmentId: string | null;
         status: string | null;
         completedAt: string | null;
         providerId: string | null;
-        assignmentId: string | null;
         executionProviderId: string | null;
         laneId: string | null;
         lanePurpose: string | null;
@@ -102,16 +240,96 @@ export declare const communicationTargetSchema: z.ZodObject<{
         returnedAt: string | null;
         failedAt: string | null;
     }>;
+    acknowledgedAt: z.ZodNullable<z.ZodString>;
+    leaseAcceptedAt: z.ZodNullable<z.ZodString>;
+    diagnostics: z.ZodObject<{
+        availability: z.ZodEnum<["available", "partial", "unavailable"]>;
+        reason: z.ZodNullable<z.ZodString>;
+        provider: z.ZodObject<{
+            providerId: z.ZodNullable<z.ZodString>;
+            executionProviderId: z.ZodNullable<z.ZodString>;
+            runtimeVersion: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            providerId: string | null;
+            executionProviderId: string | null;
+            runtimeVersion: string | null;
+        }, {
+            providerId: string | null;
+            executionProviderId: string | null;
+            runtimeVersion: string | null;
+        }>;
+        selection: z.ZodObject<{
+            model: z.ZodNullable<z.ZodString>;
+            capabilities: z.ZodArray<z.ZodString, "many">;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strict", z.ZodTypeAny, {
+            parameters: Record<string, unknown>;
+            capabilities: string[];
+            model: string | null;
+        }, {
+            parameters: Record<string, unknown>;
+            capabilities: string[];
+            model: string | null;
+        }>;
+        identityManifest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        contextManifest: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        usage: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        timing: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        resources: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        traceEvents: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        fullPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        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;
+    }, {
+        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;
+    }>;
 }, "strict", z.ZodTypeAny, {
+    invocationId: string | null;
     status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
     projectId: string;
     completedAt: string | null;
     agentSlug: string;
     capacity: {
+        assignmentId: string | null;
         status: string | null;
         completedAt: string | null;
         providerId: string | null;
-        assignmentId: string | null;
         executionProviderId: string | null;
         laneId: string | null;
         lanePurpose: string | null;
@@ -120,6 +338,27 @@ export declare const communicationTargetSchema: z.ZodObject<{
         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;
+    };
     projectSlug: string;
     definitionRevision: string;
     revisions: {
@@ -128,7 +367,6 @@ export declare const communicationTargetSchema: z.ZodObject<{
         agentDefinition: string;
         chatProfile: string;
     };
-    invocationId: string | null;
     requirement: "required" | "optional";
     parentInvocationId: string | null;
     depth: number;
@@ -138,16 +376,19 @@ export declare const communicationTargetSchema: z.ZodObject<{
         code: string;
         message: string | null;
     } | null;
+    acknowledgedAt: string | null;
+    leaseAcceptedAt: string | null;
 }, {
+    invocationId: string | null;
     status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
     projectId: string;
     completedAt: string | null;
     agentSlug: string;
     capacity: {
+        assignmentId: string | null;
         status: string | null;
         completedAt: string | null;
         providerId: string | null;
-        assignmentId: string | null;
         executionProviderId: string | null;
         laneId: string | null;
         lanePurpose: string | null;
@@ -156,6 +397,27 @@ export declare const communicationTargetSchema: z.ZodObject<{
         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;
+    };
     projectSlug: string;
     definitionRevision: string;
     revisions: {
@@ -164,7 +426,6 @@ export declare const communicationTargetSchema: z.ZodObject<{
         agentDefinition: string;
         chatProfile: string;
     };
-    invocationId: string | null;
     requirement: "required" | "optional";
     parentInvocationId: string | null;
     depth: number;
@@ -174,11 +435,14 @@ export declare const communicationTargetSchema: z.ZodObject<{
         code: string;
         message: string | null;
     } | null;
+    acknowledgedAt: string | null;
+    leaseAcceptedAt: string | null;
 }>;
 export declare const communicationResponseSchema: z.ZodObject<{
     projectId: z.ZodString;
     agentSlug: z.ZodString;
 } & {
+    projectSlug: z.ZodString;
     invocationId: z.ZodString;
     assignmentId: z.ZodNullable<z.ZodString>;
     messageRef: z.ZodString;
@@ -187,28 +451,30 @@ export declare const communicationResponseSchema: z.ZodObject<{
     status: z.ZodEnum<["responded", "abstained", "failed", "cancelled"]>;
     createdAt: z.ZodString;
 }, "strict", z.ZodTypeAny, {
+    invocationId: string;
+    assignmentId: string | null;
     status: "failed" | "cancelled" | "responded" | "abstained";
-    projectId: string;
     createdAt: string;
+    projectId: string;
     agentSlug: string;
-    assignmentId: string | null;
-    invocationId: string;
+    projectSlug: string;
     requirement: "required" | "optional";
     messageRef: string;
     markdown: string;
 }, {
+    invocationId: string;
+    assignmentId: string | null;
     status: "failed" | "cancelled" | "responded" | "abstained";
-    projectId: string;
     createdAt: string;
+    projectId: string;
     agentSlug: string;
-    assignmentId: string | null;
-    invocationId: string;
+    projectSlug: string;
     requirement: "required" | "optional";
     messageRef: string;
     markdown: string;
 }>;
 export declare const communicationSendReceiptSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<"treeseed.communication-send-receipt/v2">;
+    schemaVersion: z.ZodLiteral<"treeseed.communication-send-receipt/v4">;
     sendId: z.ZodString;
     teamId: z.ZodString;
     channel: z.ZodString;
@@ -222,22 +488,25 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         id: string;
         slug: string;
     }>;
-    projectStream: z.ZodObject<{
+    projectStreams: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         projectId: z.ZodString;
         projectSlug: z.ZodString;
+        discussionId: z.ZodString;
+        messageRef: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         id: string;
         projectId: string;
         projectSlug: string;
+        messageRef: string;
+        discussionId: string;
     }, {
         id: string;
         projectId: string;
         projectSlug: string;
-    }>;
-    discussionId: z.ZodString;
-    messageRef: z.ZodString;
-    sourceMessage: z.ZodString;
+        messageRef: string;
+        discussionId: string;
+    }>, "many">;
     status: z.ZodEnum<["queued", "running", "complete", "partial", "failed"]>;
     targets: z.ZodArray<z.ZodObject<{
         projectId: z.ZodString;
@@ -292,10 +561,10 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             returnedAt: z.ZodNullable<z.ZodString>;
             failedAt: z.ZodNullable<z.ZodString>;
         }, "strict", z.ZodTypeAny, {
+            assignmentId: string | null;
             status: string | null;
             completedAt: string | null;
             providerId: string | null;
-            assignmentId: string | null;
             executionProviderId: string | null;
             laneId: string | null;
             lanePurpose: string | null;
@@ -304,10 +573,10 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             returnedAt: string | null;
             failedAt: string | null;
         }, {
+            assignmentId: string | null;
             status: string | null;
             completedAt: string | null;
             providerId: string | null;
-            assignmentId: string | null;
             executionProviderId: string | null;
             laneId: string | null;
             lanePurpose: string | null;
@@ -316,16 +585,96 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             returnedAt: string | null;
             failedAt: string | null;
         }>;
+        acknowledgedAt: z.ZodNullable<z.ZodString>;
+        leaseAcceptedAt: z.ZodNullable<z.ZodString>;
+        diagnostics: z.ZodObject<{
+            availability: z.ZodEnum<["available", "partial", "unavailable"]>;
+            reason: z.ZodNullable<z.ZodString>;
+            provider: z.ZodObject<{
+                providerId: z.ZodNullable<z.ZodString>;
+                executionProviderId: z.ZodNullable<z.ZodString>;
+                runtimeVersion: z.ZodNullable<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                providerId: string | null;
+                executionProviderId: string | null;
+                runtimeVersion: string | null;
+            }, {
+                providerId: string | null;
+                executionProviderId: string | null;
+                runtimeVersion: string | null;
+            }>;
+            selection: z.ZodObject<{
+                model: z.ZodNullable<z.ZodString>;
+                capabilities: z.ZodArray<z.ZodString, "many">;
+                parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, "strict", z.ZodTypeAny, {
+                parameters: Record<string, unknown>;
+                capabilities: string[];
+                model: string | null;
+            }, {
+                parameters: Record<string, unknown>;
+                capabilities: string[];
+                model: string | null;
+            }>;
+            identityManifest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            contextManifest: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+            usage: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+            timing: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            resources: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            traceEvents: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+            fullPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strict", z.ZodTypeAny, {
+            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;
+        }, {
+            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;
+        }>;
     }, "strict", z.ZodTypeAny, {
+        invocationId: string | null;
         status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
         projectId: string;
         completedAt: string | null;
         agentSlug: string;
         capacity: {
+            assignmentId: string | null;
             status: string | null;
             completedAt: string | null;
             providerId: string | null;
-            assignmentId: string | null;
             executionProviderId: string | null;
             laneId: string | null;
             lanePurpose: string | null;
@@ -334,6 +683,27 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             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;
+        };
         projectSlug: string;
         definitionRevision: string;
         revisions: {
@@ -342,7 +712,6 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             agentDefinition: string;
             chatProfile: string;
         };
-        invocationId: string | null;
         requirement: "required" | "optional";
         parentInvocationId: string | null;
         depth: number;
@@ -352,16 +721,19 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             code: string;
             message: string | null;
         } | null;
+        acknowledgedAt: string | null;
+        leaseAcceptedAt: string | null;
     }, {
+        invocationId: string | null;
         status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
         projectId: string;
         completedAt: string | null;
         agentSlug: string;
         capacity: {
+            assignmentId: string | null;
             status: string | null;
             completedAt: string | null;
             providerId: string | null;
-            assignmentId: string | null;
             executionProviderId: string | null;
             laneId: string | null;
             lanePurpose: string | null;
@@ -370,6 +742,27 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             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;
+        };
         projectSlug: string;
         definitionRevision: string;
         revisions: {
@@ -378,7 +771,6 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             agentDefinition: string;
             chatProfile: string;
         };
-        invocationId: string | null;
         requirement: "required" | "optional";
         parentInvocationId: string | null;
         depth: number;
@@ -388,11 +780,14 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             code: string;
             message: string | null;
         } | null;
+        acknowledgedAt: string | null;
+        leaseAcceptedAt: string | null;
     }>, "many">;
     responses: z.ZodArray<z.ZodObject<{
         projectId: z.ZodString;
         agentSlug: z.ZodString;
     } & {
+        projectSlug: z.ZodString;
         invocationId: z.ZodString;
         assignmentId: z.ZodNullable<z.ZodString>;
         messageRef: z.ZodString;
@@ -401,42 +796,111 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         status: z.ZodEnum<["responded", "abstained", "failed", "cancelled"]>;
         createdAt: z.ZodString;
     }, "strict", z.ZodTypeAny, {
+        invocationId: string;
+        assignmentId: string | null;
         status: "failed" | "cancelled" | "responded" | "abstained";
-        projectId: string;
         createdAt: string;
+        projectId: string;
         agentSlug: string;
-        assignmentId: string | null;
-        invocationId: string;
+        projectSlug: string;
         requirement: "required" | "optional";
         messageRef: string;
         markdown: string;
     }, {
+        invocationId: string;
+        assignmentId: string | null;
         status: "failed" | "cancelled" | "responded" | "abstained";
-        projectId: string;
         createdAt: string;
+        projectId: string;
         agentSlug: string;
-        assignmentId: string | null;
-        invocationId: string;
+        projectSlug: string;
         requirement: "required" | "optional";
         messageRef: string;
         markdown: string;
     }>, "many">;
+    events: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        teamId: z.ZodString;
+        topicId: z.ZodString;
+        channel: z.ZodString;
+        type: z.ZodEnum<["message.posted", "mention.acknowledged", "response_lease.accepted", "agent.progress", "agent.response", "agent.abstained", "agent.failed"]>;
+        occurredAt: z.ZodString;
+        sendId: z.ZodNullable<z.ZodString>;
+        invocationId: z.ZodNullable<z.ZodString>;
+        assignmentId: z.ZodNullable<z.ZodString>;
+        actor: z.ZodObject<{
+            kind: z.ZodEnum<["user", "agent", "provider", "control-plane"]>;
+            id: z.ZodString;
+            handle: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        }, {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        }>;
+        summary: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        teamId: string;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        assignmentId: string | null;
+        sequence: number;
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        payload: Record<string, unknown>;
+        id: string;
+        actor: {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        };
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }, {
+        teamId: string;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        assignmentId: string | null;
+        sequence: number;
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        payload: Record<string, unknown>;
+        id: string;
+        actor: {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        };
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }>, "many">;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     replayed: z.ZodBoolean;
 }, "strict", z.ZodTypeAny, {
+    teamId: string;
+    sendId: string;
+    schemaVersion: "treeseed.communication-send-receipt/v4";
     status: "failed" | "running" | "partial" | "complete" | "queued";
-    schemaVersion: "treeseed.communication-send-receipt/v2";
+    createdAt: string;
     targets: {
+        invocationId: string | null;
         status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
         projectId: string;
         completedAt: string | null;
         agentSlug: string;
         capacity: {
+            assignmentId: string | null;
             status: string | null;
             completedAt: string | null;
             providerId: string | null;
-            assignmentId: string | null;
             executionProviderId: string | null;
             laneId: string | null;
             lanePurpose: string | null;
@@ -445,6 +909,27 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             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;
+        };
         projectSlug: string;
         definitionRevision: string;
         revisions: {
@@ -453,7 +938,6 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             agentDefinition: string;
             chatProfile: string;
         };
-        invocationId: string | null;
         requirement: "required" | "optional";
         parentInvocationId: string | null;
         depth: number;
@@ -463,49 +947,71 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             code: string;
             message: string | null;
         } | null;
+        acknowledgedAt: string | null;
+        leaseAcceptedAt: string | null;
     }[];
-    createdAt: string;
     responses: {
+        invocationId: string;
+        assignmentId: string | null;
         status: "failed" | "cancelled" | "responded" | "abstained";
-        projectId: string;
         createdAt: string;
+        projectId: string;
         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: {
+        teamId: string;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        assignmentId: string | null;
+        sequence: number;
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        payload: Record<string, unknown>;
+        id: string;
+        actor: {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        };
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }[];
+    updatedAt: string;
+    projectStreams: {
         id: string;
         projectId: string;
         projectSlug: string;
-    };
-    discussionId: string;
-    sourceMessage: string;
+        messageRef: string;
+        discussionId: string;
+    }[];
     replayed: boolean;
 }, {
+    teamId: string;
+    sendId: string;
+    schemaVersion: "treeseed.communication-send-receipt/v4";
     status: "failed" | "running" | "partial" | "complete" | "queued";
-    schemaVersion: "treeseed.communication-send-receipt/v2";
+    createdAt: string;
     targets: {
+        invocationId: string | null;
         status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
         projectId: string;
         completedAt: string | null;
         agentSlug: string;
         capacity: {
+            assignmentId: string | null;
             status: string | null;
             completedAt: string | null;
             providerId: string | null;
-            assignmentId: string | null;
             executionProviderId: string | null;
             laneId: string | null;
             lanePurpose: string | null;
@@ -514,6 +1020,27 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             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;
+        };
         projectSlug: string;
         definitionRevision: string;
         revisions: {
@@ -522,7 +1049,6 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             agentDefinition: string;
             chatProfile: string;
         };
-        invocationId: string | null;
         requirement: "required" | "optional";
         parentInvocationId: string | null;
         depth: number;
@@ -532,36 +1058,698 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             code: string;
             message: string | null;
         } | null;
+        acknowledgedAt: string | null;
+        leaseAcceptedAt: string | null;
     }[];
-    createdAt: string;
     responses: {
+        invocationId: string;
+        assignmentId: string | null;
         status: "failed" | "cancelled" | "responded" | "abstained";
-        projectId: string;
         createdAt: string;
+        projectId: string;
         agentSlug: string;
-        assignmentId: string | null;
-        invocationId: string;
+        projectSlug: string;
         requirement: "required" | "optional";
         messageRef: string;
         markdown: string;
     }[];
-    teamId: string;
     channel: string;
+    topic: {
+        id: string;
+        slug: string;
+    };
+    events: {
+        teamId: string;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        assignmentId: string | null;
+        sequence: number;
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        payload: Record<string, unknown>;
+        id: string;
+        actor: {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        };
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }[];
     updatedAt: string;
-    messageRef: string;
-    sendId: string;
+    projectStreams: {
+        id: string;
+        projectId: string;
+        projectSlug: string;
+        messageRef: string;
+        discussionId: string;
+    }[];
+    replayed: boolean;
+}>;
+export declare const communicationTopicListenerSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    agentSlug: z.ZodString;
+} & {
+    projectSlug: z.ZodString;
+    agentHandle: z.ZodString;
+    status: z.ZodEnum<["active", "removed"]>;
+    subscribedAt: z.ZodString;
+    updatedAt: z.ZodString;
+    source: z.ZodEnum<["mention", "operator", "seed"]>;
+}, "strict", z.ZodTypeAny, {
+    status: "active" | "removed";
+    projectId: string;
+    source: "operator" | "seed" | "mention";
+    agentSlug: string;
+    projectSlug: string;
+    updatedAt: string;
+    agentHandle: string;
+    subscribedAt: string;
+}, {
+    status: "active" | "removed";
+    projectId: string;
+    source: "operator" | "seed" | "mention";
+    agentSlug: string;
+    projectSlug: string;
+    updatedAt: string;
+    agentHandle: string;
+    subscribedAt: string;
+}>;
+export declare const communicationTopicSchema: z.ZodObject<{
+    id: z.ZodString;
+    teamId: z.ZodString;
+    slug: z.ZodString;
+    status: z.ZodEnum<["active", "archived"]>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    streams: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        projectSlug: z.ZodString;
+        discussionId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        projectId: string;
+        projectSlug: string;
+        discussionId: string;
+    }, {
+        id: string;
+        projectId: string;
+        projectSlug: string;
+        discussionId: string;
+    }>, "many">;
+    listeners: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        agentSlug: z.ZodString;
+    } & {
+        projectSlug: z.ZodString;
+        agentHandle: z.ZodString;
+        status: z.ZodEnum<["active", "removed"]>;
+        subscribedAt: z.ZodString;
+        updatedAt: z.ZodString;
+        source: z.ZodEnum<["mention", "operator", "seed"]>;
+    }, "strict", z.ZodTypeAny, {
+        status: "active" | "removed";
+        projectId: string;
+        source: "operator" | "seed" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    }, {
+        status: "active" | "removed";
+        projectId: string;
+        source: "operator" | "seed" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    teamId: string;
+    status: "active" | "archived";
+    createdAt: string;
+    id: 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;
+    }[];
+}, {
+    teamId: string;
+    status: "active" | "archived";
+    createdAt: string;
+    id: 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;
+    }[];
+}>;
+export declare const communicationTopicPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        teamId: z.ZodString;
+        slug: z.ZodString;
+        status: z.ZodEnum<["active", "archived"]>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        streams: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            projectId: z.ZodString;
+            projectSlug: z.ZodString;
+            discussionId: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }, {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }>, "many">;
+        listeners: z.ZodArray<z.ZodObject<{
+            projectId: z.ZodString;
+            agentSlug: z.ZodString;
+        } & {
+            projectSlug: z.ZodString;
+            agentHandle: z.ZodString;
+            status: z.ZodEnum<["active", "removed"]>;
+            subscribedAt: z.ZodString;
+            updatedAt: z.ZodString;
+            source: z.ZodEnum<["mention", "operator", "seed"]>;
+        }, "strict", z.ZodTypeAny, {
+            status: "active" | "removed";
+            projectId: string;
+            source: "operator" | "seed" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }, {
+            status: "active" | "removed";
+            projectId: string;
+            source: "operator" | "seed" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        teamId: string;
+        status: "active" | "archived";
+        createdAt: string;
+        id: 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;
+        }[];
+    }, {
+        teamId: string;
+        status: "active" | "archived";
+        createdAt: string;
+        id: 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;
+        }[];
+    }>, "many">;
+    cursor: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    items: {
+        teamId: string;
+        status: "active" | "archived";
+        createdAt: string;
+        id: 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;
+}, {
+    items: {
+        teamId: string;
+        status: "active" | "archived";
+        createdAt: string;
+        id: 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;
+}>;
+export declare const communicationTopicTimelineSchema: z.ZodObject<{
+    topic: z.ZodObject<{
+        id: z.ZodString;
+        teamId: z.ZodString;
+        slug: z.ZodString;
+        status: z.ZodEnum<["active", "archived"]>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        streams: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            projectId: z.ZodString;
+            projectSlug: z.ZodString;
+            discussionId: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }, {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }>, "many">;
+        listeners: z.ZodArray<z.ZodObject<{
+            projectId: z.ZodString;
+            agentSlug: z.ZodString;
+        } & {
+            projectSlug: z.ZodString;
+            agentHandle: z.ZodString;
+            status: z.ZodEnum<["active", "removed"]>;
+            subscribedAt: z.ZodString;
+            updatedAt: z.ZodString;
+            source: z.ZodEnum<["mention", "operator", "seed"]>;
+        }, "strict", z.ZodTypeAny, {
+            status: "active" | "removed";
+            projectId: string;
+            source: "operator" | "seed" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }, {
+            status: "active" | "removed";
+            projectId: string;
+            source: "operator" | "seed" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        teamId: string;
+        status: "active" | "archived";
+        createdAt: string;
+        id: 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;
+        }[];
+    }, {
+        teamId: string;
+        status: "active" | "archived";
+        createdAt: string;
+        id: 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;
+        }[];
+    }>;
+    events: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        sequence: z.ZodNumber;
+        teamId: z.ZodString;
+        topicId: z.ZodString;
+        channel: z.ZodString;
+        type: z.ZodEnum<["message.posted", "mention.acknowledged", "response_lease.accepted", "agent.progress", "agent.response", "agent.abstained", "agent.failed"]>;
+        occurredAt: z.ZodString;
+        sendId: z.ZodNullable<z.ZodString>;
+        invocationId: z.ZodNullable<z.ZodString>;
+        assignmentId: z.ZodNullable<z.ZodString>;
+        actor: z.ZodObject<{
+            kind: z.ZodEnum<["user", "agent", "provider", "control-plane"]>;
+            id: z.ZodString;
+            handle: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        }, {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        }>;
+        summary: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        teamId: string;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        assignmentId: string | null;
+        sequence: number;
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        payload: Record<string, unknown>;
+        id: string;
+        actor: {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        };
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }, {
+        teamId: string;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        assignmentId: string | null;
+        sequence: number;
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        payload: Record<string, unknown>;
+        id: string;
+        actor: {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        };
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }>, "many">;
+    cursor: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    cursor: string | null;
+    topic: {
+        teamId: string;
+        status: "active" | "archived";
+        createdAt: string;
+        id: 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;
+        }[];
+    };
+    events: {
+        teamId: string;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        assignmentId: string | null;
+        sequence: number;
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        payload: Record<string, unknown>;
+        id: string;
+        actor: {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        };
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }[];
+}, {
+    cursor: string | null;
     topic: {
+        teamId: string;
+        status: "active" | "archived";
+        createdAt: string;
         id: 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: {
+        teamId: string;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        assignmentId: string | null;
+        sequence: number;
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        payload: Record<string, unknown>;
         id: string;
+        actor: {
+            kind: "control-plane" | "provider" | "agent" | "user";
+            id: string;
+            handle: string | null;
+        };
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }[];
+}>;
+export declare const communicationTopicSubscriptionRequestSchema: z.ZodObject<{
+    agent: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    agent: string;
+}, {
+    agent: string;
+}>;
+export declare const communicationTopicSubscriptionReceiptSchema: z.ZodObject<{
+    topicId: z.ZodString;
+    listener: z.ZodObject<{
+        projectId: z.ZodString;
+        agentSlug: z.ZodString;
+    } & {
+        projectSlug: z.ZodString;
+        agentHandle: z.ZodString;
+        status: z.ZodEnum<["active", "removed"]>;
+        subscribedAt: z.ZodString;
+        updatedAt: z.ZodString;
+        source: z.ZodEnum<["mention", "operator", "seed"]>;
+    }, "strict", z.ZodTypeAny, {
+        status: "active" | "removed";
+        projectId: string;
+        source: "operator" | "seed" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    }, {
+        status: "active" | "removed";
         projectId: string;
+        source: "operator" | "seed" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    }>;
+    replayed: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    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;
+}, {
+    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 const providerCommunicationNotificationAcknowledgeRequestSchema: z.ZodObject<{
+    providerId: z.ZodString;
+    runnerId: z.ZodString;
+    observedAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    providerId: string;
+    runnerId: string;
+    observedAt: string;
+}, {
+    providerId: string;
+    runnerId: string;
+    observedAt: string;
+}>;
+export declare const providerCommunicationTraceEventRequestSchema: z.ZodObject<{
+    leaseToken: z.ZodString;
+    runnerId: z.ZodString;
+    sequence: z.ZodNumber;
+    type: z.ZodString;
+    occurredAt: z.ZodString;
+    summary: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    protectedPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    sequence: number;
+    type: string;
+    payload: Record<string, unknown>;
+    summary: string;
+    occurredAt: string;
+    runnerId: string;
+    leaseToken: string;
+    protectedPayload?: Record<string, unknown> | undefined;
+}, {
+    sequence: number;
+    type: string;
+    payload: Record<string, unknown>;
+    summary: string;
+    occurredAt: string;
+    runnerId: string;
+    leaseToken: string;
+    protectedPayload?: Record<string, unknown> | undefined;
 }>;
 export declare const providerDiscussionResponseRequestSchema: z.ZodEffects<z.ZodObject<{
     leaseToken: z.ZodString;
@@ -571,29 +1759,29 @@ export declare const providerDiscussionResponseRequestSchema: z.ZodEffects<z.Zod
     summary: z.ZodOptional<z.ZodString>;
     usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
-    leaseToken: string;
     runnerId: string;
+    leaseToken: string;
     outcome: "responded" | "abstained";
     summary?: string | undefined;
     usage?: Record<string, unknown> | undefined;
     markdown?: string | undefined;
 }, {
-    leaseToken: string;
     runnerId: string;
+    leaseToken: string;
     summary?: string | undefined;
     usage?: Record<string, unknown> | undefined;
     markdown?: string | undefined;
     outcome?: "responded" | "abstained" | undefined;
 }>, {
-    leaseToken: string;
     runnerId: string;
+    leaseToken: string;
     outcome: "responded" | "abstained";
     summary?: string | undefined;
     usage?: Record<string, unknown> | undefined;
     markdown?: string | undefined;
 }, {
-    leaseToken: string;
     runnerId: string;
+    leaseToken: string;
     summary?: string | undefined;
     usage?: Record<string, unknown> | undefined;
     markdown?: string | undefined;
@@ -607,22 +1795,24 @@ export declare const providerDiscussionResponseReceiptSchema: z.ZodObject<{
     status: z.ZodEnum<["responded", "abstained"]>;
     settledAt: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    status: "responded" | "abstained";
-    schemaVersion: "treeseed.provider-discussion-response-receipt/v1";
-    assignmentId: string;
     invocationId: string;
+    assignmentId: string;
+    schemaVersion: "treeseed.provider-discussion-response-receipt/v1";
+    status: "responded" | "abstained";
     messageRef: string;
     settledAt: string;
 }, {
-    status: "responded" | "abstained";
-    schemaVersion: "treeseed.provider-discussion-response-receipt/v1";
-    assignmentId: string;
     invocationId: string;
+    assignmentId: string;
+    schemaVersion: "treeseed.provider-discussion-response-receipt/v1";
+    status: "responded" | "abstained";
     messageRef: string;
     settledAt: string;
 }>;
 export type CommunicationSendRequest = z.infer<typeof communicationSendRequestSchema>;
 export type CommunicationSendReceipt = z.infer<typeof communicationSendReceiptSchema>;
 export type CommunicationResponse = z.infer<typeof communicationResponseSchema>;
+export type CommunicationTopicEvent = z.infer<typeof communicationTopicEventSchema>;
+export type CommunicationDiagnostic = z.infer<typeof communicationDiagnosticSchema>;
 export type ProviderDiscussionResponseRequest = z.infer<typeof providerDiscussionResponseRequestSchema>;
 export type ProviderDiscussionResponseReceipt = z.infer<typeof providerDiscussionResponseReceiptSchema>;