yoyo-pi 0.1.4

package/extensions/kenx-infra/themes/dark.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "dark",
+	"vars": {
+		"bg": "#2E322E",
+		"edge": "#272A27",
+		"ink": "#ECE7DC",
+		"ink2": "#B0B0A5",
+		"ink3": "#777768",
+		"red": "#D89B7E",
+		"yellow": "#D9B670",
+		"green": "#ADC79A",
+		"blue": "#8FB4CE",
+		"purple": "#BCA0C5",
+		"selection": "#50473E",
+		"redBg": "#464139",
+		"yellowBg": "#494739",
+		"greenBg": "#40473D",
+		"blueBg": "#3A4241",
+		"purpleBg": "#424143"
+	},
+	"colors": {
+		"accent": "red",
+		"border": "ink3",
+		"borderAccent": "red",
+		"borderMuted": "ink3",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "ink2",
+		"dim": "ink3",
+		"text": "ink",
+		"thinkingText": "ink2",
+		"selectedBg": "selection",
+		"userMessageBg": "edge",
+		"userMessageText": "ink",
+		"customMessageBg": "purpleBg",
+		"customMessageText": "ink",
+		"customMessageLabel": "red",
+		"toolPendingBg": "blueBg",
+		"toolSuccessBg": "greenBg",
+		"toolErrorBg": "redBg",
+		"toolTitle": "red",
+		"toolOutput": "ink2",
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "ink3",
+		"mdCode": "red",
+		"mdCodeBlock": "ink",
+		"mdCodeBlockBorder": "ink3",
+		"mdQuote": "ink2",
+		"mdQuoteBorder": "ink3",
+		"mdHr": "ink3",
+		"mdListBullet": "red",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "ink3",
+		"syntaxComment": "ink3",
+		"syntaxKeyword": "blue",
+		"syntaxFunction": "yellow",
+		"syntaxVariable": "ink",
+		"syntaxString": "green",
+		"syntaxNumber": "purple",
+		"syntaxType": "blue",
+		"syntaxOperator": "red",
+		"syntaxPunctuation": "ink2",
+		"thinkingOff": "ink3",
+		"thinkingMinimal": "ink2",
+		"thinkingLow": "blue",
+		"thinkingMedium": "green",
+		"thinkingHigh": "purple",
+		"thinkingXhigh": "red",
+		"bashMode": "yellow"
+	},
+	"export": {
+		"pageBg": "#272A27",
+		"cardBg": "#2E322E",
+		"infoBg": "yellowBg"
+	}
+}

package/extensions/kenx-infra/themes/light.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "light",
+	"vars": {
+		"bg": "#F5F1EA",
+		"edge": "#ECE7DC",
+		"ink": "#2A2D28",
+		"ink2": "#6B6B60",
+		"ink3": "#9A9A8E",
+		"red": "#A8734F",
+		"yellow": "#A88A50",
+		"green": "#6F8A68",
+		"blue": "#5F8880",
+		"purple": "#8A6E9C",
+		"selection": "#E9DDD1",
+		"redBg": "#EDE4DA",
+		"yellowBg": "#EDE7DB",
+		"greenBg": "#E8E7DD",
+		"blueBg": "#E6E6DF",
+		"purpleBg": "#EAE4E2"
+	},
+	"colors": {
+		"accent": "red",
+		"border": "ink3",
+		"borderAccent": "red",
+		"borderMuted": "ink3",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "ink2",
+		"dim": "ink3",
+		"text": "ink",
+		"thinkingText": "ink2",
+		"selectedBg": "selection",
+		"userMessageBg": "edge",
+		"userMessageText": "ink",
+		"customMessageBg": "purpleBg",
+		"customMessageText": "ink",
+		"customMessageLabel": "red",
+		"toolPendingBg": "blueBg",
+		"toolSuccessBg": "greenBg",
+		"toolErrorBg": "redBg",
+		"toolTitle": "red",
+		"toolOutput": "ink2",
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "ink3",
+		"mdCode": "red",
+		"mdCodeBlock": "ink",
+		"mdCodeBlockBorder": "ink3",
+		"mdQuote": "ink2",
+		"mdQuoteBorder": "ink3",
+		"mdHr": "ink3",
+		"mdListBullet": "red",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "ink3",
+		"syntaxComment": "ink3",
+		"syntaxKeyword": "blue",
+		"syntaxFunction": "yellow",
+		"syntaxVariable": "ink",
+		"syntaxString": "green",
+		"syntaxNumber": "purple",
+		"syntaxType": "blue",
+		"syntaxOperator": "red",
+		"syntaxPunctuation": "ink2",
+		"thinkingOff": "ink3",
+		"thinkingMinimal": "ink2",
+		"thinkingLow": "blue",
+		"thinkingMedium": "green",
+		"thinkingHigh": "purple",
+		"thinkingXhigh": "red",
+		"bashMode": "yellow"
+	},
+	"export": {
+		"pageBg": "#F5F1EA",
+		"cardBg": "#FFFFFF",
+		"infoBg": "yellowBg"
+	}
+}

package/extensions/kenx-infra/themes/paper.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "paper",
+	"vars": {
+		"bg": "#EFE7D4",
+		"edge": "#E5DBC2",
+		"ink": "#1D1916",
+		"ink2": "#5B524A",
+		"ink3": "#8C8175",
+		"red": "#8C2A1F",
+		"yellow": "#8A6A1F",
+		"green": "#3F5C45",
+		"blue": "#2F5A78",
+		"purple": "#6E4A78",
+		"selection": "#DDC5B3",
+		"redBg": "#E5D4C2",
+		"yellowBg": "#E3D8BE",
+		"greenBg": "#DAD6C3",
+		"blueBg": "#DCD9CB",
+		"purpleBg": "#E2D7CB"
+	},
+	"colors": {
+		"accent": "red",
+		"border": "ink3",
+		"borderAccent": "red",
+		"borderMuted": "ink3",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "ink2",
+		"dim": "ink3",
+		"text": "ink",
+		"thinkingText": "ink2",
+		"selectedBg": "selection",
+		"userMessageBg": "edge",
+		"userMessageText": "ink",
+		"customMessageBg": "purpleBg",
+		"customMessageText": "ink",
+		"customMessageLabel": "red",
+		"toolPendingBg": "blueBg",
+		"toolSuccessBg": "greenBg",
+		"toolErrorBg": "redBg",
+		"toolTitle": "red",
+		"toolOutput": "ink2",
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "ink3",
+		"mdCode": "red",
+		"mdCodeBlock": "ink",
+		"mdCodeBlockBorder": "ink3",
+		"mdQuote": "ink2",
+		"mdQuoteBorder": "ink3",
+		"mdHr": "ink3",
+		"mdListBullet": "red",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "ink3",
+		"syntaxComment": "ink3",
+		"syntaxKeyword": "blue",
+		"syntaxFunction": "yellow",
+		"syntaxVariable": "ink",
+		"syntaxString": "green",
+		"syntaxNumber": "purple",
+		"syntaxType": "blue",
+		"syntaxOperator": "red",
+		"syntaxPunctuation": "ink2",
+		"thinkingOff": "ink3",
+		"thinkingMinimal": "ink2",
+		"thinkingLow": "blue",
+		"thinkingMedium": "green",
+		"thinkingHigh": "purple",
+		"thinkingXhigh": "red",
+		"bashMode": "yellow"
+	},
+	"export": {
+		"pageBg": "#EFE7D4",
+		"cardBg": "#F6F0E2",
+		"infoBg": "yellowBg"
+	}
+}

package/extensions/plan-mode/README.md

@@ -0,0 +1,58 @@
+# Plan mode extension
+
+Packaged extension in `extensions/plan-mode/`.
+
+## Commands
+
+- `/plan` - enter plan mode. The UI offers to spawn `plan-agent` immediately.
+- `/plan <request>` - enter plan mode and spawn `plan-agent` for the request.
+- `/plan spawn <request>` - same as above.
+- `/plan status` - show whether plan mode is active.
+- `/plan off` - leave plan mode, first showing the latest generated plan when available, then restoring previous active tools and opening the todo sidebar for the latest `.plan/*.jsonl` todo file.
+- `/todo` - toggle the right-side todo timeline sidebar.
+- `/todo show` - open the latest `.plan/*.jsonl` todo sidebar.
+- `/todo off` - close the todo sidebar.
+- `/todo status` - show the active/latest todo file.
+- `/todo <goal>` - ask the main agent to decompose the goal into `.plan/todo.jsonl`, open the sidebar, and execute while updating todo statuses.
+- `Ctrl+Shift+T` - toggle the todo sidebar.
+
+## Tool
+
+In plan mode the main agent can use `plan_agent`.
+
+`plan_agent` spawns a separate pi process using the bundled agent at `agents/plan-agent.md` and the sandbox extension at `sandbox.ts`.
+
+The child agent can:
+
+- read/search/list only inside the current repo;
+- use read-only bash commands only;
+- use `plan_web_search` for external research;
+- write/edit under `.plan/` only, including the markdown plan and `.plan/todo.jsonl`;
+- delete under `.plan/` only through `plan_delete`.
+
+Plans are written to `.plan/<timestamp>-<slug>.md` unless an output path under `.plan/` is provided.
+
+Each `plan-agent` run must also rewrite `.plan/todo.jsonl` with one JSON object per implementation todo derived from the plan's numbered steps. The todo lines use `type: "plan_todo"`, `schemaVersion: 1`, `planPath`, `step`, `title`, `description`, `status: "pending"`, `priority`, `dependencies`, `validation`, and `createdAt` fields.
+
+## Plan review and exit handoff
+
+After a successful `plan-agent` run, the parent `plan-mode` extension displays the markdown plan content before asking whether to exit plan mode. The review choices are:
+
+- `plan没问题，允许退出plan mode，开始执行` — exit plan mode, open the todo sidebar, and send a kickoff message to execute the approved plan while updating `.plan/todo.jsonl` statuses.
+- `允许退出plan mode，先搁置` — exit plan mode and open the todo sidebar without starting execution.
+- `不允许退出，需要修改：{修改意见}` — stay in plan mode, collect modification feedback, and ask the main agent to rerun `plan_agent` with the same output path.
+
+When plan mode really exits with an approved/shelved plan, future LLM context is pruned to a hidden handoff containing only the user's original planning prompt, the plan path/content, the todo path, and newer messages. The old planning conversation and `plan_agent` tool history remain in the session file but are not sent as active LLM context.
+
+## Todo sidebar
+
+The todo sidebar reuses the right-side overlay slot used by `/filetree`; opening todo closes/switches away from an active file tree. It renders a V3-style timeline, sizes itself from the current todo content, and watches `.plan/todo.jsonl` (or the latest todo-like `.jsonl` under `.plan/`) for changes.
+
+During `/todo <goal>`, the agent is instructed to update todo statuses as it works:
+
+- `pending` - queued work
+- `in_progress` - current work
+- `done` - completed work
+- `blocked` - cannot proceed; explain the blocker in `description`
+
+`skipped`/`cancelled` are also treated as terminal states by the sidebar.

package/extensions/plan-mode/agents/plan-agent.md

@@ -0,0 +1,98 @@
+---
+name: plan-agent
+description: Researches the current repo and writes implementation plans plus plan todos under .plan/ only
+tools: read, grep, find, ls, bash, write, edit, plan_web_search, plan_delete
+---
+
+You are `plan-agent`, a planning-only specialist.
+
+Your job is to research the user's request, write a concrete markdown plan in `.plan/`, and write matching implementation todos to `.plan/todo.jsonl`. Do not implement the plan.
+
+The parent `plan-mode` extension owns the exit/review flow. After you finish successfully, the parent will display the plan to the user, ask whether to execute, shelve, or revise it, and prune future LLM context to the original prompt plus plan only if the user approves exiting plan mode.
+
+## Permissions and boundaries
+
+- You may read/search/list only inside the current repository.
+- You may create/edit/delete only inside `.plan/`.
+- Do not modify source files, config files, tests, lockfiles, git state, or anything outside `.plan/`.
+- Use `write` and `edit` only for `.plan/...` paths.
+- Use `plan_delete` only for `.plan/...` paths if you need to remove an obsolete plan file.
+- Use `bash` only for read-only inspection commands. If a useful command could write outside `.plan/`, skip it and note the limitation.
+- Use `plan_web_search` for external documentation, APIs, libraries, framework behavior, known issues, or error messages when relevant.
+- Every planning run must produce both required outputs: the requested markdown plan path and `.plan/todo.jsonl`.
+
+The sandbox extension enforces these permissions. If a tool call is blocked, adapt rather than trying to bypass it.
+
+## Required inputs to consider
+
+Base the plan on all of the following:
+
+1. The user's prompt.
+2. The parent session's system prompt/context included in the task.
+3. Repository guidance files, especially `AGENTS.md`, `agent.md`, `Agent.md`, `CLAUDE.md`, and related instructions if present.
+4. Code searching and code reading in the current repository.
+5. Web search when external behavior or documentation matters.
+6. Code checks by inspection, and read-only commands where safe.
+
+## Workflow
+
+1. Read the task carefully, including the required output path.
+2. Locate repo instructions and relevant code with `find`, `grep`, `ls`, and `read`.
+3. Follow imports/callers enough to make the plan actionable.
+4. Use `plan_web_search` if the plan depends on external APIs, package behavior, framework docs, or current best practices.
+5. Identify risks, unknowns, validation steps, and the implementation todo breakdown.
+6. Write the final plan to the exact `.plan/...` path requested by the task.
+7. Derive todos from the final plan's `## Plan` steps and write `.plan/todo.jsonl`.
+8. Return a concise summary with the plan path and todo path.
+
+## Plan file format
+
+Write markdown with this structure:
+
+```markdown
+# Plan: <short title>
+
+## Request
+<user request in your own words>
+
+## Context Used
+- Parent/system instructions considered: <brief summary>
+- Repo instructions read: <files or "none found beyond loaded context">
+- Code searched/read: <important files and why>
+- Web research: <queries/results or "not needed">
+
+## Findings
+<relevant current behavior, architecture, constraints>
+
+## Plan
+1. <specific actionable step, including target file/function when known>
+2. <specific actionable step>
+3. ...
+
+## Validation
+- <checks/tests/review steps to run during implementation>
+
+## Risks and Open Questions
+- <risk/question, or "None identified">
+```
+
+## Todo JSONL format
+
+Write `.plan/todo.jsonl` for the same plan before you finish. Treat it as the current plan's todo list: replace stale contents with todos for this run only unless the task explicitly says otherwise.
+
+Rules:
+
+- Derive todos directly from the markdown plan's `## Plan` numbered steps.
+- Write one compact, valid JSON object per line; do not wrap the JSONL in markdown fences.
+- Keep `step` values aligned with the markdown plan order and start at 1.
+- Use `status: "pending"` for new todos.
+- Include concrete validation guidance per todo when possible.
+- If the task prompt gives an exact schema or timestamp, follow that exactly.
+
+Required fields per line:
+
+```jsonl
+{"type":"plan_todo","schemaVersion":1,"planPath":".plan/example-plan.md","step":1,"title":"Short actionable title","description":"Concrete implementation task tied to the plan step","status":"pending","priority":"medium","dependencies":[],"validation":["Check or test for this step"],"createdAt":"<ISO timestamp from task>"}
+```
+
+Keep the plan concrete enough that an implementation agent can execute it without repeating all research. Prefer file paths, symbols, exact sequencing, and todo items over generic advice.