@parlor/chat 0.0.0-stage → 0.1.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":""}

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"}

package/dist/protocol.d.ts

@@ -0,0 +1,67 @@
+import { type ItemId, type ThreadId, type TurnId } from "@parlor/core";
+import type { AgentInfo, OpenItem } from "./model.js";
+export declare const CHAT_CHANNEL = "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;AAEnC,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,78 @@
+import { asId, } from "@parlor/core";
+export const CHAT_CHANNEL = "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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"}