@parlor/chat 0.0.0-stage → 0.1.0

package/dist/server/index.js

@@ -0,0 +1,129 @@
+import { userAudience } from "@parlor/agent-ui/server";
+import { REVOCATION_HORIZON_MS } from "@parlor/server";
+import { CHAT_TAG, chatActions, HOSTS_TAG } from "./actions.js";
+import { inProcessRelay } from "./live.js";
+import { CHAT_MIGRATIONS } from "./migrations.js";
+import { chatRoutes } from "./routes.js";
+import { sqlChatStore } from "./store.js";
+export { CHAT_ACTIVITY_TAG, CHAT_TAG, chatActions, HOST_GRANTS_TAG, hostChatActions, HOSTS_TAG, userChatActions, } from "./actions.js";
+export { TRANSCRIPT_BUDGET_BYTES, turnContext, } from "./context.js";
+export { chatItemBodies, hostItemDraft } from "../items.js";
+export { idSchema } from "../id-schemas.js";
+export { inProcessRelay, MAX_OPEN_BYTES_PER_TURN, MAX_OPEN_TURNS, } from "./live.js";
+export { CHAT_MIGRATIONS } from "./migrations.js";
+export { chatAction, } from "./party.js";
+export { chatRoutes, MAX_STREAM_BODY_BYTES } from "./routes.js";
+export { sqlChatStore, } from "./store.js";
+export const CHAT_PLUGIN = "chat";
+/** Chat then serves nothing, so the client reads `useChat().status` as `unavailable`. */
+export const UNAVAILABLE_WITHOUT_AUTH = "chat() is unavailable: no auth provider is configured, so every action runs without a signed-in user.";
+export const AUTH_UNDEFINED = "auth is undefined. Check the environment variables your auth setup reads, or remove the auth option to run without sign-in.";
+/** Outlives a 30 s network drop plus a 5 s reconnect. */
+export const DEFAULT_LEASE_MS = 60_000;
+export const DEFAULT_HEARTBEAT_MS = 30_000;
+export const DEFAULT_MAX_QUEUED = 4;
+/** A lease past the revocation memory would outlive the revocation of its grant. */
+export const MAX_LEASE_MS = REVOCATION_HORIZON_MS;
+function positiveInteger(name, value) {
+    if (!Number.isInteger(value) || value < 1) {
+        throw new Error(`chat(): ${name} must be a positive whole number, got ${value}.`);
+    }
+    return value;
+}
+/**
+ * The inline agent's server half: the `parlor_chat_*` log, the user and host actions, the
+ * `chat` channel, and the host-only stream and heartbeat routes.
+ */
+export function chat(options = {}) {
+    return {
+        name: CHAT_PLUGIN,
+        migrations: CHAT_MIGRATIONS,
+        setup(host) {
+            const leaseMs = positiveInteger("leaseMs", options.leaseMs ?? DEFAULT_LEASE_MS);
+            const maxQueued = positiveInteger("maxQueued", options.maxQueued ?? DEFAULT_MAX_QUEUED);
+            if (leaseMs > MAX_LEASE_MS) {
+                throw new Error(`chat(): leaseMs ${leaseMs} is above ${MAX_LEASE_MS}, the longest a revoked computer's turn token can be kept out.`);
+            }
+            const { auth, database } = host;
+            if (!database)
+                throw new Error("chat() needs a database.");
+            if (!auth?.delegate) {
+                if (host.authMisconfigured)
+                    throw new Error(AUTH_UNDEFINED);
+                console.warn(UNAVAILABLE_WITHOUT_AUTH);
+                return {};
+            }
+            const relay = (options.relay ?? inProcessRelay)();
+            const db = () => database.read();
+            const ownStream = (owner) => userAudience(owner.scope, owner.userId);
+            const transact = (owner, work) => database.transaction(async (tx) => {
+                const { result, threadId } = await work(tx);
+                if (threadId !== undefined)
+                    await host.announce(ownStream(owner), [[CHAT_TAG, threadId]], tx);
+                return result;
+            });
+            const heartbeatMs = DEFAULT_HEARTBEAT_MS;
+            const reconcile = async (owner) => {
+                if (!(await sqlChatStore.hasLapsed(db(), owner)))
+                    return;
+                await database.transaction(async (tx) => {
+                    for (const change of await sqlChatStore.expireLapsed(tx, owner)) {
+                        const tags = [
+                            ...change.threads.map((threadId) => [CHAT_TAG, threadId]),
+                            ...change.hosts.map((hostId) => [HOSTS_TAG, hostId]),
+                        ];
+                        await host.announce(ownStream(change), tags, tx);
+                    }
+                });
+            };
+            const pruneHosts = async (owner, hostIds) => {
+                try {
+                    await database.transaction((tx) => sqlChatStore.pruneHosts(tx, owner, hostIds));
+                }
+                catch (error) {
+                    console.warn("[parlor] chat: pruning revoked computers failed:", error);
+                }
+            };
+            const sweep = setInterval(() => {
+                (host.ready?.() ?? Promise.resolve())
+                    .then(() => reconcile())
+                    .catch((error) => {
+                    console.warn("[parlor] chat: sweeping lapsed turns failed:", error);
+                });
+            }, heartbeatMs);
+            sweep.unref();
+            const actions = chatActions({
+                enforcing: auth.enforcing,
+                transact,
+                reconcile,
+                pruneHosts,
+                auth,
+                store: sqlChatStore,
+                relay,
+                leaseMs,
+                heartbeatMs,
+                maxQueued,
+                instructions: options.instructions,
+                appName: process.env.PARLOR_APP_NAME ?? "this app",
+                appOrigin: () => process.env.PARLOR_ORIGIN ?? process.env.PARLOR_WEB_ORIGIN ?? "",
+            });
+            return {
+                actions,
+                routes: chatRoutes({
+                    db,
+                    store: sqlChatStore,
+                    relay,
+                    heartbeatMs,
+                    reconcile,
+                    announceHost: (owner, hostId) => host.announce(ownStream(owner), [[HOSTS_TAG, hostId]]),
+                }),
+                channel: relay.channel,
+                close: () => {
+                    clearInterval(sweep);
+                    relay.close();
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAqB,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EAAE,QAAQ,EAAuB,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,cAAc,EAAkB,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EACL,iBAAiB,EACjB,QAAQ,EAIR,WAAW,EAGX,eAAe,EACf,eAAe,EACf,SAAS,EACT,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,uBAAuB,EACvB,WAAW,GAEZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EACL,cAAc,EAEd,uBAAuB,EACvB,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAEL,UAAU,GAKX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAsB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAKL,YAAY,GAIb,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAElC,yFAAyF;AACzF,MAAM,CAAC,MAAM,wBAAwB,GACnC,uGAAuG,CAAC;AAE1G,MAAM,CAAC,MAAM,cAAc,GACzB,6HAA6H,CAAC;AAEhI,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAWpC,oFAAoF;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAElD,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,yCAAyC,KAAK,GAAG,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,OAAO,GAAgB,EAAE;IAC5C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,eAAe;QAC3B,KAAK,CAAC,IAAI;YACR,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC;YAChF,MAAM,SAAS,GAAG,eAAe,CAC/B,WAAW,EACX,OAAO,CAAC,SAAS,IAAI,kBAAkB,CACxC,CAAC;YACF,IAAI,OAAO,GAAG,YAAY,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,mBAAmB,OAAO,aAAa,YAAY,gEAAgE,CACpH,CAAC;YACJ,CAAC;YACD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;YAChC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC3D,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;gBACpB,IAAI,IAAI,CAAC,iBAAiB;oBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;gBAC5D,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;gBACvC,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC,EAAE,CAAC;YAClD,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAY,CAAC;YAC3C,MAAM,SAAS,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAChF,MAAM,QAAQ,GAA+B,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAC3D,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;gBAChC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,EAAY,CAAC,CAAC;gBACtD,IAAI,QAAQ,KAAK,SAAS;oBACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpE,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC,CAAC;YACL,MAAM,WAAW,GAAG,oBAAoB,CAAC;YACzC,MAAM,SAAS,GAAG,KAAK,EAAE,KAAiB,EAAE,EAAE;gBAC5C,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;oBAAE,OAAO;gBACzD,MAAM,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;oBACtC,KAAK,MAAM,MAAM,IAAI,MAAM,YAAY,CAAC,YAAY,CAAC,EAAY,EAAE,KAAK,CAAC,EAAE,CAAC;wBAC1E,MAAM,IAAI,GAAU;4BAClB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;4BACzD,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;yBACrD,CAAC;wBACF,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;oBACnD,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;YACF,MAAM,UAAU,GAAiC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBACxE,IAAI,CAAC;oBACH,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAChC,YAAY,CAAC,UAAU,CAAC,EAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CACtD,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBAC7B,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;qBAClC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;qBACvB,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;oBACxB,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAK,CAAC,CAAC;gBACtE,CAAC,CAAC,CAAC;YACP,CAAC,EAAE,WAAW,CAAC,CAAC;YAChB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,WAAW,CAAC;gBAC1B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ;gBACR,SAAS;gBACT,UAAU;gBACV,IAAI;gBACJ,KAAK,EAAE,YAAY;gBACnB,KAAK;gBACL,OAAO;gBACP,WAAW;gBACX,SAAS;gBACT,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,UAAU;gBAClD,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;aAClF,CAAC,CAAC;YACH,OAAO;gBACL,OAAO;gBACP,MAAM,EAAE,UAAU,CAAC;oBACjB,EAAE;oBACF,KAAK,EAAE,YAAY;oBACnB,KAAK;oBACL,WAAW;oBACX,SAAS;oBACT,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAC9B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;iBACzD,CAAC;gBACF,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,GAAG,EAAE;oBACV,aAAa,CAAC,KAAK,CAAC,CAAC;oBACrB,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/live.d.ts

@@ -0,0 +1,24 @@
+import { type ThreadId, type TurnId } from "@parlor/core";
+import type { ServerChannel } from "@parlor/sync";
+import type { ChatOwner, OpenTurn } from "../model.js";
+import { type HostStreamBatch } from "../protocol.js";
+import type { TurnHolder } from "./store.js";
+export declare const MAX_OPEN_BYTES_PER_TURN: number;
+export declare const MAX_OPEN_TURNS = 1024;
+/**
+ * The live half of the chat: what is streaming now, carried to the `chat` channel of the
+ * owner's own streams. Nothing here is the truth; drop it and every client still
+ * converges on the log, only without token streaming. So it writes nothing and can be
+ * replaced by a relay that crosses instances.
+ */
+export interface LiveRelay {
+    readonly channel: ServerChannel;
+    /** Applies a batch to the open turn and pushes it; a turn over its byte budget stops streaming. */
+    accept(turn: TurnHolder, batch: HostStreamBatch): void;
+    settle(owner: ChatOwner, threadId: ThreadId, turnId: TurnId): void;
+    open(owner: ChatOwner, threadId: ThreadId): readonly OpenTurn[];
+    close(): void;
+}
+/** The default: one instance, in memory. */
+export declare function inProcessRelay(): LiveRelay;
+//# sourceMappingURL=live.d.ts.map

package/dist/server/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/server/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,MAAM,EAGZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAqB,aAAa,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,KAAK,EAAE,SAAS,EAAY,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAgC,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAClD,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,mGAAmG;IACnG,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,QAAQ,EAAE,CAAC;IAChE,KAAK,IAAI,IAAI,CAAC;CACf;AAuBD,4CAA4C;AAC5C,wBAAgB,cAAc,IAAI,SAAS,CA8G1C"}

package/dist/server/live.js

@@ -0,0 +1,130 @@
+import { DEV_USER_ID, userOf, } from "@parlor/core";
+import { applyFrame } from "../open-turns.js";
+import { CHAT_CHANNEL } from "../protocol.js";
+export const MAX_OPEN_BYTES_PER_TURN = 256 * 1024;
+export const MAX_OPEN_TURNS = 1024;
+const SETTLED_MEMORY = 4 * MAX_OPEN_TURNS;
+const encoder = new TextEncoder();
+function ownerKey(scope, userId) {
+    return `${scope}\u001f${userId ?? DEV_USER_ID}`;
+}
+function sizeOf(frame) {
+    return frame.type === "delta"
+        ? encoder.encode(frame.text).length
+        : encoder.encode(JSON.stringify(frame.item)).length;
+}
+/** The default: one instance, in memory. */
+export function inProcessRelay() {
+    const connections = new Map();
+    const turns = new Map();
+    const settled = new Set();
+    let closed = false;
+    const push = (owner, frame) => {
+        const audience = connections.get(ownerKey(owner.scope, owner.userId));
+        if (!audience || audience.size === 0)
+            return;
+        const data = JSON.stringify(frame);
+        for (const connection of audience) {
+            try {
+                connection.send(data);
+            }
+            catch {
+                audience.delete(connection);
+            }
+        }
+    };
+    const channel = {
+        event: CHAT_CHANNEL,
+        connect(connection) {
+            if (closed || connection.closed?.aborted)
+                return () => { };
+            const key = ownerKey(connection.scope, userOf(connection.principal));
+            let audience = connections.get(key);
+            if (!audience) {
+                audience = new Set();
+                connections.set(key, audience);
+            }
+            audience.add(connection);
+            const detach = () => {
+                const current = connections.get(key);
+                current?.delete(connection);
+                if (current?.size === 0)
+                    connections.delete(key);
+                connection.closed?.removeEventListener("abort", detach);
+            };
+            connection.closed?.addEventListener("abort", detach, { once: true });
+            return detach;
+        },
+    };
+    const forget = (turnId) => {
+        turns.delete(turnId);
+        settled.add(turnId);
+        if (settled.size > SETTLED_MEMORY) {
+            const oldest = settled.values().next();
+            if (!oldest.done)
+                settled.delete(oldest.value);
+        }
+    };
+    return {
+        channel,
+        accept(holder, batch) {
+            if (closed || settled.has(batch.turnId))
+                return;
+            let state = turns.get(batch.turnId);
+            if (!state) {
+                if (turns.size >= MAX_OPEN_TURNS) {
+                    const oldest = turns.keys().next();
+                    if (!oldest.done)
+                        turns.delete(oldest.value);
+                }
+                state = {
+                    owner: holder.owner,
+                    threadId: holder.threadId,
+                    items: [],
+                    bytes: 0,
+                    overBudget: false,
+                };
+                turns.set(batch.turnId, state);
+            }
+            for (const hostFrame of batch.frames) {
+                const frame = {
+                    ...hostFrame,
+                    threadId: state.threadId,
+                    turnId: batch.turnId,
+                };
+                const cost = sizeOf(frame);
+                if (state.overBudget || state.bytes + cost > MAX_OPEN_BYTES_PER_TURN) {
+                    state.overBudget = true;
+                    break;
+                }
+                const applied = applyFrame(state.items, frame);
+                if (!applied)
+                    continue;
+                state.items = applied.items;
+                state.bytes += cost;
+                push(state.owner, applied.frame);
+            }
+        },
+        settle(owner, threadId, turnId) {
+            forget(turnId);
+            push(owner, { type: "settled", threadId, turnId });
+        },
+        open(owner, threadId) {
+            const open = [];
+            for (const [turnId, state] of turns) {
+                if (state.threadId === threadId &&
+                    state.owner.scope === owner.scope &&
+                    state.owner.userId === owner.userId) {
+                    open.push({ turnId, threadId, items: state.items });
+                }
+            }
+            return open;
+        },
+        close() {
+            closed = true;
+            connections.clear();
+            turns.clear();
+        },
+    };
+}
+//# sourceMappingURL=live.js.map

package/dist/server/live.js.map

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

package/dist/server/migrations.d.ts

@@ -0,0 +1,3 @@
+import type { Migration } from "@parlor/server";
+export declare const CHAT_MIGRATIONS: readonly Migration[];
+//# sourceMappingURL=migrations.d.ts.map

package/dist/server/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/server/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,eAAO,MAAM,eAAe,EAAE,SAAS,SAAS,EA8F/C,CAAC"}

package/dist/server/migrations.js

@@ -0,0 +1,96 @@
+export const CHAT_MIGRATIONS = [
+    {
+        id: "chat/0001_threads",
+        sql: `
+      create table parlor_chat_threads (
+        id text primary key,
+        scope text not null,
+        owner_id text not null,
+        title text not null default '',
+        host_id text,
+        agent_id text,
+        last_seq bigint not null default 0,
+        created_at timestamptz not null default now(),
+        updated_at timestamptz not null default now()
+      );
+      create index parlor_chat_threads_owner
+        on parlor_chat_threads (owner_id, scope, updated_at desc);
+
+      create table parlor_chat_items (
+        id text primary key,
+        thread_id text not null references parlor_chat_threads (id) on delete cascade,
+        turn_id text not null,
+        seq bigint not null,
+        author text not null check (author in ('user', 'agent', 'system')),
+        kind text not null,
+        body jsonb not null,
+        created_at timestamptz not null default now(),
+        unique (thread_id, seq)
+      );
+      create unique index parlor_chat_items_one_answer
+        on parlor_chat_items (thread_id, (body->>'askId')) where kind = 'answer';
+
+      create table parlor_chat_turns (
+        id text primary key,
+        thread_id text not null references parlor_chat_threads (id) on delete cascade,
+        scope text not null,
+        owner_id text not null,
+        host_id text not null,
+        agent_id text not null,
+        client_id text not null,
+        device_id text,
+        prompt_item_id text not null,
+        state text not null
+          check (state in ('queued', 'running', 'done', 'failed', 'cancelled')),
+        lease_until timestamptz,
+        outcome jsonb,
+        created_at timestamptz not null default now(),
+        finished_at timestamptz
+      );
+      create index parlor_chat_turns_queue
+        on parlor_chat_turns (host_id, state, created_at) where state = 'queued';
+      create unique index parlor_chat_turns_one_running
+        on parlor_chat_turns (thread_id) where state = 'running';
+      create index parlor_chat_turns_thread_state on parlor_chat_turns (thread_id, state);
+      create index parlor_chat_turns_lease
+        on parlor_chat_turns (lease_until) where state = 'running';
+
+      create index parlor_chat_items_signals
+        on parlor_chat_items (turn_id, seq) where kind in ('answer', 'cancel');
+
+      create table parlor_chat_hosts (
+        id text primary key,
+        scope text not null,
+        owner_id text not null,
+        grant_id text not null,
+        protocol integer not null,
+        name text not null,
+        platform text not null,
+        agents jsonb not null,
+        online_until timestamptz not null,
+        announced_online boolean not null
+      );
+      create index parlor_chat_hosts_owner on parlor_chat_hosts (owner_id, scope);
+      create index parlor_chat_hosts_lapse
+        on parlor_chat_hosts (online_until) where announced_online;`,
+    },
+    {
+        id: "chat/0002_answer_retry",
+        sql: `
+      drop index parlor_chat_items_one_answer;
+      create index parlor_chat_items_answers
+        on parlor_chat_items (thread_id, (body->>'askId')) where kind = 'answer';
+      create index parlor_chat_items_rejections
+        on parlor_chat_items (thread_id, (body->>'itemId'))
+        where kind = 'event' and body->>'event' = 'answer_rejected';`,
+    },
+    {
+        id: "chat/0003_host_devices",
+        sql: `alter table parlor_chat_hosts add column devices jsonb;`,
+    },
+    {
+        id: "chat/0004_host_presence",
+        sql: `alter table parlor_chat_hosts add column presence_due jsonb;`,
+    },
+];
+//# sourceMappingURL=migrations.js.map

package/dist/server/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/server/migrations.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD;QACE,EAAE,EAAE,mBAAmB;QACvB,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAuE2D;KACjE;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,GAAG,EAAE;;;;;;qEAM4D;KAClE;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,GAAG,EAAE,yDAAyD;KAC/D;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,GAAG,EAAE,8DAA8D;KACpE;CACF,CAAC"}

package/dist/server/party.d.ts

@@ -0,0 +1,24 @@
+import { type ActionConfig, type ActionContext, type ActionDefinition, type DeviceId, type HostPrincipal, type Principal } from "@parlor/core";
+import type { z } from "zod";
+import type { ChatOwner } from "../model.js";
+export type Party = "user" | "host";
+export interface ChatUser extends ChatOwner {
+    readonly deviceId: DeviceId | undefined;
+}
+/** A host and the owner whose rows it may touch: its own user. */
+export interface ChatHost extends ChatOwner {
+    readonly host: HostPrincipal;
+}
+export type PartyOf<P extends Party> = P extends "user" ? ChatUser : ChatHost;
+export interface ChatActionConfig<P extends Party, I extends z.ZodType, O> extends Omit<ActionConfig<I, O>, "run" | "confirm" | "public"> {
+    run(input: z.output<I>, party: PartyOf<P>, ctx: ActionContext): Promise<O> | O;
+}
+/**
+ * An action only `party` may call, checked once before `run`: a user action takes a
+ * signed-in user, or without an enforcing provider an anonymous caller as `DEV_USER_ID`;
+ * a host action takes only a host. Everything else is `forbidden`, so no body checks the
+ * principal itself.
+ */
+export declare function chatAction<P extends Party, I extends z.ZodType, O>(party: P, enforcing: boolean, config: ChatActionConfig<P, I, O>): ActionDefinition<I, O>;
+export declare function partyOf<P extends Party>(party: P, principal: Principal, scope: string, enforcing: boolean): PartyOf<P>;
+//# sourceMappingURL=party.d.ts.map

package/dist/server/party.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"party.d.ts","sourceRoot":"","sources":["../../src/server/party.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAErB,KAAK,QAAQ,EAEb,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;CACzC;AAED,kEAAkE;AAClE,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAE,SAAQ,IAAI,CACrF,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,KAAK,GAAG,SAAS,GAAG,QAAQ,CAC7B;IACC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAChF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAChE,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAChC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAQxB;AAgCD,wBAAgB,OAAO,CAAC,CAAC,SAAS,KAAK,EACrC,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/server/party.js

@@ -0,0 +1,38 @@
+import { ActionError, defineAction, DEV_USER_ID, } from "@parlor/core";
+/**
+ * An action only `party` may call, checked once before `run`: a user action takes a
+ * signed-in user, or without an enforcing provider an anonymous caller as `DEV_USER_ID`;
+ * a host action takes only a host. Everything else is `forbidden`, so no body checks the
+ * principal itself.
+ */
+export function chatAction(party, enforcing, config) {
+    const { run, ...rest } = config;
+    return defineAction({
+        notifies: "user",
+        ...rest,
+        run: (input, ctx) => run(input, partyOf(party, ctx.principal, ctx.scope, enforcing), ctx),
+    });
+}
+const resolvers = {
+    host: (principal, scope) => {
+        if (principal.kind !== "host") {
+            throw new ActionError("forbidden", "Only a connected computer can call this.");
+        }
+        return { scope, userId: principal.userId, host: principal };
+    },
+    user: (principal, scope, enforcing) => {
+        if (principal.kind === "user") {
+            return { scope, userId: principal.userId, deviceId: principal.deviceId };
+        }
+        if (principal.kind === "anonymous") {
+            if (enforcing)
+                throw new ActionError("unauthenticated", "Sign in first.");
+            return { scope, userId: DEV_USER_ID, deviceId: undefined };
+        }
+        throw new ActionError("forbidden", `A ${principal.kind} principal cannot use the chat.`);
+    },
+};
+export function partyOf(party, principal, scope, enforcing) {
+    return resolvers[party](principal, scope, enforcing);
+}
+//# sourceMappingURL=party.js.map

package/dist/server/party.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"party.js","sourceRoot":"","sources":["../../src/server/party.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAIX,YAAY,EAEZ,WAAW,GAGZ,MAAM,cAAc,CAAC;AAyBtB;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,KAAQ,EACR,SAAkB,EAClB,MAAiC;IAEjC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAChC,OAAO,YAAY,CAAO;QACxB,QAAQ,EAAE,MAAM;QAChB,GAAG,IAAI;QACP,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAClB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC;KACvE,CAAC,CAAC;AACL,CAAC;AAUD,MAAM,SAAS,GAAmB;IAChC,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;QACzB,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,0CAA0C,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;QACpC,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC3E,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACnC,IAAI,SAAS;gBAAE,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;YAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QAC7D,CAAC;QACD,MAAM,IAAI,WAAW,CACnB,WAAW,EACX,KAAK,SAAS,CAAC,IAAI,iCAAiC,CACrD,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,OAAO,CACrB,KAAQ,EACR,SAAoB,EACpB,KAAa,EACb,SAAkB;IAElB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC"}

package/dist/server/routes.d.ts

@@ -0,0 +1,17 @@
+import { type HostId } from "@parlor/core";
+import { type AnyPluginRoute } from "@parlor/server";
+import type { ChatOwner } from "../model.js";
+import type { LiveRelay } from "./live.js";
+import type { ChatDb, ChatStore } from "./store.js";
+export declare const MAX_STREAM_BODY_BYTES: number;
+export interface ChatRouteDeps {
+    readonly db: () => ChatDb;
+    readonly store: ChatStore;
+    readonly relay: LiveRelay;
+    readonly heartbeatMs: number;
+    readonly reconcile: (owner: ChatOwner) => Promise<void>;
+    readonly announceHost: (owner: ChatOwner, hostId: HostId) => Promise<void>;
+}
+/** Plain routes only a host principal reaches, by type: no browser session, no agent token. */
+export declare function chatRoutes(deps: ChatRouteDeps): readonly AnyPluginRoute[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/server/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,KAAK,cAAc,EAAgC,MAAM,gBAAgB,CAAC;AAInF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAG/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAmDD,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,cAAc,EAAE,CAmDzE"}

package/dist/server/routes.js

@@ -0,0 +1,105 @@
+import { ActionError } from "@parlor/core";
+import { pluginRoute, readBoundedText } from "@parlor/server";
+import { z } from "zod";
+import { idSchema } from "../id-schemas.js";
+export const MAX_STREAM_BODY_BYTES = 64 * 1024;
+const MAX_FRAMES_PER_BATCH = 512;
+const streamBatch = z.object({
+    turnId: idSchema("turn"),
+    frames: z
+        .array(z.discriminatedUnion("type", [
+        z.object({
+            type: z.literal("delta"),
+            itemId: idSchema("item"),
+            kind: z.enum(["reply", "reasoning"]),
+            offset: z.number().int().min(0),
+            text: z.string(),
+        }),
+        z.object({
+            type: z.literal("item"),
+            item: z.discriminatedUnion("kind", [
+                z.object({
+                    id: idSchema("item"),
+                    kind: z.literal("tool"),
+                    title: z.string(),
+                    status: z.enum(["pending", "running"]),
+                }),
+                z.object({
+                    id: idSchema("item"),
+                    kind: z.literal("plan"),
+                    entries: z.array(z.object({
+                        content: z.string(),
+                        status: z.enum(["pending", "in_progress", "completed"]),
+                    })),
+                }),
+            ]),
+        }),
+    ]))
+        .max(MAX_FRAMES_PER_BATCH),
+});
+const tooLarge = () => Response.json({
+    error: {
+        code: "invalid_input",
+        message: `A stream batch is at most ${MAX_STREAM_BODY_BYTES} bytes.`,
+    },
+}, { status: 413 });
+/** Plain routes only a host principal reaches, by type: no browser session, no agent token. */
+export function chatRoutes(deps) {
+    return [
+        pluginRoute({
+            method: "POST",
+            path: "/stream",
+            access: ["host"],
+            handle: async (request, caller) => {
+                const text = await readBoundedText(request, MAX_STREAM_BODY_BYTES);
+                if (text === undefined)
+                    return tooLarge();
+                const parsed = streamBatch.safeParse(parseJson(text));
+                if (!parsed.success) {
+                    throw new ActionError("invalid_input", "Not a stream batch", {
+                        issues: parsed.error.issues,
+                    });
+                }
+                const batch = parsed.data;
+                const holder = await deps.store.turnHolder(deps.db(), batch.turnId);
+                const { principal } = caller;
+                const owns = holder !== undefined &&
+                    holder.hostId === principal.hostId &&
+                    holder.owner.userId === principal.userId &&
+                    holder.owner.scope === caller.scope;
+                if (!owns)
+                    throw new ActionError("forbidden", "This turn is not yours.");
+                const { live, ...heldBy } = holder;
+                if (!live)
+                    throw new ActionError("forbidden", "The turn is not running.");
+                deps.relay.accept(heldBy, batch);
+                return new Response(null, { status: 204 });
+            },
+        }),
+        pluginRoute({
+            method: "POST",
+            path: "/heartbeat",
+            access: ["host"],
+            handle: async (_request, caller) => {
+                const { principal } = caller;
+                const owner = { scope: caller.scope, userId: principal.userId };
+                const { returned } = await deps.store.heartbeat(deps.db(), owner, principal, 2 * deps.heartbeatMs);
+                if (returned)
+                    await deps.announceHost(owner, principal.hostId);
+                await deps.reconcile(owner).catch((error) => {
+                    console.warn("[parlor] chat: reconciling lapsed turns failed:", error);
+                });
+                return new Response(null, { status: 204 });
+            },
+        }),
+    ];
+}
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new ActionError("invalid_input", "Request body must be JSON");
+    }
+}
+//# sourceMappingURL=routes.js.map

package/dist/server/routes.js.map

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