@tai42/api-client 16.0.0 → 16.0.1

package/dist/client/conversations-client.d.ts

@@ -0,0 +1,399 @@
+/** Conversation route, thread, transcript, config and admin sub-client. */
+import * as s from '../schemas';
+import type { Transport } from './transport';
+/**
+ * The thread-list filter set (GET `/api/conversations/{route}/threads` query
+ * params, alongside `page`/`pageSize`). `status` narrows to threads whose newest
+ * record sits in one delivery state; `address` is a SUBSTRING match over the
+ * client address. Both omitted when undefined — an unfiltered listing.
+ */
+export interface ConversationThreadFilters {
+    readonly status?: s.ConversationDeliveryStatus;
+    readonly address?: string;
+}
+/**
+ * One transcript read (GET `/api/conversations/{route}/transcript` query params).
+ * `order` is not a default the caller may skip: `asc` reads the thread from its
+ * beginning and `desc` from its newest end, and which one a screen wants is a
+ * decision that screen must make. `q` narrows the page to records whose text
+ * matches it (a SUBSTRING), omitted for an unfiltered read.
+ */
+export interface ConversationTranscriptQuery {
+    readonly routeName: string;
+    readonly threadId: string;
+    readonly page: number;
+    readonly pageSize: number;
+    readonly order: s.TranscriptOrder;
+    readonly q?: string;
+}
+/**
+ * A route-scoped message search (GET
+ * `/api/conversations/{route}/messages/search` query params). `q` is the required
+ * needle — a substring over record text, across every thread on the route; `page`
+ * is supplied per-request by the infinite query.
+ */
+export interface ConversationMessageSearchQuery {
+    readonly routeName: string;
+    readonly q: string;
+    readonly page: number;
+    readonly pageSize: number;
+}
+/**
+ * Body for sending a message into a thread (POST
+ * `/api/conversations/{route}/thread/messages`). `thread_id` names the thread
+ * (an api-door address, passed as a value); `text` is the message. `address` is
+ * an optional override the server otherwise derives from the thread, omitted
+ * when undefined.
+ */
+export interface ConversationThreadMessageBody {
+    readonly thread_id: string;
+    readonly text: string;
+    readonly address?: string;
+}
+export declare function conversationsClient(t: Transport): {
+    listConversationRoutes: (signal?: AbortSignal) => Promise<{
+        items: {
+            callback_secret: string | null;
+            callback_url: string | null;
+            channel: string | null;
+            door: "channel" | "api";
+            error_reply_text: string | null;
+            execution_key: string;
+            execution_key_fingerprint: string;
+            initial_mode: "agent" | "manual";
+            locale: string | null;
+            our_identity: string | null;
+            payload_expr: {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
+            reply_expr: {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
+            route_name: string;
+            target_kind: "tool" | "agent";
+            target_name: string;
+            turns_per_hour_override: number | null;
+        }[];
+        total: number;
+    }>;
+    createOrReplaceConversationRoute: (route: s.ConversationRouteCreate) => Promise<{
+        created: boolean;
+        route_name: string;
+        route: {
+            callback_secret: string | null;
+            callback_url: string | null;
+            channel: string | null;
+            door: "channel" | "api";
+            error_reply_text: string | null;
+            execution_key: string;
+            execution_key_fingerprint: string;
+            initial_mode: "agent" | "manual";
+            locale: string | null;
+            our_identity: string | null;
+            payload_expr: {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
+            reply_expr: {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
+            route_name: string;
+            target_kind: "tool" | "agent";
+            target_name: string;
+            turns_per_hour_override: number | null;
+        };
+        callback_secret: string | null;
+    }>;
+    deleteConversationRoute: (routeName: string) => Promise<{
+        removed: boolean;
+        route_name: string;
+    }>;
+    listConversationThreads: (routeName: string, page: number, pageSize: number, filters?: ConversationThreadFilters, signal?: AbortSignal) => Promise<{
+        total: number;
+        page: number;
+        page_size: number;
+        next_page: number | null;
+        truncated: boolean;
+        items: {
+            thread_id: string;
+            client_address: string;
+            last_activity_at: number;
+            message_count: number;
+            last_delivery_status: "failed" | "accepted" | "pending_delivery" | "provisional" | "delivered" | "shed" | "silent";
+        }[];
+    }>;
+    readConversationTranscript: (query: ConversationTranscriptQuery, signal?: AbortSignal) => Promise<{
+        order: "asc" | "desc";
+        total: number;
+        page: number;
+        page_size: number;
+        next_page: number | null;
+        truncated: boolean;
+        items: {
+            message_id: string;
+            route_name: string;
+            door: "channel" | "api";
+            thread_id: string;
+            client_address: string;
+            caller_principal: string | null;
+            inbound_text: string;
+            answer_status: "error" | "silent" | "answered" | null;
+            answer: string | null;
+            origin: "client" | "operator";
+            delivery_status: "failed" | "accepted" | "pending_delivery" | "provisional" | "delivered" | "shed" | "silent";
+            created_at: number;
+            updated_at: number;
+            channel?: string | null | undefined;
+            our_identity?: string | null | undefined;
+            provider_message_id?: string | null | undefined;
+            callback_url?: string | null | undefined;
+            error?: string | null | undefined;
+            outbound_message_ids?: string[] | undefined;
+            attempts?: number | undefined;
+        }[];
+    }>;
+    searchConversationMessages: (query: ConversationMessageSearchQuery, signal?: AbortSignal) => Promise<{
+        total: number;
+        page: number;
+        page_size: number;
+        next_page: number | null;
+        truncated: boolean;
+        items: {
+            message_id: string;
+            route_name: string;
+            door: "channel" | "api";
+            thread_id: string;
+            client_address: string;
+            caller_principal: string | null;
+            inbound_text: string;
+            answer_status: "error" | "silent" | "answered" | null;
+            answer: string | null;
+            origin: "client" | "operator";
+            delivery_status: "failed" | "accepted" | "pending_delivery" | "provisional" | "delivered" | "shed" | "silent";
+            created_at: number;
+            updated_at: number;
+            channel?: string | null | undefined;
+            our_identity?: string | null | undefined;
+            provider_message_id?: string | null | undefined;
+            callback_url?: string | null | undefined;
+            error?: string | null | undefined;
+            outbound_message_ids?: string[] | undefined;
+            attempts?: number | undefined;
+        }[];
+    }>;
+    sendConversationThreadMessage: (routeName: string, body: ConversationThreadMessageBody) => Promise<{
+        message_id: string;
+        thread_id: string;
+    }>;
+    getConversationThreadMode: (routeName: string, threadId: string, signal?: AbortSignal) => Promise<{
+        mode: "agent" | "manual";
+        source: "route" | "thread";
+    }>;
+    setConversationThreadMode: (routeName: string, threadId: string, mode: s.ConversationThreadMode) => Promise<{
+        mode: "agent" | "manual";
+        source: "route" | "thread";
+    }>;
+    listConversationConfigs: (signal?: AbortSignal) => Promise<{
+        items: {
+            greeting_template: string | null;
+            multichannel: boolean;
+            state_binding: {
+                states: {
+                    input_injections: {
+                        into: string;
+                        jq: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        template_jq: string | null;
+                    }[];
+                    scope_expr: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    } | null;
+                    state: string;
+                    subject_expr: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    };
+                    templates: string[];
+                    updates: {
+                        adapter: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        jq: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        op_id: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        template_jq: string | null;
+                    }[];
+                }[];
+            } | null;
+            target_kind: "tool" | "agent";
+            target_name: string;
+        }[];
+        total: number;
+    }>;
+    getConversationConfig: (targetKind: s.ConversationTargetKind, targetName: string, signal?: AbortSignal) => Promise<{
+        greeting_template: string | null;
+        multichannel: boolean;
+        state_binding: {
+            states: {
+                input_injections: {
+                    into: string;
+                    jq: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    } | null;
+                    template_jq: string | null;
+                }[];
+                scope_expr: {
+                    content?: string | undefined;
+                    id?: string | undefined;
+                    kwargs?: Record<string, unknown> | undefined;
+                } | null;
+                state: string;
+                subject_expr: {
+                    content?: string | undefined;
+                    id?: string | undefined;
+                    kwargs?: Record<string, unknown> | undefined;
+                };
+                templates: string[];
+                updates: {
+                    adapter: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    } | null;
+                    jq: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    } | null;
+                    op_id: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    } | null;
+                    template_jq: string | null;
+                }[];
+            }[];
+        } | null;
+        target_kind: "tool" | "agent";
+        target_name: string;
+    }>;
+    setConversationConfig: (config: s.TargetConversationConfig) => Promise<{
+        created: boolean;
+        target_kind: "tool" | "agent";
+        target_name: string;
+        config: {
+            greeting_template: string | null;
+            multichannel: boolean;
+            state_binding: {
+                states: {
+                    input_injections: {
+                        into: string;
+                        jq: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        template_jq: string | null;
+                    }[];
+                    scope_expr: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    } | null;
+                    state: string;
+                    subject_expr: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    };
+                    templates: string[];
+                    updates: {
+                        adapter: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        jq: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        op_id: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        template_jq: string | null;
+                    }[];
+                }[];
+            } | null;
+            target_kind: "tool" | "agent";
+            target_name: string;
+        };
+    }>;
+    deleteConversationConfig: (targetKind: s.ConversationTargetKind, targetName: string) => Promise<{
+        removed: boolean;
+        target_kind: "tool" | "agent";
+        target_name: string;
+    }>;
+    listFailedConversationMessages: (signal?: AbortSignal) => Promise<{
+        items: {
+            message_id: string;
+            route_name: string;
+            door: "channel" | "api";
+            thread_id: string;
+            client_address: string;
+            caller_principal: string | null;
+            inbound_text: string;
+            answer_status: "error" | "silent" | "answered" | null;
+            answer: string | null;
+            origin: "client" | "operator";
+            delivery_status: "failed" | "accepted" | "pending_delivery" | "provisional" | "delivered" | "shed" | "silent";
+            created_at: number;
+            updated_at: number;
+            channel?: string | null | undefined;
+            our_identity?: string | null | undefined;
+            provider_message_id?: string | null | undefined;
+            callback_url?: string | null | undefined;
+            error?: string | null | undefined;
+            outbound_message_ids?: string[] | undefined;
+            attempts?: number | undefined;
+        }[];
+        total: number;
+    }>;
+    deleteConversationThread: (routeName: string, threadId: string) => Promise<{
+        removed: number;
+        route_name: string;
+        thread_id: string;
+    }>;
+    deleteConversationPerson: (personId: string) => Promise<{
+        person_id: string;
+        removed: number;
+        erased: boolean;
+    }>;
+};
+//# sourceMappingURL=conversations-client.d.ts.map

package/dist/client/conversations-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations-client.d.ts","sourceRoot":"","sources":["../../src/client/conversations-client.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAEhC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,eAAe,CAAC;IAClC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AA6KD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS;sCArKV,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAMH,CAAC,CAAC,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCAO9B,MAAM;;;;yCAc9B,MAAM,QACX,MAAM,YACF,MAAM,YACP,yBAAyB,WACzB,WAAW;;;;;;;;;;;;;;wCAYc,2BAA2B,WAAW,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAkBjD,8BAA8B,WAAW,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CAQ7C,MAAM,QAAQ,6BAA6B;;;;2CAQ/C,MAAM,YAAY,MAAM,WAAW,WAAW;;;;2CAQxE,MAAM,YACP,MAAM,QACV,CAAC,CAAC,sBAAsB;;;;uCAgBG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAIhC,CAAC,CAAC,sBAAsB,cACxB,MAAM,WACT,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAUU,CAAC,CAAC,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAOnB,CAAC,CAAC,sBAAsB,cAAc,MAAM;;;;;8CAezC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;0CAOf,MAAM,YAAY,MAAM;;;;;yCAUzB,MAAM;;;;;EAiB9C"}

package/dist/client/conversations-client.js

@@ -0,0 +1,120 @@
+/** Conversation route, thread, transcript, config and admin sub-client. */
+import * as s from '../schemas';
+import { encodeSegment } from '../http';
+/** Route CRUD: the stored routing rows and their create/replace/delete doors. */
+function conversationRouteMethods(t) {
+    const { req } = t;
+    return {
+        // The stored routing rows, each with its `callback_secret` withheld — the
+        // conversation monitor's route picker.
+        listConversationRoutes: (signal) => req('/api/conversations', s.conversationRoutes, { signal }),
+        // Create or REPLACE a route (an UPSERT: the same door is the create and the
+        // edit path). `route_name` rides the URL path AND the body; the door rejects a
+        // disagreeing pair, so both come from the one create object. The reply carries
+        // the freshly-minted `callback_secret` for an `api`-door row, returned ONCE.
+        createOrReplaceConversationRoute: (route) => req(`/api/conversations/${encodeSegment(route.route_name)}`, s.conversationRouteWritten, {
+            method: 'POST',
+            body: route,
+        }),
+        // Delete a route by name (destructive + authority-changing server-side): it
+        // drops the routing row and reclaims the thread indexes it owned.
+        deleteConversationRoute: (routeName) => req(`/api/conversations/${encodeSegment(routeName)}`, s.conversationRouteDeleted, {
+            method: 'DELETE',
+        }),
+    };
+}
+/** Thread reads and writes: listings, transcript, message search, send, reply mode. */
+function conversationThreadMethods(t) {
+    const { req } = t;
+    return {
+        // One route's threads, newest activity first. Admin-only server-side: a
+        // listing spans every caller on the route, so a scoped session gets a 403.
+        listConversationThreads: (routeName, page, pageSize, filters = {}, signal) => req(`/api/conversations/${encodeSegment(routeName)}/threads`, s.conversationThreadsPage, {
+            signal,
+            query: { page, pageSize, status: filters.status, address: filters.address },
+        }),
+        // One thread's transcript, caller-scoped, read in the asked-for direction.
+        // The `thread_id` rides the QUERY STRING, never the path: it embeds the api
+        // door's `{principal}/{end user}` address with the principal already
+        // percent-encoded, which a path segment would have to encode a second time
+        // and the server would then decode once too few. A query value is decoded
+        // exactly once whatever it holds, so it is passed through verbatim.
+        readConversationTranscript: (query, signal) => req(`/api/conversations/${encodeSegment(query.routeName)}/transcript`, s.conversationTranscriptPage, {
+            signal,
+            query: {
+                thread_id: query.threadId,
+                page: query.page,
+                pageSize: query.pageSize,
+                order: query.order,
+                q: query.q,
+            },
+        }),
+        // Search every record on a route by text, across threads, newest first. The
+        // needle rides the QUERY (`q`); paging is the infinite query's own window. The
+        // page's `truncated` flag says the match set outran the door's scan cap.
+        searchConversationMessages: (query, signal) => req(`/api/conversations/${encodeSegment(query.routeName)}/messages/search`, s.conversationMessageSearchPage, { signal, query: { q: query.q, page: query.page, pageSize: query.pageSize } }),
+        // Send a human message into a thread. The `thread_id` rides the BODY (a POST,
+        // never a path segment) — same encode-once reasoning as the transcript read.
+        sendConversationThreadMessage: (routeName, body) => req(`/api/conversations/${encodeSegment(routeName)}/thread/messages`, s.conversationThreadMessageSent, { method: 'POST', body }),
+        // Read a thread's reply mode (`agent`/`manual`) and where it comes from. The
+        // `thread_id` rides the QUERY value, encoded once, as the transcript read does.
+        getConversationThreadMode: (routeName, threadId, signal) => req(`/api/conversations/${encodeSegment(routeName)}/thread/mode`, s.conversationThreadModeState, { signal, query: { thread_id: threadId } }),
+        // Flip a thread's reply mode. The `thread_id` rides the BODY (a PUT).
+        setConversationThreadMode: (routeName, threadId, mode) => req(`/api/conversations/${encodeSegment(routeName)}/thread/mode`, s.conversationThreadModeState, { method: 'PUT', body: { thread_id: threadId, mode } }),
+    };
+}
+/** Per-target presentation configs, keyed by `(target_kind, target_name)`. Admin surface. */
+function conversationConfigMethods(t) {
+    const { req } = t;
+    return {
+        // The stored per-target presentation configs (each `(target_kind, target_name)`
+        // pair's multichannel flag + first-contact greeting). Admin config surface.
+        listConversationConfigs: (signal) => req('/api/conversation-configs', s.conversationConfigs, { signal }),
+        // One config by its `(target_kind, target_name)` key. 404 when unknown.
+        getConversationConfig: (targetKind, targetName, signal) => req(`/api/conversation-configs/${encodeSegment(targetKind)}/${encodeSegment(targetName)}`, s.targetConversationConfig, { signal }),
+        // Create or REPLACE a config (an UPSERT: the same door is the create and the
+        // edit path). The `(target_kind, target_name)` key rides the URL path; the door
+        // rejects a body whose key disagrees, so both come from the one config object.
+        setConversationConfig: (config) => req(`/api/conversation-configs/${encodeSegment(config.target_kind)}/${encodeSegment(config.target_name)}`, s.conversationConfigWritten, { method: 'PUT', body: config }),
+        // Delete a config by its key. 404 when the key is unknown.
+        deleteConversationConfig: (targetKind, targetName) => req(`/api/conversation-configs/${encodeSegment(targetKind)}/${encodeSegment(targetName)}`, s.conversationConfigDeleted, { method: 'DELETE' }),
+    };
+}
+/** Admin/GDPR doors: failed-message audit and destructive thread/person erasure. */
+function conversationAdminMethods(t) {
+    const { req } = t;
+    return {
+        // Every answer record whose delivery ended `failed`, across every route and
+        // caller. Admin-only server-side; not a paged window (returns `{items, total}`).
+        listFailedConversationMessages: (signal) => req('/api/conversations/messages/failed', s.conversationFailedMessages, { signal }),
+        // Forget ONE thread on a route (destructive): its checkpoint, answer records and
+        // thread indexes. The `thread_id` rides the QUERY value, encoded once — it embeds
+        // the api door's percent-encoded `{principal}/{end user}` address, which a path
+        // segment would encode a second time. `removed` counts the records this call
+        // cleared; a valid id on its own route always succeeds, never a 404.
+        deleteConversationThread: (routeName, threadId) => req(`/api/conversations/${encodeSegment(routeName)}/thread`, s.conversationThreadDeleted, {
+            method: 'DELETE',
+            query: { thread_id: threadId },
+        }),
+        // Erase a LINKED person ENTIRELY (GDPR, wide blast radius): its aggregated thread
+        // and checkpoint, its person row, and every address→person index mapping, across
+        // EVERY route it wrote under. The `person_id` is a uuid4 with no percent-encoded
+        // principal, so it rides the PATH cleanly. `erased` says whether this call removed
+        // the person row (idempotent — a retry answers `false`, never a 404).
+        deleteConversationPerson: (personId) => req(`/api/conversations/persons/${encodeSegment(personId)}`, s.conversationPersonDeleted, {
+            method: 'DELETE',
+        }),
+    };
+}
+export function conversationsClient(t) {
+    // Declaration emit prepends each spread group's members, so the groups are
+    // spread in reverse of their public order to keep the surface route → thread
+    // → config → admin.
+    return {
+        ...conversationAdminMethods(t),
+        ...conversationConfigMethods(t),
+        ...conversationThreadMethods(t),
+        ...conversationRouteMethods(t),
+    };
+}
+//# sourceMappingURL=conversations-client.js.map

package/dist/client/conversations-client.js.map

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

package/dist/client/hooks-client.d.ts

@@ -0,0 +1,113 @@
+/** Hook listing, registration and topic-verifier sub-client. */
+import * as s from '../schemas';
+import type { Transport } from './transport';
+/**
+ * Body for binding a webhook verifier to a topic
+ * (PUT `/api/hooks/topics/{topic}/verifier`). `verifier` is a registered verifier
+ * NAME, resolved against the live registry at bind time (an unknown name is a loud
+ * 400). `config` is that verifier's config object — it carries a `secret_env` name,
+ * never a secret value — and defaults to `{}` when omitted.
+ */
+export interface TopicVerifierBody {
+    readonly verifier: string;
+    readonly config?: Record<string, unknown>;
+}
+export declare function hooksClient(t: Transport): {
+    listHooks: (topic?: string, signal?: AbortSignal) => Promise<{
+        items: {
+            condition: {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
+            execution_key: string;
+            execution_key_fingerprint: string;
+            expr: {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
+            name: string;
+            state_binding: {
+                states: {
+                    input_injections: {
+                        into: string;
+                        jq: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        template_jq: string | null;
+                    }[];
+                    scope_expr: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    } | null;
+                    state: string;
+                    subject_expr: {
+                        content?: string | undefined;
+                        id?: string | undefined;
+                        kwargs?: Record<string, unknown> | undefined;
+                    };
+                    templates: string[];
+                    updates: {
+                        adapter: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        jq: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        op_id: {
+                            content?: string | undefined;
+                            id?: string | undefined;
+                            kwargs?: Record<string, unknown> | undefined;
+                        } | null;
+                        template_jq: string | null;
+                    }[];
+                }[];
+            } | null;
+            subject: {
+                key_expr: {
+                    content?: string | undefined;
+                    id?: string | undefined;
+                    kwargs?: Record<string, unknown> | undefined;
+                };
+                kind: string;
+                target_kind: "tool" | "agent";
+                target_name: string;
+            } | null;
+            tool: string;
+            tool_kwargs: Record<string, unknown>;
+            topic: string;
+        }[];
+        total: number;
+        topic_verifiers: Record<string, {
+            verifier: string;
+            config: Record<string, unknown>;
+        }>;
+        trigger_auth: Record<string, "public" | "verifier" | "token" | "token+api_key" | "out-of-service">;
+    }>;
+    registerHook: (params: s.HookRegister) => Promise<{
+        registered: boolean;
+        name: string;
+    }>;
+    unregisterHook: (name: string) => Promise<{
+        removed: boolean;
+        name: string;
+    }>;
+    listHookVerifiers: (signal?: AbortSignal) => Promise<string[]>;
+    setTopicVerifier: (topic: string, body: TopicVerifierBody) => Promise<{
+        topic: string;
+        verifier: string;
+    }>;
+    deleteTopicVerifier: (topic: string) => Promise<{
+        removed: boolean;
+        topic: string;
+    }>;
+};
+//# sourceMappingURL=hooks-client.d.ts.map

package/dist/client/hooks-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-client.d.ts","sourceRoot":"","sources":["../../src/client/hooks-client.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAEhC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS;wBAGhB,MAAM,WAAW,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAEzB,CAAC,CAAC,YAAY;;;;2BAEd,MAAM;;;;iCAIA,WAAW;8BAId,MAAM,QAAQ,iBAAiB;;;;iCAM5B,MAAM;;;;EAKtC"}