longer-agent 0.1.0

package/dist/tui/launch.js

@@ -0,0 +1,104 @@
+/**
+ * TUI launcher -- renders the Ink application.
+ *
+ * This is the entry point for the terminal UI.  It sets up the
+ * progress bridge, wires session and store, and renders the
+ * React/Ink component tree.
+ */
+import React from "react";
+import { render } from "ink";
+import { App } from "./app.js";
+import { ProgressReporter } from "../progress.js";
+import { buildDefaultRegistry } from "../commands.js";
+const KITTY_KEYBOARD_ENABLE = "\u001b[>1u";
+const KITTY_KEYBOARD_DISABLE = "\u001b[<u";
+const BRACKETED_PASTE_ENABLE = "\u001b[?2004h";
+const BRACKETED_PASTE_DISABLE = "\u001b[?2004l";
+const SET_TERMINAL_TITLE = "\u001b]0;LongerAgent\u0007";
+function shouldEnableKittyKeyboard() {
+    if (process.env["LONGERAGENT_DISABLE_KITTY_KEYBOARD"] === "1")
+        return false;
+    return process.stdout.isTTY === true;
+}
+export async function launchTui(sessionOrOptions, commandRegistryArg, storeArg, optsArg) {
+    let session;
+    let commandRegistry;
+    let store;
+    let verbose = false;
+    if (typeof sessionOrOptions === "object" &&
+        "session" in sessionOrOptions &&
+        typeof sessionOrOptions.session?.turn === "function") {
+        // Options-object form
+        const lo = sessionOrOptions;
+        session = lo.session;
+        commandRegistry =
+            lo.commandRegistry ?? buildDefaultRegistry();
+        store = lo.sessionStore ?? null;
+    }
+    else {
+        // Positional form
+        session = sessionOrOptions;
+        commandRegistry = commandRegistryArg ?? buildDefaultRegistry();
+        store = storeArg ?? null;
+        verbose = optsArg?.verbose ?? false;
+    }
+    // Progress bridge: captures progress events and forwards to React
+    let progressCallback;
+    const tuiProgress = new ProgressReporter({
+        level: verbose ? "verbose" : "normal",
+        callback: (event) => {
+            if (progressCallback) {
+                progressCallback(event);
+            }
+        },
+    });
+    // Wire progress to session
+    session._progress = tuiProgress;
+    let ttyFeaturesEnabled = false;
+    if (process.stdout.isTTY === true) {
+        try {
+            process.stdout.write(SET_TERMINAL_TITLE);
+            process.stdout.write(BRACKETED_PASTE_ENABLE);
+            if (shouldEnableKittyKeyboard()) {
+                process.stdout.write(KITTY_KEYBOARD_ENABLE);
+            }
+            ttyFeaturesEnabled = true;
+        }
+        catch {
+            // ignore
+        }
+    }
+    try {
+        const { waitUntilExit } = render(React.createElement(App, {
+            session,
+            commandRegistry,
+            store,
+            onProgressCallback: (cb) => {
+                progressCallback = cb;
+            },
+        }), { exitOnCtrlC: false });
+        await waitUntilExit();
+    }
+    finally {
+        if (ttyFeaturesEnabled) {
+            try {
+                if (shouldEnableKittyKeyboard()) {
+                    process.stdout.write(KITTY_KEYBOARD_DISABLE);
+                }
+                process.stdout.write(BRACKETED_PASTE_DISABLE);
+            }
+            catch {
+                // ignore
+            }
+        }
+        // Catch-all cleanup after TUI exits.
+        // Safe to call even if close() was already called by /quit or Ctrl+C.
+        try {
+            await session.close();
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=launch.js.map

package/dist/tui/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/tui/launch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAC3C,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAC3C,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAC/C,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAChD,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAExD,SAAS,yBAAyB;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAC5E,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AACvC,CAAC;AAkBD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,gBAAyC,EACzC,kBAAoC,EACpC,QAA8B,EAC9B,OAA+B;IAE/B,IAAI,OAAgB,CAAC;IACrB,IAAI,eAAgC,CAAC;IACrC,IAAI,KAA0B,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IACE,OAAO,gBAAgB,KAAK,QAAQ;QACpC,SAAS,IAAI,gBAAgB;QAC7B,OAAQ,gBAAkC,CAAC,OAAO,EAAE,IAAI,KAAK,UAAU,EACvE,CAAC;QACD,sBAAsB;QACtB,MAAM,EAAE,GAAG,gBAAiC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;QACrB,eAAe;YACZ,EAAE,CAAC,eAAmC,IAAI,oBAAoB,EAAE,CAAC;QACpE,KAAK,GAAG,EAAE,CAAC,YAAY,IAAI,IAAI,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,kBAAkB;QAClB,OAAO,GAAG,gBAA2B,CAAC;QACtC,eAAe,GAAG,kBAAkB,IAAI,oBAAoB,EAAE,CAAC;QAC/D,KAAK,GAAG,QAAQ,IAAI,IAAI,CAAC;QACzB,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;IACtC,CAAC;IAED,kEAAkE;IAClE,IAAI,gBAA8C,CAAC;IAEnD,MAAM,WAAW,GAAG,IAAI,gBAAgB,CAAC;QACvC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;QACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,IAAI,gBAAgB,EAAE,CAAC;gBACrB,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,2BAA2B;IAC3B,OAAO,CAAC,SAAS,GAAG,WAAW,CAAC;IAEhC,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC7C,IAAI,yBAAyB,EAAE,EAAE,CAAC;gBAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAC9C,CAAC;YACD,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAC9B,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE;YACvB,OAAO;YACP,eAAe;YACf,KAAK;YACL,kBAAkB,EAAE,CAAC,EAAoB,EAAE,EAAE;gBAC3C,gBAAgB,GAAG,EAAE,CAAC;YACxB,CAAC;SACF,CAAC,EACF,EAAE,WAAW,EAAE,KAAK,EAAE,CACvB,CAAC;QAEF,MAAM,aAAa,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,IAAI,kBAAkB,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,yBAAyB,EAAE,EAAE,CAAC;oBAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBAC/C,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,sEAAsE;QACtE,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tui/theme.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Centralized TUI theme.
+ *
+ * `theme.accent` is the primary brand color used for logo, prompts,
+ * headings, and highlights.  Change it at runtime via `setAccent()`.
+ * Ink accepts: named colors, "bright" variants, or hex strings like "#7c3aed".
+ */
+export declare const DEFAULT_ACCENT = "#4b4bf0";
+export declare const theme: {
+    /** Primary brand / accent color used for logo, prompts, headings, highlights. */
+    accent: string;
+};
+/** Update the accent color at runtime. */
+export declare function setAccent(color: string): void;
+/** Preset accent color options for the /theme picker (ordered by hue). */
+export declare const ACCENT_PRESETS: ReadonlyArray<{
+    label: string;
+    value: string;
+}>;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,KAAK;IAChB,iFAAiF;;CAElF,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAU1E,CAAC"}

package/dist/tui/theme.js

@@ -0,0 +1,29 @@
+/**
+ * Centralized TUI theme.
+ *
+ * `theme.accent` is the primary brand color used for logo, prompts,
+ * headings, and highlights.  Change it at runtime via `setAccent()`.
+ * Ink accepts: named colors, "bright" variants, or hex strings like "#7c3aed".
+ */
+export const DEFAULT_ACCENT = "#4b4bf0";
+export const theme = {
+    /** Primary brand / accent color used for logo, prompts, headings, highlights. */
+    accent: DEFAULT_ACCENT,
+};
+/** Update the accent color at runtime. */
+export function setAccent(color) {
+    theme.accent = color;
+}
+/** Preset accent color options for the /theme picker (ordered by hue). */
+export const ACCENT_PRESETS = [
+    { label: "Indigo", value: "#4b4bf0" },
+    { label: "Lavender", value: "#7264B5" },
+    { label: "Mauve", value: "#AF5A85" },
+    { label: "Dusty Rose", value: "#C0596A" },
+    { label: "Terracotta", value: "#C26647" },
+    { label: "Gold", value: "#BE9C37" },
+    { label: "Olive", value: "#759E4C" },
+    { label: "Ocean", value: "#4396B2" },
+    { label: "Deep Blue", value: "#1919E6" },
+];
+//# sourceMappingURL=theme.js.map

package/dist/tui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,iFAAiF;IACjF,MAAM,EAAE,cAAc;CACvB,CAAC;AAEF,0CAA0C;AAC1C,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAoD;IAC7E,EAAE,KAAK,EAAE,QAAQ,EAAO,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,KAAK,EAAE,UAAU,EAAK,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,KAAK,EAAE,OAAO,EAAQ,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,KAAK,EAAE,YAAY,EAAG,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,KAAK,EAAE,YAAY,EAAG,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,KAAK,EAAE,MAAM,EAAS,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,KAAK,EAAE,OAAO,EAAQ,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,KAAK,EAAE,OAAO,EAAQ,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,KAAK,EAAE,WAAW,EAAI,KAAK,EAAE,SAAS,EAAE;CAC3C,CAAC"}

package/dist/tui/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * TUI-specific type definitions.
+ *
+ * Defines interfaces for Session, CommandRegistry, and other types
+ * that the TUI layer depends on.  These act as the contract boundary
+ * between the TUI and the core runtime.
+ */
+import type { ProgressReporter } from "../progress.js";
+import type { SessionStore, LogSessionMeta } from "../persistence.js";
+import type { PendingAskUi, AgentQuestionDecision } from "../ask.js";
+import type { LogEntry, LogIdAllocator } from "../log-entry.js";
+import type { CommandRegistry as ActualCommandRegistry, CommandContext, SlashCommand as ActualSlashCommand, CommandOption as ActualCommandOption } from "../commands.js";
+export type CommandRegistry = ActualCommandRegistry;
+export type SlashCommand = ActualSlashCommand;
+export type CommandOption = ActualCommandOption;
+export type { CommandContext };
+export interface Session {
+    turn(userInput: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<string>;
+    close(): Promise<void>;
+    requestTurnInterrupt?(): {
+        accepted: boolean;
+        reason?: "compact_in_progress";
+    };
+    cancelCurrentTurn?(): void;
+    primaryAgent: {
+        name: string;
+        modelConfig?: {
+            name?: string;
+            provider?: string;
+            model?: string;
+            contextLength?: number;
+        };
+    };
+    _progress?: ProgressReporter;
+    _turnCount: number;
+    _compactCount: number;
+    _createdAt?: string;
+    /** Input tokens from the most recent provider response. */
+    lastInputTokens: number;
+    /** Total tokens from the most recent provider response. */
+    lastTotalTokens: number;
+    /** Cache-read tokens from the most recent provider response. */
+    lastCacheReadTokens?: number;
+    /** Callback for incremental persistence — called at save-worthy checkpoints. */
+    onSaveRequest?: () => void;
+    setStore(store: SessionStore | null): void;
+    getPendingAsk(): PendingAskUi | null;
+    resolveAgentQuestionAsk?(askId: string, decision: AgentQuestionDecision): void;
+    resumePendingTurn?(options?: {
+        signal?: AbortSignal;
+    }): Promise<string>;
+    hasPendingTurnToResume?(): boolean;
+    runManualSummarize?(instruction?: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<string>;
+    runManualCompact?(instruction?: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** The config name for the current model (e.g., "my-claude"). */
+    currentModelConfigName?: string;
+    /** Switch to a different configured model by config name. */
+    switchModel?(modelConfigName: string): void;
+    /** Access to Config for model enumeration. */
+    config?: {
+        modelNames: string[];
+        getModel(name: string): {
+            provider: string;
+            model: string;
+            contextLength: number;
+            supportsThinking: boolean;
+            supportsMultimodal: boolean;
+        };
+    };
+    _resetTransientState(): void;
+    _initConversation(): void;
+    /** Deliver a message to the agent (routes based on agent state). */
+    deliverMessage?(source: "user" | "system" | "sub-agent", content: string): void;
+    /** Read-only structured log snapshot. */
+    log?: readonly LogEntry[];
+    /** Subscribe to log changes. Returns unsubscribe function. */
+    subscribeLog?(listener: () => void): () => void;
+    /** Restore session from loaded log data. */
+    restoreFromLog?(meta: LogSessionMeta, entries: LogEntry[], idAllocator: LogIdAllocator): void;
+    /** Get log data for persistence (meta + entries). */
+    getLogForPersistence?(): {
+        meta: LogSessionMeta;
+        entries: readonly LogEntry[];
+    };
+    /** Reset session for /new. */
+    resetForNewSession?(newStore?: any): void;
+    /** Append a persisted status line to the log. */
+    appendStatusMessage?(text: string, statusType?: string): void;
+    /** Append a persisted error line to the log. */
+    appendErrorMessage?(text: string, errorType?: string): void;
+    /** Return all skills (enabled + disabled) for UI display. */
+    getAllSkillNames?(): {
+        name: string;
+        description: string;
+        enabled: boolean;
+    }[];
+    /** Enable or disable a skill by name. */
+    setSkillEnabled?(name: string, enabled: boolean): void;
+    /** Rescan disk and rebuild skill state. */
+    reloadSkills?(): {
+        added: string[];
+        removed: string[];
+        total: number;
+    };
+    /** Read-only access to loaded skills. */
+    skills?: ReadonlyMap<string, unknown>;
+}
+export type ConversationEntryKind = "user" | "assistant" | "interrupted_marker" | "progress" | "sub_agent_rollup" | "sub_agent_done" | "tool_call" | "tool_result" | "reasoning" | "status" | "error" | "compact_mark";
+export interface ConversationEntry {
+    kind: ConversationEntryKind;
+    text: string;
+    /** Timestamp when this entry was created (Unix ms). Used for tool call timing. */
+    startedAt?: number;
+    /** Elapsed time in ms (set when the matching tool_result is found). */
+    elapsedMs?: number;
+    id?: string;
+    /** Whether this user message is queued for delivery (agent is working). */
+    queued?: boolean;
+    /** When true, TUI renders this entry in dim/gray style. */
+    dim?: boolean;
+}
+export interface LaunchOptions {
+    session: Session;
+    commandRegistry?: CommandRegistry;
+    sessionStore?: SessionStore | null;
+    config?: {
+        defaultModel?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tui/types.d.ts.map

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

package/dist/tui/types.js

@@ -0,0 +1,9 @@
+/**
+ * TUI-specific type definitions.
+ *
+ * Defines interfaces for Session, CommandRegistry, and other types
+ * that the TUI layer depends on.  These act as the contract boundary
+ * between the TUI and the core runtime.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tui/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "longer-agent",
+  "version": "0.1.0",
+  "description": "A terminal AI coding agent built for long sessions — three-layer context management, persistent memory, and parallel sub-agents",
+  "type": "module",
+  "license": "MIT",
+  "author": "Felix Rui Gao",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FelixRuiGao/LongerAgent.git"
+  },
+  "homepage": "https://github.com/FelixRuiGao/LongerAgent",
+  "bugs": {
+    "url": "https://github.com/FelixRuiGao/LongerAgent/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "longeragent": "./dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "agent_templates/",
+    "prompts/",
+    "skills/",
+    "configExample.yaml",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "llm",
+    "coding-agent",
+    "multi-agent",
+    "context-management",
+    "summarization",
+    "terminal"
+  ],
+  "scripts": {
+    "build": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true});\" && tsc -p tsconfig.build.json",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build && pnpm test"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.61.0",
+    "@inquirer/prompts": "^8.3.0",
+    "commander": "^12.0.0",
+    "gpt-tokenizer": "^3.4.0",
+    "ink": "^6.8.0",
+    "js-yaml": "^4.1.0",
+    "marked": "^15.0.0",
+    "marked-terminal": "^7.0.0",
+    "markitdown-ts": "^0.0.10",
+    "openai": "^4.90.0",
+    "react": "^19.2.4"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.14",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "optionalDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  }
+}

package/prompts/sections/agents_md.md

@@ -0,0 +1,23 @@
+## AGENTS.md — Persistent Memory
+
+Two persistent memory files are automatically loaded and injected into your context on every turn:
+
+1. **Global memory** (`~/AGENTS.md`) — user-level preferences, conventions, and knowledge that apply across all projects.
+2. **Project memory** (`{PROJECT_ROOT}/AGENTS.md`) — project-specific architecture decisions, patterns, key file paths, and accumulated insights.
+
+These files survive across sessions and context resets — they are always visible after the system prompt, similar to the important log.
+
+**Reading:** You always see the latest content from both files. Use this context to inform your work.
+
+**Writing:** Use `edit_file` or `write_file` to update these files when you discover stable, long-term knowledge worth persisting. The project AGENTS.md is the more common target.
+
+**What belongs here:**
+- Confirmed patterns and conventions (coding style, architecture decisions)
+- Key file paths and project structure insights
+- User preferences for workflow and communication
+- Solutions to recurring problems
+
+**What does NOT belong here:**
+- Session-specific or in-progress work (use the important log instead)
+- Transient debugging context
+- Information that duplicates existing project docs

package/prompts/sections/important_log.md

@@ -0,0 +1,16 @@
+## Important Log
+
+The primary agent's persistent engineering notebook at `{SESSION_ARTIFACTS}/important-log.md`. It survives context resets and compaction — always visible after the system prompt. Maintained by the primary agent; sub-agents can read it for background context.
+
+This file is auto-created by the system. Use `edit_file` to update it.
+
+**Only log information that is genuinely valuable long-term.** Keep entries concise. Examples of what belongs here:
+
+- A viable approach discovered after extensive exploration and trial-and-error — the conclusion, not the journey
+- The path to a reference file created during investigation (e.g., "code issues cataloged in `{SESSION_ARTIFACTS}/issues.md`") — rather than duplicating the content here
+- Architecture insights or critical decisions that will inform future work
+- Failed approaches and *why* they failed, to avoid repeating them
+
+**Don't log:** verbose code (reference file paths instead), full exploration dumps (summarize them), routine progress, anything transient.
+
+**Manage size actively.** When the file grows large, edit it to compress or remove entries from completed work.

package/prompts/sections/system_mechanisms.md

@@ -0,0 +1,18 @@
+# System Mechanisms
+
+## Auto-Compact
+
+When your context approaches the model's limit, the system triggers auto-compact:
+
+1. You write a **continuation prompt** — a briefing summarizing the full conversation state.
+2. Context is reset. System prompt, important log, master plan, and phase plan are re-injected.
+3. Your briefing becomes the new starting context for a fresh instance.
+
+**Proactive compression is better than forced compact.** Use `summarize_context` regularly. A forced compact is disruptive — it interrupts your workflow and compresses everything at once.
+
+## Hint Compression
+
+When context is filling (but below the compact threshold), you'll see:
+`[SYSTEM: Context window is filling up...]`
+
+This is a soft reminder to use `summarize_context`. Prioritize: completed subtasks, large consumed tool results, exploratory steps that led to conclusions.

package/prompts/tools/apply_patch.md

@@ -0,0 +1,31 @@
+## `apply_patch`
+
+`apply_patch(patch)`
+
+Apply a structured multi-file patch. Use this for:
+
+- Multiple edits in one file
+- Coordinated edits across files
+- Appending to large files in chunks
+
+Recommended workflow for large file generation:
+
+- Start the file with `write_file`
+- Then use `apply_patch` to append additional sections in chunks
+
+Patch syntax:
+
+```text
+*** Begin Patch
+*** Update File: src/app.ts
+@@
+-old line
++new line
+*** Append File: docs/guide.md
++## Next Section
++More text...
+*** Add File: src/new.ts
++export const x = 1;
+*** Delete File: src/old.ts
+*** End Patch
+```

package/prompts/tools/ask.md

@@ -0,0 +1,18 @@
+## `ask`
+
+Ask the user 1-4 structured questions, each with 1-4 concrete options. The system automatically adds two extra options to each question: **"Enter custom answer"** (user types free text) and **"Discuss further"** (user wants open discussion before deciding).
+
+**Use `ask`** when you have concrete, limited alternatives — architecture patterns, implementation approaches, library choices.
+
+> Three approaches to optimize queries: indexes, rewriting, caching. Use `ask`.
+
+**Ask in text instead** when the problem is vague or exploratory.
+
+> "The auth flow feels wrong somehow." Discuss in text first, use `ask` when concrete alternatives emerge.
+
+**Don't ask** when you can find the answer yourself via tool calls.
+
+**Understanding responses:**
+- **Option selected** — proceed with that choice.
+- **Custom input** — the user typed a free-text answer instead of picking an option. Treat it as their specific instruction.
+- **Discuss further** — treat it as a normal answer meaning the user wants to continue the discussion before making a final commitment. Use any other answers normally. Briefly address the discussion points, then wait for the user's next message.

package/prompts/tools/bash.md

@@ -0,0 +1,13 @@
+## `bash`
+
+`bash(command, timeout?, cwd?)`
+
+Execute shell commands. Returns stdout, stderr, and exit code.
+
+Use `bash` for: running builds, installing dependencies, git operations, short scripts, checking system state. For file reading, searching, and editing, prefer the dedicated tools — they have proper access controls and structured output.
+
+**Before creating directories or files via bash**, verify the parent directory exists first.
+
+**Timeouts:** Default 60s, max 600s. Long-running commands should specify a timeout.
+
+**Output limit:** ~200KB per stream. Large outputs are truncated.

package/prompts/tools/bash_background.md

@@ -0,0 +1,9 @@
+## `bash_background`
+
+`bash_background(command, cwd?, id?)`
+
+Start a tracked background shell command. Use this for long-running processes like dev servers and watchers.
+
+- Returns a shell ID and a stable log file path.
+- Use `bash_output` to inspect logs later.
+- Use `wait(shell="...", seconds=60)` if you want to wait for the process to exit.

package/prompts/tools/bash_output.md

@@ -0,0 +1,9 @@
+## `bash_output`
+
+`bash_output(id, tail_lines?, max_chars?)`
+
+Read output from a tracked background shell.
+
+- Without `tail_lines`, returns unread output since the last `bash_output` call for that shell.
+- With `tail_lines`, returns the recent tail without advancing the unread cursor.
+- If output is truncated, prefer searching the full log file first and then reading the relevant region.

package/prompts/tools/check_status.md

@@ -0,0 +1,3 @@
+## `check_status`
+
+Check for new messages (user messages, system notifications), sub-agent status, and tracked shell status. Non-blocking. Use to read messages when you see a `[Message Notification]` in a tool result. **For waiting, use `wait` instead** — it's more efficient and doesn't waste activations.

package/prompts/tools/diff.md

@@ -0,0 +1,5 @@
+## `diff`
+
+`diff(path, file_b?, content_b?)`
+
+Show unified diff between two files, or between a file and provided content.

package/prompts/tools/edit_file.md

@@ -0,0 +1,11 @@
+## `edit_file`
+
+`edit_file(path, old_str, new_str, expected_mtime_ms?)`
+
+Apply a minimal patch by replacing a unique string. `old_str` must appear **exactly once** in the file — if it's not unique, provide more surrounding context to make it unique.
+
+```
+edit_file(path="{PROJECT_ROOT}/example.py", old_str="Hello", new_str="Hi")
+```
+
+Supports `expected_mtime_ms` for concurrency safety. Prefer `edit_file` over `write_file` for modifications — it's smaller and safer.

package/prompts/tools/glob.md

@@ -0,0 +1,7 @@
+## `glob`
+
+`glob(pattern, path?)`
+
+Find files by name pattern. Returns matching paths sorted by modification time (newest first).
+
+Supports patterns like `**/*.ts`, `src/**/*.test.tsx`, `*.{js,jsx}`.

package/prompts/tools/grep.md

@@ -0,0 +1,20 @@
+## `grep`
+
+`grep(pattern, path?, output_mode?, glob?, type?, -A?, -B?, -C?, -i?, head_limit?)`
+
+Search file contents using regex. Supports glob filtering, file type filtering, context lines, and multiple output modes.
+
+Key parameters:
+- `output_mode`: `"files_with_matches"` (default, paths only), `"content"` (matching lines), `"count"` (match counts).
+- `glob`: Filter files by pattern (e.g. `"*.ts"`, `"*.{ts,tsx}"`).
+- `type`: Filter by file type (e.g. `"js"`, `"py"`).
+- `-A`, `-B`, `-C`: Context lines after/before/around each match (content mode only).
+- `-i`: Case insensitive.
+- `head_limit`: Limit number of results.
+
+Recommended workflow for large files and logs:
+
+- Start with `grep` to find the relevant area.
+- Then use `read_file(start_line, end_line)` to inspect the matching region.
+- Prefer this over reading a very large file from the top unless you genuinely need the overall structure.
+- When output says "truncated", search the full log file or source file for specific keywords rather than re-requesting full content.

package/prompts/tools/kill_agent.md

@@ -0,0 +1,3 @@
+## `kill_agent`
+
+Kill running sub-agents by ID. Use when agents are no longer needed or taking too long. Prefer waiting with `wait` — only kill in exceptional cases (task irrelevant due to new info, unreasonably long work time).

package/prompts/tools/kill_shell.md

@@ -0,0 +1,5 @@
+## `kill_shell`
+
+`kill_shell(ids, signal?)`
+
+Terminate one or more tracked background shells. Default signal is `TERM`.

package/prompts/tools/list_dir.md

@@ -0,0 +1,5 @@
+## `list_dir`
+
+`list_dir(path?)`
+
+List files and directories in a tree up to 2 levels deep.