@oharness/server 0.9.3 → 0.11.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/suggest.d.ts

@@ -0,0 +1,42 @@
+import type { Message } from "@oharness/engine/core/types.ts";
+import type { Harness } from "@oharness/engine/harness.ts";
+/**
+ * The grey line in the composer: what the user is likely to type next.
+ *
+ * Written once a turn has ended on its own, from the last few exchanges — the
+ * requests, the replies' final answers and, for the latest, a line per tool
+ * call; never tool output — and offered for Tab to
+ * take. On the conversation's own model, the way Claude Code does it: the
+ * guess reads like the agent the user is talking to, and costs what that
+ * model costs, which the Settings switch is there to turn off.
+ *
+ * Absent whenever the model is unsure: an empty box is better than a wrong
+ * prediction sitting in it.
+ */
+export declare const SUGGEST_PROMPT = "You predict the next message a user will send to their AI agent, so it can be offered in their input box for them to accept with one key.\n\nYou are given the last few exchanges of the conversation, oldest first. For the latest one you also see, in <agent_actions>, the tools the agent used on the way to its answer: what it read, changed and ran, and what failed.\n\nWrite the single most likely next message, as the user would type it:\n- a short instruction, at most 12 words, in the same language the user wrote in;\n- grounded in the latest reply: approving what the agent proposed, answering a question it asked, or picking up something it said was left unfinished or failing;\n- specific to this conversation, never generic (\"thanks\", \"continue\", \"ok\");\n- never something the agent already did, and never a new task the conversation does not point to.\n\nIf the user has wrapped up (thanked the agent, said it is done) or the latest reply leaves nothing open, reply with exactly NONE.\nReply with only the message or NONE: no quotes, no preamble.";
+/** One request, the answer it got, and what the agent did in between. */
+export interface Exchange {
+    ask: string;
+    reply: string;
+    actions: string[];
+}
+/** Roughly what a tokenizer makes of it: a token per CJK character, four of anything else. */
+export declare function estimateTokens(text: string): number;
+/** Cut to `tokens`, from the start, the end, or both ends with the middle elided. */
+export declare function cut(text: string, tokens: number, keep: "head" | "tail" | "ends"): string;
+/**
+ * The last few exchanges, oldest first, cut to their budgets and redacted.
+ *
+ * A request is a user message with text that the harness did not write:
+ * tool results come back as user messages with none, and a compaction
+ * summary, a task notification or a goal nudge are marked synthetic. The
+ * reply is the agent's final answer — the text after its last tool call —
+ * because the narration on the way ("let me look at X") is not what the user
+ * answers; when a turn ends on a call, its last words are used instead.
+ */
+export declare function recentExchanges(messages: readonly Message[], count?: number): Exchange[];
+/** The exchanges as the model reads them. */
+export declare function suggestContext(messages: readonly Message[]): string | undefined;
+/** One line fit for the box, or nothing: a long, multi-line or quoted answer is the model not following the brief. */
+export declare function cleanSuggestion(raw: string): string | undefined;
+export declare function suggestNext(harness: Harness, messages: readonly Message[], model: string, signal: AbortSignal): Promise<string | undefined>;

package/dist/suggest.js

@@ -0,0 +1,215 @@
+import { visibleText } from "@oharness/engine/core/types.ts";
+import { redactSecrets } from "@oharness/engine/agent/memory-redact.ts";
+/**
+ * The grey line in the composer: what the user is likely to type next.
+ *
+ * Written once a turn has ended on its own, from the last few exchanges — the
+ * requests, the replies' final answers and, for the latest, a line per tool
+ * call; never tool output — and offered for Tab to
+ * take. On the conversation's own model, the way Claude Code does it: the
+ * guess reads like the agent the user is talking to, and costs what that
+ * model costs, which the Settings switch is there to turn off.
+ *
+ * Absent whenever the model is unsure: an empty box is better than a wrong
+ * prediction sitting in it.
+ */
+export const SUGGEST_PROMPT = `You predict the next message a user will send to their AI agent, so it can be offered in their input box for them to accept with one key.
+
+You are given the last few exchanges of the conversation, oldest first. For the latest one you also see, in <agent_actions>, the tools the agent used on the way to its answer: what it read, changed and ran, and what failed.
+
+Write the single most likely next message, as the user would type it:
+- a short instruction, at most 12 words, in the same language the user wrote in;
+- grounded in the latest reply: approving what the agent proposed, answering a question it asked, or picking up something it said was left unfinished or failing;
+- specific to this conversation, never generic ("thanks", "continue", "ok");
+- never something the agent already did, and never a new task the conversation does not point to.
+
+If the user has wrapped up (thanked the agent, said it is done) or the latest reply leaves nothing open, reply with exactly NONE.
+Reply with only the message or NONE: no quotes, no preamble.`;
+/**
+ * What the guess reads, in estimated tokens rather than characters: a Chinese
+ * character is about a token and an English one about a quarter, so a budget
+ * in characters gave a Chinese conversation three times the context, and the
+ * bill to match.
+ *
+ * Most of it goes to the exchange that just ended — its request kept at both
+ * ends, where a pasted log's actual question sits, and its reply's final
+ * answer — and a little to each one before it, enough to say what the thread
+ * is about. With these caps three exchanges always fit.
+ */
+const EXCHANGES = 3;
+const LATEST_ASK_TOKENS = 400;
+const LATEST_REPLY_TOKENS = 450;
+const EARLIER_ASK_TOKENS = 80;
+const EARLIER_REPLY_TOKENS = 80;
+/** The actions line: the latest turn's tool calls, most recent kept. */
+const MAX_ACTIONS = 12;
+const ARG_TOKENS = 20;
+const MAX_LENGTH = 120;
+const TIMEOUT_MS = 15_000;
+const WIDE = /[\u1100-\u11ff\u2e80-\ua4cf\uac00-\ud7af\uf900-\ufaff\ufe30-\ufe4f\uff00-\uffef]/;
+/** Roughly what a tokenizer makes of it: a token per CJK character, four of anything else. */
+export function estimateTokens(text) {
+    let tokens = 0;
+    for (const char of text)
+        tokens += WIDE.test(char) ? 1 : 0.25;
+    return Math.ceil(tokens);
+}
+/** The longest start, or end, of `text` within `tokens`. */
+function fit(text, tokens, from) {
+    const chars = [...text];
+    let used = 0;
+    let n = 0;
+    for (; n < chars.length; n++) {
+        const char = chars[from === "head" ? n : chars.length - 1 - n];
+        used += WIDE.test(char) ? 1 : 0.25;
+        if (used > tokens)
+            break;
+    }
+    return from === "head" ? chars.slice(0, n).join("") : chars.slice(chars.length - n).join("");
+}
+/** Cut to `tokens`, from the start, the end, or both ends with the middle elided. */
+export function cut(text, tokens, keep) {
+    if (estimateTokens(text) <= tokens)
+        return text;
+    if (keep === "head")
+        return fit(text, tokens, "head") + "…";
+    if (keep === "tail")
+        return "…" + fit(text, tokens, "tail");
+    return fit(text, tokens / 2, "head") + "\n…\n" + fit(text, tokens / 2, "tail");
+}
+/** The argument that says what a call was about: a path, a command, a pattern. */
+const KEY_ARGS = ["path", "file_path", "command", "pattern", "url", "query", "description", "name"];
+function describeCall(name, input, failed) {
+    let arg = "";
+    if (input && typeof input === "object") {
+        for (const key of KEY_ARGS) {
+            const value = input[key];
+            if (typeof value === "string" && value.trim()) {
+                arg = cut(redactSecrets(value.replace(/\s+/g, " ").trim()).text, ARG_TOKENS, "head");
+                break;
+            }
+        }
+    }
+    return `${name}${arg ? ` ${JSON.stringify(arg)}` : ""}${failed ? " → failed" : ""}`;
+}
+/**
+ * A run of the same call is one line with a count: twenty reads of one file
+ * say less than "read ×20", and the room is for what else happened.
+ */
+function collapse(actions) {
+    const out = [];
+    for (const line of actions) {
+        const last = out.at(-1);
+        if (last && last.line === line)
+            last.times++;
+        else
+            out.push({ line, times: 1 });
+    }
+    const lines = out.map(({ line, times }) => (times > 1 ? `${line} ×${times}` : line));
+    if (lines.length <= MAX_ACTIONS)
+        return lines;
+    return [`(${lines.length - MAX_ACTIONS} earlier)`, ...lines.slice(-MAX_ACTIONS)];
+}
+/**
+ * The last few exchanges, oldest first, cut to their budgets and redacted.
+ *
+ * A request is a user message with text that the harness did not write:
+ * tool results come back as user messages with none, and a compaction
+ * summary, a task notification or a goal nudge are marked synthetic. The
+ * reply is the agent's final answer — the text after its last tool call —
+ * because the narration on the way ("let me look at X") is not what the user
+ * answers; when a turn ends on a call, its last words are used instead.
+ */
+export function recentExchanges(messages, count = EXCHANGES) {
+    const exchanges = [];
+    let after = [];
+    for (let i = messages.length - 1; i >= 0 && exchanges.length < count; i--) {
+        const message = messages[i];
+        const text = message.role === "user" && !message.meta?.synthetic ? visibleText(message).trim() : "";
+        if (!text) {
+            after.unshift(message);
+            continue;
+        }
+        const turn = after;
+        after = [];
+        const latest = exchanges.length === 0;
+        const reply = finalAnswer(turn);
+        if (!reply)
+            continue;
+        exchanges.unshift({
+            // Redacted whole, then cut: a key cut in half no longer looks like one.
+            ask: cut(redactSecrets(text).text, latest ? LATEST_ASK_TOKENS : EARLIER_ASK_TOKENS, latest ? "ends" : "head"),
+            reply: cut(redactSecrets(reply).text, latest ? LATEST_REPLY_TOKENS : EARLIER_REPLY_TOKENS, "tail"),
+            actions: latest ? collapse(actionsOf(turn)) : [],
+        });
+    }
+    return exchanges;
+}
+function finalAnswer(turn) {
+    let final = [];
+    let last = "";
+    for (const message of turn) {
+        if (message.role !== "assistant")
+            continue;
+        for (const block of message.content) {
+            if (block.type === "tool_call")
+                final = [];
+            else if (block.type === "text" && block.text.trim()) {
+                final.push(block.text.trim());
+                last = block.text.trim();
+            }
+        }
+    }
+    return final.length ? final.join("\n") : last;
+}
+function actionsOf(turn) {
+    const failed = new Set();
+    for (const message of turn) {
+        for (const block of message.content) {
+            if (block.type === "tool_result" && block.isError)
+                failed.add(block.toolCallId);
+        }
+    }
+    const actions = [];
+    for (const message of turn) {
+        if (message.role !== "assistant")
+            continue;
+        for (const block of message.content) {
+            if (block.type === "tool_call")
+                actions.push(describeCall(block.name, block.input, failed.has(block.id)));
+        }
+    }
+    return actions;
+}
+/** The exchanges as the model reads them. */
+export function suggestContext(messages) {
+    const exchanges = recentExchanges(messages);
+    if (!exchanges.length)
+        return undefined;
+    return exchanges
+        .map((exchange) => {
+        const parts = [`<user>\n${exchange.ask}\n</user>`];
+        if (exchange.actions.length)
+            parts.push(`<agent_actions>\n${exchange.actions.map((line) => `- ${line}`).join("\n")}\n</agent_actions>`);
+        parts.push(`<agent>\n${exchange.reply}\n</agent>`);
+        return parts.join("\n");
+    })
+        .join("\n");
+}
+/** One line fit for the box, or nothing: a long, multi-line or quoted answer is the model not following the brief. */
+export function cleanSuggestion(raw) {
+    const text = raw.trim().replace(/^["'“「]+|["'”」]+$/g, "").trim();
+    // The model's way of saying there is nothing to offer; an empty reply is
+    // the other, but small models will not give one.
+    if (!text || /^none\.?$/i.test(text) || text.includes("\n") || text.length > MAX_LENGTH)
+        return undefined;
+    return text;
+}
+export async function suggestNext(harness, messages, model, signal) {
+    const context = suggestContext(messages);
+    if (!context)
+        return undefined;
+    const reply = await harness.generateWith(model, SUGGEST_PROMPT, context, AbortSignal.any([signal, AbortSignal.timeout(TIMEOUT_MS)]), 200);
+    return cleanSuggestion(reply);
+}
+//# sourceMappingURL=suggest.js.map

package/dist/suggest.js.map

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

package/dist/terminal.d.ts

@@ -1,4 +1,27 @@
 import type { ServerResponse } from "node:http";
+/**
+ * Programs a new shell may be opened running, by name. A fixed list rather
+ * than a command from the request: the page asks for "claude", and what that
+ * means is decided here.
+ *
+ * `claude` is the hand-off to Claude Code. It is the user's own install,
+ * signed in to their own account through Claude Code's own login — OHarness
+ * starts it and does nothing else, which is the one way of using a Claude
+ * plan from another app that Anthropic's terms leave plainly open. It is
+ * typed into the shell rather than spawned in its place, so PATH is the
+ * login shell's and the shell is still there when Claude Code exits.
+ */
+export declare const LAUNCHERS: {
+    readonly claude: (platform: NodeJS.Platform, resume?: string) => string;
+};
+export type Launcher = keyof typeof LAUNCHERS;
+export declare function isLauncher(value: unknown): value is Launcher;
+/**
+ * An agent session id fit to put on a command line: letters, digits and
+ * dashes, the shape Claude Code's ids have. Anything else is refused rather
+ * than escaped — there is no legitimate id that needs escaping.
+ */
+export declare function isAgentSessionId(value: unknown): value is string;
 export declare class TerminalHub {
     private readonly terminals;
     private seq;
@@ -8,11 +31,14 @@ export declare class TerminalHub {
         name: string;
         exited: boolean;
     }>;
-    /** A new shell in `cwd`; `replace` names one it takes the place of. */
+    /**
+     * A new shell in `cwd`; `replace` names one it takes the place of, and
+     * `run` a launcher typed into it as soon as it starts.
+     */
     open(cwd: string, size: {
         cols?: unknown;
         rows?: unknown;
-    }, replace?: string): Promise<{
+    }, replace?: string, run?: Launcher, resume?: string): Promise<{
         id: string;
         name: string;
     } | {