@tai42/api-client 16.0.0 → 17.0.0

package/dist/schemas/fleet.js

@@ -0,0 +1,132 @@
+/** Backend identity and worker-bus fleet/fan-out response schemas. */
+import { z } from 'zod';
+import { jsonValue } from './shared';
+/** `GET /api/backend` — the execution-backend identity, or the absent sentinel
+ * (`present: false`, a 200) when no backend plugin is registered. Backend identity
+ * is kept distinct from the fleet: the fleet doors ride the app's worker bus and
+ * need no backend at all. */
+export const backendInfo = z.object({
+    present: z.boolean(),
+    backend: z.string().nullable(),
+    module: z.string().nullable(),
+});
+/** The two worker kinds that join the bus: an ASGI `serve` worker or a
+ * `backend` runtime process. A drift throws `ApiSchemaError`. */
+export const workerKind = z.enum(['serve', 'backend']);
+/** The lifecycle state a worker advertises in its presence value: `ready` once its
+ * resync has converged, `resyncing` while a boot/reconnect resync runs, `recycling`
+ * once it has begun a graceful self-exit. A drift throws `ApiSchemaError`. */
+export const workerState = z.enum(['ready', 'resyncing', 'recycling']);
+/** The last op a worker applied, stamped onto its presence row after the terminal
+ * reply. `outcome` is the free op-outcome string; `at` is the ISO instant it landed. */
+export const workerLastOp = z.object({
+    op: z.string(),
+    outcome: z.string(),
+    at: z.string(),
+});
+/**
+ * One live worker on the bus — a presence-census row. `name` is the stable slot
+ * (`{kind}-{n}`) that doubles as a reload target; `generation` is the monotonic life
+ * counter minted with the worker's claim; `kind` tells the two worker kinds apart;
+ * `pid` is the process id. `joined_at`/`beat_at` are ISO instants (first-seen and last
+ * heartbeat) for the cosmetic seen-since display; `state` is the advertised lifecycle
+ * state; `stale` is SERVER-computed from the row's remaining presence TTL against the
+ * bus cadence (a quiet row past the freshness bound — reconnecting or dead) and is the
+ * only freshness signal a client reads, never a client-side threshold; `last_op` is the
+ * worker's last applied op, or `null` before it has applied one.
+ */
+export const fleetWorker = z.object({
+    name: z.string(),
+    kind: workerKind,
+    pid: z.number(),
+    generation: z.number(),
+    joined_at: z.string(),
+    beat_at: z.string(),
+    state: workerState,
+    stale: z.boolean(),
+    last_op: workerLastOp.nullable(),
+});
+/**
+ * `GET /api/fleet/workers` — the live worker fleet from the bus presence census.
+ * The census lists ALL subscribed workers (ASGI `serve` workers and backend-runtime
+ * processes alike), not only backend workers. A census read that fails surfaces as a
+ * loud 500, never a fabricated empty fleet.
+ */
+export const fleetWorkers = z.object({ workers: z.array(fleetWorker) });
+/**
+ * One worker's outcome within a fleet broadcast. `applied`/`failed` are terminal wire
+ * replies from a subscriber; `missing`/`departed`/`timed_out` are publisher-computed
+ * from the presence census (a silent worker never sends them); `resyncing`/`recycling`/
+ * `stale` are the gap outcomes for a row that failed the ready+fresh gate — reported as
+ * its own actual condition rather than dropped (`resyncing` converges on its resync,
+ * `recycling` is departing, `stale` is a quiet row past the freshness bound carrying no
+ * convergence promise).
+ */
+export const fleetOutcome = z.enum([
+    'applied',
+    'failed',
+    'missing',
+    'departed',
+    'timed_out',
+    'resyncing',
+    'recycling',
+    'stale',
+]);
+/**
+ * One worker's result within a {@link fleetResult}. `payload` carries query-op data
+ * (opaque to the UI); `error` carries a failed apply's message; `detail` carries the
+ * publisher's report text for a computed gap outcome (`missing`/`departed`/`timed_out`/
+ * `resyncing`/`recycling`/`stale`). A drift throws `ApiSchemaError`.
+ */
+export const fleetWorkerResult = z.object({
+    name: z.string(),
+    outcome: fleetOutcome,
+    payload: jsonValue,
+    error: z.string().nullable(),
+    detail: z.string().nullable(),
+});
+/**
+ * The awaited per-worker report of one fleet broadcast. Two honest shapes ride the
+ * same schema. Reachable (`reachable: true`): `results` holds one entry per expected
+ * worker (the serving worker's own entry included) plus the gap rows, so an unconfirmed
+ * sibling is a visible `failed`/`missing`/`departed`/`timed_out`/`resyncing`/`recycling`/
+ * `stale` entry, never a silent stale worker. Bus-unreachable (`reachable: false`): the
+ * transport failed before any worker could reply, so `results` is empty and only `error`
+ * is carried. This is the bare body of `POST /api/fleet/reload-config` and the single-MCP
+ * reload; it is also the body the mode-wrapped {@link fleetReportFanout} carries under its
+ * `fleet` / `unreachable` modes.
+ */
+export const fleetResult = z.object({
+    op: z.string(),
+    reachable: z.boolean(),
+    local_only: z.boolean(),
+    results: z.array(fleetWorkerResult),
+    error: z.string().nullable(),
+});
+/**
+ * `POST /api/fleet/reload-config` — soft-restart the fleet and report per-worker. The
+ * serving worker applies its own reload first, then broadcasts; the returned report
+ * names every worker's outcome. A failed local apply does not abort the broadcast, so
+ * the report is embedded even on the convergence-failure path.
+ */
+export const fleetReloadResult = fleetResult;
+/**
+ * The mode-wrapped fan-out summary a mutation embeds under its `fanout` field. Three
+ * honest modes, discriminated on `mode`:
+ *   - `local-only` — the broadcast reached no sibling (a lone worker / no bus), a
+ *     benign single-process note.
+ *   - `fleet` — a reachable multi-worker broadcast; carries the full {@link
+ *     fleetResult} so an unconfirmed sibling is visible.
+ *   - `unreachable` — the bus itself could not be reached; carries the
+ *     bus-unreachable {@link fleetResult} (no worker list, only `error`).
+ *
+ * Every mutation whose response embeds this parses it EXPLICITLY: zod's default
+ * unknown-key stripping would otherwise silently drop the field, hiding a failed
+ * propagation from the shared fleet-report handler. A drift throws `ApiSchemaError`.
+ */
+export const fleetReportFanout = z.discriminatedUnion('mode', [
+    z.object({ mode: z.literal('local-only'), note: z.string() }),
+    fleetResult.extend({ mode: z.literal('fleet') }),
+    fleetResult.extend({ mode: z.literal('unreachable') }),
+]);
+//# sourceMappingURL=fleet.js.map

package/dist/schemas/fleet.js.map

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

package/dist/schemas/hooks.d.ts

@@ -0,0 +1,120 @@
+/** Hook listing, registration and topic-verifier response schemas. */
+import { z } from 'zod';
+/** A fire door — who may trigger a path, not what the fire may do. A string enum. */
+export declare const triggerAuth: z.ZodEnum<{
+    token: "token";
+    public: "public";
+    verifier: "verifier";
+    "token+api_key": "token+api_key";
+    "out-of-service": "out-of-service";
+}>;
+export type TriggerAuth = z.infer<typeof triggerAuth>;
+export declare const hookList: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        condition: 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]>>;
+        execution_key: z.ZodString;
+        execution_key_fingerprint: z.ZodString;
+        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]>>;
+        name: z.ZodString;
+        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]>>;
+        subject: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+            key_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>;
+            kind: z.ZodString;
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+        }, z.core.$strict>, z.ZodNull]>>;
+        tool: z.ZodString;
+        tool_kwargs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        topic: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    topic_verifiers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        verifier: z.ZodString;
+        config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    trigger_auth: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        token: "token";
+        public: "public";
+        verifier: "verifier";
+        "token+api_key": "token+api_key";
+        "out-of-service": "out-of-service";
+    }>>>;
+}, z.core.$strip>;
+export type HookList = z.infer<typeof hookList>;
+export declare const hookRegistered: z.ZodObject<{
+    registered: z.ZodBoolean;
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const hookRemoved: z.ZodObject<{
+    removed: z.ZodBoolean;
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const hookVerifiers: z.ZodArray<z.ZodString>;
+/** `PUT /api/hooks/topics/{topic}/verifier` — the bound topic + verifier name. */
+export declare const topicVerifierSet: z.ZodObject<{
+    topic: z.ZodString;
+    verifier: z.ZodString;
+}, z.core.$strip>;
+/** `DELETE /api/hooks/topics/{topic}/verifier` — the unbound topic. */
+export declare const topicVerifierRemoved: z.ZodObject<{
+    removed: z.ZodBoolean;
+    topic: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/schemas/hooks.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,qFAAqF;AACrF,eAAO,MAAM,WAAW;;;;;;EAMtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAEH,eAAO,MAAM,WAAW;;;iBAGtB,CAAC;AAKH,eAAO,MAAM,aAAa,yBAAsB,CAAC;AAEjD,kFAAkF;AAClF,eAAO,MAAM,gBAAgB;;;iBAAwD,CAAC;AAEtF,uEAAuE;AACvE,eAAO,MAAM,oBAAoB;;;iBAAwD,CAAC"}

package/dist/schemas/hooks.js

@@ -0,0 +1,44 @@
+/** Hook listing, registration and topic-verifier response schemas. */
+import { z } from 'zod';
+import { hookParams } from './served';
+// The hand-written hook response DTOs: the fire-door authority enum, the list rows and
+// their wrapper, and the per-topic verifier/trigger metadata. The served hook DOCUMENT
+// schemas (`hookSubject`/`hookParams`/`hookRegister`) are generated from the contract
+// bundle and re-exported at the top of this file, not defined here.
+/** A fire door — who may trigger a path, not what the fire may do. A string enum. */
+export const triggerAuth = z.enum([
+    'public',
+    'verifier',
+    'token',
+    'token+api_key',
+    'out-of-service',
+]);
+export const hookList = z.object({
+    items: z.array(hookParams),
+    total: z.number(),
+    // Per-topic verifier bindings: the topic name maps to the verifier bound to it
+    // and that verifier's config (which carries a `secret_env` name, never a secret
+    // value). Tolerant of an older/empty response, which omits the key entirely.
+    topic_verifiers: z
+        .record(z.string(), z.object({ verifier: z.string(), config: z.record(z.string(), z.unknown()) }))
+        .default({}),
+    // Per-topic fire door (topic → door). Tolerant of an older response omitting it.
+    trigger_auth: z.record(z.string(), triggerAuth).default({}),
+});
+export const hookRegistered = z.object({
+    registered: z.boolean(),
+    name: z.string(),
+});
+export const hookRemoved = z.object({
+    removed: z.boolean(),
+    name: z.string(),
+});
+// The registered webhook-verifier catalog (`GET /api/hooks/verifiers`) — the
+// sorted verifier NAMES only, never any verifier's config. An empty registry is a
+// valid empty array. This is the ONLY source the topic-verifier bind picker reads.
+export const hookVerifiers = z.array(z.string());
+/** `PUT /api/hooks/topics/{topic}/verifier` — the bound topic + verifier name. */
+export const topicVerifierSet = z.object({ topic: z.string(), verifier: z.string() });
+/** `DELETE /api/hooks/topics/{topic}/verifier` — the unbound topic. */
+export const topicVerifierRemoved = z.object({ removed: z.boolean(), topic: z.string() });
+//# sourceMappingURL=hooks.js.map

package/dist/schemas/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/schemas/hooks.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,uFAAuF;AACvF,uFAAuF;AACvF,sFAAsF;AACtF,oEAAoE;AAEpE,qFAAqF;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC;IAChC,QAAQ;IACR,UAAU;IACV,OAAO;IACP,eAAe;IACf,gBAAgB;CACjB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,+EAA+E;IAC/E,gFAAgF;IAChF,6EAA6E;IAC7E,eAAe,EAAE,CAAC;SACf,MAAM,CACL,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAC9E;SACA,OAAO,CAAC,EAAE,CAAC;IACd,iFAAiF;IACjF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,6EAA6E;AAC7E,kFAAkF;AAClF,mFAAmF;AACnF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAEjD,kFAAkF;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEtF,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,40 @@
+/** Public barrel for the api-client response/DTO schemas. */
+export { toolRunList, toolRunRecord, toolRunSubmitResult } from '../tool-runs';
+export * from './api-keys';
+export * from './auth-routes';
+export * from './backup';
+export * from './capabilities';
+export * from './channels';
+export * from './config';
+export * from './connectors';
+export * from './conversations';
+export * from './extensions';
+export * from './fleet';
+export * from './hooks';
+export * from './interactions';
+export * from './login';
+export * from './manifest-mcp';
+export * from './marketplace';
+export * from './notifications';
+export * from './observability';
+export * from './policy';
+export * from './presets';
+export * from './principals';
+export * from './profiles';
+export * from './roles';
+export * from './schedules';
+export * from './served';
+export * from './settings-schema';
+export * from './setup';
+export { jsonSchema, jsonValue } from './shared';
+export * from './states';
+export * from './storage';
+export * from './studio-plugins';
+export * from './sub-mcp';
+export * from './system-kinds';
+export * from './templates';
+export * from './tool-meta';
+export * from './tools';
+export * from './trigger-links';
+export * from './web-entry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC/E,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACjD,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,40 @@
+/** Public barrel for the api-client response/DTO schemas. */
+export { toolRunList, toolRunRecord, toolRunSubmitResult } from '../tool-runs';
+export * from './api-keys';
+export * from './auth-routes';
+export * from './backup';
+export * from './capabilities';
+export * from './channels';
+export * from './config';
+export * from './connectors';
+export * from './conversations';
+export * from './extensions';
+export * from './fleet';
+export * from './hooks';
+export * from './interactions';
+export * from './login';
+export * from './manifest-mcp';
+export * from './marketplace';
+export * from './notifications';
+export * from './observability';
+export * from './policy';
+export * from './presets';
+export * from './principals';
+export * from './profiles';
+export * from './roles';
+export * from './schedules';
+export * from './served';
+export * from './settings-schema';
+export * from './setup';
+export { jsonSchema, jsonValue } from './shared';
+export * from './states';
+export * from './storage';
+export * from './studio-plugins';
+export * from './sub-mcp';
+export * from './system-kinds';
+export * from './templates';
+export * from './tool-meta';
+export * from './tools';
+export * from './trigger-links';
+export * from './web-entry';
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC/E,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACjD,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/schemas/interactions.d.ts

@@ -0,0 +1,156 @@
+/** Interaction question, answer and media response schemas. */
+import { z } from 'zod';
+export declare const answerFormat: z.ZodEnum<{
+    text: "text";
+    external: "external";
+    confirm: "confirm";
+    select: "select";
+    form: "form";
+}>;
+export type AnswerFormat = z.infer<typeof answerFormat>;
+/** The kind of a question's display-only media item: a remote/inline image, or a link. */
+export declare const mediaKind: z.ZodEnum<{
+    image: "image";
+    link: "link";
+}>;
+export type MediaKind = z.infer<typeof mediaKind>;
+/**
+ * One item of a question's display-only media. Applied PER ITEM by the renderer
+ * (never as a strict array on the frame): the frame's `media` field is a loose
+ * `z.array(z.unknown())`, and the renderer `safeParse`s each item with this schema
+ * so one malformed/hostile item is a loud per-item notice, not a whole-frame parse
+ * failure that would silently vanish an answerable question.
+ *
+ * `caption` is `.nullish()` (absent OR `null` both parse to a caption-less item):
+ * a caption-less item may arrive with the key omitted OR with an explicit `null`, so
+ * `.optional()` here would false-fail the explicit `null` and render a good image as
+ * malformed. `url` and `kind` are the only load-bearing fields; the image
+ * src scheme gate and the link neutralization are enforced by the renderer.
+ */
+export declare const interactionMediaItem: z.ZodObject<{
+    kind: z.ZodEnum<{
+        image: "image";
+        link: "link";
+    }>;
+    url: z.ZodString;
+    caption: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type InteractionMediaItem = z.infer<typeof interactionMediaItem>;
+/**
+ * One per-send choice for a `form` property whose schema is a string (or array of
+ * strings). `value` is what the answer carries; `label` (absent OR null both parse
+ * to no label) is the human text shown in its place. A send may replace a property's
+ * `enum` this way for one ask without republishing the form. Applied per property by
+ * the form preview (safeParsed), so a malformed entry is a loud notice, never silent.
+ */
+export declare const formOption: z.ZodObject<{
+    value: z.ZodString;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type FormOption = z.infer<typeof formOption>;
+/**
+ * Per-send `form` data: `values` prefills top-level properties (keyed by property
+ * name), `options` supplies per-send choice lists (keyed by property name). Both
+ * default to empty. The form preview safeParses this off `format_payload.data`, so a
+ * malformed block is a loud notice rather than a whole-frame parse failure.
+ */
+export declare const formData: z.ZodObject<{
+    values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+export type FormData = z.infer<typeof formData>;
+/**
+ * One page of a stepped `form`: a `title` and the ordered top-level property names it
+ * groups. `format_payload.pages` is the ordered list of these; absent = one page. The
+ * form preview safeParses the list, so a malformed page is a loud notice, never silent.
+ */
+export declare const formPage: z.ZodObject<{
+    title: z.ZodString;
+    fields: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type FormPage = z.infer<typeof formPage>;
+/** The `form` pages list (`format_payload.pages`), safeParsed as a whole by the preview. */
+export declare const formPages: z.ZodArray<z.ZodObject<{
+    title: z.ZodString;
+    fields: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>;
+export type FormPages = z.infer<typeof formPages>;
+export declare const interaction: z.ZodObject<{
+    interaction_id: z.ZodString;
+    group_id: z.ZodString;
+    question: z.ZodDefault<z.ZodString>;
+    answer_format: z.ZodEnum<{
+        text: "text";
+        external: "external";
+        confirm: "confirm";
+        select: "select";
+        form: "form";
+    }>;
+    format_payload: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, z.ZodTransform<Record<string, unknown>, Record<string, unknown> | null | undefined>>;
+    created_at: z.ZodString;
+    timeout_at: z.ZodString;
+    sensitive: z.ZodDefault<z.ZodBoolean>;
+    server_verified: z.ZodOptional<z.ZodBoolean>;
+    channel: z.ZodOptional<z.ZodString>;
+    recipient: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodString>;
+    audience: z.ZodOptional<z.ZodString>;
+    media: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export type Interaction = z.infer<typeof interaction>;
+/** The answer door's response — the blocked caller was woken. */
+export declare const interactionAnswered: z.ZodObject<{
+    interaction_id: z.ZodString;
+    status: z.ZodString;
+}, z.core.$strip>;
+export type InteractionAnswered = z.infer<typeof interactionAnswered>;
+/**
+ * The cancel door's response — a pending ask was WITHDRAWN without an answer (the
+ * asking flow does not resume). `status` is `"cancelled"`; the shape mirrors the
+ * answer door's terminal reply, but the door is distinct so it carries its own
+ * schema.
+ */
+export declare const interactionCancelled: z.ZodObject<{
+    interaction_id: z.ZodString;
+    status: z.ZodString;
+}, z.core.$strip>;
+export type InteractionCancelled = z.infer<typeof interactionCancelled>;
+/**
+ * A page of pending interactions from `GET /api/interactions?page=&pageSize=`. Each
+ * item is the same record the stream's `interaction.add` frame carries. The pending
+ * set is the paged base the tail-only stream applies live deltas over.
+ */
+export declare const interactionsPage: 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<{
+        interaction_id: z.ZodString;
+        group_id: z.ZodString;
+        question: z.ZodDefault<z.ZodString>;
+        answer_format: z.ZodEnum<{
+            text: "text";
+            external: "external";
+            confirm: "confirm";
+            select: "select";
+            form: "form";
+        }>;
+        format_payload: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, z.ZodTransform<Record<string, unknown>, Record<string, unknown> | null | undefined>>;
+        created_at: z.ZodString;
+        timeout_at: z.ZodString;
+        sensitive: z.ZodDefault<z.ZodBoolean>;
+        server_verified: z.ZodOptional<z.ZodBoolean>;
+        channel: z.ZodOptional<z.ZodString>;
+        recipient: z.ZodOptional<z.ZodString>;
+        origin: z.ZodOptional<z.ZodString>;
+        audience: z.ZodOptional<z.ZodString>;
+        media: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type InteractionsPage = z.infer<typeof interactionsPage>;
+//# sourceMappingURL=interactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../src/schemas/interactions.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,YAAY;;;;;;EAA4D,CAAC;AACtF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,0FAA0F;AAC1F,eAAO,MAAM,SAAS;;;EAA4B,CAAC;AACnD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB;;;;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;iBAGrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;iBAGnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;iBAGnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,4FAA4F;AAC5F,eAAO,MAAM,SAAS;;;kBAAoB,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;iBAsCtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,iEAAiE;AACjE,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}