@teammates/cli 0.3.4 → 0.4.1

package/README.md

@@ -129,7 +129,7 @@ The CLI uses a generic adapter interface to support any coding agent. Each adapt
 ### How Adapters Work
 
 1. The adapter queries the recall index for relevant memories (automatic, in-process)
-2. The orchestrator builds a full prompt (SOUL → WISDOM → recall results → daily logs → weekly summaries → session history → roster → task)
+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

package/dist/adapter.d.ts

@@ -70,14 +70,27 @@ export declare function syncRecallIndex(teammatesDir: string, teammate?: string)
 /**
  * Build the full prompt for a teammate session.
  * Includes identity, memory, roster, output protocol, and the task.
+ *
+ * Context budget (32k tokens):
+ * - Current daily log (today): always included, outside budget
+ * - Days 2-7: up to 24k tokens (whole entries)
+ * - Recall results: at least 8k tokens + unused daily log budget
+ *   (last entry may overflow by up to 4k tokens)
+ * - Weekly summaries: excluded (already indexed by recall)
+ *
+ * Identity, wisdom, roster, and protocol are never trimmed.
+ * The task prompt is never trimmed.
  */
 export declare function buildTeammatePrompt(teammate: TeammateConfig, taskPrompt: string, options?: {
     handoffContext?: string;
     roster?: RosterEntry[];
     services?: InstalledService[];
     sessionFile?: string;
-    sessionContent?: string;
     recallResults?: SearchResult[];
+    /** Contents of USER.md — injected just before the task. */
+    userProfile?: string;
+    /** Token budget for the prompt wrapper (default 64k). Task is excluded. */
+    tokenBudget?: number;
 }): string;
 /**
  * Format a handoff envelope into a human-readable context string.

package/dist/adapter.js

@@ -40,164 +40,170 @@ export async function syncRecallIndex(teammatesDir, teammate) {
         await indexer.syncAll();
     }
 }
+/**
+ * Default token budget for the prompt wrapper (everything except the task).
+ * ~64k tokens ≈ 256k chars at ~4 chars/token.
+ * The task prompt itself is excluded from this budget — if a user pastes
+ * a large input, that's intentional and we don't trim it.
+ */
+const DEFAULT_TOKEN_BUDGET = 64_000;
+const CHARS_PER_TOKEN = 4;
+/**
+ * Context budget allocation:
+ * - Days 2-7 get up to DAILY_LOG_BUDGET tokens (whole entries)
+ * - Recall gets at least RECALL_MIN_BUDGET, plus whatever daily logs didn't use
+ * - Last recall entry can push total up to CONTEXT_BUDGET + RECALL_OVERFLOW (36k)
+ * - Weekly summaries are excluded (already indexed by recall)
+ */
+const CONTEXT_BUDGET_TOKENS = 32_000;
+const DAILY_LOG_BUDGET_TOKENS = 24_000;
+const RECALL_MIN_BUDGET_TOKENS = 8_000;
+const RECALL_OVERFLOW_TOKENS = 4_000;
+/** Estimate tokens from character count. */
+function estimateTokens(text) {
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
 /**
  * Build the full prompt for a teammate session.
  * Includes identity, memory, roster, output protocol, and the task.
+ *
+ * Context budget (32k tokens):
+ * - Current daily log (today): always included, outside budget
+ * - Days 2-7: up to 24k tokens (whole entries)
+ * - Recall results: at least 8k tokens + unused daily log budget
+ *   (last entry may overflow by up to 4k tokens)
+ * - Weekly summaries: excluded (already indexed by recall)
+ *
+ * Identity, wisdom, roster, and protocol are never trimmed.
+ * The task prompt is never trimmed.
  */
 export function buildTeammatePrompt(teammate, taskPrompt, options) {
     const parts = [];
-    // ── Identity ──────────────────────────────────────────────────────
-    parts.push(`# You are ${teammate.name}\n`);
-    parts.push(teammate.soul);
-    parts.push("\n---\n");
-    // ── Wisdom ───────────────────────────────────────────────────────
+    // ── Identity (required) ─────────────────────────────────────────
+    parts.push(`# You are ${teammate.name}\n\n${teammate.soul}\n\n---\n`);
+    // ── Wisdom (required) ───────────────────────────────────────────
     if (teammate.wisdom.trim()) {
-        parts.push("## Your Wisdom\n");
-        parts.push(teammate.wisdom);
-        parts.push("\n---\n");
-    }
-    // ── Recall results (relevant episodic & semantic memories) ────────
-    if (options?.recallResults && options.recallResults.length > 0) {
-        parts.push("## Relevant Memories (from recall search)\n");
-        parts.push("These memories were retrieved based on relevance to the current task:\n");
-        for (const r of options.recallResults) {
+        parts.push(`## Your Wisdom\n\n${teammate.wisdom}\n\n---\n`);
+    }
+    // ── Budget-allocated context (daily logs → recall) ──────────────
+    // Today's log: always included, outside budget
+    // Days 2-7: up to 24k tokens (whole entries)
+    // Recall: at least 8k + unused daily budget, last entry may overflow by 4k
+    const todayLog = teammate.dailyLogs.slice(0, 1);
+    const pastLogs = teammate.dailyLogs.slice(1, 7); // days 2-7
+    let dailyBudget = DAILY_LOG_BUDGET_TOKENS;
+    // Current daily log (today) — never trimmed, always included
+    if (todayLog.length > 0) {
+        const todayLines = ["## Recent Daily Logs\n"];
+        for (const log of todayLog) {
+            todayLines.push(`### ${log.date}\n${log.content}\n`);
+        }
+        parts.push(todayLines.join("\n"));
+    }
+    // Days 2-7 — whole entries, up to 24k tokens
+    if (pastLogs.length > 0) {
+        const lines = [];
+        for (const log of pastLogs) {
+            const entry = `### ${log.date}\n${log.content}\n`;
+            const cost = estimateTokens(entry);
+            if (cost > dailyBudget)
+                break;
+            lines.push(entry);
+            dailyBudget -= cost;
+        }
+        if (lines.length > 0)
+            parts.push(lines.join("\n"));
+    }
+    // Recall results — gets at least 8k tokens, plus unused daily budget
+    // Last entry may overflow by up to 4k tokens
+    const recallBudget = Math.max(RECALL_MIN_BUDGET_TOKENS, RECALL_MIN_BUDGET_TOKENS + dailyBudget);
+    const recallResults = options?.recallResults ?? [];
+    if (recallResults.length > 0) {
+        const lines = [
+            "## Relevant Memories (from recall search)\n",
+            "These memories were retrieved based on relevance to the current task:\n",
+        ];
+        const headerCost = estimateTokens(lines.join("\n"));
+        let recallUsed = headerCost;
+        for (const r of recallResults) {
             const label = r.contentType
                 ? `[${r.contentType}] ${r.uri}`
                 : r.uri;
-            parts.push(`### ${label}\n${r.text}\n`);
+            const entry = `### ${label}\n${r.text}\n`;
+            const cost = estimateTokens(entry);
+            if (recallUsed + cost > recallBudget + RECALL_OVERFLOW_TOKENS)
+                break;
+            lines.push(entry);
+            recallUsed += cost;
+            // Stop cleanly at budget — but allow the current entry (overflow grace)
+            if (recallUsed >= recallBudget)
+                break;
         }
-        parts.push("\n---\n");
-    }
-    // ── Recent daily logs ──────────────────────────────────────────────
-    if (teammate.dailyLogs.length > 0) {
-        parts.push("## Recent Daily Logs\n");
-        for (const log of teammate.dailyLogs.slice(0, 7)) {
-            parts.push(`### ${log.date}\n${log.content}\n`);
+        if (lines.length > 2) {
+            lines.push("\n---\n");
+            parts.push(lines.join("\n"));
         }
-        parts.push("\n---\n");
     }
-    // ── Weekly summaries (recent episodic context) ─────────────────────
-    if (teammate.weeklyLogs.length > 0) {
-        parts.push("## Recent Weekly Summaries\n");
-        for (const log of teammate.weeklyLogs.slice(0, 2)) {
-            parts.push(`### ${log.week}\n${log.content}\n`);
+    // Close context section with separator if needed
+    if (todayLog.length > 0 || pastLogs.length > 0) {
+        const lastPart = parts[parts.length - 1];
+        if (!lastPart.endsWith("---\n")) {
+            parts.push("\n---\n");
         }
-        parts.push("\n---\n");
     }
-    // ── Session history (prior tasks in this session) ─────────────────
-    if (options?.sessionContent?.trim()) {
-        parts.push("## Session History\n");
-        parts.push("These are entries from your prior tasks in this session:\n");
-        parts.push(options.sessionContent);
-        parts.push("\n---\n");
-    }
-    // ── Team roster ───────────────────────────────────────────────────
+    // ── Team roster (required, small) ───────────────────────────────
     if (options?.roster && options.roster.length > 0) {
-        parts.push("## Your Team\n");
-        parts.push("These are the other teammates you can hand off work to:\n");
+        const lines = [
+            "## Your Team\n",
+            "These are the other teammates you can hand off work to:\n",
+        ];
         for (const t of options.roster) {
             if (t.name === teammate.name)
                 continue;
             const owns = t.ownership.primary.length > 0
                 ? ` — owns: ${t.ownership.primary.join(", ")}`
                 : "";
-            parts.push(`- **@${t.name}**: ${t.role}${owns}`);
+            lines.push(`- **@${t.name}**: ${t.role}${owns}`);
         }
-        parts.push("\n---\n");
+        lines.push("\n---\n");
+        parts.push(lines.join("\n"));
     }
-    // ── Installed services ──────────────────────────────────────────────
+    // ── Installed services (required, small) ────────────────────────
     if (options?.services && options.services.length > 0) {
-        parts.push("## Available Services\n");
-        parts.push("These services are installed and available for you to use:\n");
+        const lines = [
+            "## Available Services\n",
+            "These services are installed and available for you to use:\n",
+        ];
         for (const svc of options.services) {
-            parts.push(`### ${svc.name}\n`);
-            parts.push(svc.description);
-            parts.push(`\n**Usage:** \`${svc.usage}\`\n`);
+            lines.push(`### ${svc.name}\n`);
+            lines.push(svc.description);
+            lines.push(`\n**Usage:** \`${svc.usage}\`\n`);
         }
-        parts.push("\n---\n");
+        lines.push("\n---\n");
+        parts.push(lines.join("\n"));
     }
-    // ── Handoff context (if this task came from another teammate) ─────
+    // ── Handoff context (required when present) ─────────────────────
     if (options?.handoffContext) {
-        parts.push("## Handoff Context\n");
-        parts.push(options.handoffContext);
-        parts.push("\n---\n");
+        parts.push(`## Handoff Context\n\n${options.handoffContext}\n\n---\n`);
     }
-    // ── Session state ────────────────────────────────────────────────
+    // ── Session state (required) ────────────────────────────────────
     if (options?.sessionFile) {
-        parts.push("## Session State\n");
-        parts.push(`Your session file is at: \`${options.sessionFile}\`
-
-**Before returning your result**, append a brief entry to this file with:
-- What you did
-- Key decisions made
-- Files changed
-- Anything the next task should know
-
-This is how you maintain continuity across tasks. Always read it, always update it.
-`);
-        parts.push("\n---\n");
-    }
-    // ── Memory updates ─────────────────────────────────────────────────
+        parts.push(`## Session State\n\nYour session file is at: \`${options.sessionFile}\`\n\n**Before returning your result**, append a brief entry to this file with:\n- What you did\n- Key decisions made\n- Files changed\n- Anything the next task should know\n\nThis is how you maintain continuity across tasks. Always read it, always update it.\n\n---\n`);
+    }
+    // ── Memory updates (required) ───────────────────────────────────
     const today = new Date().toISOString().slice(0, 10);
-    parts.push("## Memory Updates\n");
-    parts.push(`**Before returning your result**, update your memory files:
-
-1. **Daily log** — Read \`.teammates/${teammate.name}/memory/${today}.md\` first (it may have entries from earlier tasks today), then write it back with your entry added. Create the file if it doesn't exist.
-   - What you did
-   - Key decisions made
-   - Files changed
-   - Anything the next task should know
-
-2. **Typed memories** — If you learned something durable (a decision, pattern, feedback, or reference), create a typed memory file at \`.teammates/${teammate.name}/memory/<type>_<topic>.md\` with frontmatter (\`name\`, \`description\`, \`type\`). Update existing memory files if the topic already has one.
-
-3. **WISDOM.md** — Do not edit directly. Wisdom entries are distilled from typed memories during compaction.
-
-These files are your persistent memory. Without them, your next session starts from scratch.
-`);
-    parts.push("\n---\n");
-    // ── Output protocol ───────────────────────────────────────────────
-    parts.push("## Output Protocol (CRITICAL)\n");
-    parts.push(`**Your #1 job is to produce a visible text response.** Session updates and memory writes are secondary — they support continuity but are not the deliverable. The user sees ONLY your text output. If you update files but return no text, the user sees an empty message and your work is invisible.
-
-Format your response as:
-
-\`\`\`
-TO: user
-# <Subject line>
-
-<Body — full markdown response>
-\`\`\`
-
-**Handoffs:** To hand off work to a teammate, include a fenced handoff block anywhere in your response:
-
-\`\`\`
-\`\`\`handoff
-@<teammate>
-<task description — what you need them to do, with full context>
-\`\`\`
-\`\`\`
-
-**Rules:**
-- **You MUST end your turn with visible text output.** A turn that ends with only tool calls and no text is a failed turn.
-- The \`# Subject\` line is REQUIRED — it becomes the message title.
-- Always write a substantive body. Never return just the subject.
-- Use markdown: headings, lists, code blocks, bold, etc.
-- Do as much work as you can before handing off.
-- Only hand off to teammates listed in "Your Team" above.
-- The handoff block can appear anywhere in your response — it will be detected automatically.
-`);
-    parts.push("\n---\n");
-    // ── Current date/time ────────────────────────────────────────────
+    parts.push(`## Memory Updates\n\n**Before returning your result**, update your memory files:\n\n1. **Daily log** — Read \`.teammates/${teammate.name}/memory/${today}.md\` first (it may have entries from earlier tasks today), then write it back with your entry added. Create the file if it doesn't exist.\n   - What you did\n   - Key decisions made\n   - Files changed\n   - Anything the next task should know\n\n2. **Typed memories** — If you learned something durable (a decision, pattern, feedback, or reference), create a typed memory file at \`.teammates/${teammate.name}/memory/<type>_<topic>.md\` with frontmatter (\`name\`, \`description\`, \`type\`). Update existing memory files if the topic already has one.\n\n3. **WISDOM.md** — Do not edit directly. Wisdom entries are distilled from typed memories during compaction.\n\nThese files are your persistent memory. Without them, your next session starts from scratch.\n\n---\n`);
+    // ── Output protocol (required) ──────────────────────────────────
+    parts.push(`## Output Protocol (CRITICAL)\n\n**Your #1 job is to produce a visible text response.** Session updates and memory writes are secondary — they support continuity but are not the deliverable. The user sees ONLY your text output. If you update files but return no text, the user sees an empty message and your work is invisible.\n\nFormat your response as:\n\n\`\`\`\nTO: user\n# <Subject line>\n\n<Body — full markdown response>\n\`\`\`\n\n**Handoffs:** To hand off work to a teammate, include a fenced handoff block anywhere in your response:\n\n\`\`\`\n\`\`\`handoff\n@<teammate>\n<task description — what you need them to do, with full context>\n\`\`\`\n\`\`\`\n\n**Rules:**\n- **You MUST end your turn with visible text output.** A turn that ends with only tool calls and no text is a failed turn.\n- The \`# Subject\` line is REQUIRED — it becomes the message title.\n- Always write a substantive body. Never return just the subject.\n- Use markdown: headings, lists, code blocks, bold, etc.\n- Do as much work as you can before handing off.\n- Only hand off to teammates listed in "Your Team" above.\n- The handoff block can appear anywhere in your response — it will be detected automatically.\n\n---\n`);
+    // ── Current date/time (required, small) ─────────────────────────
     const now = new Date();
-    parts.push(`**Current date:** ${now.toLocaleDateString("en-US", { weekday: "long", year: "numeric", month: "long", day: "numeric" })} (${today})`);
-    parts.push(`**Current time:** ${now.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit" })}\n`);
-    parts.push("---\n");
-    // ── Task ──────────────────────────────────────────────────────────
-    parts.push("## Task\n");
-    parts.push(taskPrompt);
-    parts.push("\n---\n");
-    // ── Final reminder (last thing the agent reads) ─────────────────
-    parts.push("**REMINDER: After completing the task and updating session/memory files, you MUST produce a text response starting with `TO: user`. An empty response is a bug.**");
+    parts.push(`**Current date:** ${now.toLocaleDateString("en-US", { weekday: "long", year: "numeric", month: "long", day: "numeric" })} (${today})\n**Current time:** ${now.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit" })}\n\n---\n`);
+    // ── User profile (always included when present) ────────────────
+    if (options?.userProfile?.trim()) {
+        parts.push(`## User Profile\n\n${options.userProfile.trim()}\n\n---\n`);
+    }
+    // ── Task (always included, excluded from budget) ────────────────
+    parts.push(`## Task\n\n${taskPrompt}\n\n---\n\n**REMINDER: After completing the task and updating session/memory files, you MUST produce a text response starting with \`TO: user\`. An empty response is a bug.**`);
     return parts.join("\n");
 }
 /**

package/dist/adapter.test.js

@@ -3,6 +3,7 @@ import { buildTeammatePrompt, formatHandoffContext } from "./adapter.js";
 function makeConfig(overrides) {
     return {
         name: "beacon",
+        type: "ai",
         role: "Platform engineer.",
         soul: "# Beacon\n\nBeacon owns the recall package.",
         wisdom: "",
@@ -99,6 +100,80 @@ describe("buildTeammatePrompt", () => {
         expect(prompt).toContain("## Session State");
         expect(prompt).toContain("/tmp/beacon-session.md");
     });
+    it("drops daily logs that exceed the 24k daily budget", () => {
+        // Each log is ~50k chars = ~12.5k tokens. Only 1 fits in 24k daily budget.
+        const bigContent = "D".repeat(50_000);
+        const config = makeConfig({
+            dailyLogs: [
+                { date: "2026-03-18", content: "Today's log — never trimmed" },
+                { date: "2026-03-17", content: bigContent }, // day 2 — fits in 24k
+                { date: "2026-03-16", content: bigContent }, // day 3 — exceeds 24k, dropped
+            ],
+        });
+        const prompt = buildTeammatePrompt(config, "task");
+        // Today's log is always fully present (never trimmed)
+        expect(prompt).toContain("Today's log — never trimmed");
+        // Day 2 fits within 24k
+        expect(prompt).toContain("2026-03-17");
+        // Day 3 doesn't fit (12.5k + 12.5k > 24k)
+        expect(prompt).not.toContain("2026-03-16");
+    });
+    it("recall gets at least 8k tokens even when daily logs use full 24k", () => {
+        // Daily logs fill their 24k budget. Recall still gets its guaranteed 8k minimum.
+        const dailyContent = "D".repeat(90_000); // ~22.5k tokens — fits in 24k
+        const config = makeConfig({
+            dailyLogs: [
+                { date: "2026-03-18", content: "today" },
+                { date: "2026-03-17", content: dailyContent },
+            ],
+        });
+        const recallText = "R".repeat(20_000); // ~5k tokens — fits in 8k min
+        const prompt = buildTeammatePrompt(config, "task", {
+            recallResults: [
+                { teammate: "beacon", uri: "memory/decision_foo.md", text: recallText, score: 0.9, contentType: "typed_memory" },
+            ],
+        });
+        expect(prompt).toContain("2026-03-17");
+        expect(prompt).toContain("## Relevant Memories");
+    });
+    it("recall gets unused daily log budget", () => {
+        // Small daily logs leave most of 24k unused — recall gets the surplus.
+        const config = makeConfig({
+            dailyLogs: [
+                { date: "2026-03-18", content: "today" },
+                { date: "2026-03-17", content: "short day 2" }, // ~3 tokens
+            ],
+        });
+        // Large recall result — should fit because daily logs barely used any budget
+        const recallText = "R".repeat(80_000); // ~20k tokens — fits in (8k + ~24k unused)
+        const prompt = buildTeammatePrompt(config, "task", {
+            recallResults: [
+                { teammate: "beacon", uri: "memory/big.md", text: recallText, score: 0.9, contentType: "typed_memory" },
+            ],
+        });
+        expect(prompt).toContain("## Relevant Memories");
+        expect(prompt).toContain("memory/big.md");
+    });
+    it("weekly summaries are excluded (indexed by recall)", () => {
+        const config = makeConfig({
+            dailyLogs: [{ date: "2026-03-13", content: "short log" }],
+            weeklyLogs: [{ week: "2026-W11", content: "short summary" }],
+        });
+        const prompt = buildTeammatePrompt(config, "task");
+        expect(prompt).toContain("## Recent Daily Logs");
+        expect(prompt).not.toContain("## Recent Weekly Summaries");
+    });
+    it("excludes task prompt from budget calculation", () => {
+        // Large task prompt should not trigger trimming of wrapper sections
+        const bigTask = "x".repeat(100_000);
+        const config = makeConfig({
+            dailyLogs: [{ date: "2026-03-13", content: "small log" }],
+        });
+        const prompt = buildTeammatePrompt(config, bigTask);
+        // Daily logs should still be included despite the huge task
+        expect(prompt).toContain("## Recent Daily Logs");
+        expect(prompt).toContain("small log");
+    });
 });
 describe("formatHandoffContext", () => {
     it("formats basic handoff", () => {

package/dist/adapters/cli-proxy.js

@@ -140,16 +140,6 @@ export class CliProxyAdapter {
         // If the teammate has no soul (e.g. the raw agent), skip identity/memory
         // wrapping but include handoff instructions so it can delegate to teammates
         const sessionFile = this.sessionFiles.get(teammate.name);
-        // Read session file content for injection into the prompt
-        let sessionContent;
-        if (sessionFile) {
-            try {
-                sessionContent = await readFile(sessionFile, "utf-8");
-            }
-            catch {
-                // Session file may not exist yet — that's fine
-            }
-        }
         let fullPrompt;
         if (teammate.soul) {
             // Query recall for relevant memories before building prompt
@@ -159,12 +149,22 @@ export class CliProxyAdapter {
             const recall = teammatesDir
                 ? await queryRecallContext(teammatesDir, teammate.name, prompt)
                 : undefined;
+            // Read USER.md for injection into the prompt
+            let userProfile;
+            if (teammatesDir) {
+                try {
+                    userProfile = await readFile(join(teammatesDir, "USER.md"), "utf-8");
+                }
+                catch {
+                    // USER.md may not exist yet — that's fine
+                }
+            }
             fullPrompt = buildTeammatePrompt(teammate, prompt, {
                 roster: this.roster,
                 services: this.services,
                 sessionFile,
-                sessionContent,
                 recallResults: recall?.results,
+                userProfile,
             });
         }
         else {
@@ -230,6 +230,7 @@ export class CliProxyAdapter {
             const command = this.options.commandPath ?? this.preset.command;
             const args = this.preset.buildArgs({ promptFile, prompt }, {
                 name: "_router",
+                type: "ai",
                 role: "",
                 soul: "",
                 wisdom: "",

package/dist/adapters/copilot.js

@@ -59,16 +59,6 @@ export class CopilotAdapter {
     async executeTask(_sessionId, teammate, prompt) {
         await this.ensureClient(teammate.cwd);
         const sessionFile = this.sessionFiles.get(teammate.name);
-        // Read session file content for injection into the prompt
-        let sessionContent;
-        if (sessionFile) {
-            try {
-                sessionContent = await readFile(sessionFile, "utf-8");
-            }
-            catch {
-                // Session file may not exist yet — that's fine
-            }
-        }
         // Build the full teammate prompt (identity + memory + task)
         let fullPrompt;
         if (teammate.soul) {
@@ -79,12 +69,22 @@ export class CopilotAdapter {
             const recall = teammatesDir
                 ? await queryRecallContext(teammatesDir, teammate.name, prompt)
                 : undefined;
+            // Read USER.md for injection into the prompt
+            let userProfile;
+            if (teammatesDir) {
+                try {
+                    userProfile = await readFile(join(teammatesDir, "USER.md"), "utf-8");
+                }
+                catch {
+                    // USER.md may not exist yet — that's fine
+                }
+            }
             fullPrompt = buildTeammatePrompt(teammate, prompt, {
                 roster: this.roster,
                 services: this.services,
                 sessionFile,
-                sessionContent,
                 recallResults: recall?.results,
+                userProfile,
             });
         }
         else {

package/dist/adapters/echo.test.js

@@ -2,6 +2,7 @@ import { describe, expect, it } from "vitest";
 import { EchoAdapter } from "./echo.js";
 const teammate = {
     name: "beacon",
+    type: "ai",
     role: "Platform engineer.",
     soul: "# Beacon\n\nBeacon owns the recall package.",
     wisdom: "",

package/dist/banner.d.ts

@@ -2,18 +2,21 @@
  * Animated startup banner for @teammates/cli.
  */
 import { type Constraint, Control, type DrawingContext, type Rect, type Size } from "@teammates/consolonia";
+import type { PresenceState } from "./types.js";
 export type ServiceStatus = "bundled" | "missing" | "not-configured" | "configured";
 export interface ServiceInfo {
     name: string;
     status: ServiceStatus;
 }
 export interface BannerInfo {
-    adapterName: string;
+    /** Display name shown in the banner (user alias or adapter name). */
+    displayName: string;
     teammateCount: number;
     cwd: string;
     teammates: {
         name: string;
         role: string;
+        presence: PresenceState;
     }[];
     services: ServiceInfo[];
 }
@@ -66,6 +69,8 @@ export declare class AnimatedBanner extends Control {
      * If the animation already reached the hold point, it resumes immediately.
      */
     releaseHold(): void;
+    /** Update service statuses and rebuild the banner lines. */
+    updateServices(services: ServiceInfo[]): void;
     /** Cancel any pending animation timer. */
     dispose(): void;
     measure(constraint: Constraint): Size;

package/dist/banner.js

@@ -72,7 +72,7 @@ export class AnimatedBanner extends Control {
         const gap = "   ";
         const lines = [];
         // TM logo row 1 + adapter info
-        lines.push(concat(tp.accent(tmTop), tp.text(gap + info.adapterName), tp.muted(` · ${info.teammateCount} teammate${info.teammateCount === 1 ? "" : "s"}`), tp.muted(` · v${PKG_VERSION}`)));
+        lines.push(concat(tp.accent(tmTop), tp.text(gap + info.displayName), tp.muted(` · ${info.teammateCount} teammate${info.teammateCount === 1 ? "" : "s"}`), tp.muted(` · v${PKG_VERSION}`)));
         // TM logo row 2 + cwd
         lines.push(concat(tp.accent(tmBot), tp.muted(gap + info.cwd)));
         // Service status rows
@@ -92,9 +92,14 @@ export class AnimatedBanner extends Control {
         // blank
         lines.push("");
         this._rosterStart = lines.length;
-        // Teammate roster
+        // Teammate roster (with presence indicators)
         for (const t of info.teammates) {
-            lines.push(concat(tp.accent("  ● "), tp.accent(`@${t.name}`.padEnd(14)), tp.muted(t.role)));
+            const presenceDot = t.presence === "online"
+                ? tp.success("  ● ")
+                : t.presence === "reachable"
+                    ? tp.warning("  ● ")
+                    : tp.error("  ● ");
+            lines.push(concat(presenceDot, tp.accent(`@${t.name}`.padEnd(14)), tp.muted(t.role)));
         }
         // blank
         lines.push("");
@@ -261,6 +266,16 @@ export class AnimatedBanner extends Control {
             this._schedule(80);
         }
     }
+    /** Update service statuses and rebuild the banner lines. */
+    updateServices(services) {
+        this._info.services = services;
+        this._buildFinalLines();
+        // If animation is done, refresh immediately
+        if (this._phase === "done") {
+            this._lines = this._finalLines;
+            this._apply();
+        }
+    }
     /** Cancel any pending animation timer. */
     dispose() {
         if (this._timer) {

package/dist/cli-args.js

@@ -102,7 +102,6 @@ ${chalk.bold("@teammates/cli")} — Agent-agnostic teammate orchestrator
 
 ${chalk.bold("Usage:")}
   teammates <agent>          Launch session with an agent
-  teammates claude           Use Claude Code
   teammates codex            Use OpenAI Codex
   teammates aider            Use Aider