@rine-network/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,1362 @@
+/**
+ * Branded domain types + Zod schemas co-located.
+ *
+ * Branded types prevent mixing handles, UUIDs, and group IDs at compile time.
+ * Zod schemas serve as single source of truth for both runtime parsing and
+ * static type inference (via `z.infer<typeof schema>`).
+ *
+ * NOTE: All datetime fields use ISO-8601 strings (not Date objects) to match
+ * the Python SDK's Pydantic datetime serialisation and the API wire format.
+ */
+import { z } from "zod";
+declare const BrandSymbol: unique symbol;
+type Brand<T, B extends string = string> = T & {
+    readonly [BrandSymbol]: B;
+};
+/** Agent UUID — e.g. "550e8400-e29b-41d4-a716-446655440000" */
+export type AgentUuid = Brand<string, "AgentUuid">;
+/** Group UUID */
+export type GroupUuid = Brand<string, "GroupUuid">;
+/** Message UUID */
+export type MessageUuid = Brand<string, "MessageUuid">;
+/** Organisation UUID */
+export type OrgUuid = Brand<string, "OrgUuid">;
+/** Webhook UUID */
+export type WebhookUuid = Brand<string, "WebhookUuid">;
+/** Agent handle — e.g. "bot@acme.rine.network" */
+export type AgentHandle = Brand<string, "AgentHandle">;
+/** Group handle — e.g. "#my-group@acme.rine.network" */
+export type GroupHandle = Brand<string, "GroupHandle">;
+export declare const UUID_RE: RegExp;
+export declare function isAgentHandle(s: string): s is AgentHandle;
+export declare function isGroupHandle(s: string): s is GroupHandle;
+export declare function asAgentUuid(s: string): AgentUuid;
+export declare function asGroupUuid(s: string): GroupUuid;
+export declare function asMessageUuid(s: string): MessageUuid;
+export declare function asOrgUuid(s: string): OrgUuid;
+export declare function asWebhookUuid(s: string): WebhookUuid;
+/**
+ * Canonical rine message type strings. Derived from `PROTOCOL.md §458-474`
+ * and the Python SDK constants (`rine-sdk/src/rine/_constants.py:48`).
+ *
+ * Use these rather than raw strings — IDE autocomplete + compile-time
+ * validation + no typo-drift between consumers.
+ */
+export declare const MessageType: {
+    readonly Dm: "rine.v1.dm";
+    readonly TaskRequest: "rine.v1.task_request";
+    readonly TaskResponse: "rine.v1.task_response";
+    readonly StatusUpdate: "rine.v1.status_update";
+    readonly Negotiation: "rine.v1.negotiation";
+    readonly Receipt: "rine.v1.receipt";
+    readonly ErrorNotice: "rine.v1.error";
+    readonly CapabilityQuery: "rine.v1.capability_query";
+    readonly CapabilityResponse: "rine.v1.capability_response";
+    readonly PaymentRequest: "rine.v1.payment_request";
+    readonly PaymentConfirmation: "rine.v1.payment_confirmation";
+    readonly ConsentRequest: "rine.v1.consent_request";
+    readonly ConsentGrant: "rine.v1.consent_grant";
+    readonly ConsentRevoke: "rine.v1.consent_revoke";
+    readonly IdentityVerification: "rine.v1.identity_verification";
+    readonly SenderKeyDistribution: "rine.v1.sender_key_distribution";
+    readonly SenderKeyRequest: "rine.v1.sender_key_request";
+    readonly GroupInvite: "rine.v1.group_invite";
+    readonly Text: "rine.v1.text";
+    readonly A2AMessage: "a2a.v1.message";
+};
+/** Union of the canonical `MessageType.*` values. */
+export type KnownMessageType = (typeof MessageType)[keyof typeof MessageType];
+/**
+ * `MessageType` with an escape hatch for namespaced custom types. The
+ * `string & {}` trick preserves autocomplete for the canonical union while
+ * still accepting any other string — matching SPEC §7.2 / §10.9 exactly.
+ */
+export type MessageTypeString = KnownMessageType | (string & {});
+export declare const ConversationStatus: {
+    readonly Submitted: "submitted";
+    readonly Open: "open";
+    readonly Paused: "paused";
+    readonly InputRequired: "input_required";
+    readonly Completed: "completed";
+    readonly Rejected: "rejected";
+    readonly Canceled: "canceled";
+    readonly Failed: "failed";
+};
+export type ConversationStatusString = (typeof ConversationStatus)[keyof typeof ConversationStatus];
+export declare const JoinRequestStatus: {
+    readonly Pending: "pending";
+    readonly Approved: "approved";
+    readonly Denied: "denied";
+    readonly Expired: "expired";
+};
+export type JoinRequestStatusString = (typeof JoinRequestStatus)[keyof typeof JoinRequestStatus];
+export declare const VoteChoice: {
+    readonly Approve: "approve";
+    readonly Deny: "deny";
+};
+export type VoteChoiceString = (typeof VoteChoice)[keyof typeof VoteChoice];
+export declare const WebhookJobStatus: {
+    readonly Pending: "pending";
+    readonly Processing: "processing";
+    readonly Delivered: "delivered";
+    readonly Failed: "failed";
+    readonly Dead: "dead";
+};
+export type WebhookJobStatusString = (typeof WebhookJobStatus)[keyof typeof WebhookJobStatus];
+export declare const EncryptionVersion: {
+    readonly HpkeV1: "hpke-v1";
+    readonly SenderKeyV1: "sender-key-v1";
+};
+export type EncryptionVersionString = (typeof EncryptionVersion)[keyof typeof EncryptionVersion];
+/** Validate a custom message type against the server-side regex. */
+export declare function isValidMessageType(s: string): boolean;
+/**
+ * Message types the E2EE layer consumes internally and that must NEVER
+ * surface to user code. Enforced by `client.messages()` and `defineAgent`
+ * via the `includeReserved` debug escape hatch (SPEC D6d).
+ */
+export declare const RESERVED_MESSAGE_TYPES: ReadonlySet<MessageTypeString>;
+export declare const OrgReadSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    contact_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    country_code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    trust_tier: z.ZodDefault<z.ZodNumber>;
+    agent_count: z.ZodDefault<z.ZodNumber>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    trust_tier: number;
+    agent_count: number;
+    created_at: string;
+    slug?: string | null | undefined;
+    contact_email?: string | null | undefined;
+    country_code?: string | null | undefined;
+}, {
+    id: string;
+    name: string;
+    created_at: string;
+    slug?: string | null | undefined;
+    contact_email?: string | null | undefined;
+    country_code?: string | null | undefined;
+    trust_tier?: number | undefined;
+    agent_count?: number | undefined;
+}>;
+export type OrgRead = z.infer<typeof OrgReadSchema>;
+export declare const AgentReadSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    human_oversight: z.ZodDefault<z.ZodBoolean>;
+    incoming_policy: z.ZodDefault<z.ZodString>;
+    outgoing_policy: z.ZodDefault<z.ZodString>;
+    created_at: z.ZodString;
+    revoked_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unlisted: z.ZodOptional<z.ZodBoolean>;
+    verification_words: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    warnings: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+    poll_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    created_at: string;
+    handle: string;
+    human_oversight: boolean;
+    incoming_policy: string;
+    outgoing_policy: string;
+    revoked_at?: string | null | undefined;
+    unlisted?: boolean | undefined;
+    verification_words?: string | null | undefined;
+    warnings?: string[] | null | undefined;
+    poll_url?: string | null | undefined;
+}, {
+    id: string;
+    name: string;
+    created_at: string;
+    handle: string;
+    human_oversight?: boolean | undefined;
+    incoming_policy?: string | undefined;
+    outgoing_policy?: string | undefined;
+    revoked_at?: string | null | undefined;
+    unlisted?: boolean | undefined;
+    verification_words?: string | null | undefined;
+    warnings?: string[] | null | undefined;
+    poll_url?: string | null | undefined;
+}>;
+export type AgentRead = z.infer<typeof AgentReadSchema>;
+export declare const WhoAmISchema: z.ZodObject<{
+    org: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        contact_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        country_code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        trust_tier: z.ZodDefault<z.ZodNumber>;
+        agent_count: z.ZodDefault<z.ZodNumber>;
+        created_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        trust_tier: number;
+        agent_count: number;
+        created_at: string;
+        slug?: string | null | undefined;
+        contact_email?: string | null | undefined;
+        country_code?: string | null | undefined;
+    }, {
+        id: string;
+        name: string;
+        created_at: string;
+        slug?: string | null | undefined;
+        contact_email?: string | null | undefined;
+        country_code?: string | null | undefined;
+        trust_tier?: number | undefined;
+        agent_count?: number | undefined;
+    }>;
+    agents: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        handle: z.ZodString;
+        human_oversight: z.ZodDefault<z.ZodBoolean>;
+        incoming_policy: z.ZodDefault<z.ZodString>;
+        outgoing_policy: z.ZodDefault<z.ZodString>;
+        created_at: z.ZodString;
+        revoked_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        unlisted: z.ZodOptional<z.ZodBoolean>;
+        verification_words: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        warnings: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        poll_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        created_at: string;
+        handle: string;
+        human_oversight: boolean;
+        incoming_policy: string;
+        outgoing_policy: string;
+        revoked_at?: string | null | undefined;
+        unlisted?: boolean | undefined;
+        verification_words?: string | null | undefined;
+        warnings?: string[] | null | undefined;
+        poll_url?: string | null | undefined;
+    }, {
+        id: string;
+        name: string;
+        created_at: string;
+        handle: string;
+        human_oversight?: boolean | undefined;
+        incoming_policy?: string | undefined;
+        outgoing_policy?: string | undefined;
+        revoked_at?: string | null | undefined;
+        unlisted?: boolean | undefined;
+        verification_words?: string | null | undefined;
+        warnings?: string[] | null | undefined;
+        poll_url?: string | null | undefined;
+    }>, "many">;
+    trust_tier: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    trust_tier: number;
+    org: {
+        id: string;
+        name: string;
+        trust_tier: number;
+        agent_count: number;
+        created_at: string;
+        slug?: string | null | undefined;
+        contact_email?: string | null | undefined;
+        country_code?: string | null | undefined;
+    };
+    agents: {
+        id: string;
+        name: string;
+        created_at: string;
+        handle: string;
+        human_oversight: boolean;
+        incoming_policy: string;
+        outgoing_policy: string;
+        revoked_at?: string | null | undefined;
+        unlisted?: boolean | undefined;
+        verification_words?: string | null | undefined;
+        warnings?: string[] | null | undefined;
+        poll_url?: string | null | undefined;
+    }[];
+}, {
+    org: {
+        id: string;
+        name: string;
+        created_at: string;
+        slug?: string | null | undefined;
+        contact_email?: string | null | undefined;
+        country_code?: string | null | undefined;
+        trust_tier?: number | undefined;
+        agent_count?: number | undefined;
+    };
+    agents: {
+        id: string;
+        name: string;
+        created_at: string;
+        handle: string;
+        human_oversight?: boolean | undefined;
+        incoming_policy?: string | undefined;
+        outgoing_policy?: string | undefined;
+        revoked_at?: string | null | undefined;
+        unlisted?: boolean | undefined;
+        verification_words?: string | null | undefined;
+        warnings?: string[] | null | undefined;
+        poll_url?: string | null | undefined;
+    }[];
+    trust_tier?: number | undefined;
+}>;
+export type WhoAmI = z.infer<typeof WhoAmISchema>;
+export declare const MessageReadSchema: z.ZodObject<{
+    id: z.ZodString;
+    conversation_id: z.ZodString;
+    from_agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    to_agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sender_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    recipient_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodString;
+    encrypted_payload: z.ZodString;
+    encryption_version: z.ZodString;
+    sender_signing_kid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    created_at: z.ZodString;
+    delivered_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    read_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    group_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    group_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    created_at: string;
+    type: string;
+    conversation_id: string;
+    encrypted_payload: string;
+    encryption_version: string;
+    metadata: Record<string, unknown>;
+    from_agent_id?: string | null | undefined;
+    to_agent_id?: string | null | undefined;
+    sender_handle?: string | null | undefined;
+    recipient_handle?: string | null | undefined;
+    sender_signing_kid?: string | null | undefined;
+    content_type?: string | null | undefined;
+    delivered_at?: string | null | undefined;
+    read_at?: string | null | undefined;
+    group_id?: string | null | undefined;
+    group_handle?: string | null | undefined;
+}, {
+    id: string;
+    created_at: string;
+    type: string;
+    conversation_id: string;
+    encrypted_payload: string;
+    encryption_version: string;
+    from_agent_id?: string | null | undefined;
+    to_agent_id?: string | null | undefined;
+    sender_handle?: string | null | undefined;
+    recipient_handle?: string | null | undefined;
+    sender_signing_kid?: string | null | undefined;
+    content_type?: string | null | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    delivered_at?: string | null | undefined;
+    read_at?: string | null | undefined;
+    group_id?: string | null | undefined;
+    group_handle?: string | null | undefined;
+}>;
+export type MessageRead = z.infer<typeof MessageReadSchema>;
+export declare const DecryptedMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    conversation_id: z.ZodString;
+    from_agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    to_agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sender_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    recipient_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodString;
+    encrypted_payload: z.ZodString;
+    encryption_version: z.ZodString;
+    sender_signing_kid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    created_at: z.ZodString;
+    delivered_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    read_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    group_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    group_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+} & {
+    plaintext: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    verification_status: z.ZodDefault<z.ZodEnum<["verified", "invalid", "unverifiable"]>>;
+    decrypt_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    created_at: string;
+    type: string;
+    conversation_id: string;
+    encrypted_payload: string;
+    encryption_version: string;
+    metadata: Record<string, unknown>;
+    verified: boolean;
+    verification_status: "verified" | "invalid" | "unverifiable";
+    from_agent_id?: string | null | undefined;
+    to_agent_id?: string | null | undefined;
+    sender_handle?: string | null | undefined;
+    recipient_handle?: string | null | undefined;
+    sender_signing_kid?: string | null | undefined;
+    content_type?: string | null | undefined;
+    delivered_at?: string | null | undefined;
+    read_at?: string | null | undefined;
+    group_id?: string | null | undefined;
+    group_handle?: string | null | undefined;
+    plaintext?: unknown;
+    decrypt_error?: string | null | undefined;
+}, {
+    id: string;
+    created_at: string;
+    type: string;
+    conversation_id: string;
+    encrypted_payload: string;
+    encryption_version: string;
+    from_agent_id?: string | null | undefined;
+    to_agent_id?: string | null | undefined;
+    sender_handle?: string | null | undefined;
+    recipient_handle?: string | null | undefined;
+    sender_signing_kid?: string | null | undefined;
+    content_type?: string | null | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    delivered_at?: string | null | undefined;
+    read_at?: string | null | undefined;
+    group_id?: string | null | undefined;
+    group_handle?: string | null | undefined;
+    plaintext?: unknown;
+    verified?: boolean | undefined;
+    verification_status?: "verified" | "invalid" | "unverifiable" | undefined;
+    decrypt_error?: string | null | undefined;
+}>;
+/**
+ * Decrypted message envelope. The `T` generic narrows `plaintext` end-to-end
+ * when a `StandardSchemaV1<T>` is supplied to `read<T>`, `messages<T>`,
+ * `sendAndWait<Req, Rep>`, `conversation(id).{messages,history}<T>`, or
+ * `defineAgent<T>` — SPEC §7.3 / §7.4 / §11.4.
+ *
+ * Default `T = unknown` forces callers to narrow before use. Without a
+ * schema the runtime plaintext is whatever rine-core's decrypt helpers
+ * returned (a string on the happy path, `null` when `decrypt_error` is
+ * populated) — the type stays `unknown` so callers can't blindly treat it
+ * as a specific shape without opting in.
+ *
+ * The Zod-inferred shape is preserved on `DecryptedMessage<unknown>` for
+ * all fields except `plaintext`, which is replaced with `T | null` so
+ * `msg.plaintext` is assignment-compatible with the user's validated
+ * output type.
+ */
+export type DecryptedMessage<T = unknown> = Omit<z.infer<typeof DecryptedMessageSchema>, "plaintext"> & {
+    plaintext?: T | null;
+};
+/**
+ * Wire-format Zod schema for `{ sent, reply }` — retained for symmetry with
+ * the other `*Schema` exports even though the resource layer no longer calls
+ * `parse(SendAndWaitResultSchema, …)` directly (Step 19 replaced that with
+ * an explicit object literal so the generic `Rep` narrowing could flow
+ * through). The hand-rolled `SendAndWaitResult<Rep>` below is the type
+ * `client.sendAndWait<Req, Rep>()` returns; the two are structurally
+ * equivalent at `Rep = unknown` but the Zod inference does not carry
+ * the generic, so consumers that want typed plaintext should rely on
+ * the function return type, not `z.infer<typeof SendAndWaitResultSchema>`.
+ */
+export declare const SendAndWaitResultSchema: z.ZodObject<{
+    sent: z.ZodObject<{
+        id: z.ZodString;
+        conversation_id: z.ZodString;
+        from_agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        to_agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sender_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        recipient_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodString;
+        encrypted_payload: z.ZodString;
+        encryption_version: z.ZodString;
+        sender_signing_kid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        created_at: z.ZodString;
+        delivered_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        read_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        group_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        group_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        created_at: string;
+        type: string;
+        conversation_id: string;
+        encrypted_payload: string;
+        encryption_version: string;
+        metadata: Record<string, unknown>;
+        from_agent_id?: string | null | undefined;
+        to_agent_id?: string | null | undefined;
+        sender_handle?: string | null | undefined;
+        recipient_handle?: string | null | undefined;
+        sender_signing_kid?: string | null | undefined;
+        content_type?: string | null | undefined;
+        delivered_at?: string | null | undefined;
+        read_at?: string | null | undefined;
+        group_id?: string | null | undefined;
+        group_handle?: string | null | undefined;
+    }, {
+        id: string;
+        created_at: string;
+        type: string;
+        conversation_id: string;
+        encrypted_payload: string;
+        encryption_version: string;
+        from_agent_id?: string | null | undefined;
+        to_agent_id?: string | null | undefined;
+        sender_handle?: string | null | undefined;
+        recipient_handle?: string | null | undefined;
+        sender_signing_kid?: string | null | undefined;
+        content_type?: string | null | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        delivered_at?: string | null | undefined;
+        read_at?: string | null | undefined;
+        group_id?: string | null | undefined;
+        group_handle?: string | null | undefined;
+    }>;
+    reply: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        conversation_id: z.ZodString;
+        from_agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        to_agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sender_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        recipient_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodString;
+        encrypted_payload: z.ZodString;
+        encryption_version: z.ZodString;
+        sender_signing_kid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        content_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        created_at: z.ZodString;
+        delivered_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        read_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        group_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        group_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    } & {
+        plaintext: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+        verified: z.ZodDefault<z.ZodBoolean>;
+        verification_status: z.ZodDefault<z.ZodEnum<["verified", "invalid", "unverifiable"]>>;
+        decrypt_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        created_at: string;
+        type: string;
+        conversation_id: string;
+        encrypted_payload: string;
+        encryption_version: string;
+        metadata: Record<string, unknown>;
+        verified: boolean;
+        verification_status: "verified" | "invalid" | "unverifiable";
+        from_agent_id?: string | null | undefined;
+        to_agent_id?: string | null | undefined;
+        sender_handle?: string | null | undefined;
+        recipient_handle?: string | null | undefined;
+        sender_signing_kid?: string | null | undefined;
+        content_type?: string | null | undefined;
+        delivered_at?: string | null | undefined;
+        read_at?: string | null | undefined;
+        group_id?: string | null | undefined;
+        group_handle?: string | null | undefined;
+        plaintext?: unknown;
+        decrypt_error?: string | null | undefined;
+    }, {
+        id: string;
+        created_at: string;
+        type: string;
+        conversation_id: string;
+        encrypted_payload: string;
+        encryption_version: string;
+        from_agent_id?: string | null | undefined;
+        to_agent_id?: string | null | undefined;
+        sender_handle?: string | null | undefined;
+        recipient_handle?: string | null | undefined;
+        sender_signing_kid?: string | null | undefined;
+        content_type?: string | null | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        delivered_at?: string | null | undefined;
+        read_at?: string | null | undefined;
+        group_id?: string | null | undefined;
+        group_handle?: string | null | undefined;
+        plaintext?: unknown;
+        verified?: boolean | undefined;
+        verification_status?: "verified" | "invalid" | "unverifiable" | undefined;
+        decrypt_error?: string | null | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    sent: {
+        id: string;
+        created_at: string;
+        type: string;
+        conversation_id: string;
+        encrypted_payload: string;
+        encryption_version: string;
+        metadata: Record<string, unknown>;
+        from_agent_id?: string | null | undefined;
+        to_agent_id?: string | null | undefined;
+        sender_handle?: string | null | undefined;
+        recipient_handle?: string | null | undefined;
+        sender_signing_kid?: string | null | undefined;
+        content_type?: string | null | undefined;
+        delivered_at?: string | null | undefined;
+        read_at?: string | null | undefined;
+        group_id?: string | null | undefined;
+        group_handle?: string | null | undefined;
+    };
+    reply: {
+        id: string;
+        created_at: string;
+        type: string;
+        conversation_id: string;
+        encrypted_payload: string;
+        encryption_version: string;
+        metadata: Record<string, unknown>;
+        verified: boolean;
+        verification_status: "verified" | "invalid" | "unverifiable";
+        from_agent_id?: string | null | undefined;
+        to_agent_id?: string | null | undefined;
+        sender_handle?: string | null | undefined;
+        recipient_handle?: string | null | undefined;
+        sender_signing_kid?: string | null | undefined;
+        content_type?: string | null | undefined;
+        delivered_at?: string | null | undefined;
+        read_at?: string | null | undefined;
+        group_id?: string | null | undefined;
+        group_handle?: string | null | undefined;
+        plaintext?: unknown;
+        decrypt_error?: string | null | undefined;
+    } | null;
+}, {
+    sent: {
+        id: string;
+        created_at: string;
+        type: string;
+        conversation_id: string;
+        encrypted_payload: string;
+        encryption_version: string;
+        from_agent_id?: string | null | undefined;
+        to_agent_id?: string | null | undefined;
+        sender_handle?: string | null | undefined;
+        recipient_handle?: string | null | undefined;
+        sender_signing_kid?: string | null | undefined;
+        content_type?: string | null | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        delivered_at?: string | null | undefined;
+        read_at?: string | null | undefined;
+        group_id?: string | null | undefined;
+        group_handle?: string | null | undefined;
+    };
+    reply: {
+        id: string;
+        created_at: string;
+        type: string;
+        conversation_id: string;
+        encrypted_payload: string;
+        encryption_version: string;
+        from_agent_id?: string | null | undefined;
+        to_agent_id?: string | null | undefined;
+        sender_handle?: string | null | undefined;
+        recipient_handle?: string | null | undefined;
+        sender_signing_kid?: string | null | undefined;
+        content_type?: string | null | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        delivered_at?: string | null | undefined;
+        read_at?: string | null | undefined;
+        group_id?: string | null | undefined;
+        group_handle?: string | null | undefined;
+        plaintext?: unknown;
+        verified?: boolean | undefined;
+        verification_status?: "verified" | "invalid" | "unverifiable" | undefined;
+        decrypt_error?: string | null | undefined;
+    } | null;
+}>;
+/**
+ * Result of `client.sendAndWait<Req, Rep>()`. The `Rep` generic narrows the
+ * decrypted reply plaintext end-to-end when `opts.replySchema` is supplied.
+ */
+export type SendAndWaitResult<Rep = unknown> = {
+    sent: MessageRead;
+    reply: DecryptedMessage<Rep> | null;
+};
+export declare const GroupReadSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enrollment_policy: z.ZodDefault<z.ZodString>;
+    visibility: z.ZodDefault<z.ZodString>;
+    isolated: z.ZodDefault<z.ZodBoolean>;
+    vote_duration_hours: z.ZodDefault<z.ZodNumber>;
+    member_count: z.ZodDefault<z.ZodNumber>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    created_at: string;
+    handle: string;
+    enrollment_policy: string;
+    visibility: string;
+    isolated: boolean;
+    vote_duration_hours: number;
+    member_count: number;
+    description?: string | null | undefined;
+}, {
+    id: string;
+    name: string;
+    created_at: string;
+    handle: string;
+    description?: string | null | undefined;
+    enrollment_policy?: string | undefined;
+    visibility?: string | undefined;
+    isolated?: boolean | undefined;
+    vote_duration_hours?: number | undefined;
+    member_count?: number | undefined;
+}>;
+export type GroupRead = z.infer<typeof GroupReadSchema>;
+export declare const GroupMemberSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    group_id: z.ZodString;
+    agent_id: z.ZodString;
+    role: z.ZodDefault<z.ZodString>;
+    joined_at: z.ZodString;
+    agent_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    group_id: string;
+    agent_id: string;
+    role: string;
+    joined_at: string;
+    id?: string | null | undefined;
+    agent_handle?: string | null | undefined;
+}, {
+    group_id: string;
+    agent_id: string;
+    joined_at: string;
+    id?: string | null | undefined;
+    role?: string | undefined;
+    agent_handle?: string | null | undefined;
+}>;
+export type GroupMember = z.infer<typeof GroupMemberSchema>;
+export declare const JoinRequestReadSchema: z.ZodObject<{
+    id: z.ZodString;
+    group_id: z.ZodString;
+    agent_id: z.ZodString;
+    invited_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodString;
+    expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+    resolved_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    your_vote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    created_at: string;
+    status: string;
+    group_id: string;
+    agent_id: string;
+    message?: string | null | undefined;
+    invited_by?: string | null | undefined;
+    expires_at?: string | null | undefined;
+    resolved_at?: string | null | undefined;
+    your_vote?: string | null | undefined;
+}, {
+    id: string;
+    created_at: string;
+    status: string;
+    group_id: string;
+    agent_id: string;
+    message?: string | null | undefined;
+    invited_by?: string | null | undefined;
+    expires_at?: string | null | undefined;
+    resolved_at?: string | null | undefined;
+    your_vote?: string | null | undefined;
+}>;
+export type JoinRequestRead = z.infer<typeof JoinRequestReadSchema>;
+export declare const JoinedResultSchema: z.ZodObject<{
+    status: z.ZodLiteral<"joined">;
+    member: z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        group_id: z.ZodString;
+        agent_id: z.ZodString;
+        role: z.ZodDefault<z.ZodString>;
+        joined_at: z.ZodString;
+        agent_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        group_id: string;
+        agent_id: string;
+        role: string;
+        joined_at: string;
+        id?: string | null | undefined;
+        agent_handle?: string | null | undefined;
+    }, {
+        group_id: string;
+        agent_id: string;
+        joined_at: string;
+        id?: string | null | undefined;
+        role?: string | undefined;
+        agent_handle?: string | null | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "joined";
+    member: {
+        group_id: string;
+        agent_id: string;
+        role: string;
+        joined_at: string;
+        id?: string | null | undefined;
+        agent_handle?: string | null | undefined;
+    };
+}, {
+    status: "joined";
+    member: {
+        group_id: string;
+        agent_id: string;
+        joined_at: string;
+        id?: string | null | undefined;
+        role?: string | undefined;
+        agent_handle?: string | null | undefined;
+    };
+}>;
+export declare const PendingJoinResultSchema: z.ZodObject<{
+    status: z.ZodLiteral<"pending">;
+    request: z.ZodObject<{
+        id: z.ZodString;
+        group_id: z.ZodString;
+        agent_id: z.ZodString;
+        invited_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodString;
+        expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodString;
+        resolved_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        your_vote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        created_at: string;
+        status: string;
+        group_id: string;
+        agent_id: string;
+        message?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        expires_at?: string | null | undefined;
+        resolved_at?: string | null | undefined;
+        your_vote?: string | null | undefined;
+    }, {
+        id: string;
+        created_at: string;
+        status: string;
+        group_id: string;
+        agent_id: string;
+        message?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        expires_at?: string | null | undefined;
+        resolved_at?: string | null | undefined;
+        your_vote?: string | null | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending";
+    request: {
+        id: string;
+        created_at: string;
+        status: string;
+        group_id: string;
+        agent_id: string;
+        message?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        expires_at?: string | null | undefined;
+        resolved_at?: string | null | undefined;
+        your_vote?: string | null | undefined;
+    };
+}, {
+    status: "pending";
+    request: {
+        id: string;
+        created_at: string;
+        status: string;
+        group_id: string;
+        agent_id: string;
+        message?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        expires_at?: string | null | undefined;
+        resolved_at?: string | null | undefined;
+        your_vote?: string | null | undefined;
+    };
+}>;
+export declare const JoinResultSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"joined">;
+    member: z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        group_id: z.ZodString;
+        agent_id: z.ZodString;
+        role: z.ZodDefault<z.ZodString>;
+        joined_at: z.ZodString;
+        agent_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        group_id: string;
+        agent_id: string;
+        role: string;
+        joined_at: string;
+        id?: string | null | undefined;
+        agent_handle?: string | null | undefined;
+    }, {
+        group_id: string;
+        agent_id: string;
+        joined_at: string;
+        id?: string | null | undefined;
+        role?: string | undefined;
+        agent_handle?: string | null | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "joined";
+    member: {
+        group_id: string;
+        agent_id: string;
+        role: string;
+        joined_at: string;
+        id?: string | null | undefined;
+        agent_handle?: string | null | undefined;
+    };
+}, {
+    status: "joined";
+    member: {
+        group_id: string;
+        agent_id: string;
+        joined_at: string;
+        id?: string | null | undefined;
+        role?: string | undefined;
+        agent_handle?: string | null | undefined;
+    };
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"pending">;
+    request: z.ZodObject<{
+        id: z.ZodString;
+        group_id: z.ZodString;
+        agent_id: z.ZodString;
+        invited_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodString;
+        expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodString;
+        resolved_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        your_vote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        created_at: string;
+        status: string;
+        group_id: string;
+        agent_id: string;
+        message?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        expires_at?: string | null | undefined;
+        resolved_at?: string | null | undefined;
+        your_vote?: string | null | undefined;
+    }, {
+        id: string;
+        created_at: string;
+        status: string;
+        group_id: string;
+        agent_id: string;
+        message?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        expires_at?: string | null | undefined;
+        resolved_at?: string | null | undefined;
+        your_vote?: string | null | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending";
+    request: {
+        id: string;
+        created_at: string;
+        status: string;
+        group_id: string;
+        agent_id: string;
+        message?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        expires_at?: string | null | undefined;
+        resolved_at?: string | null | undefined;
+        your_vote?: string | null | undefined;
+    };
+}, {
+    status: "pending";
+    request: {
+        id: string;
+        created_at: string;
+        status: string;
+        group_id: string;
+        agent_id: string;
+        message?: string | null | undefined;
+        invited_by?: string | null | undefined;
+        expires_at?: string | null | undefined;
+        resolved_at?: string | null | undefined;
+        your_vote?: string | null | undefined;
+    };
+}>]>;
+export type JoinResult = z.infer<typeof JoinResultSchema>;
+export declare const InviteResultSchema: z.ZodObject<{
+    status: z.ZodString;
+    request_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    request_id?: string | null | undefined;
+}, {
+    status: string;
+    request_id?: string | null | undefined;
+}>;
+export type InviteResult = z.infer<typeof InviteResultSchema>;
+export declare const GroupSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visibility: z.ZodDefault<z.ZodString>;
+    member_count: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    handle: string;
+    visibility: string;
+    member_count: number;
+    description?: string | null | undefined;
+}, {
+    id: string;
+    name: string;
+    handle: string;
+    description?: string | null | undefined;
+    visibility?: string | undefined;
+    member_count?: number | undefined;
+}>;
+export type GroupSummary = z.infer<typeof GroupSummarySchema>;
+export declare const VoteResponseSchema: z.ZodObject<{
+    request_id: z.ZodString;
+    your_vote: z.ZodString;
+    status: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    your_vote: string;
+    request_id: string;
+}, {
+    status: string;
+    your_vote: string;
+    request_id: string;
+}>;
+export type VoteResponse = z.infer<typeof VoteResponseSchema>;
+export declare const AgentSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    handle: string;
+    verified: boolean;
+    description?: string | null | undefined;
+    category?: string | null | undefined;
+}, {
+    id: string;
+    name: string;
+    handle: string;
+    verified?: boolean | undefined;
+    description?: string | null | undefined;
+    category?: string | null | undefined;
+}>;
+export type AgentSummary = z.infer<typeof AgentSummarySchema>;
+export declare const AgentProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    human_oversight: z.ZodDefault<z.ZodBoolean>;
+    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    handle: string;
+    human_oversight: boolean;
+    verified: boolean;
+    created_at?: string | null | undefined;
+    description?: string | null | undefined;
+    category?: string | null | undefined;
+}, {
+    id: string;
+    name: string;
+    handle: string;
+    created_at?: string | null | undefined;
+    human_oversight?: boolean | undefined;
+    verified?: boolean | undefined;
+    description?: string | null | undefined;
+    category?: string | null | undefined;
+}>;
+export type AgentProfile = z.infer<typeof AgentProfileSchema>;
+export declare const AgentCardSchema: z.ZodObject<{
+    id: z.ZodString;
+    agent_id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    is_public: z.ZodDefault<z.ZodBoolean>;
+    skills: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>>;
+    rine: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    created_at: z.ZodString;
+    updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    created_at: string;
+    agent_id: string;
+    is_public: boolean;
+    skills: Record<string, unknown>[];
+    rine: Record<string, unknown>;
+    description?: string | null | undefined;
+    version?: string | null | undefined;
+    updated_at?: string | null | undefined;
+}, {
+    id: string;
+    name: string;
+    created_at: string;
+    agent_id: string;
+    description?: string | null | undefined;
+    version?: string | null | undefined;
+    is_public?: boolean | undefined;
+    skills?: Record<string, unknown>[] | undefined;
+    rine?: Record<string, unknown> | undefined;
+    updated_at?: string | null | undefined;
+}>;
+export type AgentCardRead = z.infer<typeof AgentCardSchema>;
+export declare const WebhookReadSchema: z.ZodObject<{
+    id: z.ZodString;
+    agent_id: z.ZodString;
+    url: z.ZodString;
+    active: z.ZodDefault<z.ZodBoolean>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    created_at: string;
+    agent_id: string;
+    url: string;
+    active: boolean;
+}, {
+    id: string;
+    created_at: string;
+    agent_id: string;
+    url: string;
+    active?: boolean | undefined;
+}>;
+export type WebhookRead = z.infer<typeof WebhookReadSchema>;
+export declare const WebhookCreatedSchema: z.ZodObject<{
+    id: z.ZodString;
+    agent_id: z.ZodString;
+    url: z.ZodString;
+    active: z.ZodDefault<z.ZodBoolean>;
+    created_at: z.ZodString;
+} & {
+    secret: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    created_at: string;
+    agent_id: string;
+    url: string;
+    active: boolean;
+    secret: string;
+}, {
+    id: string;
+    created_at: string;
+    agent_id: string;
+    url: string;
+    secret: string;
+    active?: boolean | undefined;
+}>;
+export type WebhookCreated = z.infer<typeof WebhookCreatedSchema>;
+export declare const WebhookDeliveryReadSchema: z.ZodObject<{
+    id: z.ZodString;
+    webhook_id: z.ZodString;
+    message_id: z.ZodString;
+    status: z.ZodString;
+    attempts: z.ZodDefault<z.ZodNumber>;
+    max_attempts: z.ZodDefault<z.ZodNumber>;
+    last_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+    delivered_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    next_attempt_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    created_at: string;
+    status: string;
+    webhook_id: string;
+    message_id: string;
+    attempts: number;
+    max_attempts: number;
+    delivered_at?: string | null | undefined;
+    last_error?: string | null | undefined;
+    next_attempt_at?: string | null | undefined;
+}, {
+    id: string;
+    created_at: string;
+    status: string;
+    webhook_id: string;
+    message_id: string;
+    delivered_at?: string | null | undefined;
+    attempts?: number | undefined;
+    max_attempts?: number | undefined;
+    last_error?: string | null | undefined;
+    next_attempt_at?: string | null | undefined;
+}>;
+export type WebhookDeliveryRead = z.infer<typeof WebhookDeliveryReadSchema>;
+export declare const WebhookJobSummarySchema: z.ZodObject<{
+    total: z.ZodDefault<z.ZodNumber>;
+    delivered: z.ZodDefault<z.ZodNumber>;
+    failed: z.ZodDefault<z.ZodNumber>;
+    dead: z.ZodDefault<z.ZodNumber>;
+    pending: z.ZodDefault<z.ZodNumber>;
+    processing: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    failed: number;
+    pending: number;
+    processing: number;
+    delivered: number;
+    dead: number;
+    total: number;
+}, {
+    failed?: number | undefined;
+    pending?: number | undefined;
+    processing?: number | undefined;
+    delivered?: number | undefined;
+    dead?: number | undefined;
+    total?: number | undefined;
+}>;
+export type WebhookJobSummary = z.infer<typeof WebhookJobSummarySchema>;
+export declare const QuotaEntrySchema: z.ZodObject<{
+    limit: z.ZodNullable<z.ZodNumber>;
+    used: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number | null;
+    used?: number | null | undefined;
+}, {
+    limit: number | null;
+    used?: number | null | undefined;
+}>;
+export type QuotaEntry = z.infer<typeof QuotaEntrySchema>;
+export declare const OrgQuotasSchema: z.ZodObject<{
+    tier: z.ZodNumber;
+    quotas: z.ZodRecord<z.ZodString, z.ZodObject<{
+        limit: z.ZodNullable<z.ZodNumber>;
+        used: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number | null;
+        used?: number | null | undefined;
+    }, {
+        limit: number | null;
+        used?: number | null | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    tier: number;
+    quotas: Record<string, {
+        limit: number | null;
+        used?: number | null | undefined;
+    }>;
+}, {
+    tier: number;
+    quotas: Record<string, {
+        limit: number | null;
+        used?: number | null | undefined;
+    }>;
+}>;
+export type OrgQuotas = z.infer<typeof OrgQuotasSchema>;
+export declare const PollTokenResponseSchema: z.ZodObject<{
+    poll_url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    poll_url: string;
+}, {
+    poll_url: string;
+}>;
+export type PollTokenResponse = z.infer<typeof PollTokenResponseSchema>;
+export declare const RineEventSchema: z.ZodObject<{
+    type: z.ZodEnum<["message", "heartbeat", "status", "disconnect"]>;
+    data: z.ZodString;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: "message" | "status" | "heartbeat" | "disconnect";
+    data: string;
+    id?: string | null | undefined;
+}, {
+    type: "message" | "status" | "heartbeat" | "disconnect";
+    data: string;
+    id?: string | null | undefined;
+}>;
+export type RineEvent = z.infer<typeof RineEventSchema>;
+export declare const ErasureResultSchema: z.ZodObject<{
+    org_id: z.ZodString;
+    erased_at: z.ZodString;
+    messages_deleted: z.ZodNumber;
+    agents_deleted: z.ZodNumber;
+    conversations_deleted: z.ZodNumber;
+    groups_deleted: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    org_id: string;
+    erased_at: string;
+    messages_deleted: number;
+    agents_deleted: number;
+    conversations_deleted: number;
+    groups_deleted: number;
+}, {
+    org_id: string;
+    erased_at: string;
+    messages_deleted: number;
+    agents_deleted: number;
+    conversations_deleted: number;
+    groups_deleted?: number | undefined;
+}>;
+export type ErasureResult = z.infer<typeof ErasureResultSchema>;
+export declare const PaginatedResponseSchema: <T extends z.ZodTypeAny>(itemSchema: T) => z.ZodObject<{
+    items: z.ZodArray<T, "many">;
+    total_estimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    prev_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    items: T["_output"][];
+    total?: number | null | undefined;
+    total_estimate?: number | null | undefined;
+    next_cursor?: string | null | undefined;
+    prev_cursor?: string | null | undefined;
+}, {
+    items: T["_input"][];
+    total?: number | null | undefined;
+    total_estimate?: number | null | undefined;
+    next_cursor?: string | null | undefined;
+    prev_cursor?: string | null | undefined;
+}>;
+/**
+ * CursorPage raw response schema — used by adapters.parsePaginated().
+ * This is NOT a generic schema; it accepts a Zod schema for the item type
+ * and returns the full paginated response schema.
+ */
+export declare function cursorPageSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    items: z.ZodArray<T, "many">;
+    total_estimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    prev_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    items: T["_output"][];
+    total?: number | null | undefined;
+    total_estimate?: number | null | undefined;
+    next_cursor?: string | null | undefined;
+    prev_cursor?: string | null | undefined;
+}, {
+    items: T["_input"][];
+    total?: number | null | undefined;
+    total_estimate?: number | null | undefined;
+    next_cursor?: string | null | undefined;
+    prev_cursor?: string | null | undefined;
+}>;
+export {};