@teammates/cli 0.5.2 → 0.5.3

package/README.md

@@ -7,18 +7,17 @@ Agent-agnostic CLI orchestrator for teammates. Routes tasks to teammates, manage
 ## Quick Start
 
 ```bash
-cd cli
+cd packages/cli
 npm install
 npm run build
 ```
 
-Then launch a session with your preferred agent:
+Then launch a session:
 
 ```bash
-teammates claude       # Claude Code
-teammates codex        # OpenAI Codex
-teammates aider        # Aider
-teammates echo         # Test adapter (no external agent)
+teammates               # Uses default adapter (claude)
+teammates --model sonnet # Override the agent model
+teammates echo           # Use the test adapter (no external agent)
 ```
 
 The CLI auto-discovers your `.teammates/` directory by walking up from the current working directory.
@@ -26,7 +25,7 @@ The CLI auto-discovers your `.teammates/` directory by walking up from the curre
 ## Usage
 
 ```
-teammates <agent> [options] [-- agent-flags...]
+teammates [options] [-- agent-flags...]
 ```
 
 ### Options
@@ -37,7 +36,7 @@ teammates <agent> [options] [-- agent-flags...]
 | `--dir <path>` | Override `.teammates/` directory location |
 | `--help` | Show usage information |
 
-Any arguments after the agent name are passed through to the underlying agent CLI.
+Any arguments after `--` are passed through to the underlying agent CLI.
 
 ## In-Session Commands
 
@@ -55,16 +54,18 @@ Once inside the REPL, you can interact with teammates using `@mentions`, `/comma
 
 | Command | Aliases | Description |
 |---|---|---|
-| `/status` | `/s`, `/queue`, `/qu` | Show teammates, active tasks, and queue |
-| `/log [teammate]` | `/l` | Show the last task result (optionally for a specific teammate) |
-| `/debug [teammate]` | `/raw` | Show raw agent output from the last task |
-| `/cancel <n>` | | Cancel a queued task by number |
-| `/init` | `/onboard`, `/setup` | Run onboarding to set up teammates for this project |
-| `/install <service>` | | Install a teammates service (e.g. `recall`) |
+| `/status` | `/s`, `/queue` | Show teammates, active tasks, and queue |
+| `/debug [teammate] [focus]` | | Analyze the last agent task with optional focus text |
+| `/cancel [n]` | | Cancel a queued task by number |
+| `/init` | `/onboard`, `/setup` | Run onboarding to set up teammates |
+| `/init pick` | | Pick teammates from persona templates (in-TUI) |
 | `/compact [teammate]` | | Compact daily logs into weekly/monthly summaries |
 | `/retro [teammate]` | | Run a structured self-retrospective for a teammate |
+| `/user [change]` | | View or update USER.md |
+| `/btw [question]` | | Ask a quick side question without interrupting |
 | `/copy` | `/cp` | Copy the last response to clipboard |
 | `/theme` | | Show current theme colors |
+| `/configure [service]` | `/config` | Configure external services (e.g. GitHub) |
 | `/clear` | `/cls`, `/reset` | Clear history and reset the session |
 | `/help` | `/h`, `/?` | Show available commands |
 | `/exit` | `/q`, `/quit` | Exit the session |
@@ -121,21 +122,24 @@ The CLI uses a generic adapter interface to support any coding agent. Each adapt
 
 | Preset | Command | Notes |
 |---|---|---|
-| `claude` | `claude -p --verbose` | Requires `claude` on PATH |
+| `claude` | `claude -p --verbose` | Default adapter. Requires `claude` on PATH |
 | `codex` | `codex exec` | Requires `codex` on PATH |
 | `aider` | `aider --message-file` | Requires `aider` on PATH |
+| `copilot` | GitHub Copilot SDK | Requires `@anthropic-ai/copilot-sdk` |
 | `echo` | (in-process) | Test adapter — echoes prompts, no external agent |
 
 ### How Adapters Work
 
-1. The adapter queries the recall index for relevant memories (automatic, in-process)
-2. The orchestrator builds a full prompt within a 32k token budget (SOUL → WISDOM → recall results → daily logs (budget-trimmed) → session state → roster → task)
-3. The prompt is written to a temp file
-4. The agent CLI is spawned with the prompt
-5. stdout/stderr are captured for result parsing
-6. The output is parsed for embedded handoff blocks
-7. The recall index is synced to pick up any files the agent created/modified
-8. Temp files are cleaned up
+1. **Auto-compaction** — If daily logs exceed the 24k token budget, oldest weeks are compacted into weekly summaries
+2. **Two-pass recall** — Pass 1: keyword extraction → query variation generation → frontmatter catalog matching → multi-query fusion with dedup. Pass 2: agents can search mid-task via `teammates-recall search`
+3. The orchestrator builds a full prompt with token-budgeted sections (identity → wisdom → recall → daily logs → roster → services → date/time/environment → user profile → task → output protocol → session/memory instructions)
+4. The prompt is written to a temp file
+5. The agent CLI is spawned with the prompt
+6. stdout/stderr are captured for result parsing
+7. **Empty response defense** — If the agent returns no text: retry with raw mode (no prompt wrapping), then minimal prompt, then synthetic fallback from metadata
+8. The output is parsed for embedded handoff blocks (with natural-language fallback)
+9. The recall index is synced to pick up any files the agent created/modified
+10. Temp files are cleaned up
 
 ### Writing a Custom Adapter
 
@@ -169,13 +173,15 @@ Or add a preset to `cli-proxy.ts` for any CLI agent that accepts a prompt and ru
 The CLI startup runs in two phases:
 
 **Phase 1 — Pre-TUI (console I/O)**
-1. **User profile setup** — Prompts for alias (required), name, role, experience, preferences, context. Creates `USER.md` and a user avatar folder at `.teammates/<alias>/` with `SOUL.md` (`**Type:** human`).
-2. **Team onboarding** (if no `.teammates/` exists) — Offers New team / Import / Solo / Exit. Onboarding agents run non-interactively to completion.
+1. **User profile setup** — If `USER.md` is missing, offers three paths: **GitHub** (imports name/alias via `gh api user`), **Manual** (prompts for alias, name, role, experience, preferences), or **Skip**. Creates `USER.md` and a user avatar folder at `.teammates/<alias>/` with `SOUL.md` (`**Type:** human`). Auto-detects the user's timezone.
+2. **Team onboarding** (if `.teammates/` was just created) — Offers **Pick teammates** (persona templates), **Auto-generate** (agent-driven), **Import** (from another project), **Solo mode**, or **Exit**.
 3. **Orchestrator init** — Loads existing teammates from `.teammates/`, registers user avatar with `type: "human"` and `presence: "online"`.
+4. **Startup maintenance** — Runs auto-compaction and recall sync for all teammates (silent — progress bar only, no feed output unless actual work was done).
 
 **Phase 2 — TUI (Consolonia)**
-4. Animated startup banner with roster
-5. REPL starts — routing, slash commands, handoff approval
+5. Animated startup banner with presence-colored roster
+6. REPL starts — routing, slash commands, handoff approval
+7. System tasks (compaction, summarization, wisdom distillation) run in the background without blocking user tasks
 
 All user interaction during Phase 1 uses plain console I/O (readline + ora spinners), avoiding mouse tracking issues that would occur inside the TUI.
 
@@ -191,7 +197,7 @@ The CLI ships with 15 built-in persona templates that serve as starting points w
 | **2 — Specialist** | Security (`shield`), Designer (`canvas`), Tech Writer (`quill`), Data Engineer (`forge`), SRE (`watchtower`), Architect (`blueprint`) |
 | **3 — Niche** | Frontend (`pixel`), Backend (`engine`), Mobile (`orbit`), ML/AI (`neuron`), Performance (`tempo`) |
 
-During onboarding, the CLI uses these personas to scaffold teammates. The user picks roles, optionally renames them, and the persona's SOUL.md body becomes the starting template — project-specific sections (commands, file patterns, technologies) are filled in by the onboarding agent.
+During onboarding, the CLI uses these personas to scaffold teammates. Use **Pick teammates** during initial onboarding or `/init pick` in-session to choose from the list. The user picks roles, optionally renames them, and the persona's SOUL.md body becomes the starting template — project-specific sections (commands, file patterns, technologies) are filled in by the onboarding agent.
 
 ## Architecture
 
@@ -201,12 +207,18 @@ cli/src/
   orchestrator.ts   # Task routing, session management, presence tracking
   adapter.ts        # AgentAdapter interface, prompt builder, handoff formatting
   registry.ts       # Discovers teammates from .teammates/, loads SOUL.md + memory, type detection
+  compact.ts        # Episodic memory compaction (daily→weekly→monthly) + auto-compaction
+  banner.ts         # Animated startup banner with presence roster and segmented footer
   personas.ts       # Persona loader — reads and parses bundled persona templates
+  theme.ts          # Theme configuration, color palette, styled text shortcuts
+  cli-args.ts       # CLI argument parsing, .teammates/ directory discovery
+  cli-utils.ts      # Pure utility functions (relativeTime, wrapLine, findAtMention, etc.)
   types.ts          # Core types (TeammateConfig, TaskResult, HandoffEnvelope, TeammateType, PresenceState)
   onboard.ts        # Template copying, team import, onboarding/adaptation prompts
   dropdown.ts       # Terminal dropdown/wordwheel widget
   adapters/
-    cli-proxy.ts    # Generic subprocess adapter with agent presets
+    cli-proxy.ts    # Generic subprocess adapter with agent presets (claude, codex, aider)
+    copilot.ts      # GitHub Copilot adapter
     echo.ts         # Test adapter (no-op)
 cli/personas/       # 15 persona template files (pm.md, swe.md, devops.md, etc.)
 ```
@@ -246,6 +258,11 @@ Tests use [Vitest](https://vitest.dev/) and cover the core modules:
 | `src/adapter.test.ts` | `buildTeammatePrompt`, `formatHandoffContext` |
 | `src/orchestrator.test.ts` | Task routing, assignment, reset |
 | `src/registry.test.ts` | Teammate discovery, SOUL.md parsing (role, ownership), daily logs |
+| `src/compact.test.ts` | Daily→weekly compaction, auto-compaction, partial merge |
+| `src/personas.test.ts` | Persona loading and scaffolding |
+| `src/theme.test.ts` | Theme configuration |
+| `src/cli-args.test.ts` | Argument parsing, directory discovery |
+| `src/cli-utils.test.ts` | Utility functions |
 | `src/adapters/echo.test.ts` | Echo adapter session and task execution |
 
 ## Dependencies

package/dist/cli-utils.d.ts

@@ -17,5 +17,34 @@ export declare function findAtMention(line: string, cursor: number): {
 } | null;
 /** Set of recognized image file extensions. */
 export declare const IMAGE_EXTS: Set<string>;
+/** A single entry in the conversation history. */
+export interface ConversationEntry {
+    role: string;
+    text: string;
+}
+/**
+ * Strip protocol artifacts (TO: header, handoff blocks, trailing JSON) from
+ * an agent's raw output, returning just the message body.
+ */
+export declare function cleanResponseBody(rawOutput: string): string;
+/**
+ * Format a conversation entry for inclusion in a prompt.
+ * Single-line text stays inline; multi-line text gets the body on the next line.
+ */
+export declare function formatConversationEntry(role: string, text: string): string;
+/**
+ * Build the conversation context section for a teammate prompt.
+ * Works backwards from newest entries, including whole entries up to the budget.
+ */
+export declare function buildConversationContext(history: ConversationEntry[], summary: string, budget: number): string;
+/**
+ * Find the split index where older conversation entries should be summarized.
+ * Returns 0 if everything fits within the budget (nothing to summarize).
+ */
+export declare function findSummarizationSplit(history: ConversationEntry[], budget: number): number;
+/**
+ * Build the summarization prompt text from entries being pushed out of the budget.
+ */
+export declare function buildSummarizationPrompt(entries: ConversationEntry[], existingSummary: string): string;
 /** Check if a string looks like an image file path. */
 export declare function isImagePath(text: string): boolean;

package/dist/cli-utils.js

@@ -61,6 +61,80 @@ export const IMAGE_EXTS = new Set([
     ".svg",
     ".ico",
 ]);
+/**
+ * Strip protocol artifacts (TO: header, handoff blocks, trailing JSON) from
+ * an agent's raw output, returning just the message body.
+ */
+export function cleanResponseBody(rawOutput) {
+    return rawOutput
+        .replace(/^TO:\s*\S+\s*\n/im, "")
+        .replace(/```handoff\s*\n@\w+\s*\n[\s\S]*?```/g, "")
+        .replace(/```json\s*\n\s*\{[\s\S]*?\}\s*\n\s*```\s*$/g, "")
+        .trim();
+}
+/**
+ * Format a conversation entry for inclusion in a prompt.
+ * Single-line text stays inline; multi-line text gets the body on the next line.
+ */
+export function formatConversationEntry(role, text) {
+    return text.includes("\n")
+        ? `**${role}:**\n${text}\n`
+        : `**${role}:** ${text}\n`;
+}
+/**
+ * Build the conversation context section for a teammate prompt.
+ * Works backwards from newest entries, including whole entries up to the budget.
+ */
+export function buildConversationContext(history, summary, budget) {
+    if (history.length === 0 && !summary)
+        return "";
+    const parts = ["## Conversation History\n"];
+    if (summary) {
+        parts.push(`### Previous Conversation Summary\n\n${summary}\n`);
+    }
+    const entries = [];
+    let used = 0;
+    for (let i = history.length - 1; i >= 0; i--) {
+        const entry = formatConversationEntry(history[i].role, history[i].text);
+        if (used + entry.length > budget && entries.length > 0)
+            break;
+        entries.unshift(entry);
+        used += entry.length;
+    }
+    if (entries.length > 0)
+        parts.push(entries.join("\n"));
+    return parts.join("\n");
+}
+/**
+ * Find the split index where older conversation entries should be summarized.
+ * Returns 0 if everything fits within the budget (nothing to summarize).
+ */
+export function findSummarizationSplit(history, budget) {
+    let recentChars = 0;
+    let splitIdx = history.length;
+    for (let i = history.length - 1; i >= 0; i--) {
+        const entry = formatConversationEntry(history[i].role, history[i].text);
+        if (recentChars + entry.length > budget)
+            break;
+        recentChars += entry.length;
+        splitIdx = i;
+    }
+    return splitIdx === history.length ? 0 : splitIdx;
+}
+/**
+ * Build the summarization prompt text from entries being pushed out of the budget.
+ */
+export function buildSummarizationPrompt(entries, existingSummary) {
+    const entriesText = entries
+        .map((e) => e.text.includes("\n")
+        ? `**${e.role}:**\n${e.text}`
+        : `**${e.role}:** ${e.text}`)
+        .join("\n\n");
+    const instructions = `## Instructions\n\nReturn ONLY the ${existingSummary ? "updated " : ""}summary — no preamble, no explanation. The summary should:\n- Be a concise bulleted list of key topics discussed, decisions made, and work completed\n- Preserve important context that future messages might reference\n- Drop trivial or redundant details\n- Stay under 2000 characters\n- Do NOT include any output protocol (no TO:, no # Subject, no handoff blocks)`;
+    return existingSummary
+        ? `You are maintaining a running summary of an ongoing conversation between a user and their AI teammates. Update the existing summary to incorporate the new conversation entries below.\n\n## Current Summary\n\n${existingSummary}\n\n## New Entries to Incorporate\n\n${entriesText}\n\n${instructions}`
+        : `You are maintaining a running summary of an ongoing conversation between a user and their AI teammates. Summarize the conversation entries below.\n\n## Entries to Summarize\n\n${entriesText}\n\n${instructions}`;
+}
 /** Check if a string looks like an image file path. */
 export function isImagePath(text) {
     // Must look like a file path (contains slash or backslash, or starts with drive letter)

package/dist/cli-utils.test.js

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { findAtMention, IMAGE_EXTS, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
+import { buildConversationContext, buildSummarizationPrompt, cleanResponseBody, findAtMention, findSummarizationSplit, formatConversationEntry, IMAGE_EXTS, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
 // ── relativeTime ────────────────────────────────────────────────────
 describe("relativeTime", () => {
     beforeEach(() => {
@@ -177,3 +177,187 @@ describe("IMAGE_EXTS", () => {
         expect(IMAGE_EXTS.size).toBe(8);
     });
 });
+// ── cleanResponseBody ──────────────────────────────────────────────
+describe("cleanResponseBody", () => {
+    it("strips TO: header", () => {
+        const raw = "TO: user\n# Subject\n\nBody text here";
+        expect(cleanResponseBody(raw)).toBe("# Subject\n\nBody text here");
+    });
+    it("strips TO: header case-insensitively", () => {
+        const raw = "to: User\n# Subject\n\nBody text here";
+        expect(cleanResponseBody(raw)).toBe("# Subject\n\nBody text here");
+    });
+    it("strips handoff blocks", () => {
+        const raw = "Some text\n\n```handoff\n@scribe\nDo this task\n```\n\nMore text";
+        expect(cleanResponseBody(raw)).toContain("Some text");
+        expect(cleanResponseBody(raw)).toContain("More text");
+        expect(cleanResponseBody(raw)).not.toContain("handoff");
+        expect(cleanResponseBody(raw)).not.toContain("@scribe");
+    });
+    it("strips multiple handoff blocks", () => {
+        const raw = "Text\n```handoff\n@scribe\ntask1\n```\nmiddle\n```handoff\n@beacon\ntask2\n```\nend";
+        expect(cleanResponseBody(raw)).toBe("Text\n\nmiddle\n\nend");
+    });
+    it("strips trailing JSON blocks", () => {
+        const raw = 'Body text\n\n```json\n{ "summary": "done" }\n```';
+        expect(cleanResponseBody(raw)).toBe("Body text");
+    });
+    it("strips all protocol artifacts together", () => {
+        const raw = 'TO: user\n# Done\n\nI finished the task.\n\n```handoff\n@pipeline\nDeploy it\n```\n\n```json\n{ "summary": "Done" }\n```';
+        expect(cleanResponseBody(raw)).toBe("# Done\n\nI finished the task.");
+    });
+    it("returns empty string for empty input", () => {
+        expect(cleanResponseBody("")).toBe("");
+    });
+    it("returns body unchanged when no protocol artifacts exist", () => {
+        expect(cleanResponseBody("Just a plain message")).toBe("Just a plain message");
+    });
+    it("trims surrounding whitespace", () => {
+        expect(cleanResponseBody("  \n  Hello  \n  ")).toBe("Hello");
+    });
+});
+// ── formatConversationEntry ────────────────────────────────────────
+describe("formatConversationEntry", () => {
+    it("formats single-line text inline", () => {
+        expect(formatConversationEntry("scribe", "Task completed")).toBe("**scribe:** Task completed\n");
+    });
+    it("formats multi-line text with body on next line", () => {
+        expect(formatConversationEntry("beacon", "Line 1\nLine 2")).toBe("**beacon:**\nLine 1\nLine 2\n");
+    });
+    it("treats single line with no newline as inline", () => {
+        expect(formatConversationEntry("user", "hello")).toBe("**user:** hello\n");
+    });
+});
+// ── buildConversationContext ────────────────────────────────────────
+describe("buildConversationContext", () => {
+    it("returns empty string for empty history and no summary", () => {
+        expect(buildConversationContext([], "", 1000)).toBe("");
+    });
+    it("includes summary when present", () => {
+        const result = buildConversationContext([], "Previous topics discussed", 1000);
+        expect(result).toContain("## Conversation History");
+        expect(result).toContain("### Previous Conversation Summary");
+        expect(result).toContain("Previous topics discussed");
+    });
+    it("includes all entries when within budget", () => {
+        const history = [
+            { role: "stevenic", text: "Hello" },
+            { role: "scribe", text: "Hi there" },
+            { role: "stevenic", text: "Do the thing" },
+        ];
+        const result = buildConversationContext(history, "", 10_000);
+        expect(result).toContain("**stevenic:** Hello");
+        expect(result).toContain("**scribe:** Hi there");
+        expect(result).toContain("**stevenic:** Do the thing");
+    });
+    it("drops oldest entries when over budget", () => {
+        const history = [
+            { role: "old", text: "A".repeat(500) },
+            { role: "mid", text: "B".repeat(500) },
+            { role: "new", text: "C".repeat(500) },
+        ];
+        // Budget enough for ~2 entries but not 3
+        const budget = 1100;
+        const result = buildConversationContext(history, "", budget);
+        expect(result).not.toContain("**old:**");
+        expect(result).toContain("**new:**");
+    });
+    it("always includes at least the newest entry even if over budget", () => {
+        const history = [
+            { role: "beacon", text: "A".repeat(2000) },
+        ];
+        const result = buildConversationContext(history, "", 100);
+        expect(result).toContain("**beacon:**");
+    });
+    it("formats multi-line entries with body on next line", () => {
+        const history = [
+            { role: "scribe", text: "Line 1\nLine 2\nLine 3" },
+        ];
+        const result = buildConversationContext(history, "", 10_000);
+        expect(result).toContain("**scribe:**\nLine 1\nLine 2\nLine 3");
+    });
+    it("includes both summary and entries", () => {
+        const history = [
+            { role: "stevenic", text: "Latest message" },
+        ];
+        const result = buildConversationContext(history, "Earlier we discussed X", 10_000);
+        expect(result).toContain("### Previous Conversation Summary");
+        expect(result).toContain("Earlier we discussed X");
+        expect(result).toContain("**stevenic:** Latest message");
+    });
+});
+// ── findSummarizationSplit ─────────────────────────────────────────
+describe("findSummarizationSplit", () => {
+    it("returns 0 when everything fits in budget", () => {
+        const history = [
+            { role: "a", text: "short" },
+            { role: "b", text: "also short" },
+        ];
+        expect(findSummarizationSplit(history, 10_000)).toBe(0);
+    });
+    it("returns 0 for empty history", () => {
+        expect(findSummarizationSplit([], 1000)).toBe(0);
+    });
+    it("returns split index when history exceeds budget", () => {
+        const history = [
+            { role: "old1", text: "A".repeat(400) },
+            { role: "old2", text: "B".repeat(400) },
+            { role: "new1", text: "C".repeat(400) },
+            { role: "new2", text: "D".repeat(400) },
+        ];
+        // Budget fits ~2 entries (~430 chars each with formatting)
+        const budget = 900;
+        const split = findSummarizationSplit(history, budget);
+        expect(split).toBeGreaterThan(0);
+        expect(split).toBeLessThan(history.length);
+    });
+    it("keeps newest entries and pushes oldest out", () => {
+        const history = [
+            { role: "oldest", text: "X".repeat(300) },
+            { role: "middle", text: "Y".repeat(300) },
+            { role: "newest", text: "Z".repeat(300) },
+        ];
+        // Budget fits 1 entry
+        const budget = 350;
+        const split = findSummarizationSplit(history, budget);
+        // Split should be 2 — entries 0 and 1 get summarized, entry 2 (newest) stays
+        expect(split).toBe(2);
+    });
+    it("returns 0 when single entry fits", () => {
+        const history = [{ role: "a", text: "hello" }];
+        expect(findSummarizationSplit(history, 10_000)).toBe(0);
+    });
+});
+// ── buildSummarizationPrompt ───────────────────────────────────────
+describe("buildSummarizationPrompt", () => {
+    const entries = [
+        { role: "stevenic", text: "Build the feature" },
+        { role: "beacon", text: "Done, here's what I did" },
+    ];
+    it("builds a fresh summarization prompt when no existing summary", () => {
+        const prompt = buildSummarizationPrompt(entries, "");
+        expect(prompt).toContain("Summarize the conversation entries below");
+        expect(prompt).toContain("**stevenic:** Build the feature");
+        expect(prompt).toContain("**beacon:** Done, here's what I did");
+        expect(prompt).not.toContain("Current Summary");
+    });
+    it("builds an update prompt when existing summary is present", () => {
+        const prompt = buildSummarizationPrompt(entries, "Previously discussed X");
+        expect(prompt).toContain("Update the existing summary");
+        expect(prompt).toContain("## Current Summary");
+        expect(prompt).toContain("Previously discussed X");
+        expect(prompt).toContain("## New Entries to Incorporate");
+    });
+    it("includes instruction constraints", () => {
+        const prompt = buildSummarizationPrompt(entries, "");
+        expect(prompt).toContain("Stay under 2000 characters");
+        expect(prompt).toContain("Do NOT include any output protocol");
+    });
+    it("formats multi-line entries correctly", () => {
+        const multiLine = [
+            { role: "scribe", text: "Line 1\nLine 2" },
+        ];
+        const prompt = buildSummarizationPrompt(multiLine, "");
+        expect(prompt).toContain("**scribe:**\nLine 1\nLine 2");
+    });
+});

package/dist/cli.js

@@ -18,7 +18,7 @@ import ora from "ora";
 import { DAILY_LOG_BUDGET_TOKENS, syncRecallIndex } from "./adapter.js";
 import { AnimatedBanner, } from "./banner.js";
 import { findTeammatesDir, PKG_VERSION, parseCliArgs, printUsage, resolveAdapter, } from "./cli-args.js";
-import { findAtMention, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
+import { buildConversationContext as buildConvCtx, buildSummarizationPrompt, cleanResponseBody, findAtMention, findSummarizationSplit, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
 import { autoCompactForBudget, buildWisdomPrompt, compactEpisodic, purgeStaleDailies, } from "./compact.js";
 import { PromptInput } from "./console/prompt-input.js";
 import { buildTitle } from "./console/startup.js";
@@ -44,9 +44,12 @@ class TeammatesREPL {
     storeResult(result) {
         this.lastResult = result;
         this.lastResults.set(result.teammate, result);
+        // Store the full response body in conversation history — not just the
+        // subject line.  The 24k-token budget + auto-summarization handle size.
+        const body = cleanResponseBody(result.rawOutput ?? "");
         this.conversationHistory.push({
             role: result.teammate,
-            text: result.summary,
+            text: body || result.summary,
         });
     }
     /**
@@ -152,27 +155,7 @@ class TeammatesREPL {
     /** Token budget for recent conversation history (24k tokens ≈ 96k chars). */
     static CONV_HISTORY_CHARS = 24_000 * 4;
     buildConversationContext() {
-        if (this.conversationHistory.length === 0 && !this.conversationSummary)
-            return "";
-        const budget = TeammatesREPL.CONV_HISTORY_CHARS;
-        const parts = ["## Conversation History\n"];
-        // Include running summary of older conversation if present
-        if (this.conversationSummary) {
-            parts.push(`### Previous Conversation Summary\n\n${this.conversationSummary}\n`);
-        }
-        // Work backwards from newest — include whole entries up to 24k tokens
-        const entries = [];
-        let used = 0;
-        for (let i = this.conversationHistory.length - 1; i >= 0; i--) {
-            const line = `**${this.conversationHistory[i].role}:** ${this.conversationHistory[i].text}\n`;
-            if (used + line.length > budget && entries.length > 0)
-                break;
-            entries.unshift(line);
-            used += line.length;
-        }
-        if (entries.length > 0)
-            parts.push(entries.join("\n"));
-        return parts.join("\n");
+        return buildConvCtx(this.conversationHistory, this.conversationSummary, TeammatesREPL.CONV_HISTORY_CHARS);
     }
     /**
      * Check if conversation history exceeds the 24k token budget.
@@ -180,28 +163,11 @@ class TeammatesREPL {
      * and queue a summarization task to the coding agent.
      */
     maybeQueueSummarization() {
-        const budget = TeammatesREPL.CONV_HISTORY_CHARS;
-        // Calculate how many recent entries fit in the budget (newest first)
-        let recentChars = 0;
-        let splitIdx = this.conversationHistory.length;
-        for (let i = this.conversationHistory.length - 1; i >= 0; i--) {
-            const line = `**${this.conversationHistory[i].role}:** ${this.conversationHistory[i].text}\n`;
-            if (recentChars + line.length > budget)
-                break;
-            recentChars += line.length;
-            splitIdx = i;
-        }
+        const splitIdx = findSummarizationSplit(this.conversationHistory, TeammatesREPL.CONV_HISTORY_CHARS);
         if (splitIdx === 0)
             return; // everything fits — nothing to summarize
-        // Collect entries that are being pushed out
         const toSummarize = this.conversationHistory.slice(0, splitIdx);
-        const entriesText = toSummarize
-            .map((e) => `**${e.role}:** ${e.text}`)
-            .join("\n");
-        // Build the summarization prompt
-        const prompt = this.conversationSummary
-            ? `You are maintaining a running summary of an ongoing conversation between a user and their AI teammates. Update the existing summary to incorporate the new conversation entries below.\n\n## Current Summary\n\n${this.conversationSummary}\n\n## New Entries to Incorporate\n\n${entriesText}\n\n## Instructions\n\nReturn ONLY the updated summary — no preamble, no explanation. The summary should:\n- Be a concise bulleted list of key topics discussed, decisions made, and work completed\n- Preserve important context that future messages might reference\n- Drop trivial or redundant details\n- Stay under 2000 characters\n- Do NOT include any output protocol (no TO:, no # Subject, no handoff blocks)`
-            : `You are maintaining a running summary of an ongoing conversation between a user and their AI teammates. Summarize the conversation entries below.\n\n## Entries to Summarize\n\n${entriesText}\n\n## Instructions\n\nReturn ONLY the summary — no preamble, no explanation. The summary should:\n- Be a concise bulleted list of key topics discussed, decisions made, and work completed\n- Preserve important context that future messages might reference\n- Drop trivial or redundant details\n- Stay under 2000 characters\n- Do NOT include any output protocol (no TO:, no # Subject, no handoff blocks)`;
+        const prompt = buildSummarizationPrompt(toSummarize, this.conversationSummary);
         // Remove the summarized entries — they'll be captured in the summary
         this.conversationHistory.splice(0, splitIdx);
         // Queue the summarization task through the user's agent
@@ -346,12 +312,12 @@ class TeammatesREPL {
         // Keep adding segments from the front until we'd exceed maxLen
         let front = parts[0];
         for (let i = 1; i < parts.length - 1; i++) {
-            const candidate = front + sep + parts[i] + sep + "..." + sep + last;
+            const candidate = `${front + sep + parts[i] + sep}...${sep}${last}`;
             if (candidate.length > maxLen)
                 break;
             front += sep + parts[i];
         }
-        return front + sep + "..." + sep + last;
+        return `${front + sep}...${sep}${last}`;
     }
     /** Format elapsed seconds as (Ns), (Nm Ns), or (Nh Nm Ns). */
     static formatElapsed(totalSeconds) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teammates/cli",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Agent-agnostic CLI for teammates. Routes tasks, manages handoffs, and plugs into any coding agent backend.",
   "type": "module",
   "main": "dist/index.js",
@@ -34,8 +34,8 @@
   "license": "MIT",
   "dependencies": {
     "@github/copilot-sdk": "^0.1.32",
-    "@teammates/consolonia": "0.5.2",
-    "@teammates/recall": "0.5.2",
+    "@teammates/consolonia": "0.5.3",
+    "@teammates/recall": "0.5.3",
     "chalk": "^5.6.2",
     "ora": "^9.3.0"
   },