@tai42/api-client 16.0.0 → 16.0.1

package/dist/schemas/conversations.d.ts

@@ -0,0 +1,600 @@
+/** Conversation route, thread, transcript and config schemas. */
+import { z } from 'zod';
+/** The inbound door a route is bound to: the authed API, or a channel medium. */
+export declare const conversationDoor: z.ZodEnum<{
+    channel: "channel";
+    api: "api";
+}>;
+export type ConversationDoor = z.infer<typeof conversationDoor>;
+/** What a route's turn runs: a registered agent, or a tool dispatch. */
+export declare const conversationTargetKind: z.ZodEnum<{
+    tool: "tool";
+    agent: "agent";
+}>;
+export type ConversationTargetKind = z.infer<typeof conversationTargetKind>;
+/**
+ * A route's default control mode (`initial_mode`) when a thread carries no
+ * per-thread override: `agent` runs the target turn, `manual` suppresses it for an
+ * operator to answer. The same value vocabulary as a per-thread mode override, but
+ * a distinct concept (the route default vs. one thread's override).
+ */
+export declare const conversationMode: z.ZodEnum<{
+    agent: "agent";
+    manual: "manual";
+}>;
+export type ConversationMode = z.infer<typeof conversationMode>;
+/**
+ * Where a record sits between intake and a terminal outcome. `failed` is the one
+ * the monitor surfaces loudly; `shed` and `silent` are terminal by design and
+ * never send.
+ */
+export declare const conversationDeliveryStatus: z.ZodEnum<{
+    failed: "failed";
+    accepted: "accepted";
+    pending_delivery: "pending_delivery";
+    provisional: "provisional";
+    delivered: "delivered";
+    shed: "shed";
+    silent: "silent";
+}>;
+export type ConversationDeliveryStatus = z.infer<typeof conversationDeliveryStatus>;
+/** The nature of a turn's outcome, orthogonal to where its delivery stands. */
+export declare const conversationAnswerStatus: z.ZodEnum<{
+    error: "error";
+    silent: "silent";
+    answered: "answered";
+}>;
+export type ConversationAnswerStatus = z.infer<typeof conversationAnswerStatus>;
+/**
+ * Who authored a record's outgoing side. `client` is the ordinary turn the flow
+ * answered; `operator` is a message a human sent into the thread, whose text
+ * rides `answer` (its `inbound_text` is empty).
+ */
+export declare const conversationRecordOrigin: z.ZodEnum<{
+    client: "client";
+    operator: "operator";
+}>;
+export type ConversationRecordOrigin = z.infer<typeof conversationRecordOrigin>;
+export declare const conversationRoutes: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        callback_secret: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        callback_url: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        channel: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        door: z.ZodEnum<{
+            channel: "channel";
+            api: "api";
+        }>;
+        error_reply_text: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        execution_key: z.ZodString;
+        execution_key_fingerprint: z.ZodString;
+        initial_mode: z.ZodDefault<z.ZodEnum<{
+            agent: "agent";
+            manual: "manual";
+        }>>;
+        locale: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        our_identity: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        payload_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>, z.ZodNull]>>;
+        reply_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>, z.ZodNull]>>;
+        route_name: z.ZodString;
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+        turns_per_hour_override: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type ConversationRoutes = z.infer<typeof conversationRoutes>;
+/**
+ * The create/replace reply: whether THIS call created the row (vs. replaced an
+ * existing one), the row itself (its `callback_secret` withheld), and the
+ * `callback_secret` returned ONCE for an `api`-door row (`null` for a `channel`
+ * row). The secret signs delivery callbacks and is never re-read from any door, so
+ * a caller that needs it must capture it from this reply.
+ */
+export declare const conversationRouteWritten: z.ZodObject<{
+    created: z.ZodBoolean;
+    route_name: z.ZodString;
+    route: z.ZodObject<{
+        callback_secret: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        callback_url: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        channel: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        door: z.ZodEnum<{
+            channel: "channel";
+            api: "api";
+        }>;
+        error_reply_text: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        execution_key: z.ZodString;
+        execution_key_fingerprint: z.ZodString;
+        initial_mode: z.ZodDefault<z.ZodEnum<{
+            agent: "agent";
+            manual: "manual";
+        }>>;
+        locale: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        our_identity: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        payload_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>, z.ZodNull]>>;
+        reply_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>, z.ZodNull]>>;
+        route_name: z.ZodString;
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+        turns_per_hour_override: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+    }, z.core.$strip>;
+    callback_secret: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ConversationRouteWritten = z.infer<typeof conversationRouteWritten>;
+/**
+ * The delete reply: `removed` says whether THIS call removed the routing row (a
+ * retryable reclamation of orphaned thread indexes answers `false` rather than a
+ * 404).
+ */
+export declare const conversationRouteDeleted: z.ZodObject<{
+    removed: z.ZodBoolean;
+    route_name: z.ZodString;
+}, z.core.$strip>;
+export type ConversationRouteDeleted = z.infer<typeof conversationRouteDeleted>;
+/**
+ * One thread of a route, summarized from its newest record. A `thread_id` holds
+ * an api-door address (`{principal}/{end user}`, percent-encoded), so it never
+ * goes back into a URL as a path segment — the transcript door takes it as a
+ * query value.
+ */
+export declare const conversationThread: z.ZodObject<{
+    thread_id: z.ZodString;
+    client_address: z.ZodString;
+    last_activity_at: z.ZodNumber;
+    message_count: z.ZodNumber;
+    last_delivery_status: z.ZodEnum<{
+        failed: "failed";
+        accepted: "accepted";
+        pending_delivery: "pending_delivery";
+        provisional: "provisional";
+        delivered: "delivered";
+        shed: "shed";
+        silent: "silent";
+    }>;
+}, z.core.$strip>;
+export type ConversationThread = z.infer<typeof conversationThread>;
+export declare const conversationThreadsPage: z.ZodObject<{
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    next_page: z.ZodNullable<z.ZodNumber>;
+    truncated: z.ZodBoolean;
+    items: z.ZodArray<z.ZodObject<{
+        thread_id: z.ZodString;
+        client_address: z.ZodString;
+        last_activity_at: z.ZodNumber;
+        message_count: z.ZodNumber;
+        last_delivery_status: z.ZodEnum<{
+            failed: "failed";
+            accepted: "accepted";
+            pending_delivery: "pending_delivery";
+            provisional: "provisional";
+            delivered: "delivered";
+            shed: "shed";
+            silent: "silent";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ConversationThreadsPage = z.infer<typeof conversationThreadsPage>;
+/**
+ * One exchange: the visitor's `inbound_text` — every record answers a message, so
+ * both projections always carry it — and the agent's `answer`, plus where that
+ * answer's delivery stands. The fields after `updated_at` are ADMIN ONLY —
+ * the same door serves a caller-scoped projection that withholds them — so they
+ * are optional here and absence means "not published to this reader".
+ */
+export declare const conversationMessage: z.ZodObject<{
+    message_id: z.ZodString;
+    route_name: z.ZodString;
+    door: z.ZodEnum<{
+        channel: "channel";
+        api: "api";
+    }>;
+    thread_id: z.ZodString;
+    client_address: z.ZodString;
+    caller_principal: z.ZodNullable<z.ZodString>;
+    inbound_text: z.ZodString;
+    answer_status: z.ZodNullable<z.ZodEnum<{
+        error: "error";
+        silent: "silent";
+        answered: "answered";
+    }>>;
+    answer: z.ZodNullable<z.ZodString>;
+    origin: z.ZodEnum<{
+        client: "client";
+        operator: "operator";
+    }>;
+    delivery_status: z.ZodEnum<{
+        failed: "failed";
+        accepted: "accepted";
+        pending_delivery: "pending_delivery";
+        provisional: "provisional";
+        delivered: "delivered";
+        shed: "shed";
+        silent: "silent";
+    }>;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    our_identity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    provider_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callback_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    outbound_message_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    attempts: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ConversationMessage = z.infer<typeof conversationMessage>;
+/**
+ * The direction a transcript page reads in. `asc` is the reading order (oldest
+ * first); `desc` is the live-tail order, where page 1 is always the newest page
+ * and paging forward walks BACKWARDS through the thread's history.
+ */
+export declare const transcriptOrder: z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+}>;
+export type TranscriptOrder = z.infer<typeof transcriptOrder>;
+/** A transcript page, echoing the order it was read in. */
+export declare const conversationTranscriptPage: z.ZodObject<{
+    order: z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    next_page: z.ZodNullable<z.ZodNumber>;
+    truncated: z.ZodBoolean;
+    items: z.ZodArray<z.ZodObject<{
+        message_id: z.ZodString;
+        route_name: z.ZodString;
+        door: z.ZodEnum<{
+            channel: "channel";
+            api: "api";
+        }>;
+        thread_id: z.ZodString;
+        client_address: z.ZodString;
+        caller_principal: z.ZodNullable<z.ZodString>;
+        inbound_text: z.ZodString;
+        answer_status: z.ZodNullable<z.ZodEnum<{
+            error: "error";
+            silent: "silent";
+            answered: "answered";
+        }>>;
+        answer: z.ZodNullable<z.ZodString>;
+        origin: z.ZodEnum<{
+            client: "client";
+            operator: "operator";
+        }>;
+        delivery_status: z.ZodEnum<{
+            failed: "failed";
+            accepted: "accepted";
+            pending_delivery: "pending_delivery";
+            provisional: "provisional";
+            delivered: "delivered";
+            shed: "shed";
+            silent: "silent";
+        }>;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+        channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        our_identity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        provider_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        callback_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        outbound_message_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ConversationTranscriptPage = z.infer<typeof conversationTranscriptPage>;
+/**
+ * A route-scoped message search (`GET /api/conversations/{route}/messages/search?q`):
+ * every record on the route whose text matches `q`, across threads, newest first.
+ * The record shape is the transcript's exactly, so a hit renders with the same
+ * projection. `truncated` says the match set outran the door's scan cap — surfaced
+ * loudly, never a silent cut.
+ */
+export declare const conversationMessageSearchPage: z.ZodObject<{
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    next_page: z.ZodNullable<z.ZodNumber>;
+    truncated: z.ZodBoolean;
+    items: z.ZodArray<z.ZodObject<{
+        message_id: z.ZodString;
+        route_name: z.ZodString;
+        door: z.ZodEnum<{
+            channel: "channel";
+            api: "api";
+        }>;
+        thread_id: z.ZodString;
+        client_address: z.ZodString;
+        caller_principal: z.ZodNullable<z.ZodString>;
+        inbound_text: z.ZodString;
+        answer_status: z.ZodNullable<z.ZodEnum<{
+            error: "error";
+            silent: "silent";
+            answered: "answered";
+        }>>;
+        answer: z.ZodNullable<z.ZodString>;
+        origin: z.ZodEnum<{
+            client: "client";
+            operator: "operator";
+        }>;
+        delivery_status: z.ZodEnum<{
+            failed: "failed";
+            accepted: "accepted";
+            pending_delivery: "pending_delivery";
+            provisional: "provisional";
+            delivered: "delivered";
+            shed: "shed";
+            silent: "silent";
+        }>;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+        channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        our_identity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        provider_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        callback_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        outbound_message_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ConversationMessageSearchPage = z.infer<typeof conversationMessageSearchPage>;
+/**
+ * Who answers a thread's incoming messages: `agent` lets the flow reply on its
+ * own; `manual` holds the flow back so a human answers. `source` says whether the
+ * setting is the thread's own (`thread`) or inherited from its route (`route`).
+ */
+export declare const conversationThreadMode: z.ZodEnum<{
+    agent: "agent";
+    manual: "manual";
+}>;
+export type ConversationThreadMode = z.infer<typeof conversationThreadMode>;
+export declare const conversationThreadModeState: z.ZodObject<{
+    mode: z.ZodEnum<{
+        agent: "agent";
+        manual: "manual";
+    }>;
+    source: z.ZodEnum<{
+        route: "route";
+        thread: "thread";
+    }>;
+}, z.core.$strip>;
+export type ConversationThreadModeState = z.infer<typeof conversationThreadModeState>;
+/** The receipt a thread-message write returns: the stored id and its thread. */
+export declare const conversationThreadMessageSent: z.ZodObject<{
+    message_id: z.ZodString;
+    thread_id: z.ZodString;
+}, z.core.$strip>;
+export type ConversationThreadMessageSent = z.infer<typeof conversationThreadMessageSent>;
+/** Every stored per-target config (`GET /api/conversation-configs`). */
+export declare const conversationConfigs: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        greeting_template: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        multichannel: z.ZodDefault<z.ZodBoolean>;
+        state_binding: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+            states: z.ZodArray<z.ZodObject<{
+                input_injections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    into: z.ZodString;
+                    jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                        content: z.ZodOptional<z.ZodString>;
+                        id: z.ZodOptional<z.ZodString>;
+                        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strict>, z.ZodNull]>>;
+                    template_jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                }, z.core.$strict>>>;
+                scope_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                    content: z.ZodOptional<z.ZodString>;
+                    id: z.ZodOptional<z.ZodString>;
+                    kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strict>, z.ZodNull]>>;
+                state: z.ZodString;
+                subject_expr: z.ZodObject<{
+                    content: z.ZodOptional<z.ZodString>;
+                    id: z.ZodOptional<z.ZodString>;
+                    kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strict>;
+                templates: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                updates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    adapter: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                        content: z.ZodOptional<z.ZodString>;
+                        id: z.ZodOptional<z.ZodString>;
+                        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strict>, z.ZodNull]>>;
+                    jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                        content: z.ZodOptional<z.ZodString>;
+                        id: z.ZodOptional<z.ZodString>;
+                        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strict>, z.ZodNull]>>;
+                    op_id: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                        content: z.ZodOptional<z.ZodString>;
+                        id: z.ZodOptional<z.ZodString>;
+                        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strict>, z.ZodNull]>>;
+                    template_jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodNull]>>;
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type ConversationConfigs = z.infer<typeof conversationConfigs>;
+/**
+ * The upsert reply: whether THIS call created the config (vs. replaced an existing
+ * one), its key, and the stored row.
+ */
+export declare const conversationConfigWritten: z.ZodObject<{
+    created: z.ZodBoolean;
+    target_kind: z.ZodEnum<{
+        tool: "tool";
+        agent: "agent";
+    }>;
+    target_name: z.ZodString;
+    config: z.ZodObject<{
+        greeting_template: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        multichannel: z.ZodDefault<z.ZodBoolean>;
+        state_binding: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+            states: z.ZodArray<z.ZodObject<{
+                input_injections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    into: z.ZodString;
+                    jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                        content: z.ZodOptional<z.ZodString>;
+                        id: z.ZodOptional<z.ZodString>;
+                        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strict>, z.ZodNull]>>;
+                    template_jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                }, z.core.$strict>>>;
+                scope_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                    content: z.ZodOptional<z.ZodString>;
+                    id: z.ZodOptional<z.ZodString>;
+                    kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strict>, z.ZodNull]>>;
+                state: z.ZodString;
+                subject_expr: z.ZodObject<{
+                    content: z.ZodOptional<z.ZodString>;
+                    id: z.ZodOptional<z.ZodString>;
+                    kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strict>;
+                templates: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                updates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    adapter: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                        content: z.ZodOptional<z.ZodString>;
+                        id: z.ZodOptional<z.ZodString>;
+                        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strict>, z.ZodNull]>>;
+                    jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                        content: z.ZodOptional<z.ZodString>;
+                        id: z.ZodOptional<z.ZodString>;
+                        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strict>, z.ZodNull]>>;
+                    op_id: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+                        content: z.ZodOptional<z.ZodString>;
+                        id: z.ZodOptional<z.ZodString>;
+                        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strict>, z.ZodNull]>>;
+                    template_jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodNull]>>;
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ConversationConfigWritten = z.infer<typeof conversationConfigWritten>;
+/** The config-delete reply: `removed` is always `true` on success (an unknown key is a 404). */
+export declare const conversationConfigDeleted: z.ZodObject<{
+    removed: z.ZodBoolean;
+    target_kind: z.ZodEnum<{
+        tool: "tool";
+        agent: "agent";
+    }>;
+    target_name: z.ZodString;
+}, z.core.$strip>;
+export type ConversationConfigDeleted = z.infer<typeof conversationConfigDeleted>;
+/**
+ * The admin-only failed-delivery listing (`GET /api/conversations/messages/failed`):
+ * every answer record whose delivery ended `failed`, across every route and caller.
+ * The records are the ADMIN projection (delivery bookkeeping and `error` included),
+ * so the row shape is {@link conversationMessage} exactly. It is NOT a paged window —
+ * the door returns `{items, total}` and nothing more.
+ */
+export declare const conversationFailedMessages: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        message_id: z.ZodString;
+        route_name: z.ZodString;
+        door: z.ZodEnum<{
+            channel: "channel";
+            api: "api";
+        }>;
+        thread_id: z.ZodString;
+        client_address: z.ZodString;
+        caller_principal: z.ZodNullable<z.ZodString>;
+        inbound_text: z.ZodString;
+        answer_status: z.ZodNullable<z.ZodEnum<{
+            error: "error";
+            silent: "silent";
+            answered: "answered";
+        }>>;
+        answer: z.ZodNullable<z.ZodString>;
+        origin: z.ZodEnum<{
+            client: "client";
+            operator: "operator";
+        }>;
+        delivery_status: z.ZodEnum<{
+            failed: "failed";
+            accepted: "accepted";
+            pending_delivery: "pending_delivery";
+            provisional: "provisional";
+            delivered: "delivered";
+            shed: "shed";
+            silent: "silent";
+        }>;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+        channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        our_identity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        provider_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        callback_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        outbound_message_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        attempts: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type ConversationFailedMessages = z.infer<typeof conversationFailedMessages>;
+/**
+ * The thread-delete reply (`DELETE /api/conversations/{route_name}/thread?thread_id=`).
+ * `removed` is a COUNT of the answer records this call deleted — `0` when a prior
+ * run already cleared them, when they had aged out under retention, or when the id
+ * was never stored (forgetting is absolute, never a 404 on a valid id).
+ */
+export declare const conversationThreadDeleted: z.ZodObject<{
+    removed: z.ZodNumber;
+    route_name: z.ZodString;
+    thread_id: z.ZodString;
+}, z.core.$strip>;
+export type ConversationThreadDeleted = z.infer<typeof conversationThreadDeleted>;
+/**
+ * The person-erase reply (`DELETE /api/conversations/persons/{person_id}`).
+ * `removed` counts the answer records deleted across the person's routes; `erased`
+ * says whether THIS call removed the person row (`false` on a retry or an
+ * already-gone person — never a 404).
+ */
+export declare const conversationPersonDeleted: z.ZodObject<{
+    person_id: z.ZodString;
+    removed: z.ZodNumber;
+    erased: z.ZodBoolean;
+}, z.core.$strip>;
+export type ConversationPersonDeleted = z.infer<typeof conversationPersonDeleted>;
+//# sourceMappingURL=conversations.d.ts.map

package/dist/schemas/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/schemas/conversations.ts"],"names":[],"mappings":"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"}