@duetso/agent 0.1.53 → 0.1.54

package/dist/src/tui/recent-sessions.js

@@ -0,0 +1,150 @@
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Filesystem layout the helper expects:
+ *   <root>/<session-dir>/state.json
+ *
+ * `state.json` is the same file the runtime writes via Session persistence;
+ * we only read the fields needed for the boot list (id, updatedAt, the most
+ * recent user prompt). Sessions with no user messages or unparseable JSON
+ * are silently skipped so a single bad file never breaks the boot screen.
+ */
+/** Default path mirrors {@link DEFAULT_SESSION_STORAGE_DIR} from session-manager. */
+export const DEFAULT_SESSIONS_ROOT = join(homedir(), ".duet", "sessions");
+/** Hard cap on the displayed prompt before ellipsis truncation. */
+export const RECENT_PROMPT_MAX_LENGTH = 60;
+/**
+ * Scan the on-disk sessions directory and return up to `limit` sessions
+ * sorted newest-first. Any session that has no readable last user prompt
+ * (empty messages, malformed JSON, missing state.json) is skipped so the
+ * caller can decide rendering on a clean list.
+ */
+export function listRecentSessions(input = {}) {
+    const root = input.sessionsRoot ?? DEFAULT_SESSIONS_ROOT;
+    const limit = input.limit ?? 4;
+    const excludeId = input.excludeId;
+    let entries;
+    try {
+        entries = readdirSync(root);
+    }
+    catch {
+        return [];
+    }
+    const candidates = [];
+    for (const name of entries) {
+        if (excludeId && name === excludeId)
+            continue;
+        const statePath = join(root, name, "state.json");
+        let raw;
+        let modifiedAt;
+        try {
+            const stats = statSync(statePath);
+            if (!stats.isFile())
+                continue;
+            modifiedAt = stats.mtimeMs;
+            raw = readFileSync(statePath, "utf8");
+        }
+        catch {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
+        const prompt = extractLastUserPrompt(parsed);
+        if (!prompt)
+            continue;
+        candidates.push({ sessionId: name, lastUserPrompt: prompt, modifiedAt });
+    }
+    candidates.sort((a, b) => b.modifiedAt - a.modifiedAt);
+    return candidates.slice(0, limit);
+}
+/** Truncate a prompt for boot-row display; appends `…` when over the cap. */
+export function truncateRecentPrompt(prompt, max = RECENT_PROMPT_MAX_LENGTH) {
+    const trimmed = prompt.trim();
+    if (trimmed.length <= max)
+        return trimmed;
+    return `${trimmed.slice(0, max - 1).trimEnd()}…`;
+}
+/**
+ * Render a relative-time label suitable for a single boot row.
+ * `now` is injectable for tests; production passes `Date.now()`.
+ */
+export function relativeTimeLabel(modifiedAt, now = Date.now()) {
+    const diffMs = Math.max(0, now - modifiedAt);
+    const minutes = Math.floor(diffMs / 60_000);
+    if (minutes < 1)
+        return "just now";
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    if (days === 1)
+        return "yesterday";
+    if (days < 7)
+        return `${days}d ago`;
+    const weeks = Math.floor(days / 7);
+    if (weeks < 5)
+        return `${weeks}w ago`;
+    const months = Math.floor(days / 30);
+    if (months < 12)
+        return `${months}mo ago`;
+    const years = Math.floor(days / 365);
+    return `${years}y ago`;
+}
+/**
+ * Reach into a parsed state.json and return the last user-authored prompt.
+ * The runtime persists messages under `state.agent.messages`; each message
+ * has either a string `content` or a list of content blocks where text
+ * blocks expose `{ type: "text", text }`.
+ */
+function extractLastUserPrompt(parsed) {
+    const messages = pickMessages(parsed);
+    if (!messages)
+        return undefined;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (!msg || typeof msg !== "object")
+            continue;
+        const role = msg.role;
+        if (role !== "user")
+            continue;
+        const text = userMessageText(msg.content);
+        const trimmed = text.trim();
+        if (trimmed.length > 0)
+            return trimmed;
+    }
+    return undefined;
+}
+function pickMessages(parsed) {
+    if (!parsed || typeof parsed !== "object")
+        return undefined;
+    const state = parsed.state;
+    if (!state || typeof state !== "object")
+        return undefined;
+    const agent = state.agent;
+    if (!agent || typeof agent !== "object")
+        return undefined;
+    const messages = agent.messages;
+    return Array.isArray(messages) ? messages : undefined;
+}
+function userMessageText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((block) => !!block &&
+        typeof block === "object" &&
+        block.type === "text" &&
+        typeof block.text === "string")
+        .map((block) => block.text)
+        .join("");
+}
+//# sourceMappingURL=recent-sessions.js.map

package/dist/src/tui/recent-sessions.js.map

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

package/dist/src/tui/starters.d.ts

@@ -0,0 +1,92 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import { type RecentSession } from "./recent-sessions.js";
+/**
+ * Inputs for {@link selectStarters}. The helper is a pure function over the
+ * filesystem and the persisted session history; it never reads from a session
+ * runtime, so it can be exercised cheaply in tests with tmp-dir fixtures.
+ */
+export interface StartersInput {
+    /** Absolute working directory. Used to detect git/package/scratch context. */
+    cwd: string;
+    /**
+     * Replayed session history (most recent last). When present, the most
+     * recent user prompt becomes the optional 5th "resume" starter.
+     */
+    sessionHistory?: readonly AgentMessage[];
+    /**
+     * Pre-loaded list of recent sessions other than the current one. Each
+     * entry surfaces as a numbered "continue: <prompt> — <relative time>"
+     * row below the cwd-based starters. Caller is responsible for excluding
+     * the active session id and ordering newest-first.
+     */
+    recentSessions?: readonly RecentSession[];
+    /** Override `now` for deterministic relative-time labels in tests. */
+    now?: number;
+}
+/**
+ * Output of {@link selectStarters}: cwd-based starters, plus optional
+ * recent-session continuations and an optional resume preview for the
+ * current session's own history.
+ */
+export interface StartersResult {
+    /** Always exactly 4 prompts, ordered for the numbered list rendering. */
+    starters: string[];
+    /**
+     * Last user message from {@link StartersInput.sessionHistory}, trimmed and
+     * truncated to {@link RESUME_MAX_LENGTH}. Undefined when no resumable
+     * prompt exists.
+     */
+    resumePrompt?: string;
+    /**
+     * Continuation rows derived from {@link StartersInput.recentSessions}.
+     * `prompt` is the raw last user prompt from that session (caller decides
+     * what to do when a row is picked); `label` is the rendered row body
+     * (truncated prompt + relative time) ready to drop into the boot list.
+     * The label intentionally omits any "continue:" prefix — the boot screen
+     * carries that meaning in the "pick up the thread" section header.
+     */
+    recentSessions: {
+        sessionId: string;
+        prompt: string;
+        label: string;
+    }[];
+}
+/**
+ * One numbered, selectable boot row in render order.
+ *
+ * `kind: "recent"` rows always render under the "pick up the thread" header
+ * and come first when any recent session exists; `kind: "prompt"` rows render
+ * under "or start something new" (returning user) or "what should we work on
+ * today?" (new user). The numbering 1..N matches the position in this list,
+ * so callers can drive arrow-key + digit navigation off a single index space.
+ */
+export interface SelectableStarter {
+    kind: "prompt" | "recent";
+    label: string;
+    submit: string;
+    sessionId?: string;
+}
+/**
+ * Flatten a {@link StartersResult} into the ordered, numbered list the boot
+ * screen renders. Recent-session rows lead when present so returning users
+ * see continuity first; otherwise the cwd-based starters lead.
+ */
+export declare function orderedSelectableStarters(result: StartersResult): SelectableStarter[];
+/** Hard cap on the resume preview before it gets ellipsis-truncated. */
+export declare const RESUME_MAX_LENGTH = 80;
+/**
+ * Pick four starter prompts (and an optional resume preview) based on the
+ * shape of the working directory and any prior session history.
+ *
+ * Detection rules run in priority order; the first match wins. Content
+ * signals beat location signals so a working tree that happens to live
+ * under /tmp still classifies by what is in it.
+ *   1. git repo with at least one commit
+ *   2. package.json present (no commits / empty git is fine)
+ *   3. .duet/skills/ present
+ *   4. text-heavy: more than 5 .md or .txt files and no package.json
+ *   5. scratch dir (/tmp, ~/Desktop, ~/Downloads) or empty
+ *   6. default
+ */
+export declare function selectStarters(input: StartersInput): StartersResult;
+//# sourceMappingURL=starters.d.ts.map

package/dist/src/tui/starters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starters.d.ts","sourceRoot":"","sources":["../../../src/tui/starters.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,OAAO,EAAE,KAAK,aAAa,EAA2C,MAAM,sBAAsB,CAAC;AAEnG;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,cAAc,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,EAAE,CAcrF;AAED,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AA4CpC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAYnE"}

package/dist/src/tui/starters.js

@@ -0,0 +1,196 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { relativeTimeLabel, truncateRecentPrompt } from "./recent-sessions.js";
+/**
+ * Flatten a {@link StartersResult} into the ordered, numbered list the boot
+ * screen renders. Recent-session rows lead when present so returning users
+ * see continuity first; otherwise the cwd-based starters lead.
+ */
+export function orderedSelectableStarters(result) {
+    const ordered = [];
+    for (const row of result.recentSessions) {
+        ordered.push({
+            kind: "recent",
+            label: row.label,
+            submit: row.prompt,
+            sessionId: row.sessionId,
+        });
+    }
+    for (const text of result.starters) {
+        ordered.push({ kind: "prompt", label: text, submit: text });
+    }
+    return ordered;
+}
+/** Hard cap on the resume preview before it gets ellipsis-truncated. */
+export const RESUME_MAX_LENGTH = 80;
+const GIT_STARTERS = [
+    "review my latest commit and suggest fixes",
+    "write release notes for the last 5 commits",
+    "find unused exports",
+    "summarize what changed in the last week",
+];
+const PACKAGE_STARTERS = [
+    "scaffold this idea into a working app",
+    "pick a tech stack for me",
+    "audit my dependencies",
+    "what should I build first",
+];
+const SCRATCH_STARTERS = [
+    "build me a landing page",
+    "research my top 3 competitors",
+    "write a cold email",
+    "plan my next launch",
+];
+const SKILL_STARTERS = [
+    "create a new skill",
+    "improve an existing skill",
+    "review my skill catalog",
+    "find skills I'm missing",
+];
+const TEXT_STARTERS = [
+    "summarize these notes",
+    "find duplicates across files",
+    "write a blog post from these notes",
+    "organize this folder",
+];
+const DEFAULT_STARTERS = [
+    "build me something",
+    "research a topic",
+    "write something",
+    "help me think through a decision",
+];
+/**
+ * Pick four starter prompts (and an optional resume preview) based on the
+ * shape of the working directory and any prior session history.
+ *
+ * Detection rules run in priority order; the first match wins. Content
+ * signals beat location signals so a working tree that happens to live
+ * under /tmp still classifies by what is in it.
+ *   1. git repo with at least one commit
+ *   2. package.json present (no commits / empty git is fine)
+ *   3. .duet/skills/ present
+ *   4. text-heavy: more than 5 .md or .txt files and no package.json
+ *   5. scratch dir (/tmp, ~/Desktop, ~/Downloads) or empty
+ *   6. default
+ */
+export function selectStarters(input) {
+    const starters = [...pickStarters(input.cwd)];
+    const resumePrompt = pickResumePrompt(input.sessionHistory);
+    const recentSessions = (input.recentSessions ?? []).map((session) => ({
+        sessionId: session.sessionId,
+        prompt: session.lastUserPrompt,
+        label: `${truncateRecentPrompt(session.lastUserPrompt)} — ${relativeTimeLabel(session.modifiedAt, input.now)}`,
+    }));
+    return resumePrompt ? { starters, resumePrompt, recentSessions } : { starters, recentSessions };
+}
+function pickStarters(cwd) {
+    if (isGitRepoWithCommits(cwd))
+        return GIT_STARTERS;
+    if (hasPackageJson(cwd))
+        return PACKAGE_STARTERS;
+    if (hasDuetSkills(cwd))
+        return SKILL_STARTERS;
+    if (isTextHeavy(cwd))
+        return TEXT_STARTERS;
+    if (isScratchDir(cwd) || isEmptyDir(cwd))
+        return SCRATCH_STARTERS;
+    return DEFAULT_STARTERS;
+}
+function isGitRepoWithCommits(cwd) {
+    if (!safeIsDir(cwd))
+        return false;
+    try {
+        const out = execFileSync("git", ["-C", cwd, "rev-list", "--count", "HEAD"], {
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 1000,
+            encoding: "utf8",
+        });
+        return Number.parseInt(out.trim(), 10) > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function hasPackageJson(cwd) {
+    return existsSync(join(cwd, "package.json"));
+}
+// Only the literal scratch roots count. Descendants like `/tmp/foo`
+// fall through to content detection or isEmptyDir — a non-empty
+// directory inside /tmp is a working tree, not a scratch space.
+function isScratchDir(cwd) {
+    const resolved = resolve(cwd);
+    const home = homedir();
+    return (resolved === "/tmp" ||
+        resolved === join(home, "Desktop") ||
+        resolved === join(home, "Downloads"));
+}
+function isEmptyDir(cwd) {
+    if (!safeIsDir(cwd))
+        return false;
+    try {
+        return readdirSync(cwd).length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+function hasDuetSkills(cwd) {
+    const dir = join(cwd, ".duet", "skills");
+    return existsSync(dir) && safeIsDir(dir);
+}
+function isTextHeavy(cwd) {
+    if (!safeIsDir(cwd))
+        return false;
+    if (hasPackageJson(cwd))
+        return false;
+    let textFiles = 0;
+    try {
+        for (const name of readdirSync(cwd)) {
+            const lower = name.toLowerCase();
+            if (lower.endsWith(".md") || lower.endsWith(".txt")) {
+                textFiles += 1;
+                if (textFiles > 5)
+                    return true;
+            }
+        }
+    }
+    catch {
+        return false;
+    }
+    return false;
+}
+function safeIsDir(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function pickResumePrompt(history) {
+    if (!history || history.length === 0)
+        return undefined;
+    for (let i = history.length - 1; i >= 0; i--) {
+        const msg = history[i];
+        if (!msg || !("role" in msg) || msg.role !== "user")
+            continue;
+        const text = userMessageText(msg.content).trim();
+        if (!text)
+            continue;
+        if (text.length <= RESUME_MAX_LENGTH)
+            return text;
+        return `${text.slice(0, RESUME_MAX_LENGTH - 1).trimEnd()}…`;
+    }
+    return undefined;
+}
+function userMessageText(content) {
+    if (typeof content === "string")
+        return content;
+    return content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("");
+}
+//# sourceMappingURL=starters.js.map

package/dist/src/tui/starters.js.map

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

package/dist/src/tui/theme.d.ts

@@ -10,6 +10,6 @@ export declare const COLORS: {
     readonly status: "#34D399";
     readonly border: "#374151";
 };
-export declare const HINT_IDLE = "Enter: send \u00B7 Esc: quit \u00B7 Ctrl+C: force quit";
-export declare const HINT_RUNNING = "Enter: steer \u00B7 Shift+Enter: queue follow-up \u00B7 Esc: interrupt and quit \u00B7 Ctrl+C: force quit";
+export declare const HINT_IDLE = "Enter: send \u00B7 Shift+Enter: newline \u00B7 drag-select + Cmd+C to copy \u00B7 Esc: quit";
+export declare const HINT_RUNNING = "Enter: queue follow-up \u00B7 drag-select + Cmd+C to copy \u00B7 Esc: interrupt";
 //# sourceMappingURL=theme.d.ts.map

package/dist/src/tui/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/tui/theme.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;;;;;;;;;;;CAWT,CAAC;AAEX,eAAO,MAAM,SAAS,2DAAiD,CAAC;AACxE,eAAO,MAAM,YAAY,8GACqE,CAAC"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/tui/theme.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;;;;;;;;;;;CAWT,CAAC;AAEX,eAAO,MAAM,SAAS,gGAC0D,CAAC;AACjF,eAAO,MAAM,YAAY,oFAA0E,CAAC"}

package/dist/src/tui/theme.js

@@ -13,6 +13,6 @@ export const COLORS = {
     status: "#34D399",
     border: "#374151",
 };
-export const HINT_IDLE = "Enter: send · Esc: quit · Ctrl+C: force quit";
-export const HINT_RUNNING = "Enter: steer · Shift+Enter: queue follow-up · Esc: interrupt and quit · Ctrl+C: force quit";
+export const HINT_IDLE = "Enter: send · Shift+Enter: newline · drag-select + Cmd+C to copy · Esc: quit";
+export const HINT_RUNNING = "Enter: queue follow-up · drag-select + Cmd+C to copy · Esc: interrupt";
 //# sourceMappingURL=theme.js.map

package/dist/src/tui/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/tui/theme.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wEAAwE;AACxE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAAG,8CAA8C,CAAC;AACxE,MAAM,CAAC,MAAM,YAAY,GACvB,4FAA4F,CAAC"}
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/tui/theme.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wEAAwE;AACxE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GACpB,8EAA8E,CAAC;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,uEAAuE,CAAC"}

package/dist/src/tui/transcript-log.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Tiny in-memory log of user / agent messages used by the `/copy` slash
+ * command and the Ctrl+Y keystroke. The TUI's transcript itself is rendered
+ * line-by-line into a ScrollBoxRenderable, so there is no straightforward
+ * way to retrieve "the last assistant message" as a clean string. This log
+ * is the parallel structure that makes copy-out possible.
+ *
+ * Only logical message bodies belong here — labels (`you:`, `[reasoning]`,
+ * `[tool]`, ...) live in the transcript renderer and are stripped before
+ * appending so what lands on the clipboard is exactly the text the user
+ * (or the agent) wrote.
+ */
+export type TranscriptEntryKind = "user" | "agent";
+export interface TranscriptEntry {
+    kind: TranscriptEntryKind;
+    /** Final body text. For streamed agent replies, append the resolved text once. */
+    text: string;
+}
+/**
+ * Pick the text to copy based on the user's `/copy` argument.
+ *
+ * - `"last"` (the default): the most recent agent reply. Falls back to the
+ *   most recent user message only if no agent reply exists yet — useful when
+ *   a user wants to grab their own prompt back before the agent responds.
+ * - `"all"`: the entire conversation, in order, formatted with `you:` /
+ *   `agent:` labels so the export reads cleanly outside the terminal.
+ * - a positive integer N: the last N entries (any kind), formatted the same
+ *   way as `"all"`.
+ *
+ * Returns `undefined` when the requested slice is empty so the caller can
+ * surface "nothing to copy yet" instead of writing an empty clipboard.
+ */
+export declare function selectCopyText(log: readonly TranscriptEntry[], argument: "last" | "all" | number): string | undefined;
+/**
+ * Parse the raw argument portion of a `/copy ...` command. Accepted shapes:
+ *
+ *   /copy            → "last"
+ *   /copy last       → "last"
+ *   /copy all        → "all"
+ *   /copy 5          → 5
+ *
+ * Returns `undefined` for malformed input so the caller can show usage help.
+ */
+export declare function parseCopyArgument(raw: string): "last" | "all" | number | undefined;
+//# sourceMappingURL=transcript-log.d.ts.map

package/dist/src/tui/transcript-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-log.d.ts","sourceRoot":"","sources":["../../../src/tui/transcript-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,eAAe,EAAE,EAC/B,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAChC,MAAM,GAAG,SAAS,CAgBpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAOlF"}

package/dist/src/tui/transcript-log.js

@@ -0,0 +1,76 @@
+/**
+ * Tiny in-memory log of user / agent messages used by the `/copy` slash
+ * command and the Ctrl+Y keystroke. The TUI's transcript itself is rendered
+ * line-by-line into a ScrollBoxRenderable, so there is no straightforward
+ * way to retrieve "the last assistant message" as a clean string. This log
+ * is the parallel structure that makes copy-out possible.
+ *
+ * Only logical message bodies belong here — labels (`you:`, `[reasoning]`,
+ * `[tool]`, ...) live in the transcript renderer and are stripped before
+ * appending so what lands on the clipboard is exactly the text the user
+ * (or the agent) wrote.
+ */
+/**
+ * Pick the text to copy based on the user's `/copy` argument.
+ *
+ * - `"last"` (the default): the most recent agent reply. Falls back to the
+ *   most recent user message only if no agent reply exists yet — useful when
+ *   a user wants to grab their own prompt back before the agent responds.
+ * - `"all"`: the entire conversation, in order, formatted with `you:` /
+ *   `agent:` labels so the export reads cleanly outside the terminal.
+ * - a positive integer N: the last N entries (any kind), formatted the same
+ *   way as `"all"`.
+ *
+ * Returns `undefined` when the requested slice is empty so the caller can
+ * surface "nothing to copy yet" instead of writing an empty clipboard.
+ */
+export function selectCopyText(log, argument) {
+    if (argument === "last") {
+        const lastAgent = findLast(log, (entry) => entry.kind === "agent");
+        if (lastAgent)
+            return lastAgent.text;
+        const lastUser = findLast(log, (entry) => entry.kind === "user");
+        return lastUser?.text;
+    }
+    if (argument === "all") {
+        return log.length > 0 ? formatEntries(log) : undefined;
+    }
+    // Numeric N — clamp to log length and take the tail.
+    const n = Math.max(1, Math.floor(argument));
+    const slice = log.slice(-n);
+    return slice.length > 0 ? formatEntries(slice) : undefined;
+}
+/**
+ * Parse the raw argument portion of a `/copy ...` command. Accepted shapes:
+ *
+ *   /copy            → "last"
+ *   /copy last       → "last"
+ *   /copy all        → "all"
+ *   /copy 5          → 5
+ *
+ * Returns `undefined` for malformed input so the caller can show usage help.
+ */
+export function parseCopyArgument(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "" || trimmed === "last")
+        return "last";
+    if (trimmed === "all")
+        return "all";
+    const n = Number(trimmed);
+    if (Number.isFinite(n) && n >= 1 && Number.isInteger(n))
+        return n;
+    return undefined;
+}
+function findLast(items, predicate) {
+    for (let i = items.length - 1; i >= 0; i--) {
+        if (predicate(items[i]))
+            return items[i];
+    }
+    return undefined;
+}
+function formatEntries(entries) {
+    return entries
+        .map((entry) => `${entry.kind === "user" ? "you" : "agent"}: ${entry.text}`)
+        .join("\n\n");
+}
+//# sourceMappingURL=transcript-log.js.map

package/dist/src/tui/transcript-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-log.js","sourceRoot":"","sources":["../../../src/tui/transcript-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,GAA+B,EAC/B,QAAiC;IAEjC,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QACnE,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC,IAAI,CAAC;QACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACjE,OAAO,QAAQ,EAAE,IAAI,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IAED,qDAAqD;IACrD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAClE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAI,KAAmB,EAAE,SAA+B;IACvE,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CAAC,OAAmC;IACxD,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;SAC3E,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}