@oharness/server 0.9.2 → 0.10.0

package/dist/starters.d.ts

@@ -0,0 +1,92 @@
+import type { MemoryEntry } from "@oharness/engine/agent/memory.ts";
+import type { Harness } from "@oharness/engine/harness.ts";
+/**
+ * The offers under "What should I work on?".
+ *
+ * A project the agent has never worked in gets the same rotating set, and
+ * they are about the user's day rather than the directory: an empty folder has
+ * no code to profile and no README to fix, and guessing at one teaches a new
+ * person that this is a code tool and nothing else.
+ *
+ * Once there is history, the offers are written from it: what the recent
+ * conversations in this project were about, plus the project's notes when it
+ * has any. Conversations come first because nearly every project has them —
+ * notes mostly go to the user's own memory, not the project's, so a starter
+ * that waited for project notes was one most people never saw. Only titles and
+ * the opening request of each are read, never the whole transcript, and both
+ * pass through the same secret redaction memory uses.
+ */
+export interface Starter {
+    /** What fits on the chip. */
+    label: string;
+    /** The sentence the chip sends. */
+    prompt: string;
+}
+/** `pending`: a set is being written for this project, and will be pushed when it lands. */
+export type StarterReply = {
+    kind: "fixed";
+    pending?: boolean;
+} | {
+    kind: "written";
+    starters: Starter[];
+};
+/** One recent conversation, as the prompt sees it. */
+export interface SessionDigest {
+    id: string;
+    title?: string;
+    /** What the user asked first, cut short and redacted. */
+    ask?: string;
+    updatedAt: number;
+}
+/** What the starters are written from. */
+export interface ProjectContext {
+    sessions: SessionDigest[];
+    notes: MemoryEntry[];
+}
+/** Ids under "starter.<id>" in i18n: the rotating offers for a project with no memory. */
+export declare const FIXED_STARTERS: readonly ["trip", "email", "research", "savings", "japanTrip"];
+export declare const STARTERS_PROMPT = "You suggest what a user could ask an AI agent to do next in one of their projects. You are given what they have recently asked the agent in this project, and the agent's notes about it when there are any.\n\nWrite exactly three suggestions. Each one:\n- is grounded in what the user has actually been doing here \u2014 a thread they started and did not finish, a natural next step after something they did, a recurring chore \u2014 never invented;\n- is specific: name the file, app, document, topic or decision it is about;\n- differs in kind from the other two (for example: continue or fix something, check or measure something, write or plan something);\n- has a \"label\": an imperative phrase under 60 characters that fits on a button;\n- has a \"prompt\": one to three sentences the agent receives, saying what to do and what to hand back.\n\nDo not simply repeat a request the user already made; offer the step after it. Skip anything that looks finished. Never include secrets, keys or personal data.\nReply with only a JSON array: [{\"label\": \"...\", \"prompt\": \"...\"}, ...]";
+/** Recent conversations as the prompt shows them: newest first, each short. */
+export declare function sessionsText(sessions: readonly SessionDigest[]): string;
+/** The notes as the prompt shows them: newest first, each cut short, the whole bounded. */
+export declare function notesText(notes: readonly MemoryEntry[], budget?: number): string;
+export declare function startersRequest(context: ProjectContext, locale: string): string;
+/** How long one generation may take before the fixed three are shown instead. */
+export declare const STARTERS_TIMEOUT_MS = 45000;
+/**
+ * The project's recent conversations, digested.
+ *
+ * The open, empty one on screen is not history, and routine runs are the
+ * scheduler talking, not the user. Reading a transcript is the costly part,
+ * so only the dozen most recent are opened, and only their first user turn.
+ */
+export declare function recentSessions(harness: Harness, cwd: string): Promise<SessionDigest[]>;
+/** Three usable starters out of a model reply, or nothing. */
+export declare function parseStarters(reply: string): Starter[] | undefined;
+/**
+ * What a set of starters was written from, in which language.
+ *
+ * A new conversation, a renamed one, or a note edited or added is a project
+ * that has moved on, so the offers are rewritten. A turn inside an existing
+ * conversation is not: keying on its last activity would pay for a new set
+ * every time a message is sent. A restart with the same history pays nothing.
+ */
+export declare function startersKey(context: ProjectContext, locale: string): string;
+/**
+ * The starters for one project, as the page asks for them.
+ *
+ * Never waits on a model. With a set already written for this history it is
+ * returned; otherwise the answer is the fixed three at once, marked pending,
+ * and a set is written in the background — `onReady` is told when it lands,
+ * so the page can swap it in, and the next ask reads it from disk. Writing
+ * one takes a flash model twenty-odd seconds, which no new conversation
+ * should sit through.
+ *
+ * One generation per project and history at a time: the page asks on boot and
+ * on every project switch, and two tabs landing together must not pay twice.
+ */
+export type StartersFor = ((harness: Harness, cwd: string, locale: string, model?: string) => Promise<StarterReply>) & {
+    /** Every generation still running has settled. For tests and shutdown. */
+    idle(): Promise<void>;
+};
+export declare function createStarters(onReady?: (cwd: string, locale: string, starters: Starter[]) => void): StartersFor;

package/dist/starters.js

@@ -0,0 +1,213 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { userPath } from "@oharness/engine/paths.ts";
+import { parseJson } from "@oharness/engine/util/json.ts";
+import { redactSecrets } from "@oharness/engine/agent/memory-redact.ts";
+import { visibleText } from "@oharness/engine/core/types.ts";
+/** Ids under "starter.<id>" in i18n: the rotating offers for a project with no memory. */
+export const FIXED_STARTERS = ["trip", "email", "research", "savings", "japanTrip"];
+const LANGUAGES = { en: "English", zh: "Simplified Chinese" };
+export const STARTERS_PROMPT = `You suggest what a user could ask an AI agent to do next in one of their projects. You are given what they have recently asked the agent in this project, and the agent's notes about it when there are any.
+
+Write exactly three suggestions. Each one:
+- is grounded in what the user has actually been doing here — a thread they started and did not finish, a natural next step after something they did, a recurring chore — never invented;
+- is specific: name the file, app, document, topic or decision it is about;
+- differs in kind from the other two (for example: continue or fix something, check or measure something, write or plan something);
+- has a "label": an imperative phrase under 60 characters that fits on a button;
+- has a "prompt": one to three sentences the agent receives, saying what to do and what to hand back.
+
+Do not simply repeat a request the user already made; offer the step after it. Skip anything that looks finished. Never include secrets, keys or personal data.
+Reply with only a JSON array: [{"label": "...", "prompt": "..."}, ...]`;
+/** Recent conversations as the prompt shows them: newest first, each short. */
+export function sessionsText(sessions) {
+    return [...sessions]
+        .sort((a, b) => b.updatedAt - a.updatedAt)
+        .map((session) => {
+        const lines = [`<session updated="${new Date(session.updatedAt).toISOString().slice(0, 10)}">`];
+        if (session.title)
+            lines.push(`title: ${session.title}`);
+        if (session.ask)
+            lines.push(`first request: ${session.ask}`);
+        lines.push("</session>");
+        return lines.join("\n");
+    })
+        .join("\n\n");
+}
+/** The notes as the prompt shows them: newest first, each cut short, the whole bounded. */
+export function notesText(notes, budget = 12_000) {
+    const sorted = [...notes].sort((a, b) => (b.updatedAt ?? b.createdAt) - (a.updatedAt ?? a.createdAt));
+    const out = [];
+    let used = 0;
+    for (const note of sorted) {
+        const body = note.body.length > 600 ? note.body.slice(0, 600) + "…" : note.body;
+        const block = `<note id="${note.id}"${note.type ? ` type="${note.type}"` : ""}>\n${note.summary}\n\n${body}\n</note>`;
+        if (used + block.length > budget)
+            break;
+        out.push(block);
+        used += block.length;
+    }
+    return out.join("\n\n");
+}
+export function startersRequest(context, locale) {
+    const language = LANGUAGES[locale] ?? LANGUAGES.en;
+    const parts = [];
+    if (context.sessions.length)
+        parts.push(`Recent conversations in this project:\n${sessionsText(context.sessions)}`);
+    if (context.notes.length)
+        parts.push(`Project notes:\n${notesText(context.notes)}`);
+    return `${parts.join("\n\n")}\n\nWrite the three suggestions in ${language}, as a JSON array.`;
+}
+/** How long one generation may take before the fixed three are shown instead. */
+export const STARTERS_TIMEOUT_MS = 45_000;
+function isTimeout(error) {
+    const name = error?.name;
+    return name === "TimeoutError" || name === "AbortError" || /abort|timed? ?out/i.test(String(error));
+}
+/** How many recent conversations are read, and how much of each. */
+const SESSION_LIMIT = 12;
+const ASK_LENGTH = 200;
+/**
+ * The project's recent conversations, digested.
+ *
+ * The open, empty one on screen is not history, and routine runs are the
+ * scheduler talking, not the user. Reading a transcript is the costly part,
+ * so only the dozen most recent are opened, and only their first user turn.
+ */
+export async function recentSessions(harness, cwd) {
+    const metas = (await harness.listSessions(500).catch(() => []))
+        .filter((meta) => meta.cwd === cwd && !meta.routine && meta.turns > 0)
+        .slice(0, SESSION_LIMIT);
+    return Promise.all(metas.map(async (meta) => {
+        let ask;
+        try {
+            const first = (await harness.store.recordsOf(meta.id)).find((record) => record.message.role === "user");
+            const text = first ? visibleText(first.message).replace(/\s+/g, " ").trim() : "";
+            if (text)
+                ask = redactSecrets(text.length > ASK_LENGTH ? text.slice(0, ASK_LENGTH) + "…" : text).text;
+        }
+        catch {
+            // A transcript that will not read still has its title.
+        }
+        const title = meta.title ? redactSecrets(meta.title).text : undefined;
+        return { id: meta.id, updatedAt: meta.updatedAt, ...(title ? { title } : {}), ...(ask ? { ask } : {}) };
+    }));
+}
+/** Three usable starters out of a model reply, or nothing. */
+export function parseStarters(reply) {
+    const start = reply.indexOf("[");
+    const end = reply.lastIndexOf("]");
+    if (start < 0 || end <= start)
+        return undefined;
+    const parsed = parseJson(reply.slice(start, end + 1));
+    if (!parsed.ok || !Array.isArray(parsed.value))
+        return undefined;
+    const starters = [];
+    for (const item of parsed.value) {
+        if (!item || typeof item !== "object")
+            continue;
+        const { label, prompt } = item;
+        if (typeof label !== "string" || typeof prompt !== "string")
+            continue;
+        const cleanLabel = label.replace(/\s+/g, " ").trim();
+        const cleanPrompt = prompt.trim();
+        if (!cleanLabel || !cleanPrompt || cleanLabel.length > 120 || cleanPrompt.length > 1_200)
+            continue;
+        starters.push({ label: cleanLabel, prompt: cleanPrompt });
+        if (starters.length === 3)
+            break;
+    }
+    return starters.length === 3 ? starters : undefined;
+}
+/**
+ * What a set of starters was written from, in which language.
+ *
+ * A new conversation, a renamed one, or a note edited or added is a project
+ * that has moved on, so the offers are rewritten. A turn inside an existing
+ * conversation is not: keying on its last activity would pay for a new set
+ * every time a message is sent. A restart with the same history pays nothing.
+ */
+export function startersKey(context, locale) {
+    const notes = context.notes
+        .map((note) => [note.id, note.updatedAt ?? note.createdAt, note.summary.length, note.body.length])
+        .sort((a, b) => String(a[0]).localeCompare(String(b[0])));
+    const sessions = context.sessions
+        .map((session) => [session.id, session.title ?? ""])
+        .sort((a, b) => String(a[0]).localeCompare(String(b[0])));
+    return createHash("sha256").update(JSON.stringify([locale, notes, sessions])).digest("hex");
+}
+const cacheFile = (cwd) => userPath("starters", createHash("sha256").update(cwd).digest("hex").slice(0, 24) + ".json");
+async function readCached(cwd, key) {
+    try {
+        const parsed = parseJson(await readFile(cacheFile(cwd), "utf8"));
+        if (!parsed.ok || parsed.value?.key !== key || !Array.isArray(parsed.value.starters))
+            return undefined;
+        return parseStarters(JSON.stringify(parsed.value.starters));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeCached(cwd, key, starters) {
+    const file = cacheFile(cwd);
+    await mkdir(path.dirname(file), { recursive: true });
+    await writeFile(file, JSON.stringify({ key, starters }), "utf8");
+}
+export function createStarters(onReady) {
+    const pending = new Map();
+    const failed = new Set();
+    const get = async (harness, cwd, locale, model) => {
+        const [notes, sessions] = await Promise.all([
+            harness.memory ? harness.memory.load().catch(() => []) : Promise.resolve([]),
+            recentSessions(harness, cwd),
+        ]);
+        if (!notes.length && !sessions.length)
+            return { kind: "fixed" };
+        const context = { notes, sessions };
+        const key = startersKey(context, locale);
+        const slot = cwd + "\0" + key;
+        if (failed.has(slot))
+            return { kind: "fixed" };
+        const cached = await readCached(cwd, key);
+        if (cached)
+            return { kind: "written", starters: cached };
+        if (!pending.has(slot)) {
+            const job = (async () => {
+                try {
+                    // Generous: a flash model answering from a dozen conversations takes
+                    // twenty-odd seconds, and nothing is waiting on it.
+                    const reply = await harness.generateText(STARTERS_PROMPT, startersRequest(context, locale), AbortSignal.timeout(STARTERS_TIMEOUT_MS), 1_500, model);
+                    const starters = parseStarters(reply);
+                    if (!starters) {
+                        harness.logger.warn("starters: the model's reply held no three usable starters", { reply: reply.slice(0, 500) });
+                        failed.add(slot);
+                        return;
+                    }
+                    await writeCached(cwd, key, starters).catch(() => { });
+                    onReady?.(cwd, locale, starters);
+                }
+                catch (error) {
+                    harness.logger.warn("starters: could not write them", { error: String(error) });
+                    // No model configured, offline, or too slow this time: the fixed
+                    // three stay. A timeout is tried again on the next ask — a slow
+                    // moment is not a model that cannot do this; anything else waits
+                    // for the history to change.
+                    if (!isTimeout(error))
+                        failed.add(slot);
+                }
+                finally {
+                    pending.delete(slot);
+                }
+            })();
+            pending.set(slot, job);
+        }
+        return { kind: "fixed", pending: true };
+    };
+    return Object.assign(get, {
+        idle: async () => {
+            while (pending.size)
+                await Promise.all([...pending.values()]);
+        },
+    });
+}
+//# sourceMappingURL=starters.js.map

package/dist/starters.js.map

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

package/dist/theme.js

@@ -14,6 +14,10 @@
 export const LIGHT = {
     bg: "#fff",
     panel: "#f7f7f8",
+    // The window's frame: the top bar and the rail, one L around the panel and
+    // the page. A third surface, set back behind both, so the frame reads as
+    // the window rather than as more page or more panel.
+    frame: "#ececee",
     fg: "#1a1a1a",
     dim: "#6b7280",
     line: "#00000010",
@@ -57,6 +61,7 @@ export const LIGHT = {
 export const DARK = {
     bg: "#0e1013",
     panel: "#15171c",
+    frame: "#08090b",
     fg: "#e6e6e6",
     dim: "#8b93a1",
     line: "#ffffff14",

package/dist/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,CAAC,MAAM,KAAK,GAAY;IAC5B,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,SAAS;IAChB,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,SAAS;IACjB,uEAAuE;IACvE,+EAA+E;IAC/E,8EAA8E;IAC9E,8EAA8E;IAC9E,8EAA8E;IAC9E,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,WAAW;IACzB,uEAAuE;IACvE,4EAA4E;IAC5E,yEAAyE;IACzE,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,WAAW;IAC1B,KAAK,EAAE,WAAW;IAClB,wEAAwE;IACxE,4EAA4E;IAC5E,2EAA2E;IAC3E,mEAAmE;IACnE,cAAc,EAAE,0CAA0C;IAC1D,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;IAChB,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,WAAW;IACzB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,WAAW;IAC1B,KAAK,EAAE,WAAW;IAClB,cAAc,EAAE,0CAA0C;IAC1D,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,OAAgB,EAAE,EAAE,CAChC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;KACpB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC;KAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;AAEf,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GACpB,6BAA6B,IAAI,CAAC,KAAK,CAAC,KAAK;IAC7C,yFAAyF,IAAI,CAAC,IAAI,CAAC,MAAM;IACzG,+CAA+C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC"}
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,CAAC,MAAM,KAAK,GAAY;IAC5B,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,SAAS;IAChB,2EAA2E;IAC3E,yEAAyE;IACzE,qDAAqD;IACrD,KAAK,EAAE,SAAS;IAChB,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,SAAS;IACjB,uEAAuE;IACvE,+EAA+E;IAC/E,8EAA8E;IAC9E,8EAA8E;IAC9E,8EAA8E;IAC9E,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,WAAW;IACzB,uEAAuE;IACvE,4EAA4E;IAC5E,yEAAyE;IACzE,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,WAAW;IAC1B,KAAK,EAAE,WAAW;IAClB,wEAAwE;IACxE,4EAA4E;IAC5E,2EAA2E;IAC3E,mEAAmE;IACnE,cAAc,EAAE,0CAA0C;IAC1D,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,WAAW;IACzB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,WAAW;IAC1B,KAAK,EAAE,WAAW;IAClB,cAAc,EAAE,0CAA0C;IAC1D,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,OAAgB,EAAE,EAAE,CAChC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;KACpB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC;KAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;AAEf,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GACpB,6BAA6B,IAAI,CAAC,KAAK,CAAC,KAAK;IAC7C,yFAAyF,IAAI,CAAC,IAAI,CAAC,MAAM;IACzG,+CAA+C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC"}

package/dist/turn-shots.d.ts

@@ -0,0 +1,27 @@
+import type { ComputerSnapshotEvent } from "@oharness/engine/computer/session.ts";
+/**
+ * The windows a Computer use turn left behind, as the person saw them.
+ *
+ * The agent works from the accessibility tree and screenshots only when that
+ * tree is not enough, so a turn in Bear or Finder usually ends with no picture
+ * in the transcript at all. When one ends, the host captures each window it
+ * worked in and the picture is kept here — beside the session, not in it: the
+ * transcript is what the model reads, and these are for the person reading it
+ * back.
+ *
+ * One directory per session: the JPEGs, and an index.jsonl of where in the
+ * conversation each belongs (`at`, the message count when its turn ended).
+ */
+export interface TurnShot {
+    at: number;
+    app: string;
+    title?: string;
+    file: string;
+}
+export declare function saveTurnShots(session: string, at: number, shots: ComputerSnapshotEvent["shots"]): Promise<TurnShot[]>;
+/** Synchronous: the transcript is flattened synchronously, and this file is a few lines. */
+export declare function listTurnShots(session: string): TurnShot[];
+/** The bytes of one picture, or nothing for a name that is not one of ours. */
+export declare function turnShotPath(session: string, file: string): string | undefined;
+export declare function removeTurnShots(session: string): Promise<void>;
+export declare function turnShotSrc(session: string, file: string): string;

package/dist/turn-shots.js

@@ -0,0 +1,71 @@
+import { existsSync, readFileSync } from "node:fs";
+import { appendFile, mkdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { userPath } from "@oharness/engine/paths.ts";
+function dir(session) {
+    // Session ids are the store's own (date_hex), but the id also arrives on a
+    // URL: anything that could climb out of the directory is refused.
+    if (!/^[\w-]+$/.test(session))
+        throw new Error("bad session id");
+    return userPath("computer-shots", session);
+}
+export async function saveTurnShots(session, at, shots) {
+    const root = dir(session);
+    await mkdir(root, { recursive: true });
+    const saved = [];
+    const stamp = Date.now();
+    for (const [index, shot] of shots.entries()) {
+        const file = `${at}-${stamp}-${index}.jpg`;
+        await writeFile(path.join(root, file), Buffer.from(shot.data, "base64"));
+        saved.push({ at, app: shot.app, ...(shot.title ? { title: shot.title } : {}), file });
+    }
+    await appendFile(path.join(root, "index.jsonl"), saved.map((one) => JSON.stringify(one) + "\n").join(""));
+    return saved;
+}
+/** Synchronous: the transcript is flattened synchronously, and this file is a few lines. */
+export function listTurnShots(session) {
+    let file;
+    try {
+        file = path.join(dir(session), "index.jsonl");
+    }
+    catch {
+        return [];
+    }
+    if (!existsSync(file))
+        return [];
+    const shots = [];
+    for (const line of readFileSync(file, "utf8").split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            shots.push(JSON.parse(line));
+        }
+        catch {
+            // A torn last line from a crash loses one picture, not the rest.
+        }
+    }
+    return shots;
+}
+/** The bytes of one picture, or nothing for a name that is not one of ours. */
+export function turnShotPath(session, file) {
+    if (!/^[\w.-]+\.jpg$/.test(file))
+        return undefined;
+    try {
+        return path.join(dir(session), file);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function removeTurnShots(session) {
+    try {
+        await rm(dir(session), { recursive: true, force: true });
+    }
+    catch {
+        // Nothing to remove, or an id that could never have had any.
+    }
+}
+export function turnShotSrc(session, file) {
+    return `/turn-shot?session=${encodeURIComponent(session)}&file=${encodeURIComponent(file)}`;
+}
+//# sourceMappingURL=turn-shots.js.map

package/dist/turn-shots.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oharness/server",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "The browser frontend's server. Deployable on its own, without a terminal attached.",
   "type": "module",
   "license": "MIT",
@@ -45,7 +45,7 @@
     "build": "rm -rf dist && tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@oharness/engine": "0.9.2",
+    "@oharness/engine": "0.10.0",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0"
   },