@parlor/chat 0.0.0-stage → 0.2.0

package/dist/model.d.ts

@@ -0,0 +1,143 @@
+import type { HostId, ItemId, ThreadId, TurnId, UserId } from "@parlor/core";
+import type { Delegation, DeviceKeys } from "@parlor/server";
+import type { ChatItemBody, LoggedItem, UserItemKind } from "./items.js";
+export interface AgentRef {
+    readonly hostId: HostId;
+    /** A profile id on that host (`claude`, `codex`), not an entity. */
+    readonly agentId: string;
+}
+/**
+ * Whose chat a row is. Every thread, turn and host row carries both and every chat query
+ * filters by both, so members of one organization scope never see each other's chats.
+ */
+export interface ChatOwner {
+    readonly scope: string;
+    readonly userId: UserId;
+}
+export interface HostSummary {
+    readonly id: HostId;
+    readonly name: string;
+    readonly platform: string;
+    readonly online: boolean;
+    readonly agents: readonly AgentInfo[];
+    /** The devices this computer runs prompts from; absent when it is too old to say. */
+    readonly devices?: readonly string[] | undefined;
+    /**
+     * When each of those devices must sign its next prompt with Face ID or Touch ID again
+     * (epoch ms); a device it never asks is missing.
+     */
+    readonly presenceDue?: Readonly<Record<string, number>> | undefined;
+}
+export interface AgentInfo {
+    readonly id: string;
+    readonly name: string;
+    readonly version?: string | undefined;
+    readonly ready: boolean;
+    /** Why a not-ready agent cannot run yet ("run `claude` to log in"). */
+    readonly problem?: string | undefined;
+}
+export interface ThreadSummary {
+    readonly id: ThreadId;
+    readonly title: string;
+    readonly agent: AgentRef | undefined;
+    readonly updatedAt: number;
+    readonly lastSeq: number;
+}
+export type TurnState = "queued" | "running" | "done" | "failed" | "cancelled";
+export type TurnFailure = "agent_exited" | "agent_unavailable" | "device_rejected" | "signature_invalid" | "prompt_expired" | "host_lost";
+export type TurnOutcome = {
+    readonly state: "done";
+    readonly stopReason: string;
+} | {
+    readonly state: "cancelled";
+} | {
+    readonly state: "failed";
+    readonly reason: TurnFailure;
+};
+/** Still being produced: only in memory, on the instance the host posts to. */
+export type OpenItem = {
+    readonly id: ItemId;
+    readonly kind: "reply" | "reasoning";
+    readonly text: string;
+} | {
+    readonly id: ItemId;
+    readonly kind: "tool";
+    readonly title: string;
+    readonly status: "pending" | "running";
+} | {
+    readonly id: ItemId;
+    readonly kind: "plan";
+    readonly entries: ChatItemBody<"plan">["entries"];
+};
+export interface OpenTurn {
+    readonly turnId: TurnId;
+    readonly threadId: ThreadId;
+    readonly items: readonly OpenItem[];
+}
+export interface TurnStatus {
+    readonly turnId: TurnId;
+    readonly state: TurnState;
+    readonly agent: AgentRef;
+    readonly failure?: TurnFailure | undefined;
+}
+export interface ThreadPage {
+    readonly thread: ThreadSummary | undefined;
+    readonly items: readonly LoggedItem[];
+    readonly open: readonly OpenTurn[];
+    readonly turns: readonly TurnStatus[];
+    readonly hasMore: boolean;
+}
+export interface ChatSnapshot {
+    readonly threads: readonly ThreadSummary[];
+    /** `threads` was cut at its limit; `threadsBefore` reads on from its last one. */
+    readonly moreThreads?: boolean | undefined;
+    readonly hosts: readonly HostSummary[];
+    readonly page: ThreadPage;
+}
+/** What `history` returns: earlier items of a thread, oldest first, with their turns. */
+export interface ThreadHistory {
+    readonly items: readonly LoggedItem[];
+    readonly turns: readonly TurnStatus[];
+    readonly hasMore: boolean;
+}
+/** What `threadsBefore` returns: the next older threads, newest first. */
+export interface ThreadList {
+    readonly threads: readonly ThreadSummary[];
+    readonly hasMore: boolean;
+}
+/** The device's keys as the account has them; the host compares them with its own pins. */
+export type ClaimedDevice = DeviceKeys;
+export interface ClaimedTurn {
+    /** The thread id; every chat write returns it as `id`, which becomes its sync tag. */
+    readonly id: ThreadId;
+    readonly turnId: TurnId;
+    readonly agent: AgentRef;
+    /** The client the prompt came from; the turn token binds `ui_*` to it. */
+    readonly clientId: string;
+    readonly prompt: LoggedItem<"prompt">;
+    readonly device: ClaimedDevice | undefined;
+    /** The `<parlor-context>` block for a fresh agent session. */
+    readonly context: string;
+    readonly token: Delegation;
+    readonly leaseUntil: number;
+}
+export interface TurnSignals {
+    readonly turnId: TurnId;
+    readonly items: readonly LoggedItem<Exclude<UserItemKind, "prompt">>[];
+    /** The keys of each device that answered, as the account lists them; revoked ones are left out. */
+    readonly devices?: readonly DeviceKeys[];
+}
+/** What a device signs for a prompt; the host rebuilds the same statement from the item. */
+export interface PromptToSign {
+    readonly threadId: ThreadId;
+    readonly turnId: TurnId;
+    readonly agent: AgentRef;
+    readonly text: string;
+}
+export interface AnswerToSign {
+    readonly threadId: ThreadId;
+    readonly askId: ItemId;
+    readonly choice: string;
+    readonly values?: ChatItemBody<"answer">["values"];
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"","sourcesContent":["import type { HostId, ItemId, ThreadId, TurnId, UserId } from \"@parlor/core\";\nimport type { Delegation, DeviceKeys } from \"@parlor/server\";\n\nimport type { ChatItemBody, LoggedItem, UserItemKind } from \"./items.js\";\n\nexport interface AgentRef {\n  readonly hostId: HostId;\n  /** A profile id on that host (`claude`, `codex`), not an entity. */\n  readonly agentId: string;\n}\n\n/**\n * Whose chat a row is. Every thread, turn and host row carries both and every chat query\n * filters by both, so members of one organization scope never see each other's chats.\n */\nexport interface ChatOwner {\n  readonly scope: string;\n  readonly userId: UserId;\n}\n\nexport interface HostSummary {\n  readonly id: HostId;\n  readonly name: string;\n  readonly platform: string;\n  readonly online: boolean;\n  readonly agents: readonly AgentInfo[];\n  /** The devices this computer runs prompts from; absent when it is too old to say. */\n  readonly devices?: readonly string[] | undefined;\n  /**\n   * When each of those devices must sign its next prompt with Face ID or Touch ID again\n   * (epoch ms); a device it never asks is missing.\n   */\n  readonly presenceDue?: Readonly<Record<string, number>> | undefined;\n}\n\nexport interface AgentInfo {\n  readonly id: string;\n  readonly name: string;\n  readonly version?: string | undefined;\n  readonly ready: boolean;\n  /** Why a not-ready agent cannot run yet (\"run `claude` to log in\"). */\n  readonly problem?: string | undefined;\n}\n\nexport interface ThreadSummary {\n  readonly id: ThreadId;\n  readonly title: string;\n  readonly agent: AgentRef | undefined;\n  readonly updatedAt: number;\n  readonly lastSeq: number;\n}\n\nexport type TurnState = \"queued\" | \"running\" | \"done\" | \"failed\" | \"cancelled\";\n\nexport type TurnFailure =\n  | \"agent_exited\"\n  | \"agent_unavailable\"\n  | \"device_rejected\"\n  | \"signature_invalid\"\n  | \"prompt_expired\"\n  | \"host_lost\";\n\nexport type TurnOutcome =\n  | { readonly state: \"done\"; readonly stopReason: string }\n  | { readonly state: \"cancelled\" }\n  | { readonly state: \"failed\"; readonly reason: TurnFailure };\n\n/** Still being produced: only in memory, on the instance the host posts to. */\nexport type OpenItem =\n  | { readonly id: ItemId; readonly kind: \"reply\" | \"reasoning\"; readonly text: string }\n  | {\n      readonly id: ItemId;\n      readonly kind: \"tool\";\n      readonly title: string;\n      readonly status: \"pending\" | \"running\";\n    }\n  | {\n      readonly id: ItemId;\n      readonly kind: \"plan\";\n      readonly entries: ChatItemBody<\"plan\">[\"entries\"];\n    };\n\nexport interface OpenTurn {\n  readonly turnId: TurnId;\n  readonly threadId: ThreadId;\n  readonly items: readonly OpenItem[];\n}\n\nexport interface TurnStatus {\n  readonly turnId: TurnId;\n  readonly state: TurnState;\n  readonly agent: AgentRef;\n  readonly failure?: TurnFailure | undefined;\n}\n\nexport interface ThreadPage {\n  readonly thread: ThreadSummary | undefined;\n  readonly items: readonly LoggedItem[];\n  readonly open: readonly OpenTurn[];\n  readonly turns: readonly TurnStatus[];\n  readonly hasMore: boolean;\n}\n\nexport interface ChatSnapshot {\n  readonly threads: readonly ThreadSummary[];\n  /** `threads` was cut at its limit; `threadsBefore` reads on from its last one. */\n  readonly moreThreads?: boolean | undefined;\n  readonly hosts: readonly HostSummary[];\n  readonly page: ThreadPage;\n}\n\n/** What `history` returns: earlier items of a thread, oldest first, with their turns. */\nexport interface ThreadHistory {\n  readonly items: readonly LoggedItem[];\n  readonly turns: readonly TurnStatus[];\n  readonly hasMore: boolean;\n}\n\n/** What `threadsBefore` returns: the next older threads, newest first. */\nexport interface ThreadList {\n  readonly threads: readonly ThreadSummary[];\n  readonly hasMore: boolean;\n}\n\n/** The device's keys as the account has them; the host compares them with its own pins. */\nexport type ClaimedDevice = DeviceKeys;\n\nexport interface ClaimedTurn {\n  /** The thread id; every chat write returns it as `id`, which becomes its sync tag. */\n  readonly id: ThreadId;\n  readonly turnId: TurnId;\n  readonly agent: AgentRef;\n  /** The client the prompt came from; the turn token binds `ui_*` to it. */\n  readonly clientId: string;\n  readonly prompt: LoggedItem<\"prompt\">;\n  readonly device: ClaimedDevice | undefined;\n  /** The `<parlor-context>` block for a fresh agent session. */\n  readonly context: string;\n  readonly token: Delegation;\n  readonly leaseUntil: number;\n}\n\nexport interface TurnSignals {\n  readonly turnId: TurnId;\n  readonly items: readonly LoggedItem<Exclude<UserItemKind, \"prompt\">>[];\n  /** The keys of each device that answered, as the account lists them; revoked ones are left out. */\n  readonly devices?: readonly DeviceKeys[];\n}\n\n/** What a device signs for a prompt; the host rebuilds the same statement from the item. */\nexport interface PromptToSign {\n  readonly threadId: ThreadId;\n  readonly turnId: TurnId;\n  readonly agent: AgentRef;\n  readonly text: string;\n}\n\nexport interface AnswerToSign {\n  readonly threadId: ThreadId;\n  readonly askId: ItemId;\n  readonly choice: string;\n  readonly values?: ChatItemBody<\"answer\">[\"values\"];\n}\n"]}

package/dist/open-turns.d.ts

@@ -0,0 +1,19 @@
+import type { OpenItem } from "./model.js";
+import type { ChatFrame } from "./protocol.js";
+export interface AppliedFrame {
+    readonly items: readonly OpenItem[];
+    /** What actually changed: a delta overlapping the text already held is cut to its new part. */
+    readonly frame: Exclude<ChatFrame, {
+        type: "settled";
+    }>;
+}
+/**
+ * Applies a `delta` or `item` frame to one turn's open items. A delta whose text is
+ * already held is skipped and one that starts past the end of the text is a gap; both
+ * answer `undefined`, and after a gap every later delta is a gap too, so the item waits
+ * for its durable twin instead of drawing a hole.
+ */
+export declare function applyFrame(items: readonly OpenItem[], frame: Exclude<ChatFrame, {
+    type: "settled";
+}>): AppliedFrame | undefined;
+//# sourceMappingURL=open-turns.d.ts.map

package/dist/open-turns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-turns.d.ts","sourceRoot":"","sources":["../src/open-turns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;CACzD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC7C,YAAY,GAAG,SAAS,CAqB1B"}

package/dist/open-turns.js

@@ -0,0 +1,31 @@
+/**
+ * Applies a `delta` or `item` frame to one turn's open items. A delta whose text is
+ * already held is skipped and one that starts past the end of the text is a gap; both
+ * answer `undefined`, and after a gap every later delta is a gap too, so the item waits
+ * for its durable twin instead of drawing a hole.
+ */
+export function applyFrame(items, frame) {
+    if (frame.type === "item") {
+        const index = items.findIndex((item) => item.id === frame.item.id);
+        const next = index < 0
+            ? [...items, frame.item]
+            : items.map((item, at) => (at === index ? frame.item : item));
+        return { items: next, frame };
+    }
+    const index = items.findIndex((item) => item.id === frame.itemId);
+    const held = index < 0 ? undefined : items[index];
+    if (held && held.kind !== "reply" && held.kind !== "reasoning")
+        return undefined;
+    const have = held ? held.text : "";
+    if (frame.offset > have.length)
+        return undefined;
+    const fresh = frame.text.slice(have.length - frame.offset);
+    if (fresh.length === 0)
+        return undefined;
+    const grown = { id: frame.itemId, kind: frame.kind, text: have + fresh };
+    const next = held
+        ? items.map((item, at) => (at === index ? grown : item))
+        : [...items, grown];
+    return { items: next, frame: { ...frame, offset: have.length, text: fresh } };
+}
+//# sourceMappingURL=open-turns.js.map

package/dist/open-turns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-turns.js","sourceRoot":"","sources":["../src/open-turns.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,KAA0B,EAC1B,KAA8C;IAE9C,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GACR,KAAK,GAAG,CAAC;YACP,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;YACxB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACjF,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,KAAK,GAAa,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI;QACf,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC;IACtB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;AAChF,CAAC","sourcesContent":["import type { OpenItem } from \"./model.js\";\nimport type { ChatFrame } from \"./protocol.js\";\n\nexport interface AppliedFrame {\n  readonly items: readonly OpenItem[];\n  /** What actually changed: a delta overlapping the text already held is cut to its new part. */\n  readonly frame: Exclude<ChatFrame, { type: \"settled\" }>;\n}\n\n/**\n * Applies a `delta` or `item` frame to one turn's open items. A delta whose text is\n * already held is skipped and one that starts past the end of the text is a gap; both\n * answer `undefined`, and after a gap every later delta is a gap too, so the item waits\n * for its durable twin instead of drawing a hole.\n */\nexport function applyFrame(\n  items: readonly OpenItem[],\n  frame: Exclude<ChatFrame, { type: \"settled\" }>,\n): AppliedFrame | undefined {\n  if (frame.type === \"item\") {\n    const index = items.findIndex((item) => item.id === frame.item.id);\n    const next =\n      index < 0\n        ? [...items, frame.item]\n        : items.map((item, at) => (at === index ? frame.item : item));\n    return { items: next, frame };\n  }\n  const index = items.findIndex((item) => item.id === frame.itemId);\n  const held = index < 0 ? undefined : items[index];\n  if (held && held.kind !== \"reply\" && held.kind !== \"reasoning\") return undefined;\n  const have = held ? held.text : \"\";\n  if (frame.offset > have.length) return undefined;\n  const fresh = frame.text.slice(have.length - frame.offset);\n  if (fresh.length === 0) return undefined;\n  const grown: OpenItem = { id: frame.itemId, kind: frame.kind, text: have + fresh };\n  const next = held\n    ? items.map((item, at) => (at === index ? grown : item))\n    : [...items, grown];\n  return { items: next, frame: { ...frame, offset: have.length, text: fresh } };\n}\n"]}

package/dist/protocol.d.ts

@@ -0,0 +1,69 @@
+import { type ItemId, type ThreadId, type TurnId } from "@parlor/core";
+import type { AgentInfo, OpenItem } from "./model.js";
+export declare const CHAT_CHANNEL = "chat";
+/** The plugin name, so its routes live under `/_parlor/chat/`. */
+export declare const CHAT_PLUGIN = "chat";
+export type StreamingKind = "reply" | "reasoning";
+/**
+ * Server to browser on the `chat` channel; never persisted. `offset` makes a duplicate
+ * delta skippable and a gap detectable, after which the client waits for the durable
+ * item. `settled` drops a turn's open items: durable now, or gone.
+ */
+export type ChatFrame = {
+    readonly type: "delta";
+    readonly threadId: ThreadId;
+    readonly turnId: TurnId;
+    readonly itemId: ItemId;
+    readonly kind: StreamingKind;
+    readonly offset: number;
+    readonly text: string;
+} | {
+    readonly type: "item";
+    readonly threadId: ThreadId;
+    readonly turnId: TurnId;
+    readonly item: Extract<OpenItem, {
+        kind: "tool" | "plan";
+    }>;
+} | {
+    readonly type: "settled";
+    readonly threadId: ThreadId;
+    readonly turnId: TurnId;
+};
+/** Host to server: the same frames minus what the batch's turn implies. Only the server settles. */
+export type HostFrame = ChatFrame extends infer F ? F extends {
+    readonly type: "delta" | "item";
+} ? Omit<F, "threadId" | "turnId"> : never : never;
+/** `POST /_parlor/chat/stream` */
+export interface HostStreamBatch {
+    readonly turnId: TurnId;
+    readonly frames: readonly HostFrame[];
+}
+/**
+ * The versioned contract between an app's backend and Parlor Host: host actions, item
+ * kinds, frames and cursor rules. Bumped on any change an older peer could misread.
+ */
+export declare const HOST_PROTOCOL = 2;
+export interface ProtocolRange {
+    readonly min: number;
+    readonly max: number;
+}
+export interface HostHello {
+    readonly protocols: ProtocolRange;
+    readonly hostVersion: string;
+    readonly name: string;
+    readonly platform: string;
+    readonly agents: readonly AgentInfo[];
+}
+export type HostWelcome = {
+    readonly accepted: true;
+    readonly protocol: number;
+    readonly leaseMs: number;
+    readonly heartbeatMs: number;
+    readonly userActivity?: true;
+} | {
+    readonly accepted: false;
+    readonly reason: "host_too_old" | "app_too_old";
+    readonly protocols: ProtocolRange;
+};
+export declare function parseChatFrame(data: string): ChatFrame | undefined;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,MAAM,EACZ,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,YAAY,SAAS,CAAC;AACnC,kEAAkE;AAClE,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,WAAW,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,oGAAoG;AACpG,MAAM,MAAM,SAAS,GAAG,SAAS,SAAS,MAAM,CAAC,GAC7C,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,GAC3C,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC,GAC9B,KAAK,GACP,KAAK,CAAC;AAEV,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC,CAAC;AAwCN,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CA8BlE"}

package/dist/protocol.js

@@ -0,0 +1,80 @@
+import { asId, } from "@parlor/core";
+export const CHAT_CHANNEL = "chat";
+/** The plugin name, so its routes live under `/_parlor/chat/`. */
+export const CHAT_PLUGIN = "chat";
+/**
+ * The versioned contract between an app's backend and Parlor Host: host actions, item
+ * kinds, frames and cursor rules. Bumped on any change an older peer could misread.
+ */
+export const HOST_PROTOCOL = 2;
+function isFields(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function oneOf(values, value) {
+    return values.find((candidate) => candidate === value);
+}
+function idOf(kind, value) {
+    return typeof value === "string" && value.length > 0 ? asId(kind, value) : undefined;
+}
+function openItemOf(value) {
+    if (!isFields(value))
+        return undefined;
+    const id = idOf("item", value.id);
+    if (!id)
+        return undefined;
+    if (value.kind === "tool") {
+        const status = oneOf(["pending", "running"], value.status);
+        if (typeof value.title !== "string" || !status)
+            return undefined;
+        return { id, kind: "tool", title: value.title, status };
+    }
+    if (value.kind === "plan" && Array.isArray(value.entries)) {
+        const entries = [];
+        for (const entry of value.entries) {
+            if (!isFields(entry) || typeof entry.content !== "string")
+                return undefined;
+            const status = oneOf(["pending", "in_progress", "completed"], entry.status);
+            if (!status)
+                return undefined;
+            entries.push({ content: entry.content, status });
+        }
+        return { id, kind: "plan", entries };
+    }
+    return undefined;
+}
+export function parseChatFrame(data) {
+    let value;
+    try {
+        value = JSON.parse(data);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isFields(value))
+        return undefined;
+    const threadId = idOf("thread", value.threadId);
+    const turnId = idOf("turn", value.turnId);
+    if (!threadId || !turnId)
+        return undefined;
+    switch (value.type) {
+        case "settled":
+            return { type: "settled", threadId, turnId };
+        case "item": {
+            const item = openItemOf(value.item);
+            return item ? { type: "item", threadId, turnId, item } : undefined;
+        }
+        case "delta": {
+            const itemId = idOf("item", value.itemId);
+            const kind = oneOf(["reply", "reasoning"], value.kind);
+            const { offset, text } = value;
+            if (!itemId || !kind || typeof text !== "string")
+                return undefined;
+            if (typeof offset !== "number" || !Number.isInteger(offset) || offset < 0)
+                return undefined;
+            return { type: "delta", threadId, turnId, itemId, kind, offset, text };
+        }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  asId,\n  type Id,\n  type IdKind,\n  type ItemId,\n  type ThreadId,\n  type TurnId,\n} from \"@parlor/core\";\n\nimport type { ChatItemBody } from \"./items.js\";\nimport type { AgentInfo, OpenItem } from \"./model.js\";\n\nexport const CHAT_CHANNEL = \"chat\";\n/** The plugin name, so its routes live under `/_parlor/chat/`. */\nexport const CHAT_PLUGIN = \"chat\";\n\nexport type StreamingKind = \"reply\" | \"reasoning\";\n\n/**\n * Server to browser on the `chat` channel; never persisted. `offset` makes a duplicate\n * delta skippable and a gap detectable, after which the client waits for the durable\n * item. `settled` drops a turn's open items: durable now, or gone.\n */\nexport type ChatFrame =\n  | {\n      readonly type: \"delta\";\n      readonly threadId: ThreadId;\n      readonly turnId: TurnId;\n      readonly itemId: ItemId;\n      readonly kind: StreamingKind;\n      readonly offset: number;\n      readonly text: string;\n    }\n  | {\n      readonly type: \"item\";\n      readonly threadId: ThreadId;\n      readonly turnId: TurnId;\n      readonly item: Extract<OpenItem, { kind: \"tool\" | \"plan\" }>;\n    }\n  | { readonly type: \"settled\"; readonly threadId: ThreadId; readonly turnId: TurnId };\n\n/** Host to server: the same frames minus what the batch's turn implies. Only the server settles. */\nexport type HostFrame = ChatFrame extends infer F\n  ? F extends { readonly type: \"delta\" | \"item\" }\n    ? Omit<F, \"threadId\" | \"turnId\">\n    : never\n  : never;\n\n/** `POST /_parlor/chat/stream` */\nexport interface HostStreamBatch {\n  readonly turnId: TurnId;\n  readonly frames: readonly HostFrame[];\n}\n\n/**\n * The versioned contract between an app's backend and Parlor Host: host actions, item\n * kinds, frames and cursor rules. Bumped on any change an older peer could misread.\n */\nexport const HOST_PROTOCOL = 2;\n\nexport interface ProtocolRange {\n  readonly min: number;\n  readonly max: number;\n}\n\nexport interface HostHello {\n  readonly protocols: ProtocolRange;\n  readonly hostVersion: string;\n  readonly name: string;\n  readonly platform: string;\n  readonly agents: readonly AgentInfo[];\n}\n\nexport type HostWelcome =\n  | {\n      readonly accepted: true;\n      readonly protocol: number;\n      readonly leaseMs: number;\n      readonly heartbeatMs: number;\n      readonly userActivity?: true;\n    }\n  | {\n      readonly accepted: false;\n      readonly reason: \"host_too_old\" | \"app_too_old\";\n      readonly protocols: ProtocolRange;\n    };\n\ntype Fields = Readonly<Record<string, unknown>>;\n\nfunction isFields(value: unknown): value is Fields {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction oneOf<T extends string>(values: readonly T[], value: unknown): T | undefined {\n  return values.find((candidate) => candidate === value);\n}\n\nfunction idOf<K extends IdKind>(kind: K, value: unknown): Id<K> | undefined {\n  return typeof value === \"string\" && value.length > 0 ? asId(kind, value) : undefined;\n}\n\nfunction openItemOf(\n  value: unknown,\n): Extract<OpenItem, { kind: \"tool\" | \"plan\" }> | undefined {\n  if (!isFields(value)) return undefined;\n  const id = idOf(\"item\", value.id);\n  if (!id) return undefined;\n  if (value.kind === \"tool\") {\n    const status = oneOf([\"pending\", \"running\"], value.status);\n    if (typeof value.title !== \"string\" || !status) return undefined;\n    return { id, kind: \"tool\", title: value.title, status };\n  }\n  if (value.kind === \"plan\" && Array.isArray(value.entries)) {\n    const entries: ChatItemBody<\"plan\">[\"entries\"][number][] = [];\n    for (const entry of value.entries as unknown[]) {\n      if (!isFields(entry) || typeof entry.content !== \"string\") return undefined;\n      const status = oneOf([\"pending\", \"in_progress\", \"completed\"], entry.status);\n      if (!status) return undefined;\n      entries.push({ content: entry.content, status });\n    }\n    return { id, kind: \"plan\", entries };\n  }\n  return undefined;\n}\n\nexport function parseChatFrame(data: string): ChatFrame | undefined {\n  let value: unknown;\n  try {\n    value = JSON.parse(data);\n  } catch {\n    return undefined;\n  }\n  if (!isFields(value)) return undefined;\n  const threadId = idOf(\"thread\", value.threadId);\n  const turnId = idOf(\"turn\", value.turnId);\n  if (!threadId || !turnId) return undefined;\n  switch (value.type) {\n    case \"settled\":\n      return { type: \"settled\", threadId, turnId };\n    case \"item\": {\n      const item = openItemOf(value.item);\n      return item ? { type: \"item\", threadId, turnId, item } : undefined;\n    }\n    case \"delta\": {\n      const itemId = idOf(\"item\", value.itemId);\n      const kind = oneOf([\"reply\", \"reasoning\"], value.kind);\n      const { offset, text } = value;\n      if (!itemId || !kind || typeof text !== \"string\") return undefined;\n      if (typeof offset !== \"number\" || !Number.isInteger(offset) || offset < 0)\n        return undefined;\n      return { type: \"delta\", threadId, turnId, itemId, kind, offset, text };\n    }\n    default:\n      return undefined;\n  }\n}\n"]}