@parlor/chat 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cychien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# @parlor/chat
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The server half of the agent sidebar: threads, prompts, agent replies and approvals, as a `createServer` plugin.
+
+```sh
+pnpm add @parlor/chat
+```
+
+```ts
+import { chat } from "@parlor/chat/server";
+import { createRegistry } from "@parlor/core/registry";
+import { createDatabase } from "@parlor/data";
+import { createServer } from "@parlor/server";
+
+const database = await createDatabase({ migrationsFolder: "migrations" });
+
+export default createServer({
+  actions: createRegistry({}),
+  database,
+  plugins: [chat()],
+});
+```
+
+New apps include it. Docs: https://cychien.github.io/parlor/guides/agent-sidebar/

package/dist/events.d.ts

@@ -0,0 +1,4 @@
+export declare const CHAT_EVENTS: readonly ["device_pending", "device_rejected", "agent_started", "agent_exited", "agent_switched", "host_lost", "turn_failed", "answer_rejected", "answered_on_computer"];
+export type ChatEvent = (typeof CHAT_EVENTS)[number];
+export type FoldedEvent = Extract<ChatEvent, "answered_on_computer">;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,YACtB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,sBAAsB,CACd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC"}

package/dist/events.js

@@ -0,0 +1,12 @@
+export const CHAT_EVENTS = [
+    "device_pending",
+    "device_rejected",
+    "agent_started",
+    "agent_exited",
+    "agent_switched",
+    "host_lost",
+    "turn_failed",
+    "answer_rejected",
+    "answered_on_computer",
+];
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,sBAAsB;CACd,CAAC","sourcesContent":["export const CHAT_EVENTS = [\n  \"device_pending\",\n  \"device_rejected\",\n  \"agent_started\",\n  \"agent_exited\",\n  \"agent_switched\",\n  \"host_lost\",\n  \"turn_failed\",\n  \"answer_rejected\",\n  \"answered_on_computer\",\n] as const;\n\nexport type ChatEvent = (typeof CHAT_EVENTS)[number];\n\nexport type FoldedEvent = Extract<ChatEvent, \"answered_on_computer\">;\n"]}

package/dist/id-schemas.d.ts

@@ -0,0 +1,5 @@
+import { type Id, type IdKind } from "@parlor/core";
+import { z } from "zod";
+/** A request field naming an entity: validated, then branded, at the boundary. */
+export declare function idSchema<K extends IdKind>(kind: K): z.ZodPipe<z.ZodString, z.ZodTransform<Id<K>, string>>;
+//# sourceMappingURL=id-schemas.d.ts.map

package/dist/id-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-schemas.d.ts","sourceRoot":"","sources":["../src/id-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvC,IAAI,EAAE,CAAC,GACN,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAMvD"}

package/dist/id-schemas.js

@@ -0,0 +1,11 @@
+import { asId } from "@parlor/core";
+import { z } from "zod";
+/** A request field naming an entity: validated, then branded, at the boundary. */
+export function idSchema(kind) {
+    return z
+        .string()
+        .min(1)
+        .max(64)
+        .transform((value) => asId(kind, value));
+}
+//# sourceMappingURL=id-schemas.js.map

package/dist/id-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-schemas.js","sourceRoot":"","sources":["../src/id-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAwB,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CACtB,IAAO;IAEP,OAAO,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { asId, type Id, type IdKind } from \"@parlor/core\";\nimport { z } from \"zod\";\n\n/** A request field naming an entity: validated, then branded, at the boundary. */\nexport function idSchema<K extends IdKind>(\n  kind: K,\n): z.ZodPipe<z.ZodString, z.ZodTransform<Id<K>, string>> {\n  return z\n    .string()\n    .min(1)\n    .max(64)\n    .transform((value) => asId(kind, value));\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { CHAT_EVENTS, type ChatEvent } from "./events.js";
+export type { Author, AuthorOf, ChatItemBody, ChatItemKind, HostItemDraft, HostItemKind, ItemSignature, LoggedItem, UserItemKind, } from "./items.js";
+export { type AppliedFrame, applyFrame } from "./open-turns.js";
+export { isPromptTooLong, MAX_PROMPT_CHARS, PROMPT_LIMIT_MESSAGE } from "./limits.js";
+export type { AgentInfo, AgentRef, AnswerToSign, ChatOwner, ChatSnapshot, ClaimedDevice, ClaimedTurn, HostSummary, OpenItem, OpenTurn, PromptToSign, ThreadHistory, ThreadList, ThreadPage, ThreadSummary, TurnFailure, TurnOutcome, TurnSignals, TurnState, TurnStatus, } from "./model.js";
+export { CHAT_CHANNEL, CHAT_PLUGIN, type ChatFrame, HOST_PROTOCOL, type HostFrame, type HostHello, type HostStreamBatch, type HostWelcome, parseChatFrame, type ProtocolRange, type StreamingKind, } from "./protocol.js";
+export { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG } from "./tags.js";
+export { type AskState, type ChatItem, type FoldedKind, type FoldInput, foldThread, type ItemFolders, type ThreadConfirmation, } from "./view.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EACV,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,SAAS,EACd,aAAa,EACb,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,SAAS,EACd,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { CHAT_EVENTS } from "./events.js";
+export { applyFrame } from "./open-turns.js";
+export { isPromptTooLong, MAX_PROMPT_CHARS, PROMPT_LIMIT_MESSAGE } from "./limits.js";
+export { CHAT_CHANNEL, CHAT_PLUGIN, HOST_PROTOCOL, parseChatFrame, } from "./protocol.js";
+export { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG } from "./tags.js";
+export { foldThread, } from "./view.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAY1D,OAAO,EAAqB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAuBtF,OAAO,EACL,YAAY,EACZ,WAAW,EAEX,aAAa,EAKb,cAAc,GAGf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAKL,UAAU,GAGX,MAAM,WAAW,CAAC","sourcesContent":["export { CHAT_EVENTS, type ChatEvent } from \"./events.js\";\nexport type {\n  Author,\n  AuthorOf,\n  ChatItemBody,\n  ChatItemKind,\n  HostItemDraft,\n  HostItemKind,\n  ItemSignature,\n  LoggedItem,\n  UserItemKind,\n} from \"./items.js\";\nexport { type AppliedFrame, applyFrame } from \"./open-turns.js\";\nexport { isPromptTooLong, MAX_PROMPT_CHARS, PROMPT_LIMIT_MESSAGE } from \"./limits.js\";\nexport type {\n  AgentInfo,\n  AgentRef,\n  AnswerToSign,\n  ChatOwner,\n  ChatSnapshot,\n  ClaimedDevice,\n  ClaimedTurn,\n  HostSummary,\n  OpenItem,\n  OpenTurn,\n  PromptToSign,\n  ThreadHistory,\n  ThreadList,\n  ThreadPage,\n  ThreadSummary,\n  TurnFailure,\n  TurnOutcome,\n  TurnSignals,\n  TurnState,\n  TurnStatus,\n} from \"./model.js\";\nexport {\n  CHAT_CHANNEL,\n  CHAT_PLUGIN,\n  type ChatFrame,\n  HOST_PROTOCOL,\n  type HostFrame,\n  type HostHello,\n  type HostStreamBatch,\n  type HostWelcome,\n  parseChatFrame,\n  type ProtocolRange,\n  type StreamingKind,\n} from \"./protocol.js\";\nexport { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG } from \"./tags.js\";\nexport {\n  type AskState,\n  type ChatItem,\n  type FoldedKind,\n  type FoldInput,\n  foldThread,\n  type ItemFolders,\n  type ThreadConfirmation,\n} from \"./view.js\";\n"]}

package/dist/items.d.ts

@@ -0,0 +1,295 @@
+import type { ItemId, ThreadId, TurnId } from "@parlor/core";
+import { z } from "zod";
+import { idSchema } from "./id-schemas.js";
+declare const signed: z.ZodObject<{
+    deviceId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@parlor/core").Id<"device">, string>>;
+    at: z.ZodNumber;
+    signature: z.ZodObject<{
+        keyId: z.ZodString;
+        presence: z.ZodEnum<{
+            none: "none";
+            user: "user";
+        }>;
+        format: z.ZodEnum<{
+            "es256-raw": "es256-raw";
+            webauthn: "webauthn";
+        }>;
+        signature: z.ZodString;
+        authenticatorData: z.ZodOptional<z.ZodString>;
+        clientDataJSON: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    pairing: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The one table of item kinds: who writes each and the body it carries. Types, the
+ * server's parsers, the host's append type and the client's view all derive from it.
+ */
+export declare const chatItemBodies: {
+    readonly prompt: {
+        readonly author: "user";
+        readonly body: z.ZodObject<{
+            text: z.ZodString;
+            agent: z.ZodObject<{
+                hostId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@parlor/core").Id<"host">, string>>;
+                agentId: z.ZodString;
+            }, z.core.$strip>;
+            signed: z.ZodOptional<z.ZodObject<{
+                deviceId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@parlor/core").Id<"device">, string>>;
+                at: z.ZodNumber;
+                signature: z.ZodObject<{
+                    keyId: z.ZodString;
+                    presence: z.ZodEnum<{
+                        none: "none";
+                        user: "user";
+                    }>;
+                    format: z.ZodEnum<{
+                        "es256-raw": "es256-raw";
+                        webauthn: "webauthn";
+                    }>;
+                    signature: z.ZodString;
+                    authenticatorData: z.ZodOptional<z.ZodString>;
+                    clientDataJSON: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                pairing: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    readonly answer: {
+        readonly author: "user";
+        readonly body: z.ZodObject<{
+            askId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@parlor/core").Id<"item">, string>>;
+            choice: z.ZodString;
+            values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            signed: z.ZodOptional<z.ZodObject<{
+                deviceId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@parlor/core").Id<"device">, string>>;
+                at: z.ZodNumber;
+                signature: z.ZodObject<{
+                    keyId: z.ZodString;
+                    presence: z.ZodEnum<{
+                        none: "none";
+                        user: "user";
+                    }>;
+                    format: z.ZodEnum<{
+                        "es256-raw": "es256-raw";
+                        webauthn: "webauthn";
+                    }>;
+                    signature: z.ZodString;
+                    authenticatorData: z.ZodOptional<z.ZodString>;
+                    clientDataJSON: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                pairing: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    readonly cancel: {
+        readonly author: "user";
+        readonly body: z.ZodObject<{}, z.core.$strip>;
+    };
+    readonly reply: {
+        readonly author: "agent";
+        readonly body: z.ZodObject<{
+            text: z.ZodString;
+            interrupted: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>;
+    };
+    readonly reasoning: {
+        readonly author: "agent";
+        readonly body: z.ZodObject<{
+            text: z.ZodString;
+        }, z.core.$strip>;
+    };
+    readonly tool: {
+        readonly author: "agent";
+        readonly body: z.ZodObject<{
+            title: z.ZodString;
+            tool: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    app: "app";
+                    local: "local";
+                }>;
+                name: z.ZodString;
+            }, z.core.$strip>;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                done: "done";
+                failed: "failed";
+            }>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly plan: {
+        readonly author: "agent";
+        readonly body: z.ZodObject<{
+            entries: z.ZodArray<z.ZodObject<{
+                content: z.ZodString;
+                status: z.ZodEnum<{
+                    completed: "completed";
+                    in_progress: "in_progress";
+                    pending: "pending";
+                }>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    readonly ask: {
+        readonly author: "agent";
+        readonly body: z.ZodObject<{
+            question: z.ZodString;
+            choices: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                effect: z.ZodEnum<{
+                    allow_always: "allow_always";
+                    allow_once: "allow_once";
+                    reject_always: "reject_always";
+                    reject_once: "reject_once";
+                }>;
+            }, z.core.$strip>>;
+            form: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            approval: z.ZodOptional<z.ZodEnum<{
+                computer: "computer";
+                presence: "presence";
+            }>>;
+        }, z.core.$strip>;
+    };
+    readonly event: {
+        readonly author: "system";
+        readonly body: z.ZodObject<{
+            event: z.ZodEnum<{
+                agent_exited: "agent_exited";
+                agent_started: "agent_started";
+                agent_switched: "agent_switched";
+                answer_rejected: "answer_rejected";
+                answered_on_computer: "answered_on_computer";
+                device_pending: "device_pending";
+                device_rejected: "device_rejected";
+                host_lost: "host_lost";
+                turn_failed: "turn_failed";
+            }>;
+            detail: z.ZodOptional<z.ZodString>;
+            itemId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@parlor/core").Id<"item">, string>>>;
+            choice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+};
+type Bodies = typeof chatItemBodies;
+export type ChatItemKind = keyof Bodies;
+export type Author = Bodies[ChatItemKind]["author"];
+export type AuthorOf<K extends ChatItemKind> = Bodies[K]["author"];
+export type ChatItemBody<K extends ChatItemKind> = z.output<Bodies[K]["body"]>;
+export type ItemSignature = z.output<typeof signed>;
+type KindsBy<A extends Author> = {
+    [K in ChatItemKind]: AuthorOf<K> extends A ? K : never;
+}[ChatItemKind];
+/** Appended only by the user's devices, through the user actions. */
+export type UserItemKind = KindsBy<"user">;
+/** Appended only by the user's computer, through the host actions. */
+export type HostItemKind = KindsBy<"agent" | "system">;
+export type LoggedItem<K extends ChatItemKind = ChatItemKind> = {
+    [Kind in K]: {
+        readonly id: ItemId;
+        readonly threadId: ThreadId;
+        readonly turnId: TurnId;
+        /** Gap-free per thread, assigned under the thread row's lock. */
+        readonly seq: number;
+        readonly at: number;
+        readonly author: AuthorOf<Kind>;
+        readonly kind: Kind;
+        readonly body: ChatItemBody<Kind>;
+    };
+}[K];
+/** Its id is `<turnId>.<n>`, chosen by the host, so a retried append is a no-op. */
+export type HostItemDraft = {
+    [K in HostItemKind]: {
+        readonly id: ItemId;
+        readonly kind: K;
+        readonly body: ChatItemBody<K>;
+    };
+}[HostItemKind];
+export declare const hostItemDraft: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: ReturnType<typeof idSchema<"item">>;
+    kind: z.ZodLiteral<"reply">;
+    body: z.ZodObject<{
+        text: z.ZodString;
+        interrupted: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: ReturnType<typeof idSchema<"item">>;
+    kind: z.ZodLiteral<"reasoning">;
+    body: z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: ReturnType<typeof idSchema<"item">>;
+    kind: z.ZodLiteral<"tool">;
+    body: z.ZodObject<{
+        title: z.ZodString;
+        tool: z.ZodObject<{
+            kind: z.ZodEnum<{
+                app: "app";
+                local: "local";
+            }>;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+        }>;
+        detail: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: ReturnType<typeof idSchema<"item">>;
+    kind: z.ZodLiteral<"plan">;
+    body: z.ZodObject<{
+        entries: z.ZodArray<z.ZodObject<{
+            content: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                in_progress: "in_progress";
+                pending: "pending";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: ReturnType<typeof idSchema<"item">>;
+    kind: z.ZodLiteral<"ask">;
+    body: z.ZodObject<{
+        question: z.ZodString;
+        choices: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            effect: z.ZodEnum<{
+                allow_always: "allow_always";
+                allow_once: "allow_once";
+                reject_always: "reject_always";
+                reject_once: "reject_once";
+            }>;
+        }, z.core.$strip>>;
+        form: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        approval: z.ZodOptional<z.ZodEnum<{
+            computer: "computer";
+            presence: "presence";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: ReturnType<typeof idSchema<"item">>;
+    kind: z.ZodLiteral<"event">;
+    body: z.ZodObject<{
+        event: z.ZodEnum<{
+            agent_exited: "agent_exited";
+            agent_started: "agent_started";
+            agent_switched: "agent_switched";
+            answer_rejected: "answer_rejected";
+            answered_on_computer: "answered_on_computer";
+            device_pending: "device_pending";
+            device_rejected: "device_rejected";
+            host_lost: "host_lost";
+            turn_failed: "turn_failed";
+        }>;
+        detail: z.ZodOptional<z.ZodString>;
+        itemId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@parlor/core").Id<"item">, string>>>;
+        choice: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "kind">;
+export {};
+//# sourceMappingURL=items.d.ts.map

package/dist/items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../src/items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAY3C,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;iBASV,CAAC;AAUH;;;GAGG;AACH,eAAO,MAAM,cAAc;aACzB,MAAM;iBACJ,MAAM,EAAE,MAAM;iBACd,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMN,MAAM;iBACJ,MAAM,EAAE,MAAM;iBACd,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;aASN,MAAM;iBAAI,MAAM,EAAE,MAAM;iBAAE,IAAI;;aAC9B,KAAK;iBACH,MAAM,EAAE,OAAO;iBACf,IAAI;;;;;aAEN,SAAS;iBAAI,MAAM,EAAE,OAAO;iBAAE,IAAI;;;;aAClC,IAAI;iBACF,MAAM,EAAE,OAAO;iBACf,IAAI;;;;;;;;;;;;;;;;;aAON,IAAI;iBACF,MAAM,EAAE,OAAO;iBACf,IAAI;;;;;;;;;;;aASN,GAAG;iBACD,MAAM,EAAE,OAAO;iBACf,IAAI;;;;;;;;;;;;;;;;;;;aAWN,KAAK;iBACH,MAAM,EAAE,QAAQ;iBAChB,IAAI;;;;;;;;;;;;;;;;;CAOE,CAAC;AAEX,KAAK,MAAM,GAAG,OAAO,cAAc,CAAC;AAEpC,MAAM,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC;AACxC,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;AACpD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,YAAY,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACnE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC;AAEpD,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI;KAC9B,CAAC,IAAI,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK;CACvD,CAAC,YAAY,CAAC,CAAC;AAEhB,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAC3C,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;AAEvD,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI;KAC7D,IAAI,IAAI,CAAC,GAAG;QACX,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,iEAAiE;QACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;KACnC;CACF,CAAC,CAAC,CAAC,CAAC;AAEL,oFAAoF;AACpF,MAAM,MAAM,aAAa,GAAG;KACzB,CAAC,IAAI,YAAY,GAAG;QACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;KAChC;CACF,CAAC,YAAY,CAAC,CAAC;AAehB,eAAO,MAAM,aAAa;QAVpB,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;;;;;;;QAAnC,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;;;;;;QAAnC,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;;;;;;;;;;;;;;;;;;;QAAnC,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;;;;;;;;;;;;;QAAnC,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;QAAnC,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;;;;;;;;;;;;;;;;;;2BAiBvC,CAAC"}

package/dist/items.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { CHAT_EVENTS } from "./events.js";
+import { idSchema } from "./id-schemas.js";
+import { MAX_PROMPT_CHARS } from "./limits.js";
+const signature = z.object({
+    keyId: z.string(),
+    presence: z.enum(["none", "user"]),
+    format: z.enum(["es256-raw", "webauthn"]),
+    signature: z.string(),
+    authenticatorData: z.string().optional(),
+    clientDataJSON: z.string().optional(),
+});
+const signed = z.object({
+    deviceId: idSchema("device"),
+    at: z.number(),
+    signature,
+    /** The browser that approved the computer's connect proving it, so the computer trusts it unasked. */
+    pairing: z
+        .string()
+        .regex(/^[A-Za-z0-9_-]{43}$/)
+        .optional(),
+});
+const agentRef = z.object({ hostId: idSchema("host"), agentId: z.string().min(1) });
+const askChoice = z.object({
+    id: z.string().min(1),
+    label: z.string(),
+    effect: z.enum(["allow_once", "allow_always", "reject_once", "reject_always"]),
+});
+/**
+ * The one table of item kinds: who writes each and the body it carries. Types, the
+ * server's parsers, the host's append type and the client's view all derive from it.
+ */
+export const chatItemBodies = {
+    prompt: {
+        author: "user",
+        body: z.object({
+            text: z.string().min(1).max(MAX_PROMPT_CHARS),
+            agent: agentRef,
+            signed: signed.optional(),
+        }),
+    },
+    answer: {
+        author: "user",
+        body: z.object({
+            askId: idSchema("item"),
+            choice: z.string().min(1),
+            values: z
+                .record(z.string(), z.union([z.string(), z.number(), z.boolean()]))
+                .optional(),
+            signed: signed.optional(),
+        }),
+    },
+    cancel: { author: "user", body: z.object({}) },
+    reply: {
+        author: "agent",
+        body: z.object({ text: z.string(), interrupted: z.literal(true).optional() }),
+    },
+    reasoning: { author: "agent", body: z.object({ text: z.string() }) },
+    tool: {
+        author: "agent",
+        body: z.object({
+            title: z.string(),
+            tool: z.object({ kind: z.enum(["app", "local"]), name: z.string() }),
+            status: z.enum(["done", "failed", "cancelled"]),
+            detail: z.string().max(4_000).optional(),
+        }),
+    },
+    plan: {
+        author: "agent",
+        body: z.object({
+            entries: z.array(z.object({
+                content: z.string(),
+                status: z.enum(["pending", "in_progress", "completed"]),
+            })),
+        }),
+    },
+    ask: {
+        author: "agent",
+        body: z.object({
+            question: z.string(),
+            choices: z.array(askChoice),
+            form: z.record(z.string(), z.unknown()).optional(),
+            /**
+             * Set by the host's policy, never by the app. Absent: any device answers from the
+             * chat, without presence.
+             */
+            approval: z.enum(["presence", "computer"]).optional(),
+        }),
+    },
+    event: {
+        author: "system",
+        body: z.object({
+            event: z.enum(CHAT_EVENTS),
+            detail: z.string().max(500).optional(),
+            itemId: idSchema("item").optional(),
+            choice: z.string().min(1).optional(),
+        }),
+    },
+};
+const draft = (kind) => z.object({
+    id: idSchema("item"),
+    kind: z.literal(kind),
+    body: chatItemBodies[kind].body,
+});
+export const hostItemDraft = z.discriminatedUnion("kind", [
+    draft("reply"),
+    draft("reasoning"),
+    draft("tool"),
+    draft("plan"),
+    draft("ask"),
+    draft("event"),
+]);
+//# sourceMappingURL=items.js.map

package/dist/items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../src/items.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,SAAS;IACT,sGAAsG;IACtG,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,CAAC;SAC5B,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEpF,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;CAC/E,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE;QACN,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC;YAC7C,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC1B,CAAC;KACH;IACD,MAAM,EAAE;QACN,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC;YACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,MAAM,EAAE,CAAC;iBACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;iBAClE,QAAQ,EAAE;YACb,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC1B,CAAC;KACH;IACD,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;IAC9C,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;KAC9E;IACD,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;IACpE,IAAI,EAAE;QACJ,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACpE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;SACzC,CAAC;KACH;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;gBACnB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;aACxD,CAAC,CACH;SACF,CAAC;KACH;IACD,GAAG,EAAE;QACH,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;YAClD;;;eAGG;YACH,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;SACtD,CAAC;KACH;IACD,KAAK,EAAE;QACL,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;YAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACtC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;YACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SACrC,CAAC;KACH;CACO,CAAC;AA0CX,MAAM,KAAK,GAAG,CACZ,IAAO,EAKN,EAAE,CACH,CAAC,CAAC,MAAM,CAAC;IACP,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,IAAyB;CACrD,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACxD,KAAK,CAAC,OAAO,CAAC;IACd,KAAK,CAAC,WAAW,CAAC;IAClB,KAAK,CAAC,MAAM,CAAC;IACb,KAAK,CAAC,MAAM,CAAC;IACb,KAAK,CAAC,KAAK,CAAC;IACZ,KAAK,CAAC,OAAO,CAAC;CACf,CAAC,CAAC","sourcesContent":["import type { ItemId, ThreadId, TurnId } from \"@parlor/core\";\nimport { z } from \"zod\";\n\nimport { CHAT_EVENTS } from \"./events.js\";\nimport { idSchema } from \"./id-schemas.js\";\nimport { MAX_PROMPT_CHARS } from \"./limits.js\";\n\nconst signature = z.object({\n  keyId: z.string(),\n  presence: z.enum([\"none\", \"user\"]),\n  format: z.enum([\"es256-raw\", \"webauthn\"]),\n  signature: z.string(),\n  authenticatorData: z.string().optional(),\n  clientDataJSON: z.string().optional(),\n});\n\nconst signed = z.object({\n  deviceId: idSchema(\"device\"),\n  at: z.number(),\n  signature,\n  /** The browser that approved the computer's connect proving it, so the computer trusts it unasked. */\n  pairing: z\n    .string()\n    .regex(/^[A-Za-z0-9_-]{43}$/)\n    .optional(),\n});\n\nconst agentRef = z.object({ hostId: idSchema(\"host\"), agentId: z.string().min(1) });\n\nconst askChoice = z.object({\n  id: z.string().min(1),\n  label: z.string(),\n  effect: z.enum([\"allow_once\", \"allow_always\", \"reject_once\", \"reject_always\"]),\n});\n\n/**\n * The one table of item kinds: who writes each and the body it carries. Types, the\n * server's parsers, the host's append type and the client's view all derive from it.\n */\nexport const chatItemBodies = {\n  prompt: {\n    author: \"user\",\n    body: z.object({\n      text: z.string().min(1).max(MAX_PROMPT_CHARS),\n      agent: agentRef,\n      signed: signed.optional(),\n    }),\n  },\n  answer: {\n    author: \"user\",\n    body: z.object({\n      askId: idSchema(\"item\"),\n      choice: z.string().min(1),\n      values: z\n        .record(z.string(), z.union([z.string(), z.number(), z.boolean()]))\n        .optional(),\n      signed: signed.optional(),\n    }),\n  },\n  cancel: { author: \"user\", body: z.object({}) },\n  reply: {\n    author: \"agent\",\n    body: z.object({ text: z.string(), interrupted: z.literal(true).optional() }),\n  },\n  reasoning: { author: \"agent\", body: z.object({ text: z.string() }) },\n  tool: {\n    author: \"agent\",\n    body: z.object({\n      title: z.string(),\n      tool: z.object({ kind: z.enum([\"app\", \"local\"]), name: z.string() }),\n      status: z.enum([\"done\", \"failed\", \"cancelled\"]),\n      detail: z.string().max(4_000).optional(),\n    }),\n  },\n  plan: {\n    author: \"agent\",\n    body: z.object({\n      entries: z.array(\n        z.object({\n          content: z.string(),\n          status: z.enum([\"pending\", \"in_progress\", \"completed\"]),\n        }),\n      ),\n    }),\n  },\n  ask: {\n    author: \"agent\",\n    body: z.object({\n      question: z.string(),\n      choices: z.array(askChoice),\n      form: z.record(z.string(), z.unknown()).optional(),\n      /**\n       * Set by the host's policy, never by the app. Absent: any device answers from the\n       * chat, without presence.\n       */\n      approval: z.enum([\"presence\", \"computer\"]).optional(),\n    }),\n  },\n  event: {\n    author: \"system\",\n    body: z.object({\n      event: z.enum(CHAT_EVENTS),\n      detail: z.string().max(500).optional(),\n      itemId: idSchema(\"item\").optional(),\n      choice: z.string().min(1).optional(),\n    }),\n  },\n} as const;\n\ntype Bodies = typeof chatItemBodies;\n\nexport type ChatItemKind = keyof Bodies;\nexport type Author = Bodies[ChatItemKind][\"author\"];\nexport type AuthorOf<K extends ChatItemKind> = Bodies[K][\"author\"];\nexport type ChatItemBody<K extends ChatItemKind> = z.output<Bodies[K][\"body\"]>;\nexport type ItemSignature = z.output<typeof signed>;\n\ntype KindsBy<A extends Author> = {\n  [K in ChatItemKind]: AuthorOf<K> extends A ? K : never;\n}[ChatItemKind];\n\n/** Appended only by the user's devices, through the user actions. */\nexport type UserItemKind = KindsBy<\"user\">;\n/** Appended only by the user's computer, through the host actions. */\nexport type HostItemKind = KindsBy<\"agent\" | \"system\">;\n\nexport type LoggedItem<K extends ChatItemKind = ChatItemKind> = {\n  [Kind in K]: {\n    readonly id: ItemId;\n    readonly threadId: ThreadId;\n    readonly turnId: TurnId;\n    /** Gap-free per thread, assigned under the thread row's lock. */\n    readonly seq: number;\n    readonly at: number;\n    readonly author: AuthorOf<Kind>;\n    readonly kind: Kind;\n    readonly body: ChatItemBody<Kind>;\n  };\n}[K];\n\n/** Its id is `<turnId>.<n>`, chosen by the host, so a retried append is a no-op. */\nexport type HostItemDraft = {\n  [K in HostItemKind]: {\n    readonly id: ItemId;\n    readonly kind: K;\n    readonly body: ChatItemBody<K>;\n  };\n}[HostItemKind];\n\nconst draft = <K extends HostItemKind>(\n  kind: K,\n): z.ZodObject<{\n  id: ReturnType<typeof idSchema<\"item\">>;\n  kind: z.ZodLiteral<K>;\n  body: Bodies[K][\"body\"];\n}> =>\n  z.object({\n    id: idSchema(\"item\"),\n    kind: z.literal(kind),\n    body: chatItemBodies[kind].body as Bodies[K][\"body\"],\n  });\n\nexport const hostItemDraft = z.discriminatedUnion(\"kind\", [\n  draft(\"reply\"),\n  draft(\"reasoning\"),\n  draft(\"tool\"),\n  draft(\"plan\"),\n  draft(\"ask\"),\n  draft(\"event\"),\n]);\n"]}

package/dist/limits.d.ts

@@ -0,0 +1,4 @@
+export declare const MAX_PROMPT_CHARS = 32000;
+export declare const PROMPT_LIMIT_MESSAGE: string;
+export declare const isPromptTooLong: (text: string) => boolean;
+//# sourceMappingURL=limits.d.ts.map

package/dist/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,eAAO,MAAM,oBAAoB,QAAoF,CAAC;AAEtH,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,OACR,CAAC"}

package/dist/limits.js

@@ -0,0 +1,4 @@
+export const MAX_PROMPT_CHARS = 32_000;
+export const PROMPT_LIMIT_MESSAGE = `Messages can be at most ${MAX_PROMPT_CHARS.toLocaleString("en-US")} characters.`;
+export const isPromptTooLong = (text) => text.trim().length > MAX_PROMPT_CHARS;
+//# sourceMappingURL=limits.js.map

package/dist/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,gBAAgB,CAAC,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC;AAEtH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAW,EAAE,CACvD,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,gBAAgB,CAAC","sourcesContent":["export const MAX_PROMPT_CHARS = 32_000;\n\nexport const PROMPT_LIMIT_MESSAGE = `Messages can be at most ${MAX_PROMPT_CHARS.toLocaleString(\"en-US\")} characters.`;\n\nexport const isPromptTooLong = (text: string): boolean =>\n  text.trim().length > MAX_PROMPT_CHARS;\n"]}