@treeseed/sdk 0.13.0-rc.1 → 0.13.0-rc.100

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

@@ -0,0 +1,1818 @@
+import { z } from 'zod';
+export declare const communicationRecipientSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    agentSlug: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    agentSlug: string;
+}, {
+    projectId: string;
+    agentSlug: string;
+}>;
+export declare const communicationSendRequestSchema: z.ZodObject<{
+    message: z.ZodString;
+    recipients: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    message: string;
+    timeoutSeconds?: number | undefined;
+    recipients?: string[] | undefined;
+}, {
+    message: 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: "provider" | "agent" | "control-plane" | "user";
+        id: string;
+        handle: string | null;
+    }, {
+        kind: "provider" | "agent" | "control-plane" | "user";
+        id: string;
+        handle: string | null;
+    }>;
+    summary: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+    actor: {
+        kind: "provider" | "agent" | "control-plane" | "user";
+        id: string;
+        handle: string | null;
+    };
+    id: string;
+    teamId: string;
+    assignmentId: string | null;
+    topicId: string;
+    sendId: string | null;
+    invocationId: string | null;
+    sequence: number;
+    payload: Record<string, unknown>;
+    summary: string;
+    channel: string;
+    occurredAt: string;
+}, {
+    type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+    actor: {
+        kind: "provider" | "agent" | "control-plane" | "user";
+        id: string;
+        handle: string | null;
+    };
+    id: string;
+    teamId: string;
+    assignmentId: string | null;
+    topicId: string;
+    sendId: string | null;
+    invocationId: string | null;
+    sequence: number;
+    payload: Record<string, unknown>;
+    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, {
+        capabilities: string[];
+        model: string | null;
+        parameters: Record<string, unknown>;
+    }, {
+        capabilities: string[];
+        model: string | null;
+        parameters: Record<string, unknown>;
+    }>;
+    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, {
+    provider: {
+        providerId: string | null;
+        executionProviderId: string | null;
+        runtimeVersion: string | null;
+    };
+    resources: Record<string, unknown>;
+    selection: {
+        capabilities: string[];
+        model: string | null;
+        parameters: Record<string, unknown>;
+    };
+    reason: 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;
+}, {
+    provider: {
+        providerId: string | null;
+        executionProviderId: string | null;
+        runtimeVersion: string | null;
+    };
+    resources: Record<string, unknown>;
+    selection: {
+        capabilities: string[];
+        model: string | null;
+        parameters: Record<string, unknown>;
+    };
+    reason: 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;
+} & {
+    projectSlug: z.ZodString;
+    definitionRevision: z.ZodString;
+    revisions: z.ZodObject<{
+        project: z.ZodString;
+        library: z.ZodString;
+        agentDefinition: z.ZodString;
+        chatProfile: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        project: string;
+        library: string;
+        agentDefinition: string;
+        chatProfile: string;
+    }, {
+        project: string;
+        library: string;
+        agentDefinition: string;
+        chatProfile: string;
+    }>;
+    invocationId: z.ZodNullable<z.ZodString>;
+    requirement: z.ZodEnum<["required", "optional"]>;
+    parentInvocationId: z.ZodNullable<z.ZodString>;
+    depth: z.ZodNumber;
+    status: z.ZodEnum<["queued", "running", "responded", "abstained", "failed", "cancelled"]>;
+    requestedAt: z.ZodString;
+    updatedAt: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodString>;
+    failure: z.ZodNullable<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        message: string | null;
+    }, {
+        code: string;
+        message: string | null;
+    }>>;
+    capacity: z.ZodObject<{
+        assignmentId: z.ZodNullable<z.ZodString>;
+        providerId: z.ZodNullable<z.ZodString>;
+        executionProviderId: z.ZodNullable<z.ZodString>;
+        laneId: z.ZodNullable<z.ZodString>;
+        lanePurpose: z.ZodNullable<z.ZodString>;
+        status: z.ZodNullable<z.ZodString>;
+        assignedAt: z.ZodNullable<z.ZodString>;
+        claimedAt: z.ZodNullable<z.ZodString>;
+        completedAt: z.ZodNullable<z.ZodString>;
+        returnedAt: z.ZodNullable<z.ZodString>;
+        failedAt: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        status: string | null;
+        providerId: string | null;
+        assignmentId: string | null;
+        completedAt: string | null;
+        executionProviderId: string | null;
+        laneId: string | null;
+        lanePurpose: string | null;
+        assignedAt: string | null;
+        claimedAt: string | null;
+        returnedAt: string | null;
+        failedAt: string | null;
+    }, {
+        status: string | null;
+        providerId: string | null;
+        assignmentId: string | null;
+        completedAt: string | null;
+        executionProviderId: string | null;
+        laneId: string | null;
+        lanePurpose: string | null;
+        assignedAt: string | null;
+        claimedAt: string | null;
+        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, {
+            capabilities: string[];
+            model: string | null;
+            parameters: Record<string, unknown>;
+        }, {
+            capabilities: string[];
+            model: string | null;
+            parameters: Record<string, unknown>;
+        }>;
+        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, {
+        provider: {
+            providerId: string | null;
+            executionProviderId: string | null;
+            runtimeVersion: string | null;
+        };
+        resources: Record<string, unknown>;
+        selection: {
+            capabilities: string[];
+            model: string | null;
+            parameters: Record<string, unknown>;
+        };
+        reason: 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;
+    }, {
+        provider: {
+            providerId: string | null;
+            executionProviderId: string | null;
+            runtimeVersion: string | null;
+        };
+        resources: Record<string, unknown>;
+        selection: {
+            capabilities: string[];
+            model: string | null;
+            parameters: Record<string, unknown>;
+        };
+        reason: 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, {
+    status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
+    projectId: string;
+    invocationId: string | null;
+    completedAt: string | null;
+    requirement: "required" | "optional";
+    agentSlug: string;
+    capacity: {
+        status: string | null;
+        providerId: string | null;
+        assignmentId: string | null;
+        completedAt: string | null;
+        executionProviderId: string | null;
+        laneId: string | null;
+        lanePurpose: string | null;
+        assignedAt: string | null;
+        claimedAt: string | null;
+        returnedAt: string | null;
+        failedAt: string | null;
+    };
+    diagnostics: {
+        provider: {
+            providerId: string | null;
+            executionProviderId: string | null;
+            runtimeVersion: string | null;
+        };
+        resources: Record<string, unknown>;
+        selection: {
+            capabilities: string[];
+            model: string | null;
+            parameters: Record<string, unknown>;
+        };
+        reason: 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: {
+        project: string;
+        library: string;
+        agentDefinition: string;
+        chatProfile: string;
+    };
+    parentInvocationId: string | null;
+    depth: number;
+    requestedAt: string;
+    updatedAt: string;
+    failure: {
+        code: string;
+        message: string | null;
+    } | null;
+    acknowledgedAt: string | null;
+    leaseAcceptedAt: string | null;
+}, {
+    status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
+    projectId: string;
+    invocationId: string | null;
+    completedAt: string | null;
+    requirement: "required" | "optional";
+    agentSlug: string;
+    capacity: {
+        status: string | null;
+        providerId: string | null;
+        assignmentId: string | null;
+        completedAt: string | null;
+        executionProviderId: string | null;
+        laneId: string | null;
+        lanePurpose: string | null;
+        assignedAt: string | null;
+        claimedAt: string | null;
+        returnedAt: string | null;
+        failedAt: string | null;
+    };
+    diagnostics: {
+        provider: {
+            providerId: string | null;
+            executionProviderId: string | null;
+            runtimeVersion: string | null;
+        };
+        resources: Record<string, unknown>;
+        selection: {
+            capabilities: string[];
+            model: string | null;
+            parameters: Record<string, unknown>;
+        };
+        reason: 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: {
+        project: string;
+        library: string;
+        agentDefinition: string;
+        chatProfile: string;
+    };
+    parentInvocationId: string | null;
+    depth: number;
+    requestedAt: string;
+    updatedAt: string;
+    failure: {
+        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;
+    markdown: z.ZodString;
+    requirement: z.ZodEnum<["required", "optional"]>;
+    status: z.ZodEnum<["responded", "abstained", "failed", "cancelled"]>;
+    createdAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    status: "failed" | "cancelled" | "responded" | "abstained";
+    projectId: string;
+    createdAt: string;
+    assignmentId: string | null;
+    invocationId: string;
+    requirement: "required" | "optional";
+    agentSlug: string;
+    projectSlug: string;
+    messageRef: string;
+    markdown: string;
+}, {
+    status: "failed" | "cancelled" | "responded" | "abstained";
+    projectId: string;
+    createdAt: string;
+    assignmentId: string | null;
+    invocationId: string;
+    requirement: "required" | "optional";
+    agentSlug: string;
+    projectSlug: string;
+    messageRef: string;
+    markdown: string;
+}>;
+export declare const communicationSendReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.communication-send-receipt/v4">;
+    sendId: z.ZodString;
+    teamId: z.ZodString;
+    channel: z.ZodString;
+    topic: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        slug: string;
+    }, {
+        id: string;
+        slug: string;
+    }>;
+    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;
+        messageRef: string;
+        discussionId: string;
+    }>, "many">;
+    status: z.ZodEnum<["queued", "running", "complete", "partial", "failed"]>;
+    targets: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        agentSlug: z.ZodString;
+    } & {
+        projectSlug: z.ZodString;
+        definitionRevision: z.ZodString;
+        revisions: z.ZodObject<{
+            project: z.ZodString;
+            library: z.ZodString;
+            agentDefinition: z.ZodString;
+            chatProfile: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            project: string;
+            library: string;
+            agentDefinition: string;
+            chatProfile: string;
+        }, {
+            project: string;
+            library: string;
+            agentDefinition: string;
+            chatProfile: string;
+        }>;
+        invocationId: z.ZodNullable<z.ZodString>;
+        requirement: z.ZodEnum<["required", "optional"]>;
+        parentInvocationId: z.ZodNullable<z.ZodString>;
+        depth: z.ZodNumber;
+        status: z.ZodEnum<["queued", "running", "responded", "abstained", "failed", "cancelled"]>;
+        requestedAt: z.ZodString;
+        updatedAt: z.ZodString;
+        completedAt: z.ZodNullable<z.ZodString>;
+        failure: z.ZodNullable<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            code: string;
+            message: string | null;
+        }, {
+            code: string;
+            message: string | null;
+        }>>;
+        capacity: z.ZodObject<{
+            assignmentId: z.ZodNullable<z.ZodString>;
+            providerId: z.ZodNullable<z.ZodString>;
+            executionProviderId: z.ZodNullable<z.ZodString>;
+            laneId: z.ZodNullable<z.ZodString>;
+            lanePurpose: z.ZodNullable<z.ZodString>;
+            status: z.ZodNullable<z.ZodString>;
+            assignedAt: z.ZodNullable<z.ZodString>;
+            claimedAt: z.ZodNullable<z.ZodString>;
+            completedAt: z.ZodNullable<z.ZodString>;
+            returnedAt: z.ZodNullable<z.ZodString>;
+            failedAt: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            status: string | null;
+            providerId: string | null;
+            assignmentId: string | null;
+            completedAt: string | null;
+            executionProviderId: string | null;
+            laneId: string | null;
+            lanePurpose: string | null;
+            assignedAt: string | null;
+            claimedAt: string | null;
+            returnedAt: string | null;
+            failedAt: string | null;
+        }, {
+            status: string | null;
+            providerId: string | null;
+            assignmentId: string | null;
+            completedAt: string | null;
+            executionProviderId: string | null;
+            laneId: string | null;
+            lanePurpose: string | null;
+            assignedAt: string | null;
+            claimedAt: string | null;
+            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, {
+                capabilities: string[];
+                model: string | null;
+                parameters: Record<string, unknown>;
+            }, {
+                capabilities: string[];
+                model: string | null;
+                parameters: Record<string, unknown>;
+            }>;
+            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, {
+            provider: {
+                providerId: string | null;
+                executionProviderId: string | null;
+                runtimeVersion: string | null;
+            };
+            resources: Record<string, unknown>;
+            selection: {
+                capabilities: string[];
+                model: string | null;
+                parameters: Record<string, unknown>;
+            };
+            reason: 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;
+        }, {
+            provider: {
+                providerId: string | null;
+                executionProviderId: string | null;
+                runtimeVersion: string | null;
+            };
+            resources: Record<string, unknown>;
+            selection: {
+                capabilities: string[];
+                model: string | null;
+                parameters: Record<string, unknown>;
+            };
+            reason: 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, {
+        status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
+        projectId: string;
+        invocationId: string | null;
+        completedAt: string | null;
+        requirement: "required" | "optional";
+        agentSlug: string;
+        capacity: {
+            status: string | null;
+            providerId: string | null;
+            assignmentId: string | null;
+            completedAt: string | null;
+            executionProviderId: string | null;
+            laneId: string | null;
+            lanePurpose: string | null;
+            assignedAt: string | null;
+            claimedAt: string | null;
+            returnedAt: string | null;
+            failedAt: string | null;
+        };
+        diagnostics: {
+            provider: {
+                providerId: string | null;
+                executionProviderId: string | null;
+                runtimeVersion: string | null;
+            };
+            resources: Record<string, unknown>;
+            selection: {
+                capabilities: string[];
+                model: string | null;
+                parameters: Record<string, unknown>;
+            };
+            reason: 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: {
+            project: string;
+            library: string;
+            agentDefinition: string;
+            chatProfile: string;
+        };
+        parentInvocationId: string | null;
+        depth: number;
+        requestedAt: string;
+        updatedAt: string;
+        failure: {
+            code: string;
+            message: string | null;
+        } | null;
+        acknowledgedAt: string | null;
+        leaseAcceptedAt: string | null;
+    }, {
+        status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
+        projectId: string;
+        invocationId: string | null;
+        completedAt: string | null;
+        requirement: "required" | "optional";
+        agentSlug: string;
+        capacity: {
+            status: string | null;
+            providerId: string | null;
+            assignmentId: string | null;
+            completedAt: string | null;
+            executionProviderId: string | null;
+            laneId: string | null;
+            lanePurpose: string | null;
+            assignedAt: string | null;
+            claimedAt: string | null;
+            returnedAt: string | null;
+            failedAt: string | null;
+        };
+        diagnostics: {
+            provider: {
+                providerId: string | null;
+                executionProviderId: string | null;
+                runtimeVersion: string | null;
+            };
+            resources: Record<string, unknown>;
+            selection: {
+                capabilities: string[];
+                model: string | null;
+                parameters: Record<string, unknown>;
+            };
+            reason: 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: {
+            project: string;
+            library: string;
+            agentDefinition: string;
+            chatProfile: string;
+        };
+        parentInvocationId: string | null;
+        depth: number;
+        requestedAt: string;
+        updatedAt: string;
+        failure: {
+            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;
+        markdown: z.ZodString;
+        requirement: z.ZodEnum<["required", "optional"]>;
+        status: z.ZodEnum<["responded", "abstained", "failed", "cancelled"]>;
+        createdAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        status: "failed" | "cancelled" | "responded" | "abstained";
+        projectId: string;
+        createdAt: string;
+        assignmentId: string | null;
+        invocationId: string;
+        requirement: "required" | "optional";
+        agentSlug: string;
+        projectSlug: string;
+        messageRef: string;
+        markdown: string;
+    }, {
+        status: "failed" | "cancelled" | "responded" | "abstained";
+        projectId: string;
+        createdAt: string;
+        assignmentId: string | null;
+        invocationId: string;
+        requirement: "required" | "optional";
+        agentSlug: string;
+        projectSlug: string;
+        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: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        }, {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        }>;
+        summary: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        actor: {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        };
+        id: string;
+        teamId: string;
+        assignmentId: string | null;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        sequence: number;
+        payload: Record<string, unknown>;
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }, {
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        actor: {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        };
+        id: string;
+        teamId: string;
+        assignmentId: string | null;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        sequence: number;
+        payload: Record<string, unknown>;
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }>, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    replayed: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    status: "failed" | "running" | "partial" | "complete" | "queued";
+    schemaVersion: "treeseed.communication-send-receipt/v4";
+    targets: {
+        status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
+        projectId: string;
+        invocationId: string | null;
+        completedAt: string | null;
+        requirement: "required" | "optional";
+        agentSlug: string;
+        capacity: {
+            status: string | null;
+            providerId: string | null;
+            assignmentId: string | null;
+            completedAt: string | null;
+            executionProviderId: string | null;
+            laneId: string | null;
+            lanePurpose: string | null;
+            assignedAt: string | null;
+            claimedAt: string | null;
+            returnedAt: string | null;
+            failedAt: string | null;
+        };
+        diagnostics: {
+            provider: {
+                providerId: string | null;
+                executionProviderId: string | null;
+                runtimeVersion: string | null;
+            };
+            resources: Record<string, unknown>;
+            selection: {
+                capabilities: string[];
+                model: string | null;
+                parameters: Record<string, unknown>;
+            };
+            reason: 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: {
+            project: string;
+            library: string;
+            agentDefinition: string;
+            chatProfile: string;
+        };
+        parentInvocationId: string | null;
+        depth: number;
+        requestedAt: string;
+        updatedAt: string;
+        failure: {
+            code: string;
+            message: string | null;
+        } | null;
+        acknowledgedAt: string | null;
+        leaseAcceptedAt: string | null;
+    }[];
+    teamId: string;
+    createdAt: string;
+    sendId: string;
+    responses: {
+        status: "failed" | "cancelled" | "responded" | "abstained";
+        projectId: string;
+        createdAt: string;
+        assignmentId: string | null;
+        invocationId: string;
+        requirement: "required" | "optional";
+        agentSlug: string;
+        projectSlug: string;
+        messageRef: string;
+        markdown: string;
+    }[];
+    channel: string;
+    topic: {
+        id: string;
+        slug: string;
+    };
+    events: {
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        actor: {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        };
+        id: string;
+        teamId: string;
+        assignmentId: string | null;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        sequence: number;
+        payload: Record<string, unknown>;
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }[];
+    updatedAt: string;
+    projectStreams: {
+        id: string;
+        projectId: string;
+        projectSlug: string;
+        messageRef: string;
+        discussionId: string;
+    }[];
+    replayed: boolean;
+}, {
+    status: "failed" | "running" | "partial" | "complete" | "queued";
+    schemaVersion: "treeseed.communication-send-receipt/v4";
+    targets: {
+        status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
+        projectId: string;
+        invocationId: string | null;
+        completedAt: string | null;
+        requirement: "required" | "optional";
+        agentSlug: string;
+        capacity: {
+            status: string | null;
+            providerId: string | null;
+            assignmentId: string | null;
+            completedAt: string | null;
+            executionProviderId: string | null;
+            laneId: string | null;
+            lanePurpose: string | null;
+            assignedAt: string | null;
+            claimedAt: string | null;
+            returnedAt: string | null;
+            failedAt: string | null;
+        };
+        diagnostics: {
+            provider: {
+                providerId: string | null;
+                executionProviderId: string | null;
+                runtimeVersion: string | null;
+            };
+            resources: Record<string, unknown>;
+            selection: {
+                capabilities: string[];
+                model: string | null;
+                parameters: Record<string, unknown>;
+            };
+            reason: 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: {
+            project: string;
+            library: string;
+            agentDefinition: string;
+            chatProfile: string;
+        };
+        parentInvocationId: string | null;
+        depth: number;
+        requestedAt: string;
+        updatedAt: string;
+        failure: {
+            code: string;
+            message: string | null;
+        } | null;
+        acknowledgedAt: string | null;
+        leaseAcceptedAt: string | null;
+    }[];
+    teamId: string;
+    createdAt: string;
+    sendId: string;
+    responses: {
+        status: "failed" | "cancelled" | "responded" | "abstained";
+        projectId: string;
+        createdAt: string;
+        assignmentId: string | null;
+        invocationId: string;
+        requirement: "required" | "optional";
+        agentSlug: string;
+        projectSlug: string;
+        messageRef: string;
+        markdown: string;
+    }[];
+    channel: string;
+    topic: {
+        id: string;
+        slug: string;
+    };
+    events: {
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        actor: {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        };
+        id: string;
+        teamId: string;
+        assignmentId: string | null;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        sequence: number;
+        payload: Record<string, unknown>;
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }[];
+    updatedAt: 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: "seed" | "operator" | "mention";
+    agentSlug: string;
+    projectSlug: string;
+    updatedAt: string;
+    agentHandle: string;
+    subscribedAt: string;
+}, {
+    status: "active" | "removed";
+    projectId: string;
+    source: "seed" | "operator" | "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: "seed" | "operator" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    }, {
+        status: "active" | "removed";
+        projectId: string;
+        source: "seed" | "operator" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    status: "active" | "archived";
+    id: string;
+    slug: string;
+    teamId: string;
+    createdAt: string;
+    updatedAt: string;
+    streams: {
+        id: string;
+        projectId: string;
+        projectSlug: string;
+        discussionId: string;
+    }[];
+    listeners: {
+        status: "active" | "removed";
+        projectId: string;
+        source: "seed" | "operator" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    }[];
+}, {
+    status: "active" | "archived";
+    id: string;
+    slug: string;
+    teamId: string;
+    createdAt: string;
+    updatedAt: string;
+    streams: {
+        id: string;
+        projectId: string;
+        projectSlug: string;
+        discussionId: string;
+    }[];
+    listeners: {
+        status: "active" | "removed";
+        projectId: string;
+        source: "seed" | "operator" | "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: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }, {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        status: "active" | "archived";
+        id: string;
+        slug: string;
+        teamId: string;
+        createdAt: string;
+        updatedAt: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }[];
+    }, {
+        status: "active" | "archived";
+        id: string;
+        slug: string;
+        teamId: string;
+        createdAt: string;
+        updatedAt: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }[];
+    }>, "many">;
+    cursor: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    items: {
+        status: "active" | "archived";
+        id: string;
+        slug: string;
+        teamId: string;
+        createdAt: string;
+        updatedAt: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }[];
+    }[];
+    cursor: string | null;
+}, {
+    items: {
+        status: "active" | "archived";
+        id: string;
+        slug: string;
+        teamId: string;
+        createdAt: string;
+        updatedAt: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "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: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }, {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        status: "active" | "archived";
+        id: string;
+        slug: string;
+        teamId: string;
+        createdAt: string;
+        updatedAt: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }[];
+    }, {
+        status: "active" | "archived";
+        id: string;
+        slug: string;
+        teamId: string;
+        createdAt: string;
+        updatedAt: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "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: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        }, {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        }>;
+        summary: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        actor: {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        };
+        id: string;
+        teamId: string;
+        assignmentId: string | null;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        sequence: number;
+        payload: Record<string, unknown>;
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }, {
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        actor: {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        };
+        id: string;
+        teamId: string;
+        assignmentId: string | null;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        sequence: number;
+        payload: Record<string, unknown>;
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }>, "many">;
+    cursor: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    cursor: string | null;
+    topic: {
+        status: "active" | "archived";
+        id: string;
+        slug: string;
+        teamId: string;
+        createdAt: string;
+        updatedAt: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }[];
+    };
+    events: {
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        actor: {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        };
+        id: string;
+        teamId: string;
+        assignmentId: string | null;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        sequence: number;
+        payload: Record<string, unknown>;
+        summary: string;
+        channel: string;
+        occurredAt: string;
+    }[];
+}, {
+    cursor: string | null;
+    topic: {
+        status: "active" | "archived";
+        id: string;
+        slug: string;
+        teamId: string;
+        createdAt: string;
+        updatedAt: string;
+        streams: {
+            id: string;
+            projectId: string;
+            projectSlug: string;
+            discussionId: string;
+        }[];
+        listeners: {
+            status: "active" | "removed";
+            projectId: string;
+            source: "seed" | "operator" | "mention";
+            agentSlug: string;
+            projectSlug: string;
+            updatedAt: string;
+            agentHandle: string;
+            subscribedAt: string;
+        }[];
+    };
+    events: {
+        type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+        actor: {
+            kind: "provider" | "agent" | "control-plane" | "user";
+            id: string;
+            handle: string | null;
+        };
+        id: string;
+        teamId: string;
+        assignmentId: string | null;
+        topicId: string;
+        sendId: string | null;
+        invocationId: string | null;
+        sequence: number;
+        payload: Record<string, unknown>;
+        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: "seed" | "operator" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    }, {
+        status: "active" | "removed";
+        projectId: string;
+        source: "seed" | "operator" | "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: "seed" | "operator" | "mention";
+        agentSlug: string;
+        projectSlug: string;
+        updatedAt: string;
+        agentHandle: string;
+        subscribedAt: string;
+    };
+}, {
+    topicId: string;
+    replayed: boolean;
+    listener: {
+        status: "active" | "removed";
+        projectId: string;
+        source: "seed" | "operator" | "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;
+    observedAt: string;
+    runnerId: string;
+}, {
+    providerId: string;
+    observedAt: string;
+    runnerId: 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, {
+    type: string;
+    sequence: number;
+    payload: Record<string, unknown>;
+    summary: string;
+    occurredAt: string;
+    runnerId: string;
+    leaseToken: string;
+    protectedPayload?: Record<string, unknown> | undefined;
+}, {
+    type: string;
+    sequence: number;
+    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;
+    runnerId: z.ZodString;
+    outcome: z.ZodDefault<z.ZodEnum<["responded", "abstained"]>>;
+    markdown: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    runnerId: string;
+    leaseToken: string;
+    outcome: "responded" | "abstained";
+    summary?: string | undefined;
+    usage?: Record<string, unknown> | undefined;
+    markdown?: string | undefined;
+}, {
+    runnerId: string;
+    leaseToken: string;
+    summary?: string | undefined;
+    usage?: Record<string, unknown> | undefined;
+    markdown?: string | undefined;
+    outcome?: "responded" | "abstained" | undefined;
+}>, {
+    runnerId: string;
+    leaseToken: string;
+    outcome: "responded" | "abstained";
+    summary?: string | undefined;
+    usage?: Record<string, unknown> | undefined;
+    markdown?: string | undefined;
+}, {
+    runnerId: string;
+    leaseToken: string;
+    summary?: string | undefined;
+    usage?: Record<string, unknown> | undefined;
+    markdown?: string | undefined;
+    outcome?: "responded" | "abstained" | undefined;
+}>;
+export declare const providerDiscussionResponseReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.provider-discussion-response-receipt/v1">;
+    assignmentId: z.ZodString;
+    invocationId: z.ZodString;
+    messageRef: z.ZodString;
+    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;
+    messageRef: string;
+    settledAt: string;
+}, {
+    status: "responded" | "abstained";
+    schemaVersion: "treeseed.provider-discussion-response-receipt/v1";
+    assignmentId: string;
+    invocationId: string;
+    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>;