@astralyn/pi 0.82.7 → 0.83.0

package/dist/extensions/plan/state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/extensions/plan/state.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,gBAAgB;IAChC,wFAAwF;IACxF,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6FAA6F;IAC7F,eAAe,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAE,gBAK9B,CAAC;AAKF,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,wBAAgB,YAAY,IAAI,gBAAgB,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAE7D;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAOzE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAGrE;AAqBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE;IACzC,cAAc,EAAE;QAAE,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;CACnD,GAAG,gBAAgB,GAAG,SAAS,CAU/B","sourcesContent":["/**\n * plan/state.ts — per-session plan-mode state, persisted as custom entries.\n *\n * State is conversation-backed like the todo extension: every transition is\n * appended as a `plan-mode` custom entry (never sent to the LLM), and lifecycle\n * handlers replay the current branch tail → head to restore. Custom entries are\n * copied on fork/clone, so `planFiles` keeps pointing at the right plan files\n * even though the forked session gets a new session id.\n *\n * State is keyed per session id: one Pi process can host several sessions over\n * its lifetime (resume, /tree switches), so callers re-point the active bucket\n * wherever ctx is in hand.\n */\nimport { PLAN_ENTRY_TYPE } from \"./constants.ts\";\n\nexport interface PlanSessionState {\n\t/** True from entry until the exit is fully applied (including a pending compaction). */\n\tplanning: boolean;\n\t/**\n\t * Full active-tool set snapshotted on entry; restored verbatim on exit.\n\t * Empty for legacy entries (pre-snapshot `removedTools` shape) — replay\n\t * re-derives a fresh snapshot for active planning, and an inactive legacy\n\t * entry needs no restore beyond dropping exit_plan.\n\t */\n\ttoolSnapshot: string[];\n\t/** A compact-and-execute exit was approved and is waiting for agent_settled + compaction. */\n\tawaitingCompact: boolean;\n\t/** Absolute paths of plan files saved on this conversation branch. */\n\tplanFiles: string[];\n}\n\nexport const EMPTY_PLAN_STATE: PlanSessionState = {\n\tplanning: false,\n\ttoolSnapshot: [],\n\tawaitingCompact: false,\n\tplanFiles: [],\n};\n\nconst states = new Map<string, PlanSessionState>();\nlet activeSid = \"\";\n\n/** Point the module at a session's state bucket. Call wherever ctx is in hand. */\nexport function setActivePlanSession(sid: string): void {\n\tactiveSid = sid;\n}\n\nexport function getPlanState(): PlanSessionState {\n\treturn states.get(activeSid) ?? clonePlanState(EMPTY_PLAN_STATE);\n}\n\nexport function replacePlanState(next: PlanSessionState): void {\n\tstates.set(activeSid, clonePlanState(next));\n}\n\n/** Drop in-memory state for a session (call from session_shutdown). */\nexport function disposePlanSession(sid: string): void {\n\tif (!sid) return;\n\tstates.delete(sid);\n\tif (activeSid === sid) activeSid = \"\";\n}\n\nexport function clonePlanState(source: PlanSessionState): PlanSessionState {\n\treturn {\n\t\tplanning: source.planning,\n\t\ttoolSnapshot: [...source.toolSnapshot],\n\t\tawaitingCompact: source.awaitingCompact,\n\t\tplanFiles: [...source.planFiles],\n\t};\n}\n\n/**\n * Accepts both the current shape (`toolSnapshot`) and the legacy one\n * (`removedTools`), so branches recorded before the snapshot change replay.\n */\nexport function isPlanState(value: unknown): value is PlanSessionState {\n\tconst parsed = parsePlanState(value);\n\treturn parsed !== undefined;\n}\n\nfunction parsePlanState(value: unknown): PlanSessionState | undefined {\n\tif (!value || typeof value !== \"object\") return undefined;\n\tconst record = value as Record<string, unknown>;\n\tif (typeof record.planning !== \"boolean\" || typeof record.awaitingCompact !== \"boolean\") return undefined;\n\tif (!Array.isArray(record.planFiles)) return undefined;\n\tconst snapshot = Array.isArray(record.toolSnapshot)\n\t\t? record.toolSnapshot\n\t\t: Array.isArray(record.removedTools)\n\t\t\t? [] // Legacy entries recorded removals, not a snapshot; nothing to restore from.\n\t\t\t: undefined;\n\tif (!snapshot) return undefined;\n\treturn {\n\t\tplanning: record.planning,\n\t\ttoolSnapshot: snapshot.filter((tool): tool is string => typeof tool === \"string\"),\n\t\tawaitingCompact: record.awaitingCompact,\n\t\tplanFiles: record.planFiles.filter((path): path is string => typeof path === \"string\"),\n\t};\n}\n\n/**\n * Latest plan-mode entry on the current branch, or undefined when the branch\n * has none (lets callers distinguish \"never used\" from \"explicitly exited\").\n */\nexport function replayPlanFromBranch(ctx: {\n\tsessionManager: { getBranch(): Iterable<unknown> };\n}): PlanSessionState | undefined {\n\tconst branch = Array.from(ctx.sessionManager.getBranch());\n\tfor (let i = branch.length - 1; i >= 0; i--) {\n\t\tconst item = branch[i] as { type?: string; customType?: string; data?: unknown };\n\t\tif (item.type !== \"custom\" || item.customType !== PLAN_ENTRY_TYPE) continue;\n\t\tconst parsed = parsePlanState(item.data);\n\t\tif (!parsed) continue;\n\t\treturn parsed;\n\t}\n\treturn undefined;\n}\n"]}

package/dist/extensions/plan/state.js

@@ -1,96 +0,0 @@
-/**
- * plan/state.ts — per-session plan-mode state, persisted as custom entries.
- *
- * State is conversation-backed like the todo extension: every transition is
- * appended as a `plan-mode` custom entry (never sent to the LLM), and lifecycle
- * handlers replay the current branch tail → head to restore. Custom entries are
- * copied on fork/clone, so `planFiles` keeps pointing at the right plan files
- * even though the forked session gets a new session id.
- *
- * State is keyed per session id: one Pi process can host several sessions over
- * its lifetime (resume, /tree switches), so callers re-point the active bucket
- * wherever ctx is in hand.
- */
-import { PLAN_ENTRY_TYPE } from "./constants.js";
-export const EMPTY_PLAN_STATE = {
-    planning: false,
-    toolSnapshot: [],
-    awaitingCompact: false,
-    planFiles: [],
-};
-const states = new Map();
-let activeSid = "";
-/** Point the module at a session's state bucket. Call wherever ctx is in hand. */
-export function setActivePlanSession(sid) {
-    activeSid = sid;
-}
-export function getPlanState() {
-    return states.get(activeSid) ?? clonePlanState(EMPTY_PLAN_STATE);
-}
-export function replacePlanState(next) {
-    states.set(activeSid, clonePlanState(next));
-}
-/** Drop in-memory state for a session (call from session_shutdown). */
-export function disposePlanSession(sid) {
-    if (!sid)
-        return;
-    states.delete(sid);
-    if (activeSid === sid)
-        activeSid = "";
-}
-export function clonePlanState(source) {
-    return {
-        planning: source.planning,
-        toolSnapshot: [...source.toolSnapshot],
-        awaitingCompact: source.awaitingCompact,
-        planFiles: [...source.planFiles],
-    };
-}
-/**
- * Accepts both the current shape (`toolSnapshot`) and the legacy one
- * (`removedTools`), so branches recorded before the snapshot change replay.
- */
-export function isPlanState(value) {
-    const parsed = parsePlanState(value);
-    return parsed !== undefined;
-}
-function parsePlanState(value) {
-    if (!value || typeof value !== "object")
-        return undefined;
-    const record = value;
-    if (typeof record.planning !== "boolean" || typeof record.awaitingCompact !== "boolean")
-        return undefined;
-    if (!Array.isArray(record.planFiles))
-        return undefined;
-    const snapshot = Array.isArray(record.toolSnapshot)
-        ? record.toolSnapshot
-        : Array.isArray(record.removedTools)
-            ? [] // Legacy entries recorded removals, not a snapshot; nothing to restore from.
-            : undefined;
-    if (!snapshot)
-        return undefined;
-    return {
-        planning: record.planning,
-        toolSnapshot: snapshot.filter((tool) => typeof tool === "string"),
-        awaitingCompact: record.awaitingCompact,
-        planFiles: record.planFiles.filter((path) => typeof path === "string"),
-    };
-}
-/**
- * Latest plan-mode entry on the current branch, or undefined when the branch
- * has none (lets callers distinguish "never used" from "explicitly exited").
- */
-export function replayPlanFromBranch(ctx) {
-    const branch = Array.from(ctx.sessionManager.getBranch());
-    for (let i = branch.length - 1; i >= 0; i--) {
-        const item = branch[i];
-        if (item.type !== "custom" || item.customType !== PLAN_ENTRY_TYPE)
-            continue;
-        const parsed = parsePlanState(item.data);
-        if (!parsed)
-            continue;
-        return parsed;
-    }
-    return undefined;
-}
-//# sourceMappingURL=state.js.map

package/dist/extensions/plan/state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/extensions/plan/state.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * plan/state.ts — per-session plan-mode state, persisted as custom entries.\n *\n * State is conversation-backed like the todo extension: every transition is\n * appended as a `plan-mode` custom entry (never sent to the LLM), and lifecycle\n * handlers replay the current branch tail → head to restore. Custom entries are\n * copied on fork/clone, so `planFiles` keeps pointing at the right plan files\n * even though the forked session gets a new session id.\n *\n * State is keyed per session id: one Pi process can host several sessions over\n * its lifetime (resume, /tree switches), so callers re-point the active bucket\n * wherever ctx is in hand.\n */\nimport { PLAN_ENTRY_TYPE } from \"./constants.ts\";\n\nexport interface PlanSessionState {\n\t/** True from entry until the exit is fully applied (including a pending compaction). */\n\tplanning: boolean;\n\t/**\n\t * Full active-tool set snapshotted on entry; restored verbatim on exit.\n\t * Empty for legacy entries (pre-snapshot `removedTools` shape) — replay\n\t * re-derives a fresh snapshot for active planning, and an inactive legacy\n\t * entry needs no restore beyond dropping exit_plan.\n\t */\n\ttoolSnapshot: string[];\n\t/** A compact-and-execute exit was approved and is waiting for agent_settled + compaction. */\n\tawaitingCompact: boolean;\n\t/** Absolute paths of plan files saved on this conversation branch. */\n\tplanFiles: string[];\n}\n\nexport const EMPTY_PLAN_STATE: PlanSessionState = {\n\tplanning: false,\n\ttoolSnapshot: [],\n\tawaitingCompact: false,\n\tplanFiles: [],\n};\n\nconst states = new Map<string, PlanSessionState>();\nlet activeSid = \"\";\n\n/** Point the module at a session's state bucket. Call wherever ctx is in hand. */\nexport function setActivePlanSession(sid: string): void {\n\tactiveSid = sid;\n}\n\nexport function getPlanState(): PlanSessionState {\n\treturn states.get(activeSid) ?? clonePlanState(EMPTY_PLAN_STATE);\n}\n\nexport function replacePlanState(next: PlanSessionState): void {\n\tstates.set(activeSid, clonePlanState(next));\n}\n\n/** Drop in-memory state for a session (call from session_shutdown). */\nexport function disposePlanSession(sid: string): void {\n\tif (!sid) return;\n\tstates.delete(sid);\n\tif (activeSid === sid) activeSid = \"\";\n}\n\nexport function clonePlanState(source: PlanSessionState): PlanSessionState {\n\treturn {\n\t\tplanning: source.planning,\n\t\ttoolSnapshot: [...source.toolSnapshot],\n\t\tawaitingCompact: source.awaitingCompact,\n\t\tplanFiles: [...source.planFiles],\n\t};\n}\n\n/**\n * Accepts both the current shape (`toolSnapshot`) and the legacy one\n * (`removedTools`), so branches recorded before the snapshot change replay.\n */\nexport function isPlanState(value: unknown): value is PlanSessionState {\n\tconst parsed = parsePlanState(value);\n\treturn parsed !== undefined;\n}\n\nfunction parsePlanState(value: unknown): PlanSessionState | undefined {\n\tif (!value || typeof value !== \"object\") return undefined;\n\tconst record = value as Record<string, unknown>;\n\tif (typeof record.planning !== \"boolean\" || typeof record.awaitingCompact !== \"boolean\") return undefined;\n\tif (!Array.isArray(record.planFiles)) return undefined;\n\tconst snapshot = Array.isArray(record.toolSnapshot)\n\t\t? record.toolSnapshot\n\t\t: Array.isArray(record.removedTools)\n\t\t\t? [] // Legacy entries recorded removals, not a snapshot; nothing to restore from.\n\t\t\t: undefined;\n\tif (!snapshot) return undefined;\n\treturn {\n\t\tplanning: record.planning,\n\t\ttoolSnapshot: snapshot.filter((tool): tool is string => typeof tool === \"string\"),\n\t\tawaitingCompact: record.awaitingCompact,\n\t\tplanFiles: record.planFiles.filter((path): path is string => typeof path === \"string\"),\n\t};\n}\n\n/**\n * Latest plan-mode entry on the current branch, or undefined when the branch\n * has none (lets callers distinguish \"never used\" from \"explicitly exited\").\n */\nexport function replayPlanFromBranch(ctx: {\n\tsessionManager: { getBranch(): Iterable<unknown> };\n}): PlanSessionState | undefined {\n\tconst branch = Array.from(ctx.sessionManager.getBranch());\n\tfor (let i = branch.length - 1; i >= 0; i--) {\n\t\tconst item = branch[i] as { type?: string; customType?: string; data?: unknown };\n\t\tif (item.type !== \"custom\" || item.customType !== PLAN_ENTRY_TYPE) continue;\n\t\tconst parsed = parsePlanState(item.data);\n\t\tif (!parsed) continue;\n\t\treturn parsed;\n\t}\n\treturn undefined;\n}\n"]}

package/dist/extensions/plan/storage.d.ts

@@ -1,26 +0,0 @@
-export interface SavePlanOptions {
-    sessionId: string;
-    title: string;
-    plan: string;
-    cwd: string;
-    revises?: string;
-}
-/** Per-project plans directory for a cwd (same encoding as sessions). */
-export declare function getPlansDir(cwd: string): string;
-/** File-name slug from a plan title: lowercase, ascii-ish, bounded. */
-export declare function slugifyTitle(title: string): string;
-/** Local-time `YYYYMMDD-HHmm` prefix: sortable and collision-poor per project. */
-export declare function formatPlanFileStamp(date: Date): string;
-export declare function buildPlanDocument(options: SavePlanOptions & {
-    createdIso: string;
-}): string;
-/** First non-existing `<base>.md`, `<base>-2.md`, ... path in dir. */
-export declare function resolvePlanFileName(dir: string, base: string): string;
-/**
- * Absolute paths of plans saved for this project, newest first (the
- * `YYYYMMDD-HHmm` prefix makes file names sort chronologically).
- */
-export declare function listProjectPlanFiles(cwd: string): string[];
-/** Write the plan to disk and return its absolute path. */
-export declare function savePlanFile(options: SavePlanOptions): string;
-//# sourceMappingURL=storage.d.ts.map

package/dist/extensions/plan/storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/extensions/plan/storage.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAGtD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAW3F;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAY1D;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAQ7D","sourcesContent":["/**\n * plan/storage.ts — plan file layout and writing.\n *\n * Plans live under `<agentDir>/plans/<safeCwdDir>/<YYYYMMDD-HHmm>-<slug>.md`,\n * grouped by project the same way sessions are (cwdToSafeDirName). The\n * directory is only the initial storage location — the authoritative index is\n * the `planFiles` list in the session's plan-mode entries, which follows\n * fork/clone. Plans saved before the per-project layout stay in their legacy\n * `plans/<sessionId>/` directories and remain readable via those entries.\n */\nimport { existsSync, mkdirSync, readdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { getAgentDir } from \"../../config.ts\";\nimport { cwdToSafeDirName, resolvePath } from \"../../utils/paths.ts\";\n\nexport interface SavePlanOptions {\n\tsessionId: string;\n\ttitle: string;\n\tplan: string;\n\tcwd: string;\n\trevises?: string;\n}\n\n/** Per-project plans directory for a cwd (same encoding as sessions). */\nexport function getPlansDir(cwd: string): string {\n\treturn join(getAgentDir(), \"plans\", cwdToSafeDirName(resolvePath(cwd)));\n}\n\n/** File-name slug from a plan title: lowercase, ascii-ish, bounded. */\nexport function slugifyTitle(title: string): string {\n\tconst slug = title\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\")\n\t\t.slice(0, 40)\n\t\t.replace(/-+$/, \"\");\n\treturn slug || \"plan\";\n}\n\n/** Local-time `YYYYMMDD-HHmm` prefix: sortable and collision-poor per project. */\nexport function formatPlanFileStamp(date: Date): string {\n\tconst pad = (value: number) => String(value).padStart(2, \"0\");\n\treturn `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-${pad(date.getHours())}${pad(date.getMinutes())}`;\n}\n\nexport function buildPlanDocument(options: SavePlanOptions & { createdIso: string }): string {\n\tconst lines = [\n\t\t\"---\",\n\t\t`title: ${JSON.stringify(options.title)}`,\n\t\t`created: ${options.createdIso}`,\n\t\t`cwd: ${JSON.stringify(options.cwd)}`,\n\t\t`session: ${options.sessionId}`,\n\t];\n\tif (options.revises) lines.push(`revises: ${JSON.stringify(options.revises)}`);\n\tlines.push(\"---\", \"\", options.plan.trimEnd(), \"\");\n\treturn lines.join(\"\\n\");\n}\n\n/** First non-existing `<base>.md`, `<base>-2.md`, ... path in dir. */\nexport function resolvePlanFileName(dir: string, base: string): string {\n\tlet candidate = `${base}.md`;\n\tfor (let attempt = 2; existsSync(join(dir, candidate)); attempt++) {\n\t\tcandidate = `${base}-${attempt}.md`;\n\t}\n\treturn candidate;\n}\n\n/**\n * Absolute paths of plans saved for this project, newest first (the\n * `YYYYMMDD-HHmm` prefix makes file names sort chronologically).\n */\nexport function listProjectPlanFiles(cwd: string): string[] {\n\tconst dir = getPlansDir(cwd);\n\tlet names: string[];\n\ttry {\n\t\tnames = readdirSync(dir);\n\t} catch {\n\t\treturn [];\n\t}\n\treturn names\n\t\t.filter((name) => name.endsWith(\".md\"))\n\t\t.sort((left, right) => right.localeCompare(left))\n\t\t.map((name) => join(dir, name));\n}\n\n/** Write the plan to disk and return its absolute path. */\nexport function savePlanFile(options: SavePlanOptions): string {\n\tconst dir = getPlansDir(options.cwd);\n\tmkdirSync(dir, { recursive: true });\n\tconst now = new Date();\n\tconst fileName = resolvePlanFileName(dir, `${formatPlanFileStamp(now)}-${slugifyTitle(options.title)}`);\n\tconst path = join(dir, fileName);\n\twriteFileSync(path, buildPlanDocument({ ...options, createdIso: now.toISOString() }), \"utf-8\");\n\treturn path;\n}\n"]}

package/dist/extensions/plan/storage.js

@@ -1,83 +0,0 @@
-/**
- * plan/storage.ts — plan file layout and writing.
- *
- * Plans live under `<agentDir>/plans/<safeCwdDir>/<YYYYMMDD-HHmm>-<slug>.md`,
- * grouped by project the same way sessions are (cwdToSafeDirName). The
- * directory is only the initial storage location — the authoritative index is
- * the `planFiles` list in the session's plan-mode entries, which follows
- * fork/clone. Plans saved before the per-project layout stay in their legacy
- * `plans/<sessionId>/` directories and remain readable via those entries.
- */
-import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { getAgentDir } from "../../config.js";
-import { cwdToSafeDirName, resolvePath } from "../../utils/paths.js";
-/** Per-project plans directory for a cwd (same encoding as sessions). */
-export function getPlansDir(cwd) {
-    return join(getAgentDir(), "plans", cwdToSafeDirName(resolvePath(cwd)));
-}
-/** File-name slug from a plan title: lowercase, ascii-ish, bounded. */
-export function slugifyTitle(title) {
-    const slug = title
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 40)
-        .replace(/-+$/, "");
-    return slug || "plan";
-}
-/** Local-time `YYYYMMDD-HHmm` prefix: sortable and collision-poor per project. */
-export function formatPlanFileStamp(date) {
-    const pad = (value) => String(value).padStart(2, "0");
-    return `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-${pad(date.getHours())}${pad(date.getMinutes())}`;
-}
-export function buildPlanDocument(options) {
-    const lines = [
-        "---",
-        `title: ${JSON.stringify(options.title)}`,
-        `created: ${options.createdIso}`,
-        `cwd: ${JSON.stringify(options.cwd)}`,
-        `session: ${options.sessionId}`,
-    ];
-    if (options.revises)
-        lines.push(`revises: ${JSON.stringify(options.revises)}`);
-    lines.push("---", "", options.plan.trimEnd(), "");
-    return lines.join("\n");
-}
-/** First non-existing `<base>.md`, `<base>-2.md`, ... path in dir. */
-export function resolvePlanFileName(dir, base) {
-    let candidate = `${base}.md`;
-    for (let attempt = 2; existsSync(join(dir, candidate)); attempt++) {
-        candidate = `${base}-${attempt}.md`;
-    }
-    return candidate;
-}
-/**
- * Absolute paths of plans saved for this project, newest first (the
- * `YYYYMMDD-HHmm` prefix makes file names sort chronologically).
- */
-export function listProjectPlanFiles(cwd) {
-    const dir = getPlansDir(cwd);
-    let names;
-    try {
-        names = readdirSync(dir);
-    }
-    catch {
-        return [];
-    }
-    return names
-        .filter((name) => name.endsWith(".md"))
-        .sort((left, right) => right.localeCompare(left))
-        .map((name) => join(dir, name));
-}
-/** Write the plan to disk and return its absolute path. */
-export function savePlanFile(options) {
-    const dir = getPlansDir(options.cwd);
-    mkdirSync(dir, { recursive: true });
-    const now = new Date();
-    const fileName = resolvePlanFileName(dir, `${formatPlanFileStamp(now)}-${slugifyTitle(options.title)}`);
-    const path = join(dir, fileName);
-    writeFileSync(path, buildPlanDocument({ ...options, createdIso: now.toISOString() }), "utf-8");
-    return path;
-}
-//# sourceMappingURL=storage.js.map

package/dist/extensions/plan/storage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/extensions/plan/storage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * plan/storage.ts — plan file layout and writing.\n *\n * Plans live under `<agentDir>/plans/<safeCwdDir>/<YYYYMMDD-HHmm>-<slug>.md`,\n * grouped by project the same way sessions are (cwdToSafeDirName). The\n * directory is only the initial storage location — the authoritative index is\n * the `planFiles` list in the session's plan-mode entries, which follows\n * fork/clone. Plans saved before the per-project layout stay in their legacy\n * `plans/<sessionId>/` directories and remain readable via those entries.\n */\nimport { existsSync, mkdirSync, readdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { getAgentDir } from \"../../config.ts\";\nimport { cwdToSafeDirName, resolvePath } from \"../../utils/paths.ts\";\n\nexport interface SavePlanOptions {\n\tsessionId: string;\n\ttitle: string;\n\tplan: string;\n\tcwd: string;\n\trevises?: string;\n}\n\n/** Per-project plans directory for a cwd (same encoding as sessions). */\nexport function getPlansDir(cwd: string): string {\n\treturn join(getAgentDir(), \"plans\", cwdToSafeDirName(resolvePath(cwd)));\n}\n\n/** File-name slug from a plan title: lowercase, ascii-ish, bounded. */\nexport function slugifyTitle(title: string): string {\n\tconst slug = title\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\")\n\t\t.slice(0, 40)\n\t\t.replace(/-+$/, \"\");\n\treturn slug || \"plan\";\n}\n\n/** Local-time `YYYYMMDD-HHmm` prefix: sortable and collision-poor per project. */\nexport function formatPlanFileStamp(date: Date): string {\n\tconst pad = (value: number) => String(value).padStart(2, \"0\");\n\treturn `${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-${pad(date.getHours())}${pad(date.getMinutes())}`;\n}\n\nexport function buildPlanDocument(options: SavePlanOptions & { createdIso: string }): string {\n\tconst lines = [\n\t\t\"---\",\n\t\t`title: ${JSON.stringify(options.title)}`,\n\t\t`created: ${options.createdIso}`,\n\t\t`cwd: ${JSON.stringify(options.cwd)}`,\n\t\t`session: ${options.sessionId}`,\n\t];\n\tif (options.revises) lines.push(`revises: ${JSON.stringify(options.revises)}`);\n\tlines.push(\"---\", \"\", options.plan.trimEnd(), \"\");\n\treturn lines.join(\"\\n\");\n}\n\n/** First non-existing `<base>.md`, `<base>-2.md`, ... path in dir. */\nexport function resolvePlanFileName(dir: string, base: string): string {\n\tlet candidate = `${base}.md`;\n\tfor (let attempt = 2; existsSync(join(dir, candidate)); attempt++) {\n\t\tcandidate = `${base}-${attempt}.md`;\n\t}\n\treturn candidate;\n}\n\n/**\n * Absolute paths of plans saved for this project, newest first (the\n * `YYYYMMDD-HHmm` prefix makes file names sort chronologically).\n */\nexport function listProjectPlanFiles(cwd: string): string[] {\n\tconst dir = getPlansDir(cwd);\n\tlet names: string[];\n\ttry {\n\t\tnames = readdirSync(dir);\n\t} catch {\n\t\treturn [];\n\t}\n\treturn names\n\t\t.filter((name) => name.endsWith(\".md\"))\n\t\t.sort((left, right) => right.localeCompare(left))\n\t\t.map((name) => join(dir, name));\n}\n\n/** Write the plan to disk and return its absolute path. */\nexport function savePlanFile(options: SavePlanOptions): string {\n\tconst dir = getPlansDir(options.cwd);\n\tmkdirSync(dir, { recursive: true });\n\tconst now = new Date();\n\tconst fileName = resolvePlanFileName(dir, `${formatPlanFileStamp(now)}-${slugifyTitle(options.title)}`);\n\tconst path = join(dir, fileName);\n\twriteFileSync(path, buildPlanDocument({ ...options, createdIso: now.toISOString() }), \"utf-8\");\n\treturn path;\n}\n"]}

package/dist/extensions/plan/view.d.ts

@@ -1,44 +0,0 @@
-/**
- * plan/view.ts — approval-dialog context and exit_plan tool rendering.
- *
- * `exit_plan` carries the whole plan as a parameter, and the default renderer
- * echoes parameters verbatim: the row would repeat, escaped onto one line, the
- * markdown the model just printed as response text. Collapsed rows therefore
- * carry the title only, and the plan body is available on expand.
- *
- * The result text is written for the model (it restates tool-state precedence
- * rules), so the result row renders from `details` instead.
- */
-import { type Component } from "@earendil-works/pi-tui";
-import type { AgentToolResult, ExtensionContext } from "../../core/extensions/types.ts";
-import type { CustomMessage } from "../../core/messages.ts";
-import { type Theme } from "../../modes/interactive/theme/theme.ts";
-import type { ExitPlanDetails, PlanKickoffDetails } from "./schema.ts";
-/** Collapse the home prefix so a plan path stays on one line. */
-export declare function shortenPlanPath(path: string): string;
-export declare function formatApprovalSubtitle(ctx: ExtensionContext): string | undefined;
-/**
- * The kickoff message body repeats the whole plan for the LLM, so the default
- * renderer would flood the chat with markdown the user already approved.
- * Collapsed: a two-line card (title + saved path with the expand hint).
- * Expanded: the complete kickoff markdown, styled like the exit_plan body.
- */
-export declare function renderPlanKickoffMessage(message: CustomMessage<PlanKickoffDetails>, options: {
-    expanded: boolean;
-    outputPad: number;
-}, theme: Theme): Component;
-type ExitPlanCallArgs = {
-    title?: unknown;
-    plan?: unknown;
-    revises?: unknown;
-};
-/** Title-only headline when collapsed; Markdown plan body and revision target on expand. */
-export declare function renderExitPlanCall(args: ExitPlanCallArgs | undefined, theme: Theme, expanded: boolean): Component;
-/**
- * What the user needs to know: where the plan landed and what happens next.
- * Falls back to the model-facing text when details are missing — a thrown
- * approval (interrupt) has no details to render from.
- */
-export declare function formatExitPlanResult(result: AgentToolResult<ExitPlanDetails>, theme: Theme): string;
-export {};
-//# sourceMappingURL=view.d.ts.map

package/dist/extensions/plan/view.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/extensions/plan/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,SAAS,EAAqC,MAAM,wBAAwB,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAoB,KAAK,KAAK,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EAAoB,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzF,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD;AAcD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAKhF;AAID;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,aAAa,CAAC,kBAAkB,CAAC,EAC1C,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACjD,KAAK,EAAE,KAAK,GACV,SAAS,CAsCX;AAKD,KAAK,gBAAgB,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAM/E,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,CAsBjH;AAsBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAgBnG","sourcesContent":["/**\n * plan/view.ts — approval-dialog context and exit_plan tool rendering.\n *\n * `exit_plan` carries the whole plan as a parameter, and the default renderer\n * echoes parameters verbatim: the row would repeat, escaped onto one line, the\n * markdown the model just printed as response text. Collapsed rows therefore\n * carry the title only, and the plan body is available on expand.\n *\n * The result text is written for the model (it restates tool-state precedence\n * rules), so the result row renders from `details` instead.\n */\nimport { type Component, Container, Markdown, Spacer, Text } from \"@earendil-works/pi-tui\";\nimport type { AgentToolResult, ExtensionContext } from \"../../core/extensions/types.ts\";\nimport type { CustomMessage } from \"../../core/messages.ts\";\nimport { keyText } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport { getMarkdownTheme, type Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport type { ExitPlanDecision, ExitPlanDetails, PlanKickoffDetails } from \"./schema.ts\";\n\n/** Collapse the home prefix so a plan path stays on one line. */\nexport function shortenPlanPath(path: string): string {\n\tconst rawHome = process.env.USERPROFILE || process.env.HOME || \"\";\n\tconst home = rawHome.replace(/[\\\\/]+$/, \"\");\n\tif (!home) return path;\n\tconst normalize = (value: string) => value.replace(/\\\\/g, \"/\").toLowerCase();\n\tif (!normalize(path).startsWith(`${normalize(home)}/`)) return path;\n\treturn `~${path.slice(home.length).replace(/\\\\/g, \"/\")}`;\n}\n\n/**\n * Context pressure is the fact the compact-or-not decision turns on, so the\n * dialog states it instead of making the user leave and check the footer.\n */\nfunction formatTokenCount(tokenCount: number): string {\n\tif (tokenCount < 1000) return `${tokenCount}`;\n\tif (tokenCount < 10_000) return `${(tokenCount / 1000).toFixed(1)}k`;\n\tif (tokenCount < 1_000_000) return `${Math.round(tokenCount / 1000)}k`;\n\tif (tokenCount < 10_000_000) return `${(tokenCount / 1_000_000).toFixed(1)}M`;\n\treturn `${Math.round(tokenCount / 1_000_000)}M`;\n}\n\nexport function formatApprovalSubtitle(ctx: ExtensionContext): string | undefined {\n\tconst usage = ctx.getContextUsage();\n\tif (usage?.percent == null) return undefined;\n\tconst window = usage.contextWindow > 0 ? ` of ${formatTokenCount(usage.contextWindow)}` : \"\";\n\treturn `Context ${usage.percent.toFixed(1)}%${window}`;\n}\n\n// ---- kickoff message rendering ----------------------------------------------\n\n/**\n * The kickoff message body repeats the whole plan for the LLM, so the default\n * renderer would flood the chat with markdown the user already approved.\n * Collapsed: a two-line card (title + saved path with the expand hint).\n * Expanded: the complete kickoff markdown, styled like the exit_plan body.\n */\nexport function renderPlanKickoffMessage(\n\tmessage: CustomMessage<PlanKickoffDetails>,\n\toptions: { expanded: boolean; outputPad: number },\n\ttheme: Theme,\n): Component {\n\tconst details = (message.details ?? {}) as Partial<PlanKickoffDetails>;\n\tconst title = typeof details.title === \"string\" && details.title.trim() ? details.title.trim() : \"plan\";\n\tconst planPath = typeof details.planPath === \"string\" ? details.planPath.trim() : \"\";\n\n\tconst container = new Container();\n\tcontainer.addChild(\n\t\tnew Text(\n\t\t\t[theme.fg(\"toolTitle\", theme.bold(\"plan\")), theme.fg(\"text\", `Executing \"${title}\"`)].join(\" \"),\n\t\t\toptions.outputPad,\n\t\t\t0,\n\t\t),\n\t);\n\tconst pathText = planPath ? `${shortenPlanPath(planPath)} ` : \"\";\n\tconst secondLine = options.expanded\n\t\t? planPath\n\t\t\t? theme.fg(\"dim\", shortenPlanPath(planPath))\n\t\t\t: undefined\n\t\t: theme.fg(\"dim\", `${pathText}(${keyText(\"app.tools.expand\")} to expand)`);\n\tif (secondLine) container.addChild(new Text(secondLine, options.outputPad, 0));\n\tif (!options.expanded) return container;\n\n\tconst body =\n\t\ttypeof message.content === \"string\"\n\t\t\t? message.content\n\t\t\t: message.content\n\t\t\t\t\t.filter((block): block is { type: \"text\"; text: string } => block.type === \"text\")\n\t\t\t\t\t.map((block) => block.text)\n\t\t\t\t\t.join(\"\\n\");\n\tif (body.trim()) {\n\t\tcontainer.addChild(new Spacer(1));\n\t\tcontainer.addChild(\n\t\t\tnew Markdown(body, options.outputPad, 0, getMarkdownTheme(), {\n\t\t\t\tcolor: (text) => theme.fg(\"toolOutput\", text),\n\t\t\t}),\n\t\t);\n\t}\n\treturn container;\n}\n\n// ---- tool call rendering ----------------------------------------------------\n// Args arrive off the wire and stream in, so every field is read defensively.\n\ntype ExitPlanCallArgs = { title?: unknown; plan?: unknown; revises?: unknown };\n\nfunction callText(value: unknown): string {\n\treturn typeof value === \"string\" ? value.trim() : \"\";\n}\n\n/** Title-only headline when collapsed; Markdown plan body and revision target on expand. */\nexport function renderExitPlanCall(args: ExitPlanCallArgs | undefined, theme: Theme, expanded: boolean): Component {\n\tconst title = callText(args?.title);\n\tconst headline = [\n\t\ttheme.fg(\"toolTitle\", theme.bold(\"exit_plan\")),\n\t\ttitle ? theme.fg(\"text\", title) : theme.fg(\"dim\", \"…\"),\n\t].join(\" \");\n\tif (!expanded) return new Text(headline, 0, 0);\n\n\tconst container = new Container();\n\tcontainer.addChild(new Text(headline, 0, 0));\n\tconst revises = callText(args?.revises);\n\tif (revises) container.addChild(new Text(theme.fg(\"dim\", `revises ${revises}`), 0, 0));\n\tconst plan = callText(args?.plan);\n\tif (plan) {\n\t\tcontainer.addChild(new Spacer(1));\n\t\tcontainer.addChild(\n\t\t\tnew Markdown(plan, 0, 0, getMarkdownTheme(), {\n\t\t\t\tcolor: (text) => theme.fg(\"toolOutput\", text),\n\t\t\t}),\n\t\t);\n\t}\n\treturn container;\n}\n\n// ---- tool result rendering --------------------------------------------------\n\nconst DECISION_SUMMARY: Record<ExitPlanDecision, string> = {\n\texecute: \"Executing with full context\",\n\tcompactAndExecute: \"Compacting context, then executing\",\n\tkeepPlanning: \"Still planning\",\n\tcancelled: \"No approval was pending\",\n};\n\nfunction isExitPlanDecision(value: unknown): value is ExitPlanDecision {\n\treturn value === \"execute\" || value === \"compactAndExecute\" || value === \"keepPlanning\" || value === \"cancelled\";\n}\n\nfunction resultText(result: AgentToolResult<ExitPlanDetails>): string {\n\treturn result.content\n\t\t.filter((block): block is { type: \"text\"; text: string } => block.type === \"text\")\n\t\t.map((block) => block.text)\n\t\t.join(\"\\n\");\n}\n\n/**\n * What the user needs to know: where the plan landed and what happens next.\n * Falls back to the model-facing text when details are missing — a thrown\n * approval (interrupt) has no details to render from.\n */\nexport function formatExitPlanResult(result: AgentToolResult<ExitPlanDetails>, theme: Theme): string {\n\tconst details = result.details as unknown;\n\tif (!details || typeof details !== \"object\" || Array.isArray(details)) {\n\t\treturn theme.fg(\"dim\", resultText(result));\n\t}\n\tconst decision = (details as Record<string, unknown>).decision;\n\tif (!isExitPlanDecision(decision)) return theme.fg(\"dim\", resultText(result));\n\tconst rawPlanPath = (details as Record<string, unknown>).planPath;\n\n\tconst lines: string[] = [];\n\tif (typeof rawPlanPath === \"string\" && rawPlanPath) {\n\t\tlines.push(theme.fg(\"dim\", `Saved to ${shortenPlanPath(rawPlanPath)}`));\n\t}\n\tconst decisionColor = decision === \"cancelled\" ? \"warning\" : \"text\";\n\tlines.push(theme.fg(decisionColor, DECISION_SUMMARY[decision]));\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/extensions/plan/view.js

@@ -1,149 +0,0 @@
-/**
- * plan/view.ts — approval-dialog context and exit_plan tool rendering.
- *
- * `exit_plan` carries the whole plan as a parameter, and the default renderer
- * echoes parameters verbatim: the row would repeat, escaped onto one line, the
- * markdown the model just printed as response text. Collapsed rows therefore
- * carry the title only, and the plan body is available on expand.
- *
- * The result text is written for the model (it restates tool-state precedence
- * rules), so the result row renders from `details` instead.
- */
-import { Container, Markdown, Spacer, Text } from "@earendil-works/pi-tui";
-import { keyText } from "../../modes/interactive/components/keybinding-hints.js";
-import { getMarkdownTheme } from "../../modes/interactive/theme/theme.js";
-/** Collapse the home prefix so a plan path stays on one line. */
-export function shortenPlanPath(path) {
-    const rawHome = process.env.USERPROFILE || process.env.HOME || "";
-    const home = rawHome.replace(/[\\/]+$/, "");
-    if (!home)
-        return path;
-    const normalize = (value) => value.replace(/\\/g, "/").toLowerCase();
-    if (!normalize(path).startsWith(`${normalize(home)}/`))
-        return path;
-    return `~${path.slice(home.length).replace(/\\/g, "/")}`;
-}
-/**
- * Context pressure is the fact the compact-or-not decision turns on, so the
- * dialog states it instead of making the user leave and check the footer.
- */
-function formatTokenCount(tokenCount) {
-    if (tokenCount < 1000)
-        return `${tokenCount}`;
-    if (tokenCount < 10_000)
-        return `${(tokenCount / 1000).toFixed(1)}k`;
-    if (tokenCount < 1_000_000)
-        return `${Math.round(tokenCount / 1000)}k`;
-    if (tokenCount < 10_000_000)
-        return `${(tokenCount / 1_000_000).toFixed(1)}M`;
-    return `${Math.round(tokenCount / 1_000_000)}M`;
-}
-export function formatApprovalSubtitle(ctx) {
-    const usage = ctx.getContextUsage();
-    if (usage?.percent == null)
-        return undefined;
-    const window = usage.contextWindow > 0 ? ` of ${formatTokenCount(usage.contextWindow)}` : "";
-    return `Context ${usage.percent.toFixed(1)}%${window}`;
-}
-// ---- kickoff message rendering ----------------------------------------------
-/**
- * The kickoff message body repeats the whole plan for the LLM, so the default
- * renderer would flood the chat with markdown the user already approved.
- * Collapsed: a two-line card (title + saved path with the expand hint).
- * Expanded: the complete kickoff markdown, styled like the exit_plan body.
- */
-export function renderPlanKickoffMessage(message, options, theme) {
-    const details = (message.details ?? {});
-    const title = typeof details.title === "string" && details.title.trim() ? details.title.trim() : "plan";
-    const planPath = typeof details.planPath === "string" ? details.planPath.trim() : "";
-    const container = new Container();
-    container.addChild(new Text([theme.fg("toolTitle", theme.bold("plan")), theme.fg("text", `Executing "${title}"`)].join(" "), options.outputPad, 0));
-    const pathText = planPath ? `${shortenPlanPath(planPath)} ` : "";
-    const secondLine = options.expanded
-        ? planPath
-            ? theme.fg("dim", shortenPlanPath(planPath))
-            : undefined
-        : theme.fg("dim", `${pathText}(${keyText("app.tools.expand")} to expand)`);
-    if (secondLine)
-        container.addChild(new Text(secondLine, options.outputPad, 0));
-    if (!options.expanded)
-        return container;
-    const body = typeof message.content === "string"
-        ? message.content
-        : message.content
-            .filter((block) => block.type === "text")
-            .map((block) => block.text)
-            .join("\n");
-    if (body.trim()) {
-        container.addChild(new Spacer(1));
-        container.addChild(new Markdown(body, options.outputPad, 0, getMarkdownTheme(), {
-            color: (text) => theme.fg("toolOutput", text),
-        }));
-    }
-    return container;
-}
-function callText(value) {
-    return typeof value === "string" ? value.trim() : "";
-}
-/** Title-only headline when collapsed; Markdown plan body and revision target on expand. */
-export function renderExitPlanCall(args, theme, expanded) {
-    const title = callText(args?.title);
-    const headline = [
-        theme.fg("toolTitle", theme.bold("exit_plan")),
-        title ? theme.fg("text", title) : theme.fg("dim", "…"),
-    ].join(" ");
-    if (!expanded)
-        return new Text(headline, 0, 0);
-    const container = new Container();
-    container.addChild(new Text(headline, 0, 0));
-    const revises = callText(args?.revises);
-    if (revises)
-        container.addChild(new Text(theme.fg("dim", `revises ${revises}`), 0, 0));
-    const plan = callText(args?.plan);
-    if (plan) {
-        container.addChild(new Spacer(1));
-        container.addChild(new Markdown(plan, 0, 0, getMarkdownTheme(), {
-            color: (text) => theme.fg("toolOutput", text),
-        }));
-    }
-    return container;
-}
-// ---- tool result rendering --------------------------------------------------
-const DECISION_SUMMARY = {
-    execute: "Executing with full context",
-    compactAndExecute: "Compacting context, then executing",
-    keepPlanning: "Still planning",
-    cancelled: "No approval was pending",
-};
-function isExitPlanDecision(value) {
-    return value === "execute" || value === "compactAndExecute" || value === "keepPlanning" || value === "cancelled";
-}
-function resultText(result) {
-    return result.content
-        .filter((block) => block.type === "text")
-        .map((block) => block.text)
-        .join("\n");
-}
-/**
- * What the user needs to know: where the plan landed and what happens next.
- * Falls back to the model-facing text when details are missing — a thrown
- * approval (interrupt) has no details to render from.
- */
-export function formatExitPlanResult(result, theme) {
-    const details = result.details;
-    if (!details || typeof details !== "object" || Array.isArray(details)) {
-        return theme.fg("dim", resultText(result));
-    }
-    const decision = details.decision;
-    if (!isExitPlanDecision(decision))
-        return theme.fg("dim", resultText(result));
-    const rawPlanPath = details.planPath;
-    const lines = [];
-    if (typeof rawPlanPath === "string" && rawPlanPath) {
-        lines.push(theme.fg("dim", `Saved to ${shortenPlanPath(rawPlanPath)}`));
-    }
-    const decisionColor = decision === "cancelled" ? "warning" : "text";
-    lines.push(theme.fg(decisionColor, DECISION_SUMMARY[decision]));
-    return lines.join("\n");
-}
-//# sourceMappingURL=view.js.map

package/dist/extensions/plan/view.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/extensions/plan/view.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * plan/view.ts — approval-dialog context and exit_plan tool rendering.\n *\n * `exit_plan` carries the whole plan as a parameter, and the default renderer\n * echoes parameters verbatim: the row would repeat, escaped onto one line, the\n * markdown the model just printed as response text. Collapsed rows therefore\n * carry the title only, and the plan body is available on expand.\n *\n * The result text is written for the model (it restates tool-state precedence\n * rules), so the result row renders from `details` instead.\n */\nimport { type Component, Container, Markdown, Spacer, Text } from \"@earendil-works/pi-tui\";\nimport type { AgentToolResult, ExtensionContext } from \"../../core/extensions/types.ts\";\nimport type { CustomMessage } from \"../../core/messages.ts\";\nimport { keyText } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport { getMarkdownTheme, type Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport type { ExitPlanDecision, ExitPlanDetails, PlanKickoffDetails } from \"./schema.ts\";\n\n/** Collapse the home prefix so a plan path stays on one line. */\nexport function shortenPlanPath(path: string): string {\n\tconst rawHome = process.env.USERPROFILE || process.env.HOME || \"\";\n\tconst home = rawHome.replace(/[\\\\/]+$/, \"\");\n\tif (!home) return path;\n\tconst normalize = (value: string) => value.replace(/\\\\/g, \"/\").toLowerCase();\n\tif (!normalize(path).startsWith(`${normalize(home)}/`)) return path;\n\treturn `~${path.slice(home.length).replace(/\\\\/g, \"/\")}`;\n}\n\n/**\n * Context pressure is the fact the compact-or-not decision turns on, so the\n * dialog states it instead of making the user leave and check the footer.\n */\nfunction formatTokenCount(tokenCount: number): string {\n\tif (tokenCount < 1000) return `${tokenCount}`;\n\tif (tokenCount < 10_000) return `${(tokenCount / 1000).toFixed(1)}k`;\n\tif (tokenCount < 1_000_000) return `${Math.round(tokenCount / 1000)}k`;\n\tif (tokenCount < 10_000_000) return `${(tokenCount / 1_000_000).toFixed(1)}M`;\n\treturn `${Math.round(tokenCount / 1_000_000)}M`;\n}\n\nexport function formatApprovalSubtitle(ctx: ExtensionContext): string | undefined {\n\tconst usage = ctx.getContextUsage();\n\tif (usage?.percent == null) return undefined;\n\tconst window = usage.contextWindow > 0 ? ` of ${formatTokenCount(usage.contextWindow)}` : \"\";\n\treturn `Context ${usage.percent.toFixed(1)}%${window}`;\n}\n\n// ---- kickoff message rendering ----------------------------------------------\n\n/**\n * The kickoff message body repeats the whole plan for the LLM, so the default\n * renderer would flood the chat with markdown the user already approved.\n * Collapsed: a two-line card (title + saved path with the expand hint).\n * Expanded: the complete kickoff markdown, styled like the exit_plan body.\n */\nexport function renderPlanKickoffMessage(\n\tmessage: CustomMessage<PlanKickoffDetails>,\n\toptions: { expanded: boolean; outputPad: number },\n\ttheme: Theme,\n): Component {\n\tconst details = (message.details ?? {}) as Partial<PlanKickoffDetails>;\n\tconst title = typeof details.title === \"string\" && details.title.trim() ? details.title.trim() : \"plan\";\n\tconst planPath = typeof details.planPath === \"string\" ? details.planPath.trim() : \"\";\n\n\tconst container = new Container();\n\tcontainer.addChild(\n\t\tnew Text(\n\t\t\t[theme.fg(\"toolTitle\", theme.bold(\"plan\")), theme.fg(\"text\", `Executing \"${title}\"`)].join(\" \"),\n\t\t\toptions.outputPad,\n\t\t\t0,\n\t\t),\n\t);\n\tconst pathText = planPath ? `${shortenPlanPath(planPath)} ` : \"\";\n\tconst secondLine = options.expanded\n\t\t? planPath\n\t\t\t? theme.fg(\"dim\", shortenPlanPath(planPath))\n\t\t\t: undefined\n\t\t: theme.fg(\"dim\", `${pathText}(${keyText(\"app.tools.expand\")} to expand)`);\n\tif (secondLine) container.addChild(new Text(secondLine, options.outputPad, 0));\n\tif (!options.expanded) return container;\n\n\tconst body =\n\t\ttypeof message.content === \"string\"\n\t\t\t? message.content\n\t\t\t: message.content\n\t\t\t\t\t.filter((block): block is { type: \"text\"; text: string } => block.type === \"text\")\n\t\t\t\t\t.map((block) => block.text)\n\t\t\t\t\t.join(\"\\n\");\n\tif (body.trim()) {\n\t\tcontainer.addChild(new Spacer(1));\n\t\tcontainer.addChild(\n\t\t\tnew Markdown(body, options.outputPad, 0, getMarkdownTheme(), {\n\t\t\t\tcolor: (text) => theme.fg(\"toolOutput\", text),\n\t\t\t}),\n\t\t);\n\t}\n\treturn container;\n}\n\n// ---- tool call rendering ----------------------------------------------------\n// Args arrive off the wire and stream in, so every field is read defensively.\n\ntype ExitPlanCallArgs = { title?: unknown; plan?: unknown; revises?: unknown };\n\nfunction callText(value: unknown): string {\n\treturn typeof value === \"string\" ? value.trim() : \"\";\n}\n\n/** Title-only headline when collapsed; Markdown plan body and revision target on expand. */\nexport function renderExitPlanCall(args: ExitPlanCallArgs | undefined, theme: Theme, expanded: boolean): Component {\n\tconst title = callText(args?.title);\n\tconst headline = [\n\t\ttheme.fg(\"toolTitle\", theme.bold(\"exit_plan\")),\n\t\ttitle ? theme.fg(\"text\", title) : theme.fg(\"dim\", \"…\"),\n\t].join(\" \");\n\tif (!expanded) return new Text(headline, 0, 0);\n\n\tconst container = new Container();\n\tcontainer.addChild(new Text(headline, 0, 0));\n\tconst revises = callText(args?.revises);\n\tif (revises) container.addChild(new Text(theme.fg(\"dim\", `revises ${revises}`), 0, 0));\n\tconst plan = callText(args?.plan);\n\tif (plan) {\n\t\tcontainer.addChild(new Spacer(1));\n\t\tcontainer.addChild(\n\t\t\tnew Markdown(plan, 0, 0, getMarkdownTheme(), {\n\t\t\t\tcolor: (text) => theme.fg(\"toolOutput\", text),\n\t\t\t}),\n\t\t);\n\t}\n\treturn container;\n}\n\n// ---- tool result rendering --------------------------------------------------\n\nconst DECISION_SUMMARY: Record<ExitPlanDecision, string> = {\n\texecute: \"Executing with full context\",\n\tcompactAndExecute: \"Compacting context, then executing\",\n\tkeepPlanning: \"Still planning\",\n\tcancelled: \"No approval was pending\",\n};\n\nfunction isExitPlanDecision(value: unknown): value is ExitPlanDecision {\n\treturn value === \"execute\" || value === \"compactAndExecute\" || value === \"keepPlanning\" || value === \"cancelled\";\n}\n\nfunction resultText(result: AgentToolResult<ExitPlanDetails>): string {\n\treturn result.content\n\t\t.filter((block): block is { type: \"text\"; text: string } => block.type === \"text\")\n\t\t.map((block) => block.text)\n\t\t.join(\"\\n\");\n}\n\n/**\n * What the user needs to know: where the plan landed and what happens next.\n * Falls back to the model-facing text when details are missing — a thrown\n * approval (interrupt) has no details to render from.\n */\nexport function formatExitPlanResult(result: AgentToolResult<ExitPlanDetails>, theme: Theme): string {\n\tconst details = result.details as unknown;\n\tif (!details || typeof details !== \"object\" || Array.isArray(details)) {\n\t\treturn theme.fg(\"dim\", resultText(result));\n\t}\n\tconst decision = (details as Record<string, unknown>).decision;\n\tif (!isExitPlanDecision(decision)) return theme.fg(\"dim\", resultText(result));\n\tconst rawPlanPath = (details as Record<string, unknown>).planPath;\n\n\tconst lines: string[] = [];\n\tif (typeof rawPlanPath === \"string\" && rawPlanPath) {\n\t\tlines.push(theme.fg(\"dim\", `Saved to ${shortenPlanPath(rawPlanPath)}`));\n\t}\n\tconst decisionColor = decision === \"cancelled\" ? \"warning\" : \"text\";\n\tlines.push(theme.fg(decisionColor, DECISION_SUMMARY[decision]));\n\treturn lines.join(\"\\n\");\n}\n"]}

package/docs/bundled/extensions/README.md

@@ -1,19 +0,0 @@
-# Bundled extensions
-
-These are extensions shipped in the `@astralyn/pi` npm package. For the public API used to write external extensions, see the [Extension API documentation](../../extensions.md).
-
-They are registered as hidden built-in extensions and use the same public Extension API available to external extensions. Their implementation details are internal to the package and are not required for installation or configuration.
-
-| Extension | Tool or command | Documentation |
-|---|---|---|
-| `llama.cpp` | `/llama` | [llama.cpp](../../llama-cpp.md) |
-| `deepwiki` | `deepwiki` | [deepwiki.md](deepwiki.md) |
-| `plan` | `exit_plan`, `/plan` | [plan.md](plan.md) |
-| `question` | `question` | [question.md](question.md) |
-| `todo` | `todo`, `/todos` | [todo.md](todo.md) |
-| `rewind` | `/rewind`, `/tree` lifecycle | [rewind.md](rewind.md) |
-| `router` | `/router` | [router.md](router.md) |
-| `statusline` | Footer | [statusline.md](statusline.md) |
-| `subagent` | `subagent`, `/agents` | [subagent.md](subagent.md) |
-
-The catalog documents installed-package behavior and configuration; it does not require access to the package's internal source.

package/docs/bundled/extensions/plan.md

@@ -1,34 +0,0 @@
-# plan — read-only plan mode
-
-Adds `/plan` for a Claude-Code-style planning phase: the model explores with read-only tooling, interviews the user, and leaves the mode through a user-approved `exit_plan` tool call that saves the plan to disk and optionally compacts the context before execution starts.
-
-## Behavior
-
-- `/plan` (or the `--plan` CLI flag) enters plan mode. On entry the active tool set is snapshotted and swapped to the exploration set: `edit` and `write` are deactivated, the standalone `grep`/`find`/`ls` search tools (registered but not active by default) are activated alongside `read`, and `bash` stays available but is constrained to read-only inspection by the plan-mode system prompt (git log/diff/blame/show/status, ls, wc, head, tail, cat, …) — the same contract as the explorer subagent. The bundled `subagent` tool stays active but only the built-in read-only `explorer` profile is allowed. Other extension tools (`question`, `todo`, `deepwiki`, …) stay available. A `tool_call` guard also covers requests already in flight when the mode toggles: it blocks `edit`/`write` and any `subagent` call whose profile (including the omitted-default `general`, and every task in `tasks` mode) is not `explorer`.
-- While planning, the system prompt gains a plan-mode block: explore before asking, interview one decision at a time with the `question` tool (with a recommendation and trade-offs), skip the interview for small clear tasks, then present the full plan as response text before calling `exit_plan`.
-- `exit_plan(title, plan, revises?)` opens the approval menu. Each option carries a muted description, and the dialog subtitle reports context usage as `Context 29.4% of 200k` when the window is known (or just the percentage otherwise) — the fact the compact-or-not decision turns on:
-  - **Start executing** *(keep full context)* — saves the plan, restores tools, and execution continues in the same run.
-  - **Compact context, then execute** *(best for long tasks)* — saves the plan, ends the run (`terminate`), compacts once the run has settled, and only then restores tools; execution restarts via a kickoff message that embeds the plan text, so continuation never depends on the compaction summary. The kickoff is a custom message: the LLM receives the full text, while the TUI renders a collapsed two-line card (title + saved path) that expands to the complete plan with the tools-expand key. If compaction fails, tools are restored and execution proceeds with full context.
-  - **Keep planning** *(refine before running)* — optionally collects feedback (multi-line editor in the TUI, input dialog in RPC) and returns it to the model; plan mode stays active. `Esc` and dialog timeouts map here, never to an executing option, so the dismiss hint reads "keep planning" rather than "cancel".
-- Both executing options save the plan file. If the session has no name yet, the plan title becomes the session name.
-- `/plan` while planning opens the plan panel (TUI): the first option exits plan mode, the rest are saved plan files — this branch's plans first, then the project's, newest first, bounded at 20. Picking a file pastes its absolute path into the editor so the user can add an instruction around it; `Esc` keeps planning with no side effects. Outside the TUI the command keeps the direct-toggle semantic. During a pending compaction the command is refused until the compaction settles.
-- Plan files live under `<agentDir>/plans/<safeCwdDir>/<YYYYMMDD-HHmm>-<slug>.md` (`~/.pi/agent/plans/…` by default, `PI_CODING_AGENT_DIR` respected), grouped per project with the same cwd encoding as sessions, with `title`, `created`, `cwd`, `session`, and optional `revises` frontmatter. The local-time stamp keeps names chronologically sortable; same-minute collisions append `-2`, `-3`, …. Revisions are new files that point back via `revises`. Plans saved before the per-project layout stay in their legacy `plans/<sessionId>/` directories and remain reachable through the branch's recorded paths.
-- To revise a plan mid-execution, re-enter with `/plan`: the system prompt lists the branch's saved plans so the model reads the latest one, accounts for completed work, and produces a revision.
-
-## Limits
-
-- The kickoff message embeds at most 24 000 characters of plan markdown; longer plans are truncated with a pointer to the full file.
-- In `json`/`print` modes `exit_plan` cannot ask, so it saves the plan and exits with context kept (write access is restored without a menu).
-- Approving with **Compact context, then execute** and then interrupting before compaction completes (quit, resume, branch switch) degrades to the keep-context exit on the next session start.
-- The dialog subtitle is omitted when context usage is not yet known (no assistant turn has reported usage).
-- The read-only bash constraint is prompt-enforced, not sandboxed — the same trust model as the explorer subagent.
-
-## Implementation notes
-
-- **Conversation-backed state.** Every transition appends a `plan-mode` custom entry (never sent to the LLM); lifecycle handlers replay the current branch tail → head, so `/reload`, `/tree`, resume, and fork restore the mode. Fork and clone copy entries, so the recorded plan-file paths follow the new session even though it gets a fresh session id — the plans directory is only the initial storage location, not the index.
-- **State is keyed per session id** (todo pattern): resume and `/tree` can switch sessions within one process, and handlers re-point the active bucket before touching state.
-- **Tool restore is a snapshot, not an inverse delta.** Entry records the full pre-entry active set and exit restores it verbatim — necessary because entry both removes (`edit`/`write`) and adds (`grep`/`find`/`ls`) tools. Replay keeps the in-memory snapshot across branch switches while planning (re-snapshotting would capture the restricted set) and treats legacy `removedTools` entries as an empty snapshot, which degrades to dropping `exit_plan` only.
-- **No write access is ever needed for the plan itself** — the plan text travels as an `exit_plan` parameter and the extension writes the file.
-- **The compact-then-execute window is closed by construction**: plan mode (and its tool restrictions) persists until compaction completes; the run is terminated by the tool result and the compaction starts on `agent_settled`, which fires once per fully settled run.
-- The `exit_plan` result text authoritatively announces mode changes because the per-run system prompt override is not rebuilt mid-run.
-- **The tool row renders from the title and `details`, not from the parameters.** `exit_plan` carries the whole plan as a parameter, and its result text is written for the model, so the default renderer would echo the plan markdown escaped onto one line and then restate tool-state rules at the user. The collapsed call shows the title; expanding renders the complete plan with Pi's standard Markdown theme while keeping `revises` metadata muted. Results give the decision normal emphasis, keep `Saved to` secondary, and warn when historical state says no approval was pending. Malformed historical decision/path values fall back safely to the bounded model text.