@joe-broadhead/messaging 0.7.1 → 0.8.0

package/dist/types/core/conversation-agent-tools.d.ts

@@ -0,0 +1,918 @@
+/** Shared conversation-model tools, including the retained task-envelope path. */
+import { z } from "zod";
+export declare const ToolSource: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"conv">;
+    cid: z.ZodString;
+    event: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"task">;
+    taskId: z.ZodString;
+}, z.core.$strict>], "kind">;
+export type ToolSource = z.infer<typeof ToolSource>;
+/** Rendered model result: peer text and names are fenced by the client, never instructions. */
+export declare const ConversationToolEvent: z.ZodObject<{
+    cite: z.ZodString;
+    cid: z.ZodString;
+    id: z.ZodString;
+    seq: z.ZodNumber;
+    at: z.ZodNumber;
+    conv: z.ZodObject<{
+        kind: z.ZodEnum<{
+            self: "self";
+            channel: "channel";
+            group: "group";
+            dm: "dm";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    author: z.ZodObject<{
+        person: z.ZodString;
+        agent: z.ZodOptional<z.ZodString>;
+        of: z.ZodOptional<z.ZodString>;
+        side: z.ZodEnum<{
+            peer: "peer";
+            ours: "ours";
+        }>;
+    }, z.core.$strip>;
+    thread: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ConversationToolEvent = z.infer<typeof ConversationToolEvent>;
+export declare const ConversationTools: {
+    readonly contacts: {
+        readonly input: z.ZodObject<{
+            query: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodEnum<{
+                person: "person";
+                channel: "channel";
+                agent: "agent";
+            }>>;
+            can: z.ZodOptional<z.ZodEnum<{
+                chat: "chat";
+                ask: "ask";
+            }>>;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+        readonly output: z.ZodObject<{
+            me: z.ZodObject<{
+                address: z.ZodString;
+                person: z.ZodString;
+                agent: z.ZodString;
+                device: z.ZodString;
+                relay: z.ZodEnum<{
+                    offline: "offline";
+                    connected: "connected";
+                }>;
+            }, z.core.$strip>;
+            contacts: z.ZodArray<z.ZodObject<{
+                can: z.ZodObject<{
+                    chat: z.ZodBoolean;
+                    agentMail: z.ZodBoolean;
+                    ask: z.ZodEnum<{
+                        request: "request";
+                        open: "open";
+                        no: "no";
+                    }>;
+                    source: z.ZodEnum<{
+                        default: "default";
+                        card: "card";
+                    }>;
+                    card: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                state: z.ZodOptional<z.ZodEnum<{
+                    unknown: "unknown";
+                    idle: "idle";
+                    busy: "busy";
+                    kept: "kept";
+                }>>;
+                seen: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                repo: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                branch: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                doing: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+                expect: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+                    kept: "kept";
+                    wake: "wake";
+                    next_turn: "next_turn";
+                    next_prompt: "next_prompt";
+                    on_read: "on_read";
+                    offline: "offline";
+                }>>>;
+                address: z.ZodString;
+                kind: z.ZodEnum<{
+                    person: "person";
+                    channel: "channel";
+                    agent: "agent";
+                }>;
+                name: z.ZodString;
+                org: z.ZodEnum<{
+                    other: "other";
+                    same: "same";
+                }>;
+                presence: z.ZodEnum<{
+                    unknown: "unknown";
+                    away: "away";
+                    offline: "offline";
+                    online: "online";
+                }>;
+                agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    address: z.ZodString;
+                    state: z.ZodEnum<{
+                        unknown: "unknown";
+                        idle: "idle";
+                        busy: "busy";
+                        kept: "kept";
+                    }>;
+                    expect: z.ZodOptional<z.ZodEnum<{
+                        kept: "kept";
+                        wake: "wake";
+                        next_turn: "next_turn";
+                        next_prompt: "next_prompt";
+                        on_read: "on_read";
+                        offline: "offline";
+                    }>>;
+                    seen: z.ZodOptional<z.ZodString>;
+                    repo: z.ZodOptional<z.ZodString>;
+                    branch: z.ZodOptional<z.ZodString>;
+                    doing: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            more: z.ZodBoolean;
+            notice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly conversations: {
+        readonly input: z.ZodObject<{
+            cid: z.ZodOptional<z.ZodString>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            cursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly output: z.ZodObject<{
+            conversations: z.ZodArray<z.ZodObject<{
+                cid: z.ZodString;
+                kind: z.ZodEnum<{
+                    self: "self";
+                    channel: "channel";
+                    group: "group";
+                    dm: "dm";
+                }>;
+                name: z.ZodOptional<z.ZodString>;
+                reason: z.ZodEnum<{
+                    seat: "seat";
+                    allow: "allow";
+                    ask: "ask";
+                }>;
+                lookbackDays: z.ZodNumber;
+                indexedFrom: z.ZodOptional<z.ZodNumber>;
+                complete: z.ZodBoolean;
+            }, z.core.$strip>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            notice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly send: {
+        readonly input: z.ZodObject<{
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                mime: z.ZodString;
+                data: z.ZodString;
+            }, z.core.$strict>>>;
+            replyTo: z.ZodOptional<z.ZodString>;
+            onBehalfOf: z.ZodOptional<z.ZodString>;
+            key: z.ZodOptional<z.ZodString>;
+            to: z.ZodOptional<z.ZodString>;
+            cid: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+            thread: z.ZodOptional<z.ZodString>;
+            answer: z.ZodOptional<z.ZodString>;
+            ask: z.ZodOptional<z.ZodBoolean>;
+            clientId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly output: z.ZodUnion<readonly [z.ZodObject<{
+            source: z.ZodObject<{
+                kind: z.ZodLiteral<"conv">;
+                cid: z.ZodString;
+                event: z.ZodString;
+            }, z.core.$strict>;
+            stage: z.ZodLiteral<"pending">;
+            clientId: z.ZodString;
+            expect: z.ZodOptional<z.ZodEnum<{
+                kept: "kept";
+                wake: "wake";
+                next_turn: "next_turn";
+                next_prompt: "next_prompt";
+                on_read: "on_read";
+                offline: "offline";
+                on_consent: "on_consent";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodObject<{
+                kind: z.ZodLiteral<"task">;
+                taskId: z.ZodString;
+            }, z.core.$strict>;
+            kind: z.ZodEnum<{
+                task: "task";
+                continuation: "continuation";
+            }>;
+            results: z.ZodArray<z.ZodObject<{
+                to: z.ZodString;
+                stage: z.ZodEnum<{
+                    accepted: "accepted";
+                    relayed: "relayed";
+                    delivered: "delivered";
+                    held: "held";
+                    handed_to_agent: "handed_to_agent";
+                    read: "read";
+                    replied: "replied";
+                    rejected: "rejected";
+                    expired: "expired";
+                }>;
+                code: z.ZodOptional<z.ZodEnum<{
+                    expired: "expired";
+                    invalid_request: "invalid_request";
+                    not_member: "not_member";
+                    bad_signature: "bad_signature";
+                    unknown_session: "unknown_session";
+                    ambiguous_address: "ambiguous_address";
+                    no_recipients: "no_recipients";
+                    unknown_address: "unknown_address";
+                    refused: "refused";
+                    declined: "declined";
+                    request_required: "request_required";
+                    peer_outdated: "peer_outdated";
+                    rate_limited: "rate_limited";
+                    loop_guard: "loop_guard";
+                    too_large: "too_large";
+                    secret_refused: "secret_refused";
+                    duplicate: "duplicate";
+                    relay_unavailable: "relay_unavailable";
+                    not_found: "not_found";
+                    invalid_state: "invalid_state";
+                    forbidden: "forbidden";
+                    guarded_turn: "guarded_turn";
+                    roster_conflict: "roster_conflict";
+                    invite_invalid: "invite_invalid";
+                    no_identity: "no_identity";
+                    binding_invalid: "binding_invalid";
+                    jelly_unavailable: "jelly_unavailable";
+                    log_conflict: "log_conflict";
+                    conv_conflict: "conv_conflict";
+                    stale_epoch: "stale_epoch";
+                    device_limit: "device_limit";
+                    admission_required: "admission_required";
+                    admission_invalid: "admission_invalid";
+                    directory_inconsistent: "directory_inconsistent";
+                    unknown_device: "unknown_device";
+                    directory_unavailable: "directory_unavailable";
+                    login_unsupported: "login_unsupported";
+                    login_denied: "login_denied";
+                    grant_required: "grant_required";
+                    grant_invalid: "grant_invalid";
+                    ticket_required: "ticket_required";
+                    ticket_invalid: "ticket_invalid";
+                    daemon_unavailable: "daemon_unavailable";
+                    daemon_mismatch: "daemon_mismatch";
+                    store_refused: "store_refused";
+                    internal: "internal";
+                }>>;
+                expect: z.ZodOptional<z.ZodEnum<{
+                    kept: "kept";
+                    wake: "wake";
+                    next_turn: "next_turn";
+                    next_prompt: "next_prompt";
+                    on_read: "on_read";
+                    offline: "offline";
+                    on_consent: "on_consent";
+                }>>;
+            }, z.core.$strip>>;
+            note: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            stage: z.ZodLiteral<"held">;
+            code: z.ZodEnum<{
+                audience: "audience";
+                context: "context";
+            }>;
+            expect: z.ZodLiteral<"on_consent">;
+            note: z.ZodString;
+        }, z.core.$strip>]>;
+    };
+    readonly inbox: {
+        readonly input: z.ZodObject<{
+            unread: z.ZodOptional<z.ZodBoolean>;
+            from: z.ZodOptional<z.ZodString>;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+        readonly output: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"conv">;
+                    cid: z.ZodString;
+                    event: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"task">;
+                    taskId: z.ZodString;
+                }, z.core.$strict>], "kind">;
+                from: z.ZodString;
+                preview: z.ZodOptional<z.ZodString>;
+                at: z.ZodNumber;
+                stage: z.ZodEnum<{
+                    delivered: "delivered";
+                    handed_to_agent: "handed_to_agent";
+                    read: "read";
+                }>;
+                consent: z.ZodEnum<{
+                    self: "self";
+                    guarded: "guarded";
+                    trusted: "trusted";
+                }>;
+                chain: z.ZodOptional<z.ZodObject<{
+                    path: z.ZodString;
+                    depth: z.ZodNumber;
+                    maxDepth: z.ZodNumber;
+                    scope: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            unread: z.ZodNumber;
+            notice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly read: {
+        readonly input: z.ZodObject<{
+            cid: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"conv">;
+                cid: z.ZodString;
+                event: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"task">;
+                taskId: z.ZodString;
+            }, z.core.$strict>], "kind">>;
+            id: z.ZodOptional<z.ZodString>;
+            offset: z.ZodOptional<z.ZodNumber>;
+            thread: z.ZodOptional<z.ZodString>;
+            before: z.ZodOptional<z.ZodString>;
+            after: z.ZodOptional<z.ZodString>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            cursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly output: z.ZodUnion<readonly [z.ZodObject<{
+            events: z.ZodArray<z.ZodObject<{
+                cite: z.ZodString;
+                cid: z.ZodString;
+                id: z.ZodString;
+                seq: z.ZodNumber;
+                at: z.ZodNumber;
+                conv: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        self: "self";
+                        channel: "channel";
+                        group: "group";
+                        dm: "dm";
+                    }>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                author: z.ZodObject<{
+                    person: z.ZodString;
+                    agent: z.ZodOptional<z.ZodString>;
+                    of: z.ZodOptional<z.ZodString>;
+                    side: z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>;
+                }, z.core.$strip>;
+                thread: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                truncated: z.ZodOptional<z.ZodBoolean>;
+                deleted: z.ZodOptional<z.ZodBoolean>;
+                nextOffset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            notice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            item: z.ZodUnion<readonly [z.ZodObject<{
+                id: z.ZodString;
+                source: z.ZodObject<{
+                    kind: z.ZodLiteral<"conv">;
+                    cid: z.ZodString;
+                    event: z.ZodString;
+                }, z.core.$strict>;
+                event: z.ZodObject<{
+                    cite: z.ZodString;
+                    cid: z.ZodString;
+                    id: z.ZodString;
+                    seq: z.ZodNumber;
+                    at: z.ZodNumber;
+                    conv: z.ZodObject<{
+                        kind: z.ZodEnum<{
+                            self: "self";
+                            channel: "channel";
+                            group: "group";
+                            dm: "dm";
+                        }>;
+                        name: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>;
+                    author: z.ZodObject<{
+                        person: z.ZodString;
+                        agent: z.ZodOptional<z.ZodString>;
+                        of: z.ZodOptional<z.ZodString>;
+                        side: z.ZodEnum<{
+                            peer: "peer";
+                            ours: "ours";
+                        }>;
+                    }, z.core.$strip>;
+                    thread: z.ZodOptional<z.ZodString>;
+                    text: z.ZodOptional<z.ZodString>;
+                    truncated: z.ZodOptional<z.ZodBoolean>;
+                    deleted: z.ZodOptional<z.ZodBoolean>;
+                    nextOffset: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                id: z.ZodString;
+                source: z.ZodObject<{
+                    kind: z.ZodLiteral<"task">;
+                    taskId: z.ZodString;
+                }, z.core.$strict>;
+                kind: z.ZodEnum<{
+                    task: "task";
+                    continuation: "continuation";
+                }>;
+                from: z.ZodString;
+                at: z.ZodString;
+                parts: z.ZodArray<z.ZodObject<{
+                    type: z.ZodEnum<{
+                        file: "file";
+                        text: "text";
+                        url: "url";
+                        data: "data";
+                    }>;
+                    author: z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>;
+                    content: z.ZodString;
+                    filename: z.ZodOptional<z.ZodString>;
+                    mediaType: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                verified: z.ZodOptional<z.ZodEnum<{
+                    none: "none";
+                    signature: "signature";
+                }>>;
+                replyTo: z.ZodOptional<z.ZodString>;
+                chain: z.ZodOptional<z.ZodObject<{
+                    path: z.ZodString;
+                    depth: z.ZodNumber;
+                    maxDepth: z.ZodNumber;
+                    scope: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                task: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    role: z.ZodEnum<{
+                        mine: "mine";
+                        asked: "asked";
+                    }>;
+                    counterpart: z.ZodString;
+                    state: z.ZodEnum<{
+                        rejected: "rejected";
+                        failed: "failed";
+                        submitted: "submitted";
+                        working: "working";
+                        completed: "completed";
+                        canceled: "canceled";
+                        input_required: "input_required";
+                        auth_required: "auth_required";
+                    }>;
+                    title: z.ZodOptional<z.ZodString>;
+                    titleAuthor: z.ZodOptional<z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>>;
+                    status: z.ZodOptional<z.ZodString>;
+                    statusAuthor: z.ZodOptional<z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>>;
+                    createdAt: z.ZodString;
+                    updatedAt: z.ZodString;
+                    consent: z.ZodOptional<z.ZodEnum<{
+                        self: "self";
+                        guarded: "guarded";
+                        trusted: "trusted";
+                    }>>;
+                    chain: z.ZodOptional<z.ZodObject<{
+                        path: z.ZodString;
+                        depth: z.ZodNumber;
+                        maxDepth: z.ZodNumber;
+                        scope: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    history: z.ZodArray<z.ZodObject<{
+                        from: z.ZodEnum<{
+                            requester: "requester";
+                            executor: "executor";
+                        }>;
+                        author: z.ZodEnum<{
+                            peer: "peer";
+                            ours: "ours";
+                        }>;
+                        parts: z.ZodArray<z.ZodObject<{
+                            type: z.ZodEnum<{
+                                file: "file";
+                                text: "text";
+                                url: "url";
+                                data: "data";
+                            }>;
+                            author: z.ZodEnum<{
+                                peer: "peer";
+                                ours: "ours";
+                            }>;
+                            content: z.ZodString;
+                            filename: z.ZodOptional<z.ZodString>;
+                            mediaType: z.ZodOptional<z.ZodString>;
+                            bytes: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>;
+                    artifacts: z.ZodArray<z.ZodObject<{
+                        author: z.ZodEnum<{
+                            peer: "peer";
+                            ours: "ours";
+                        }>;
+                        name: z.ZodOptional<z.ZodString>;
+                        parts: z.ZodArray<z.ZodObject<{
+                            type: z.ZodEnum<{
+                                file: "file";
+                                text: "text";
+                                url: "url";
+                                data: "data";
+                            }>;
+                            author: z.ZodEnum<{
+                                peer: "peer";
+                                ours: "ours";
+                            }>;
+                            content: z.ZodString;
+                            filename: z.ZodOptional<z.ZodString>;
+                            mediaType: z.ZodOptional<z.ZodString>;
+                            bytes: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>;
+                    followUps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        sentAt: z.ZodString;
+                        stage: z.ZodEnum<{
+                            accepted: "accepted";
+                            relayed: "relayed";
+                            delivered: "delivered";
+                            held: "held";
+                            handed_to_agent: "handed_to_agent";
+                            read: "read";
+                            replied: "replied";
+                            rejected: "rejected";
+                            expired: "expired";
+                        }>;
+                        read: z.ZodBoolean;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>;
+            notice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            stage: z.ZodLiteral<"held">;
+            code: z.ZodEnum<{
+                audience: "audience";
+                context: "context";
+            }>;
+            expect: z.ZodLiteral<"on_consent">;
+            note: z.ZodString;
+        }, z.core.$strip>]>;
+    };
+    readonly search: {
+        readonly input: z.ZodObject<{
+            query: z.ZodString;
+            cid: z.ZodOptional<z.ZodString>;
+            from: z.ZodOptional<z.ZodString>;
+            after: z.ZodOptional<z.ZodNumber>;
+            before: z.ZodOptional<z.ZodNumber>;
+            thread: z.ZodOptional<z.ZodString>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            cursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly output: z.ZodUnion<readonly [z.ZodObject<{
+            events: z.ZodArray<z.ZodObject<{
+                cite: z.ZodString;
+                cid: z.ZodString;
+                id: z.ZodString;
+                seq: z.ZodNumber;
+                at: z.ZodNumber;
+                conv: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        self: "self";
+                        channel: "channel";
+                        group: "group";
+                        dm: "dm";
+                    }>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                author: z.ZodObject<{
+                    person: z.ZodString;
+                    agent: z.ZodOptional<z.ZodString>;
+                    of: z.ZodOptional<z.ZodString>;
+                    side: z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>;
+                }, z.core.$strip>;
+                thread: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                truncated: z.ZodOptional<z.ZodBoolean>;
+                deleted: z.ZodOptional<z.ZodBoolean>;
+                nextOffset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            notice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            stage: z.ZodLiteral<"held">;
+            code: z.ZodEnum<{
+                audience: "audience";
+                context: "context";
+            }>;
+            expect: z.ZodLiteral<"on_consent">;
+            note: z.ZodString;
+        }, z.core.$strip>]>;
+    };
+    readonly context: {
+        readonly input: z.ZodObject<{
+            cid: z.ZodString;
+            event: z.ZodString;
+            before: z.ZodOptional<z.ZodNumber>;
+            after: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+        readonly output: z.ZodUnion<readonly [z.ZodObject<{
+            event: z.ZodObject<{
+                cite: z.ZodString;
+                cid: z.ZodString;
+                id: z.ZodString;
+                seq: z.ZodNumber;
+                at: z.ZodNumber;
+                conv: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        self: "self";
+                        channel: "channel";
+                        group: "group";
+                        dm: "dm";
+                    }>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                author: z.ZodObject<{
+                    person: z.ZodString;
+                    agent: z.ZodOptional<z.ZodString>;
+                    of: z.ZodOptional<z.ZodString>;
+                    side: z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>;
+                }, z.core.$strip>;
+                thread: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                truncated: z.ZodOptional<z.ZodBoolean>;
+                deleted: z.ZodOptional<z.ZodBoolean>;
+                nextOffset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            before: z.ZodArray<z.ZodObject<{
+                cite: z.ZodString;
+                cid: z.ZodString;
+                id: z.ZodString;
+                seq: z.ZodNumber;
+                at: z.ZodNumber;
+                conv: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        self: "self";
+                        channel: "channel";
+                        group: "group";
+                        dm: "dm";
+                    }>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                author: z.ZodObject<{
+                    person: z.ZodString;
+                    agent: z.ZodOptional<z.ZodString>;
+                    of: z.ZodOptional<z.ZodString>;
+                    side: z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>;
+                }, z.core.$strip>;
+                thread: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                truncated: z.ZodOptional<z.ZodBoolean>;
+                deleted: z.ZodOptional<z.ZodBoolean>;
+                nextOffset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            after: z.ZodArray<z.ZodObject<{
+                cite: z.ZodString;
+                cid: z.ZodString;
+                id: z.ZodString;
+                seq: z.ZodNumber;
+                at: z.ZodNumber;
+                conv: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        self: "self";
+                        channel: "channel";
+                        group: "group";
+                        dm: "dm";
+                    }>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                author: z.ZodObject<{
+                    person: z.ZodString;
+                    agent: z.ZodOptional<z.ZodString>;
+                    of: z.ZodOptional<z.ZodString>;
+                    side: z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>;
+                }, z.core.$strip>;
+                thread: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                truncated: z.ZodOptional<z.ZodBoolean>;
+                deleted: z.ZodOptional<z.ZodBoolean>;
+                nextOffset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            root: z.ZodOptional<z.ZodObject<{
+                cite: z.ZodString;
+                cid: z.ZodString;
+                id: z.ZodString;
+                seq: z.ZodNumber;
+                at: z.ZodNumber;
+                conv: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        self: "self";
+                        channel: "channel";
+                        group: "group";
+                        dm: "dm";
+                    }>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                author: z.ZodObject<{
+                    person: z.ZodString;
+                    agent: z.ZodOptional<z.ZodString>;
+                    of: z.ZodOptional<z.ZodString>;
+                    side: z.ZodEnum<{
+                        peer: "peer";
+                        ours: "ours";
+                    }>;
+                }, z.core.$strip>;
+                thread: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                truncated: z.ZodOptional<z.ZodBoolean>;
+                deleted: z.ZodOptional<z.ZodBoolean>;
+                nextOffset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            notice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            stage: z.ZodLiteral<"held">;
+            code: z.ZodEnum<{
+                audience: "audience";
+                context: "context";
+            }>;
+            expect: z.ZodLiteral<"on_consent">;
+            note: z.ZodString;
+        }, z.core.$strip>]>;
+    };
+    readonly tasks: {
+        readonly input: z.ZodObject<{
+            role: z.ZodOptional<z.ZodEnum<{
+                mine: "mine";
+                asked: "asked";
+            }>>;
+            state: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                done: "done";
+                open: "open";
+            }>, z.ZodEnum<{
+                rejected: "rejected";
+                failed: "failed";
+                submitted: "submitted";
+                working: "working";
+                completed: "completed";
+                canceled: "canceled";
+                input_required: "input_required";
+                auth_required: "auth_required";
+            }>]>>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            cursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly output: z.ZodObject<{
+            tasks: z.ZodArray<z.ZodObject<{
+                role: z.ZodEnum<{
+                    mine: "mine";
+                    asked: "asked";
+                }>;
+                state: z.ZodEnum<{
+                    rejected: "rejected";
+                    failed: "failed";
+                    submitted: "submitted";
+                    working: "working";
+                    completed: "completed";
+                    canceled: "canceled";
+                    input_required: "input_required";
+                    auth_required: "auth_required";
+                }>;
+                status: z.ZodOptional<z.ZodString>;
+                id: z.ZodString;
+                chain: z.ZodOptional<z.ZodObject<{
+                    path: z.ZodString;
+                    depth: z.ZodNumber;
+                    maxDepth: z.ZodNumber;
+                    scope: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                consent: z.ZodOptional<z.ZodEnum<{
+                    self: "self";
+                    guarded: "guarded";
+                    trusted: "trusted";
+                }>>;
+                updatedAt: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                counterpart: z.ZodString;
+                titleAuthor: z.ZodOptional<z.ZodEnum<{
+                    peer: "peer";
+                    ours: "ours";
+                }>>;
+                statusAuthor: z.ZodOptional<z.ZodEnum<{
+                    peer: "peer";
+                    ours: "ours";
+                }>>;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodOptional<z.ZodString>;
+            total: z.ZodNumber;
+            notice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly task_update: {
+        readonly input: z.ZodObject<{
+            id: z.ZodString;
+            state: z.ZodEnum<{
+                rejected: "rejected";
+                failed: "failed";
+                working: "working";
+                completed: "completed";
+                input_required: "input_required";
+            }>;
+            text: z.ZodOptional<z.ZodString>;
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                mime: z.ZodString;
+                data: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        readonly output: z.ZodObject<{
+            id: z.ZodString;
+            state: z.ZodEnum<{
+                rejected: "rejected";
+                failed: "failed";
+                submitted: "submitted";
+                working: "working";
+                completed: "completed";
+                canceled: "canceled";
+                input_required: "input_required";
+                auth_required: "auth_required";
+            }>;
+            stage: z.ZodEnum<{
+                accepted: "accepted";
+                relayed: "relayed";
+                delivered: "delivered";
+                held: "held";
+                handed_to_agent: "handed_to_agent";
+                read: "read";
+                replied: "replied";
+                rejected: "rejected";
+                expired: "expired";
+            }>;
+            to: z.ZodString;
+        }, z.core.$strip>;
+    };
+    readonly task_cancel: {
+        readonly input: z.ZodObject<{
+            id: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly output: z.ZodObject<{
+            id: z.ZodString;
+            state: z.ZodEnum<{
+                rejected: "rejected";
+                failed: "failed";
+                submitted: "submitted";
+                working: "working";
+                completed: "completed";
+                canceled: "canceled";
+                input_required: "input_required";
+                auth_required: "auth_required";
+            }>;
+            to: z.ZodString;
+        }, z.core.$strip>;
+    };
+};
+export type ConversationToolVerb = keyof typeof ConversationTools;
+export declare const CONVERSATION_TOOL_VERBS: readonly ["contacts", "conversations", "send", "inbox", "read", "search", "context", "tasks", "task_update", "task_cancel"];
+export type ConversationToolInput<V extends ConversationToolVerb> = z.output<(typeof ConversationTools)[V]["input"]>;
+export type ConversationToolOutput<V extends ConversationToolVerb> = z.output<(typeof ConversationTools)[V]["output"]>;