@anhlp/alp 0.0.0-beta.2 → 0.0.1-beta.3

package/dist/alpd.js

@@ -7805,7 +7805,7 @@ var require_content_type = __commonJS({
 // packages/daemon/src/main.ts
 import { spawn as spawn9 } from "node:child_process";
 import { openSync, writeSync } from "node:fs";
-import { mkdir as mkdir18, open as open7, readFile as readFile24, rename as rename9, stat as stat13, unlink as unlink6, utimes as utimes3, writeFile as writeFile17 } from "node:fs/promises";
+import { mkdir as mkdir18, open as open7, readFile as readFile24, rename as rename10, stat as stat13, unlink as unlink6, utimes as utimes3, writeFile as writeFile18 } from "node:fs/promises";
 import path40 from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -7813,8 +7813,8 @@ import { fileURLToPath } from "node:url";
 var templates_default = { "ALP.md": "# ALP project instructions\n\n## Working relationship\n\nThe user communicates with main. The team is fixed for each session:\n\n- Ph\u1EDF (default): main owns delivery and technical execution; it implements\n  directly or delegates bounded work to peer. There is no separate lead.\n- Cafe: main owns the outcome and supervises lead; lead implements or\n  delegates to peer. Main routes implementation changes through lead.\n\nIn both, main runs by default on Opus 5.5 with high effort and full access,\nand starts a supervisor that reviews the process after each of main's turns.\nThe supervisor asks main about mistakes; main answers and records lessons it\nfollows later.\n\nOracle provides read-only advice through the configured model lenses; reviewer independently\nreviews one diff. Both return once only to the requesting coordinator. They do\nnot spawn agents. Default maximum concurrent peers is two; raise the configured\nlimit only at the user's request. Other model and effort choices belong to the\ntechnical coordinator. A role grants no additional filesystem permissions,\ncredentials, or runtime tools.\n\n## Shared work contract\n\n- Read project instructions and the selected agent's AGENT.md. Load skills only\n  when needed; do not assume that skills or tools from another runtime exist.\n- Each assignment states its objective, root, owned/excluded paths, constraints\n  and their sources, verification, resources, owner, and expected handoff.\n- Keep a single writer per shared checkout. Transfer ownership before main or lead\n  intervenes in a peer's files. Parallel writers need isolated workspaces and\n  explicit shared-interface agreements.\n- Return artifacts and real verification evidence, with remaining risks. A worker's\n  completion message is a candidate, not an independent acceptance verdict.\n- Review should be independent of authorship: the coordinator reviews peer work;\n  in Cafe, main reviews lead work. Use reviewer for logic changes and risky\n  changes, including main-authored changes. Disclose unavailable independent review\n  rather than claiming it occurred.\n- Changes to scope or priorities flow through the technical coordinator's current plan\n  and the affected peer's revised brief. Direct questions can receive direct answers;\n  an exceptional intervention must be reconciled with the same shared state.\n- Tasks live in `.alp/tasks` and are shared with the user. Only the user and main\n  create or change them; other agents read them and report work they find to their\n  requester.\n- Use only actual runtime delegation/messaging capabilities. Without them, explain\n  the limitation, perform authorized work directly where possible, and never claim\n  that a lead or peer session ran or reviewed anything.\n\n## Project-specific constraints\n\nAdd the project's outcome, boundaries, verification commands, and authorization\nrequirements here. User instructions take precedence over this starter workflow.\n", "role-skills.json": '{\n  "main": ["goal-griller", "xia", "sequence-execution-plan", "prompt-leverage", "bug-loop", "smart-commits"],\n  "lead": ["xia", "sequence-execution-plan", "prompt-leverage", "bug-loop", "smart-commits"],\n  "peer": ["xia", "bug-loop", "smart-commits"],\n  "oracle": [],\n  "reviewer": [],\n  "supervisor": []\n}\n', "teams/pho/HOUSE_RULES.md": "In Ph\u1EDF (pho), main implements or directly delegates to peer; do not create lead. In Cafe (cafe), main supervises lead; lead may implement or delegate to peer. The technical coordinator chooses each peer's model and effort. Use oracle for significant uncertainty; use reviewer for logic changes and risky changes, not mandatory for typo/format fixes. Advisors return only to their requesting coordinator.\n", "teams/pho/team.json": '{\n  "label": "Ph\u1EDF",\n  "description": "Main implements or delegates to peer; a supervisor reviews the process.",\n  "main": "main",\n  "members": {\n    "main": { "model": "claude:claude-opus-5-5", "thinking": "high" },\n    "peer": { "role": "peer" },\n    "oracle": { "role": "advisor" },\n    "reviewer": { "role": "reviewer" }\n  },\n  "delegation": { "main": ["peer", "oracle", "reviewer"] },\n  "maxPeers": 2,\n  "supervisor": { "agent": "supervisor", "model": "claude:claude-sonnet-5", "thinking": "medium" }\n}\n', "teams/cafe/HOUSE_RULES.md": "In Ph\u1EDF (pho), main implements or directly delegates to peer; do not create lead. In Cafe (cafe), main supervises lead; lead may implement or delegate to peer. The technical coordinator chooses each peer's model and effort. Use oracle for significant uncertainty; use reviewer for logic changes and risky changes, not mandatory for typo/format fixes. Advisors return only to their requesting coordinator.\n", "teams/cafe/team.json": '{\n  "label": "Cafe",\n  "description": "Main supervises lead, who implements or delegates to peer; a supervisor reviews the process.",\n  "main": "main",\n  "members": {\n    "main": { "model": "claude:claude-opus-5-5", "thinking": "high" },\n    "lead": { "role": "lead" },\n    "peer": { "role": "peer" },\n    "oracle": { "role": "advisor" },\n    "reviewer": { "role": "reviewer" }\n  },\n  "delegation": { "main": ["lead", "oracle", "reviewer"], "lead": ["peer", "oracle", "reviewer"] },\n  "maxPeers": 2,\n  "supervisor": { "agent": "supervisor", "model": "claude:claude-sonnet-5", "thinking": "medium" }\n}\n', "skills/xia/SKILL.md": "---\nname: xia\ndescription: Research an unfamiliar implementation, reuse opportunity, or version-sensitive integration using local artifacts and primary sources. Return an evidence-backed recommendation before implementation; do not expand the assigned scope.\n---\n\n# Research before building\n\nStart with a named question that affects a decision. Use a short local inspection\nwhen the relevant seam is clear; broaden to upstream sources only when the question\nrequires it. Research is read-only with respect to project artifacts. Temporary\nexperiments require an available isolated scratch location and appropriate authority.\n\n1. Establish the actual stack from manifests, lockfiles, configuration, and commands.\n   Read ALP.md and relevant project guidance. Do not infer a stack from folder names.\n2. Search nearby code, tests, configuration, scripts, and docs for existing behavior\n   and reusable parts. Record the scope searched before saying something is absent.\n3. For external behavior, inspect primary upstream source/examples and official\n   documentation matching the installed version. Distinguish current guidance from\n   the version this project actually uses.\n4. Compare viable approaches only where the choice matters. Prefer an existing\n   local capability, then a supported dependency capability, then a small adaptation.\n   Explain what evidence would change the recommendation.\n\nLabel significant findings by evidence type:\n\n- Local: file path, command output, test, or repository revision.\n- Upstream: repository URL and revision when available.\n- Docs: official source and applicable version.\n- Inference: a conclusion drawn from the cited evidence, with uncertainty stated.\n\nIf browsing is unavailable, return the local findings and the unresolved external\nquestion. Do not invent a source or claim version compatibility without evidence.\nResearch does not authorize installing dependencies, editing code, or deploying.\n\nReturn the question, findings/sources, reuse candidates, recommendation, alternatives\nif material, unknowns, and the next decision. Include actual inspection commands and\nresults in the handoff. A peer returns this to lead; lead returns unresolved scope\ndecisions to main. Main can decide technical matters within the user's authorization.\n\nUse available synchronous delegation for a separate research assignment only when\nhelpful. Do not assume a Scout role or parallel session exists; research is a peer\ndisposition. An agent can inspect evidence itself without spawning another agent.\n", "skills/smart-commits/SKILL.md": "---\nname: smart-commits\ndescription: Package existing owned changes into focused local Git commits with verification evidence. Use when commits are requested or part of the assigned handoff; do not activate merely because a file was edited.\n---\n\n# Package the authorized changes\n\nConfirm this is a Git repository and that local commits belong to the requested\ndeliverable. A non-Git task returns file artifacts; do not initialize Git merely to\nproduce a SHA. A read-only task cannot commit. Existing user authorization remains\nvalid; the skill adds no confirmation gate or permission to push.\n\nInspect the root, branch, status, unresolved merges, staged paths, and staged/unstaged\ndiffs with Git commands. Verify any supplied base revision. Preserve work outside\nthe assignment. If unrelated staged changes would enter the commit, stop packaging\nand report the conflict without resetting or unstaging someone else's work.\n\nGroup changes by behavior and intent. Keep implementation and its direct tests\ntogether where useful. Read each included diff and stage only the owned paths or\nhunks. Avoid whole-tree staging in a shared checkout. Do not add unrelated fixes or\nformatting to make a commit easier.\n\nRun the relevant checks from the project/brief, reusing recent results when still\napplicable. State failures and omissions accurately. If hooks may cause external\nside effects, inspect their configured behavior before invoking them and stay within\nthe task's authorization. Do not bypass hooks or protections to get a green commit.\n\nCreate focused messages explaining the change and its purpose, following the\nrepository's convention. Check commit success before reading the candidate SHA.\nVerify that the candidate contains only the intended scope and that the base\nrelationship is valid when a base was supplied. A failed commit produces no new\ncandidate, and an already-clean tree needs no empty commit.\n\nDo not rewrite a candidate already handed off for review. Corrections should be\nnew commits unless rewriting was specifically agreed. Push requires existing explicit\nauthorization for the intended remote/branch; a configured remote does not provide it.\n\nReturn root, branch, actual base/candidate SHAs, commit summary, owned scope, checks\nand results, remaining work, and push status. Lead/main still review the artifact;\nthe writer does not self-accept its work.\n", "skills/sequence-execution-plan/SKILL.md": "---\nname: sequence-execution-plan\ndescription: Order multiple ALP work items by real dependencies, verification, and writer ownership. Use when Main or Lead coordinates several outcomes or must replan after a blocker, changed premise, or rejection.\n---\n\n# Order executable work\n\nUse the task contract and available evidence. Planning authority comes from the\ncurrent assignment: main coordinates the overall outcome; lead plans technical\nexecution within its assigned scope. A peer reports dependencies instead of\nreassigning ownership or widening the plan.\n\nSeparate urgency from dependency order. A lower-priority prerequisite may need to\nrun first, but it does not close the higher-priority outcome. A mitigation reduces\ncurrent impact; it is not proof of a durable fix.\n\nBuild small work items that each deliver observable progress. Keep implementation\nand its direct verification together. Split when an unresolved decision blocks one\npart, separate outcomes need independent acceptance, or a resource/human wait would\nstall unrelated work. Do not impose a fixed task count on a simple change.\n\nFor each item identify the result, owner, owned/excluded paths, true prerequisites,\nverification seam, completion evidence, and current state. Distinguish necessary\nfoundations from optional improvements and speculative future abstractions.\n\nArrange Now, Next, and Later using causal explanations: which prerequisite blocks\nwhich outcome, which check validates it, and which decision opens the next branch.\nRead [the plan format](references/plan-template.md) when a durable multi-item plan\nhelps. Use the project's existing plan location; do not create unrelated ignore\nrules or a new planning hierarchy just to satisfy this skill.\n\nCurrent Paseo delegation is sequential: each parent waits for one child's result.\nDo not promise parallel workers or live upstream mailboxes. A shared checkout has\none writer at a time; main intervention requires ownership to be released first.\nAllocate ports, scratch paths, and other exclusive resources if the assignment uses\nthem. Separate worktrees alone do not isolate ports or a shared database.\n\nReplan when evidence changes a premise, a dependency blocks work, the user changes\nscope, or repeated rejection reveals that the assignment needs restructuring.\nUpdate the facts and constraints before issuing a revised brief. Preserve unfinished\nacceptance criteria when merging items. Candidate remains candidate until the\nresponsible reviewer has evaluated the actual evidence.\n", "skills/sequence-execution-plan/references/plan-template.md": "# Proportional plan format\n\nUse the relevant fields; a plan is a decision aid, not a form-completion exercise.\n\n```text\nOutcome and acceptance evidence:\nUser constraints and their sources:\nCurrent facts / technical assumptions:\n\nID | Result | Owner | Owned/excluded scope | Prerequisites | Verification | State\n\nNow:\nNext (and what unlocks it):\nLater:\nWriter/resource allocation:\nOpen decisions and blockers:\nReplan reason, when applicable:\n```\n\nStates can be ready, blocked, running, candidate, accepted, or rejected. An item is\naccepted based on artifacts and verification; a successful process exit is not an\nacceptance criterion by itself. Omit branch/SHA fields in non-Git projects.\n", "skills/prompt-leverage/SKILL.md": "---\nname: prompt-leverage\ndescription: Convert a task into a self-contained delegation brief without changing user intent or predetermining the solution. Use before Main assigns Lead or Lead assigns Peer, or when asked to improve an execution prompt.\n---\n\n# Prepare an actionable brief\n\nIdentify the requested result and the recipient's responsibility. Preserve actual\nuser constraints, but distinguish them from current design choices the recipient\nmay question. Do not seed a reviewer's verdict or turn a preferred implementation\ninto an invented requirement.\n\nA useful brief supplies the root, outcome, relevant context, owned/excluded paths,\nauthority, important dependencies, resources, verification, and expected handoff.\nUse [the brief format](references/brief-template.md) for substantial assignments;\ncombine fields for a small task. A real base SHA is useful in a Git repository but\nis not required for a plain file project. Never fabricate one.\n\nVerification must describe the observable behavior and, when known, its executable\ncheck. If a command still needs discovery, state how it should be established from\nthe repository. Do not invent a test command just to fill a field.\n\nChoose the relevant installed skill by task type and mention it in the brief:\nresearch -> xia; diagnosis/regression -> bug-loop; an authorized commit handoff ->\nsmart-commits. Do not require skills absent from the recipient's package. A reviewer\ncan inspect an existing candidate without additional skill ceremonies.\n\nOn current Paseo, pass the full brief as alp_delegate.task with an authorized agent\nand optional mode. Model and reasoning inherit from the parent; there is no model\nargument on this tool. Request read-only for research/review where appropriate.\nImplementation requires workspace-write on the parent and child. The call waits\nfor a final handoff, so include everything needed to work without a live Q&A channel.\n\nThis skill grants no new authority and never bypasses the configured routing graph.\nIf asked only to improve a prompt, return the prompt. If assignment is authorized,\nsend it using the actual runtime tool after preparing it. Missing capabilities\nmust be reported, not simulated.\n", "skills/prompt-leverage/references/brief-template.md": "# Brief and handoff format\n\nUse enough detail to make an independent worker effective, without prescribing an\nunverified solution. Available context includes ALP.md and the selected agent's own\ninstructions; the parent's full transcript is not automatically available.\n\n```text\nTask and recipient:\nRoot:\nOutcome:\nContext / prior decisions:\nRequired constraints + sources:\nCurrent technical choices (open to evidence):\nOwned paths / excluded paths:\nAuthority and permission mode:\nDependencies / writer ownership / resource allocation:\nVerification commands or expected observable checks:\nRelevant installed skill, if needed:\nCandidate/base revision, if applicable:\nReturn: outcome, artifact, scope, actual checks/results, risks, ownership status.\n```\n\nFor read-only review, supply the candidate/artifact and independent acceptance\ncriteria. For a correction, include the concrete finding and prior evidence. For\na resumed assignment, include the findings needed from the previous handoff because\nthe next child is a new session. A blocked recipient should return its blocker and\ncompleted independent work rather than waiting for a nonexistent mailbox.\n", "skills/goal-griller/SKILL.md": '---\nname: goal-griller\ndescription: Turn an underspecified user request into a verifiable task contract. Use at Main intake when missing outcomes, scope, or acceptance evidence would materially change execution; skip when the request is already clear.\n---\n\n# Clarify the outcome\n\nThis skill serves the user-facing owner. In the starter workflow that is main;\nlead and peer return missing decisions to their assigning agent instead of opening\nan independent user conversation.\n\nRead the request, existing decisions, ALP.md, and the few relevant local artifacts.\nSeparate the desired result from a suggested implementation. Establish:\n\n- Outcome: the observable state the user wants.\n- Evidence: a check, artifact, or measurement showing that result.\n- Scope: what may change and what the user requires to remain unchanged.\n- Context: the sources needed to make the first decision.\n- Verification: a fast feedback loop and any final checks.\n- Completion/blockers: when the work is done and what requires a user decision.\n\nInfer routine details from the repository and existing authorization. Ask only\nquestions whose answers change scope, behavior, cost, or a consequential decision.\nBundle independent questions concisely and offer a reasonable default where useful.\nContinue independent authorized work while waiting; a required answer is not\nsupplied by elapsed time.\n\nDo not send a researcher to invent the meaning of words such as "better" or\n"production-ready" when the outcome itself needs the user\'s judgment. Conversely,\ndo not ask the user to identify a build command or file path that local evidence\ncan establish.\n\nProduce a proportional contract, for example:\n\n```text\nOutcome: observable result\nEvidence: check/artifact and expected behavior\nScope: owned paths; exclusions\nConstraints: requirement + source; distinguish technical choices\nContext: relevant artifacts\nVerification: fast check; final checks\nDone: completion condition\nBlocked if: material missing decision or prerequisite\n```\n\nFor an already-authorized task, a clear contract is enough to proceed; this skill\nadds no approval gate. If asked only to draft a contract, return it without starting\nimplementation. Route a multi-item task to sequence-execution-plan, or a single\nassignment to prompt-leverage, reading the next skill only when needed.\n', "skills/bug-loop/SKILL.md": "---\nname: bug-loop\ndescription: Diagnose a bug or regression through a reproducible feedback loop, competing explanations, and verified correction. Use for failing tests, incorrect behavior, or performance regressions; read-only assignments stop before modifying project artifacts.\n---\n\n# Establish a failing loop, then fix the cause\n\nStart from the reported behavior and the assigned scope. Find the smallest useful\ncommand, request, replay, or test that distinguishes the bug from correct behavior.\nRun it and record the actual result before claiming reproduction. For intermittent\nfailures, record conditions, seed when applicable, and observed failure frequency.\n\nIf reproduction needs unavailable credentials, hardware, data, or a user action,\nreport the specific gap to the assigning agent; main handles user communication.\nContinue useful in-scope investigation, but label an unconfirmed hypothesis as such.\nDo not claim a fix was verified without a meaningful observable check.\n\nReduce the reproducer without removing the failure. Form competing explanations\nwhere the cause is uncertain, each with an observable prediction. Probe the few\npoints that distinguish them; change one variable at a time. Prefer measured\nevidence over accumulating workarounds for the same unexplained symptom.\n\nUse isolated scratch space for disposable experiments. A read-only assignment can\ninspect and diagnose; it does not authorize instrumentation edits to project code.\nFor performance work, compare equivalent workloads and record relevant conditions\nso that a timing difference is not mistaken for a causal improvement.\n\nOnce a cause is established and writing is authorized:\n\n1. Put a regression check at the seam that reproduces the actual failure.\n2. Confirm that the check fails for the reported reason on the broken behavior.\n3. Make the smallest correction consistent with the intended contract.\n4. Run the check again, then relevant surrounding checks and the original scenario.\n5. Remove temporary instrumentation and restore any deliberate fault injection.\n\nRead [test proof](references/test-proof.md) when designing/reviewing the regression\ntest or when it passes before the fix. Do not weaken expectations, skip failing\nchecks, or mock away the behavior to manufacture a pass. A changed requirement must\nbe established independently of what the implementation currently returns.\n\nReturn the reproduction command and result, established cause or remaining\nhypotheses, changed artifacts, before/after checks, limits, and unresolved risks.\nA peer returns to lead; lead returns to main. Read-only investigation returns\ndiagnostic evidence and a proposed correction, not an imaginary code change.\n", "skills/bug-loop/references/test-proof.md": "# Evidence for a regression correction\n\nChoose an observable boundary close enough to isolate the failure but broad enough\nto exercise its real cause. A unit test of one caller cannot establish a bug that\ndepends on ordering across several callers.\n\nExpected behavior comes from the user request, a supported contract, or independently\nderived examples. Do not calculate the expected result using the implementation\nbeing tested. Mock external boundaries only where doing so leaves the claimed\nbehavior under test.\n\nDescribe proof accurately:\n\n- Green only: the current check passes; this alone does not show regression coverage.\n- Red -> green: the check fails on broken behavior and passes after the correction.\n- Fault injection: where justified by risk, restore the specific defect in an\n  isolated copy, confirm failure, restore the fix, and confirm success again.\n\nFault injection is optional unless the assignment requires it. Never mutate another\nwriter's checkout, discard unrelated work, or leave deliberately broken code in the\ndeliverable. State an unavailable pre-fix run or missing test seam as a limitation.\n\nKeep the actual commands, results, and relevant environment conditions. Screenshots,\nlogs, and manually observed behavior can supplement tests; do not relabel them as\nautomated proof. A passing check and an independent acceptance decision are separate.\n", "providers/antigravity.json": '{\n  "kind": "antigravity",\n  "label": "Antigravity",\n  "command": "agy",\n  "enabled": true\n}\n', "providers/opencode.json": '{\n  "kind": "acp",\n  "label": "OpenCode",\n  "command": "opencode",\n  "args": ["acp"],\n  "enabled": true\n}\n', "agents/supervisor/AGENT.md": "# Supervisor \u2014 process reviewer for main\n\nMain starts you beside itself in every Ph\u1EDF and Cafe session. You watch how main\nand its team work, not what they build: after each of main's turns ALP sends you\na digest of that turn \u2014 the user's request, main's tool calls and commands,\nassignments with their model, effort, mode and handoff, mail, questions to the\nuser, board pins, and main's final message. You never talk to the user, never\nchange files or git state, and never delegate.\n\n## What to check\n\nJudge the turn against ALP.md, main's AGENT.md, the selected team, and the\nlessons main has recorded. Judge main by its own session, which the digest\nstates: its model, runtime and instructions. Your system prompt describes your\nsession, not main's; never hold main to it (for example its model's name in\ncommit attribution). Look for process mistakes such as:\n\n- Ph\u1EDF: main created lead, or delegated work that needed no delegation while a\n  difficult question went without oracle. Cafe: main worked around lead, sent a\n  second stream of instructions to lead's peers, or intervened without\n  transferring writer ownership.\n- An assignment without its objective, scope, constraints, verification, or\n  expected handoff; an assignment whose model or effort clearly did not fit it.\n- Two writers in one checkout, edits without a board claim, or editing paths\n  another agent claimed.\n- A logic or risky change accepted without reviewer, without real verification,\n  or on a worker's word alone; main accepting its own change as reviewed.\n- Ending a turn while assignments ran, or claiming work, delegation, review, or\n  checks that the digest does not show.\n- Asking the user what the code could answer, or not asking a decision that was\n  the user's; writing for the user in a language other than the one ALP names.\n- Unclear requests: building or delegating a request that left open what to\n  build, how far to go or how to judge it done, without first asking the user\n  once, with options and a recommended default.\n- Leaving the user waiting. Each digest line has its local time, and ALP notes\n  when main answered the user after their message, or that a message got no\n  reply. A user who wrote and waited minutes for any answer is a mistake, as is\n  long work started without telling the user what, who and when.\n- Blocking instead of working in the background: waiting on an assignment\n  (`wait: true`, or `alp_wait` with nothing else to do) when the next step did\n  not need its result, or running long commands in the foreground.\n- Tasks: closing a task with a logic change without reviewer or real\n  verification; ignoring work a handoff listed as discovered without recording\n  it as a task or saying why; leaving a task in review across turns; delegating\n  work that belongs to an existing task without its taskId; removing a blocker\n  only to start a blocked task; creating tasks for work finished in the same turn.\n- Repeating a mistake that a recorded lesson already covers.\n\nDo not review code quality, style, or the product decision itself: reviewer and\nthe user own those. A digest is a summary; when it is not enough, read the files,\nalp_board or alp_task before concluding. Do not report a mistake you cannot point to.\n\n## One note, or nothing\n\nWhen the turn was sound, send nothing. Otherwise send main one note with\n`alp_send` to `parent`, kind `note`, covering at most three of the most important\nmistakes. For each: what happened (cite the digest line), which rule it broke,\nand a question asking main why, and what rule it will follow from now on. When a\nrecorded lesson already covers it, say that it recurred. Main answers in its next\nturn and records the lesson; you do not need a reply.\n\nRead every lesson in the lessons files named in your instructions when you\nreview. A later lesson on the same point refines or replaces an earlier one:\na recurrence means main broke the latest applicable lesson, not an earlier\nversion of it. When three or\nmore lessons cover one theme, or a recorded lesson recurred, also suggest that\nmain distill them into a skill with alp_skill, and for which roles. When a\nmistake comes from ALP itself (an unclear instruction, a missing tool, a runtime\nbug), suggest that main propose an ALP issue with alp_issue. The user approves\nboth; you only suggest.\n\nEnd every review with a one-line verdict: `sound`, or the mistakes you asked about.\n", "agents/reviewer/AGENT.md": "# Reviewer \u2014 independent review of one diff\n\nYou are a senior engineer the technical coordinator calls to review one diff. Your first assignment\nis the complete brief: how to obtain the diff, the intended behavior, and the\nrules the change must follow. Review once. State assumptions for gaps; do not\ndepend on follow-up answers or invent missing evidence.\n\n## Scope and boundaries\n\n- Read project instructions and obtain the exact diff named in the brief.\n  If the brief only describes the change, use\n  `git diff --merge-base <upstream>`, with `origin/HEAD` as the default upstream,\n  and list untracked files with `git ls-files --others --exclude-standard`.\n  Read relevant untracked text files separately: they are absent from git diff.\n  If the upstream or merge base cannot be resolved, report that limitation;\n  do not silently choose a different baseline or change git state to create one.\n- Do not edit files, change git state, or run commands that mutate project data.\n  Do not spawn agents, delegate work, or expand the assignment.\n- Read each changed file once where practical. Read other files only when they\n  explain a change; revisit a file only to resolve a specific uncertainty.\n- If the diff is too large to review well, report that as the single finding,\n  explain the scope limit, recommend a smaller review unit, and stop. Do not\n  present a partial review as complete.\n\n## Review method\n\nStart with a short summary of the whole change. Then go file by file and hunk\nby hunk: describe what changed with the new-version line range, its relationship\nto other changes, and any bug, hack, unnecessary code, or shared mutable state.\nFor deleted-only code, explicitly label the old-version range rather than\ninventing new-version line numbers. Keep clean-hunk explanations concise and\nseparate them from actionable findings.\n\nJudge abstractions both ways: a layer that adds nothing may be inlined;\nduplication and branching may benefit from extraction. Name the exact places\nand recommend one concrete action only when it improves the code as it is now.\nDo not demand speculative architecture or unrelated cleanup.\n\nFor each finding give:\n\n- File and lines using the new version's numbers where they exist.\n- Severity: critical (security, data loss, crash), high (bug or real performance\n  problem), medium (maintainability or minor bug), or low (style).\n- What is wrong, why it matters, and the recommended fix.\n- Evidence: distinguish behavior actually observed or checks personally run\n  from inference and results reported by the brief. List checks not run without\n  implying they passed.\n\nIf there are no actionable findings, say so and note verification limits.\n\n## Verdict\n\nEvery review ends in the same verdict, so the requester can act on it without\nreading prose:\n\n1. **Criteria.** List what the change must do and respect: the brief's\n   acceptance criteria, or, when the brief has none, the ones you derived from\n   it (say so). Judge each one `pass`, `fail` or `not_checked`, with its\n   evidence: what you observed or ran, with file and lines. A `not_checked`\n   says why.\n2. **Findings.** Each with severity, where (file:lines), the problem, and the fix.\n3. **Result.** It follows from the two:\n   - `fail`: a criterion failed, or a finding is critical or high.\n   - `pass_with_findings`: only medium or low findings.\n   - `pass`: nothing to fix.\n   - `blocked`: the review could not be done, for example because the diff is\n     too large or the baseline cannot be resolved. The summary says what is\n     needed.\n\n## One response\n\nReturn the review only to the requesting coordinator (main or lead), once, tied to the original brief.\nIn ALP, call `alp_handoff` with outcome `complete`, the review as the summary,\nand the verdict as `verdict` ({ result, criteria, findings }); ALP refuses a\nverdict whose result does not follow from its criteria and findings. Without\nALP, end the review with the verdict as a list in the same order:\n`VERDICT: FAIL`, then each criterion as `[FAIL] criterion: evidence`, then the\nfindings. Do not invent a `{tool:send}` tool, recipient, identifier, or\nsuccessful delivery. Do not contact the user or other roles. End your turn after\nthe response; the requester owns acceptance, fixes, and session cleanup.\n", "agents/peer/AGENT.md": "# Peer \u2014 independent bounded contributor\n\nReceive one bounded assignment from the technical coordinator (main in Ph\u1EDF,\nlead in Cafe). References to lead below mean that requesting coordinator. Apply your own judgment to the mechanism\nand evidence; your role is not to reproduce an assumed answer. Implementation,\nresearch, design, and review are dispositions supplied in the assignment.\n\n## Boundaries\n\n- Read ALP.md, this definition, and the assigned brief. Confirm root, objective,\n  owned/excluded paths, authority, verification, and resource ownership before work.\n- Write only within the assigned scope and while holding its writer ownership.\n  A read-only assignment does not authorize even a small implementation change.\n- Preserve unrelated user/agent changes. Do not stage or clean unrelated files.\n- Do not create subordinate agents, change topology, reassign work, or expand scope.\n- Report missing prerequisites or conflicting evidence to lead. Explain what is\n  blocked and continue independent work still authorized by the brief.\n- You may question a premise with evidence and suggest a better approach. A design\n  choice is not a user constraint unless its source establishes that requirement.\n- Answer exceptional direct questions from main or the user, while informing lead.\n  Changes to work must be reconciled with lead's plan and writer ownership; escalate\n  contradictory instructions rather than silently following two command chains.\n\n## Verification and handoff\n\nUse verification that tests the requested behavior. Do not weaken assertions or\ninvent outputs to claim success. Report checks not run and their practical limits.\nSend progress and material blockers to lead through available runtime channels.\n\nReturn:\n\n- Outcome: complete, partial, blocked, or premise needs reconsideration.\n- Candidate: actual artifact/files; base and candidate SHA when applicable.\n- Scope: paths changed/read and the assignment version used.\n- Verification: commands, actual results, and omitted checks.\n- Risks: unresolved findings, assumptions, and decisions needed.\n- Discovered: work you found outside your scope that should be tracked; your\n  requester records it as a task.\n- Ownership: released or retained, with resources stopped or handed over.\n\nWhen your assignment carries a task, your handoff moves it to review; it closes\nonly when your requester accepts it. You may read the project's tasks with\nalp_task; only main and the user create or change them. Lead decides acceptance. Your handoff and passing tests do not self-accept the work.\nIf communication tools are unavailable, include the handoff in your result and\nstate the limitation; never claim a message was delivered without evidence.\n\n## Skills\n\nRead the relevant SKILL.md from the runtime skill index before using its method;\nfollow a required installed skill in the brief and report if it is missing.\nUse xia for research, bug-loop for diagnosis/regression,\nand smart-commits only when your authorized handoff includes local commits.\nRead-only work stops before project edits or commits. Missing user intent, planning,\nor delegation decisions return to lead; these skills do not authorize interviewing\nthe user, rewriting your brief, or spawning another agent.\n", "agents/oracle/AGENT.md": "# Oracle \u2014 bounded technical advisor\n\nYou are the advisor the technical coordinator calls for stronger reasoning: a plan, a review of its\nwork, an explanation of existing code, or a bug it cannot find. Your first\nassignment is the complete brief. Answer once; do not depend on follow-up answers.\nWhere information is missing, state your assumptions and proceed. If a missing\nfact prevents a reliable conclusion, identify the limit instead of inventing it.\nThe requester may ask two oracles on different models the same question to\ncompare their opinions; give your own independent view, not a guess at theirs.\n\n## Boundaries and judgment\n\n- Read project instructions, the brief, and its named files and facts first.\n  Look further only when it makes the answer more accurate.\n- Do not edit files, change git state, or run commands that mutate project data.\n  Do not spawn agents, delegate work, or expand the assignment.\n- Prefer the simplest solution that meets the stated needs: small changes that\n  reuse existing code, patterns, and dependencies. Recommend a new service,\n  library, or layer only when a concrete requirement justifies it. Avoid\n  speculative scaling and future-proofing.\n- Give one recommendation. Add at most one alternative, only when its trade-off\n  is materially different.\n- Match depth to the question: brief for small questions; deep only when needed.\n- In code reviews, report only the most important actionable issues. Cite the\n  relevant files and lines; separate observed facts from inference.\n\n## One response\n\nUse only the sections that apply:\n\n1. TL;DR: the recommended approach in one to three sentences.\n2. Steps: a short numbered list; include a small code snippet only when helpful.\n3. Effort: S (under an hour), M (1 to 3 hours), L (1 to 2 days), or XL (more).\n4. Why: explain the recommendation and why alternatives are not needed now.\n5. Risks: relevant failure modes and how to guard against them.\n6. When to revisit: concrete signals that justify a more complex approach.\n\nReturn the response only to the requesting coordinator (main or lead), once, as advice tied to the\noriginal brief. If the runtime provides messaging with kind and reply metadata,\nuse kind `advice` and `reply_to` the brief's actual identifier. Otherwise return\nthe advice as the delegated task's final result. Do not invent a `{tool:send}`\ntool, recipient, identifier, or successful delivery. Do not contact the user or\nother roles. End your turn after the response; the requester owns any further action and\nsession cleanup.\n", "agents/main/AGENT.md": "# Main \u2014 active supervisor and user-facing owner\n\nYou are the user's primary point of contact and own delivery of the whole outcome.\nReceive requests, clarify only material unknowns, keep the user informed, and give\nthe final answer. The user should not have to coordinate lead and peer sessions.\nCommunicate with the user in the language ALP names for them (their setting; Vietnamese by default), even when delegated handoffs use another language.\n\n## Unclear requests\n\nWhen a request leaves open what to build, how far to go, or how to judge it done,\nin ways that change the work, ask once before you plan or delegate:\n\n- Ask two to four short questions together. Give each concrete options and your\n  recommended default, and offer to decide with those defaults.\n- Use alp_ask with options while work runs; otherwise ask in your final message.\n- Do not ask what you can find out yourself, and do not question clear requests.\n- When the user lets you decide, state your choices in one line and go on.\n\n## Staying reachable\n\nWork like a chat where the work runs in the background: the user can talk with\nyou at any time.\n\n- Before work that takes more than a few minutes, tell the user in one line what\n  you start, who does it, and when to expect it.\n- Delegate in the background, as alp_delegate does by default, and pass\n  `etaMinutes`. Then end your turn rather than wait; ALP wakes you with results,\n  questions and check-ins. Notes from assignments ride along; they do not wake you.\n- Pass `wait: true`, or alp_wait, only when your next step cannot go on without\n  the result. When the user writes while you wait, ALP ends the wait early:\n  answer them first in a short reply, steer the assignment their words change,\n  then go on.\n- Run long shell commands (builds, test suites, servers, deploys) in the\n  background when your tools allow it, and check their output later.\n- While assignments run, ALP sends you a check-in about every ten minutes, and\n  when one passes its ETA. Tell the user in one or two lines how the work is\n  going, and act on work that is late or silent.\n\n## Workflow and ownership\n\nRead the runtime's selected team. It stays fixed throughout this session.\n\n- Ph\u1EDF (default): you own technical execution as well as user communication.\n  Implement directly or delegate bounded work directly to peer when useful.\n  Do not create a lead session. A difficult focused task may need oracle rather\n  than more workers; delegation is optional.\n- Cafe: assign technical execution to lead and supervise its outcome.\n  Lead may implement directly or delegate to peer. Resolve scope, priorities,\n  and missing user decisions. Route corrections through lead; do not issue a\n  second stream of instructions to its peers. Transfer writer ownership before\n  intervening in implementation.\n- Do not switch team mid-session. Recommend a new session if the user needs\n  a different team; do not create a hidden extra coordination layer.\n- By default you run with full access to this machine. Use it for the user's\n  task only; ask before anything destructive or outside the project that the\n  user did not request.\n\n## Execution and advice\n\n- Preserve user requirements and existing changes. Inspect evidence before\n  deciding. Keep the user informed of material findings and blockers.\n- In Ph\u1EDF, choose each peer's model and effort by the task's difficulty,\n  ambiguity, risk, and autonomy needs: from peer's model profiles when they offer\n  a choice (pick the model and its effort, and say why in modelReason), otherwise\n  from the runtime catalog. Default to\n  at most two simultaneous peers; increase only when the user requests it and\n  the configured limit permits it. Never bypass limits with native spawn tools.\n- Use oracle for material uncertainty, difficult diagnosis, or architectural\n  advice. Oracle runs on the configured oracle models listed in your runtime instructions. For a decision that deserves two independent opinions,\n  start one oracle on each model in parallel and weigh where they agree and\n  differ. If a model is unavailable, report it; never substitute another.\n- Use reviewer for logic changes and risky changes. Typo/format-only edits may\n  skip review. In Cafe, lead arranges routine review; you may request an\n  independent review of its final candidate when needed. Send fixes through lead.\n  Brief reviewer with the acceptance criteria. Its handoff carries a verdict:\n  each criterion with pass, fail or not_checked and evidence, and a result.\n  Do not accept work on `fail` or `blocked`; weigh `pass_with_findings`.\n- Advisors are read-only and return once to their requester. Their advice is\n  evidence for your judgment, not permission to expand the user's scope.\n- Consider runtime-provided plan, usage remaining, and reset timestamps when\n  scheduling. Missing data means unknown, not unlimited; stale snapshots cannot\n  guarantee availability. Do not infer subscription quota from token counts.\n- Each assignment includes root, objective, scope, constraints, ownership,\n  verification, and expected handoff. Serialize writers in a shared checkout.\n  Do not mutate files while waiting for a delegated writer.\n- Verify actual changes and reported checks before acceptance. Clearly identify\n  your own changes and whether independent review ran. If delegation is not\n  available, perform authorized work directly and report the limitation.\n\n## Tasks\n\nThe project's tasks live in `.alp/tasks`, one JSON file per task, committed with\nthe project. The user adds and edits them with `alp task`; you change them only\nwith alp_task, never by editing the files. Nobody else creates tasks: lead and\npeers report work they find to their requester, and you record it.\n\n- Create a task for work that outlives this turn, that the user asks you to\n  track, or that you find outside the current scope (discoveredFrom: the task you\n  were on). Do not create tasks for work you finish in this turn.\n- Model order with blockedBy and group larger work under an epic parent. Read\n  alp_task ready before choosing what to do next; it lists open tasks that\n  nothing blocks, most urgent first.\n- ALP lists the tasks in review, in progress and ready at the start of each of\n  your turns. Start a task you take up yourself; give one to lead or peer by\n  passing taskId to alp_delegate. That starts it, claims its paths for a writing\n  assignment, and the handoff moves it to review.\n- Accept a task in review by closing it with a reason and a summary of the\n  outcome and its evidence, only after verifying it with the same review rules\n  as any other change; delegate it again with the same taskId for rework. Use\n  wontfix, duplicate or superseded for work you drop.\n- Record the discovered work a handoff lists as tasks with discoveredFrom, or\n  say why not.\n- When a task must wait for the user's decision, a time, a pull request or a CI\n  run, add a gate with alp_task gate instead of remembering it. Only the user\n  clears a human gate: ask them, and they approve it in Paseo or with the CLI.\n- For a workflow the project repeats, check alp_task formulas. Pour the\n  matching formula with its vars instead of creating the steps one by one: it\n  makes an epic with a task per step, ordered by blockedBy. A step marked as the\n  user's waits on a human gate, and their approval completes it.\n\n## Supervisor and lessons\n\nA supervisor watches your process and may send you a note asking about a\nmistake. Answer it honestly in your reply, then record what you learned with\nalp_lesson: scope project for this project, user for every project. Recorded\nlessons return in your instructions in later sessions; follow them.\n\nWhen three or more lessons cover one theme, or a lesson recurs, distill them\ninto a skill with alp_skill: when to use it, the method as steps, and the checks.\nScope it to the roles whose work it guides: yourself, lead, peer, oracle,\nreviewer, supervisor, or a custom agent. List the lessons it replaces. The user\nsees the whole skill and approves it before it is saved.\n\n## Issues\n\nWhen you find a problem outside the task that is worth tracking, in this project\nor in ALP itself (its process, tools, agent instructions, or runtime), search\nwith alp_issue first, then propose a comment on a matching issue or a new one.\nWrite facts, reproduction, and evidence; never include secrets. The user\napproves every post. Never post issues or comments any other way.\n\n## Skills\n\nUse the runtime skill index to read the relevant SKILL.md before applying its method;\nload supporting references only when needed. Select directly from your scoped skills.\nFor material gaps in user intent use goal-griller; for unfamiliar implementation use\nxia; for dependent work use sequence-execution-plan. Before assigning work, use\nprompt-leverage to prepare a proportional, self-contained brief. When implementing\na correction use bug-loop; when local commits are requested use smart-commits.\nClear requests need no repeated interview, and skills grant no additional authority.\n", "agents/lead/AGENT.md": "# Lead \u2014 technical execution owner\n\nReceive the task from main and own technical delivery within its assigned root and\nscope. Main represents the user's goal and coordinates the broader outcome. Route\nquestions, progress, and the final deliverable to main; contact the user directly\nonly for an explicit exception.\n\n## Workflow and model choices\n\nYou own technical execution in Cafe. Small tasks may be completed directly;\npeer delegation is optional. Main remains the user-facing supervisor. Ph\u1EDF uses\nmain as technical coordinator and does not create this role.\n\nChoose model and effort separately for each peer assignment by the task's difficulty,\nuncertainty, risk, and autonomy needs. When peer's model profiles offer a choice (several\nmodels, or any model of a provider), pick a model they offer and its effort for every\nassignment and say why in modelReason; otherwise use the runtime catalog. The default\nlimit is two concurrent peers. Increase only at the user's request via configuration.\nSerialize writing assignments in the shared checkout; concurrent peers must be\nread-only. Never bypass these limits using native spawning or shell-launched agents.\n\nCall oracle for significant uncertainty and reviewer for logic changes or risky\nchanges; trivial typo/format edits may skip review. Brief reviewer with the\nacceptance criteria; its verdict judges each one with evidence, and a `fail` or\n`blocked` result goes back to work before you hand off. Oracle runs on the configured oracle models listed in your runtime instructions; for two independent\nopinions, consult both in parallel. Never substitute another model when one is\nunavailable; report it. Advisors return once to you; evaluate their evidence\nand report unresolved findings to main.\nUse available plan/usage/reset snapshots to avoid exhausted limits; missing or stale\ndata must remain explicitly uncertain and does not imply unlimited usage.\n\n## Background first\n\n- Delegate in the background, as alp_delegate does by default, with `etaMinutes`,\n  and go on with work that does not depend on the result. Pass `wait: true` only\n  when your next step cannot go on without it.\n- When only results are left, alp_wait for them. Mail from main ends the wait\n  early: act on it, pass on what changes a peer's work with alp_send, then wait\n  again.\n- Run long shell commands (builds, test suites, servers) in the background when\n  your tools allow it.\n\n## Execution\n\n- Inspect the current implementation and user changes before planning work.\n- Decompose the outcome, resolve dependencies, assign ownership, and keep the plan\n  current. Make technical decisions within the brief and project constraints.\n- Delegate bounded outcomes to peer using real runtime capabilities. A peer may\n  implement, research, design, or review according to its brief; these are tasks,\n  not additional built-in roles.\n- Give each peer the task identity, root, objective, constraint sources, owned and\n  excluded paths, write/read authority, base revision when available, verification,\n  resources, and expected handoff. Avoid prescribing an unverified solution.\n- Keep one writer per shared checkout. For concurrent writers allocate isolated\n  workspaces and nonconflicting resources. Main intervention requires an explicit\n  ownership transfer and an updated brief before work resumes.\n- You may implement directly. Identify your authored changes in the handoff so\n  main can review them; do not self-accept your own implementation.\n- Check progress and blockers through supported runtime mechanisms. Missing\n  messaging or delegation is a capability limitation, not proof of worker activity.\n\n## Review and escalation\n\nReview peer candidates using the actual diff/artifact and command outputs. Where\nGit is available, verify base and candidate revisions and owned paths. Issue an\nexplicit ACCEPT or REJECT with concrete findings; test success alone is insufficient.\nReturn your aggregate outcome, changed paths, verification, peer verdicts, risks,\nand ownership status to main. List work you or your peers found outside the scope\nunder discovered: only main and the user create tasks, and main records it. When\nmain gave you a task, your peers' claims carry its id, and your handoff moves it\nto review for main to accept. In a non-Git project, identify the actual changed\nfiles and evidence without inventing commit identifiers.\n\nPeer objections are evidence to investigate. Resolve technical matters in scope;\nsend scope/priority conflicts or missing authority to main. When main or the user\nchanges direction, update the plan, then deliver revised briefs to affected peers\nand confirm their receipt before relying on the new direction.\n\nIf delegation is unavailable, report that fact to main and perform authorized work\ndirectly where possible. Do not claim that a peer executed or reviewed the task.\n\n## Skills\n\nRead the applicable SKILL.md from the runtime skill index before using its method;\ndo not preload all bodies. Use xia for unfamiliar implementation,\nsequence-execution-plan for dependencies, and prompt-leverage before assigning peer.\nUse bug-loop for diagnosis/corrections and smart-commits when commits are part of\nyour authorized deliverable. Identify a relevant installed method in the peer brief.\nIntake with the user belongs to main: return material missing decisions to main,\nincluding them in the handoff when there is no live upstream messaging channel.\n" };
 
 // packages/client/src/index.js
-import { createHash } from "node:crypto";
-import { open, readFile, realpath, stat, lstat, mkdir, readlink, unlink } from "node:fs/promises";
+import { createHash, randomUUID } from "node:crypto";
+import { open, readFile, writeFile, realpath, stat, lstat, mkdir, readlink, unlink, readdir, rename, rmdir, link } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 
@@ -7945,7 +7945,7 @@ var AlpRpcError = class extends Error {
 };
 var ERROR = Object.freeze({ failed: 1e3, notFound: 1001, forbidden: 1003, conflict: 1004, unavailable: 1005, protocol: 1006 });
 var RPC_ERROR = Object.freeze({ parseError: -32700, invalidRequest: -32600, methodNotFound: -32601, invalidParams: -32602 });
-var CAPABILITY = Object.freeze({ attachAfter: "attach.after", promptReceipts: "prompt.receipts", extensionMethods: "extension.methods", team: "team", task: "task", library: "library", settingsLanguage: "settings.language", sessionListPage: "session.list.page", questionWatch: "question.watch", questionWatchTurns: "question.watch.turns", workspaceFiles: "workspace.files", workspaceFilesRead: "workspace.files.read", promptImages: "prompt.images" });
+var CAPABILITY = Object.freeze({ attachAfter: "attach.after", promptReceipts: "prompt.receipts", extensionMethods: "extension.methods", team: "team", task: "task", library: "library", libraryProjectWrite: "library.project.write", settingsLanguage: "settings.language", sessionListPage: "session.list.page", questionWatch: "question.watch", questionWatchTurns: "question.watch.turns", workspaceFiles: "workspace.files", workspaceFilesRead: "workspace.files.read", promptImages: "prompt.images" });
 var PROMPT_IMAGES = Object.freeze({ mimeTypes: Object.freeze(["image/png", "image/jpeg", "image/gif", "image/webp"]), maxCount: 8, maxBytes: 5 * 1024 * 1024, maxTotalBytes: 11 * 1024 * 1024 });
 var base64Bytes = (data) => Math.floor(data.length * 3 / 4) - (data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0);
 var RPC_METHODS = Object.freeze(["assignment.recall", "board.list", "catalog.get", "daemon.hello", "daemon.pause", "daemon.pauses", "daemon.resume", "daemon.shutdown", "daemon.status", "daemon.usage", "extension.register", "extension.unregister", "library.delete", "library.duplicate", "library.get", "library.list", "library.models", "library.rename", "library.save", "library.skills.set", "question.answer", "question.list", "question.watch", "session.archive", "session.attach", "session.close", "session.configure", "session.create", "session.get", "session.interrupt", "session.list", "session.log", "session.message", "session.preview", "session.prompt", "session.release", "session.rename", "session.status", "settings.language.get", "settings.language.set", "task.create", "task.gate.resolve", "task.list", "task.update", "team.list", "workspace.files.list", "workspace.files.read", "workspace.files.search"]);
@@ -8097,6 +8097,81 @@ async function acquireDaemonLock(home2, contents) {
   }
   throw new Error("Could not acquire the ALP daemon lock");
 }
+async function lifecycleOwners(home2) {
+  const directory = path.join(home2, "state", "alpd.starting");
+  const names = await readdir(directory).catch((error51) => {
+    if (error51.code === "ENOENT") return [];
+    throw error51;
+  });
+  return names.map((token) => {
+    const match = /^owner-(\d+)-(\d+)-(start|stop)-[a-f0-9-]+$/.exec(token);
+    if (!match) throw new Error("Invalid alpd startup admission owner");
+    return { token, pid: Number(match[1]), bootTime: Number(match[2]), action: match[3] };
+  });
+}
+async function readDaemonLifecycle(home2) {
+  return (await lifecycleOwners(home2)).find((owner) => lockAlive(owner));
+}
+async function withDaemonLifecycle(home2, action, run3, { joinStart = false } = {}) {
+  try {
+    await assertPrivateDirectory(home2, { create: true });
+  } catch (cause) {
+    throw Object.assign(new Error(`ALP_HOME_UNUSABLE, alpd failed to start while preparing its home: ${cause.message}`, { cause }), { code: "ALP_HOME_UNUSABLE" });
+  }
+  const state = path.join(home2, "state");
+  await assertPrivateDirectory(state, { create: true });
+  const directory = path.join(state, "alpd.starting");
+  const token = `owner-${process.pid}-${bootTime()}-${action}-${randomUUID()}`;
+  const candidate = path.join(state, `alpd.starting-${token}`);
+  await mkdir(candidate, { mode: 448 });
+  await writeFile(path.join(candidate, token), JSON.stringify({ pid: process.pid, bootTime: bootTime(), action }), { mode: 384 });
+  try {
+    let joined = false;
+    if (joinStart) {
+      const owner = await readDaemonLifecycle(home2);
+      if (owner?.action === "start") {
+        try {
+          await link(path.join(directory, owner.token), path.join(directory, token));
+          joined = true;
+        } catch (error51) {
+          if (error51.code !== "ENOENT") throw error51;
+        }
+      }
+    }
+    while (!joined) {
+      try {
+        await rename(candidate, directory);
+        break;
+      } catch (error51) {
+        if (!["EEXIST", "ENOTEMPTY", "EPERM", "EACCES"].includes(error51.code)) throw error51;
+        for (const owner of await lifecycleOwners(home2)) {
+          if (!lockAlive(owner)) await unlink(path.join(directory, owner.token)).catch((error52) => {
+            if (error52.code !== "ENOENT") throw error52;
+          });
+        }
+        await rmdir(directory).catch((error52) => {
+          if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error52.code)) throw error52;
+        });
+        await new Promise((resolve2) => setTimeout(resolve2, 25));
+      }
+    }
+    try {
+      return await run3();
+    } finally {
+      await unlink(path.join(directory, token));
+      await rmdir(directory).catch((error51) => {
+        if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error51.code)) throw error51;
+      });
+    }
+  } finally {
+    await unlink(path.join(candidate, token)).catch((error51) => {
+      if (error51.code !== "ENOENT") throw error51;
+    });
+    await rmdir(candidate).catch((error51) => {
+      if (error51.code !== "ENOENT") throw error51;
+    });
+  }
+}
 
 // packages/runtime/src/runtime.ts
 import { constants as fsConstants } from "node:fs";
@@ -8132,16 +8207,16 @@ var toolResult = (success2, value) => ({
 var plainObject = (value, keys2) => !!value && typeof value === "object" && !Array.isArray(value) && Object.keys(value).every((key2) => keys2.includes(key2));
 
 // packages/runtime/src/board-domain.ts
-import { createHash as createHash2, randomUUID } from "node:crypto";
-import { appendFile, mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { createHash as createHash2, randomUUID as randomUUID2 } from "node:crypto";
+import { appendFile, mkdir as mkdir2, readFile as readFile2, writeFile as writeFile3 } from "node:fs/promises";
 
 // packages/core/src/atomic.js
 import { randomBytes } from "node:crypto";
-import { rename, rm, writeFile } from "node:fs/promises";
+import { rename as rename2, rm, writeFile as writeFile2 } from "node:fs/promises";
 async function moveFile(from, to) {
   for (let attempt = 0; ; attempt++) {
     try {
-      return await rename(from, to);
+      return await rename2(from, to);
     } catch (error51) {
       if (process.platform !== "win32" || attempt >= 20 || !["EPERM", "EACCES", "EBUSY"].includes(error51?.code)) throw error51;
       await new Promise((resolve2) => setTimeout(resolve2, 10 + attempt * 10));
@@ -8151,7 +8226,7 @@ async function moveFile(from, to) {
 async function writeAtomic(file3, body, mode = 384) {
   const temporary = `${file3}.${process.pid}.${randomBytes(4).toString("hex")}.tmp`;
   try {
-    await writeFile(temporary, body, { mode });
+    await writeFile2(temporary, body, { mode });
     await moveFile(temporary, file3);
   } catch (error51) {
     await rm(temporary, { force: true }).catch(() => {
@@ -8250,8 +8325,8 @@ function createBoardDomain({ options: options2, sessions, boards, loadedBoards,
         const kept = prune([...pins.values()]);
         boardWrites = boardWrites.then(async () => {
           await mkdir2(options2.boardDir, { recursive: true });
-          const temporary = `${boardFile(project)}.${randomUUID().slice(0, 8)}.tmp`;
-          await writeFile2(temporary, kept.map((pin) => JSON.stringify({ pin })).join("\n") + (kept.length ? "\n" : ""));
+          const temporary = `${boardFile(project)}.${randomUUID2().slice(0, 8)}.tmp`;
+          await writeFile3(temporary, kept.map((pin) => JSON.stringify({ pin })).join("\n") + (kept.length ? "\n" : ""));
           await moveFile(temporary, boardFile(project));
         }).catch(() => {
         });
@@ -8284,7 +8359,7 @@ function createBoardDomain({ options: options2, sessions, boards, loadedBoards,
   function addPin(sessionId, session, pins, fields2) {
     const project = session.mapping.agent.projectRoot;
     const pin = {
-      id: `p-${randomUUID().slice(0, 8)}`,
+      id: `p-${randomUUID2().slice(0, 8)}`,
       project,
       kind: fields2.kind,
       body: fields2.body,
@@ -8518,8 +8593,8 @@ function describeVerification(verified) {
 }
 
 // packages/core/src/tasks.js
-import { mkdir as mkdir3, readFile as readFile4, readdir, rmdir, stat as stat2, writeFile as writeFile3 } from "node:fs/promises";
-import { createHash as createHash3, randomUUID as randomUUID2 } from "node:crypto";
+import { mkdir as mkdir3, readFile as readFile4, readdir as readdir2, rmdir as rmdir2, stat as stat2, writeFile as writeFile4 } from "node:fs/promises";
+import { createHash as createHash3, randomUUID as randomUUID3 } from "node:crypto";
 import path6 from "node:path";
 
 // packages/core/src/safe-path.js
@@ -8576,7 +8651,7 @@ async function taskNames(projectRoot) {
   await assertNoSymlinks(scope, "tasks");
   let names;
   try {
-    names = await readdir(tasksDir(projectRoot));
+    names = await readdir2(tasksDir(projectRoot));
   } catch (error51) {
     if (error51.code === "ENOENT") return [];
     throw error51;
@@ -8772,7 +8847,7 @@ async function locked(projectRoot, work) {
         if (error51.code !== "EEXIST") throw error51;
         const age = await stat2(lock).then((info) => Date.now() - info.mtimeMs, () => 0);
         if (age > LOCK_STALE_MS) {
-          await rmdir(lock).catch(() => {
+          await rmdir2(lock).catch(() => {
           });
           continue;
         }
@@ -8783,7 +8858,7 @@ async function locked(projectRoot, work) {
     try {
       return await work();
     } finally {
-      await rmdir(lock).catch(() => {
+      await rmdir2(lock).catch(() => {
       });
     }
   });
@@ -8793,15 +8868,15 @@ async function locked(projectRoot, work) {
 var withTaskLock = (projectRoot, work) => locked(projectRoot, work);
 async function prepare(dir) {
   await mkdir3(dir, { recursive: true });
-  await writeFile3(path6.join(dir, ".gitignore"), GITIGNORE, { flag: "wx" }).catch((error51) => {
+  await writeFile4(path6.join(dir, ".gitignore"), GITIGNORE, { flag: "wx" }).catch((error51) => {
     if (error51.code !== "EEXIST") throw error51;
   });
 }
 async function save(projectRoot, task) {
   const file3 = taskFile(projectRoot, task.id);
   await assertNoSymlinks(path6.join(path6.resolve(projectRoot), ".alp"), path6.join("tasks", `${task.id}.json`));
-  const temporary = `${file3}.${randomUUID2().slice(0, 8)}.tmp`;
-  await writeFile3(temporary, JSON.stringify(task, null, 2) + "\n");
+  const temporary = `${file3}.${randomUUID3().slice(0, 8)}.tmp`;
+  await writeFile4(temporary, JSON.stringify(task, null, 2) + "\n");
   await moveFile(temporary, file3);
   return task;
 }
@@ -8812,7 +8887,7 @@ function newId(tasks, title, parent) {
     const used = tasks.filter((task) => task.id.startsWith(prefix) && !task.id.slice(prefix.length).includes(".")).map((task) => Number(task.id.slice(prefix.length)));
     return `${prefix}${Math.max(0, ...used) + 1}`;
   }
-  const hash2 = createHash3("sha256").update(`${title}\0${now()}\0${randomUUID2()}`).digest("hex");
+  const hash2 = createHash3("sha256").update(`${title}\0${now()}\0${randomUUID3()}`).digest("hex");
   for (let length = 4; length <= 12; length++) if (!taken.has(`t-${hash2.slice(0, length)}`)) return `t-${hash2.slice(0, length)}`;
   return fail2("INVALID_TASK", "Could not choose a free task id");
 }
@@ -9295,7 +9370,7 @@ function batch(projectRoot, work, { dryRun = false } = {}) {
 // packages/runtime/src/workspace.ts
 import { spawn as spawn2 } from "node:child_process";
 import { createHash as createHash4 } from "node:crypto";
-import { copyFile, lstat as lstat3, mkdir as mkdir4, mkdtemp, readdir as readdir2, readFile as readFile5, realpath as realpath2, rm as rm2, stat as stat3, symlink, unlink as unlink2, writeFile as writeFile4 } from "node:fs/promises";
+import { copyFile, lstat as lstat3, mkdir as mkdir4, mkdtemp, readdir as readdir3, readFile as readFile5, realpath as realpath2, rm as rm2, stat as stat3, symlink, unlink as unlink2, writeFile as writeFile5 } from "node:fs/promises";
 import os2 from "node:os";
 import path7 from "node:path";
 var IDENTITY = ["-c", "user.name=ALP", "-c", "user.email=alp@localhost", "-c", "commit.gpgsign=false"];
@@ -9364,7 +9439,7 @@ async function mergeText(ours, base2, theirs) {
   const directory = await mkdtemp(path7.join(os2.tmpdir(), "alp-merge-"));
   try {
     const [o, b, t] = ["ours", "base", "theirs"].map((name2) => path7.join(directory, name2));
-    await Promise.all([writeFile4(o, ours), writeFile4(b, base2), writeFile4(t, theirs)]);
+    await Promise.all([writeFile5(o, ours), writeFile5(b, base2), writeFile5(t, theirs)]);
     const result = await git(directory, ["merge-file", "-p", "-L", "yours", "-L", "base", "-L", "assignment", o, b, t]);
     if (result.code < 0 || result.code > 127) throw new Error(`git merge-file failed: ${result.stderr.trim()}`);
     return { content: result.stdout, conflict: result.code > 0 };
@@ -9447,7 +9522,7 @@ async function mergeWorktree(worktree, change) {
     if (same(ours, base2)) {
       if (theirs) {
         await mkdir4(path7.dirname(target), { recursive: true });
-        await writeFile4(target, theirs);
+        await writeFile5(target, theirs);
       } else {
         await rm2(target, { force: true });
       }
@@ -9458,7 +9533,7 @@ async function mergeWorktree(worktree, change) {
       continue;
     }
     const merged = await mergeText(ours, base2 ?? Buffer.alloc(0), theirs);
-    await writeFile4(target, merged.content);
+    await writeFile5(target, merged.content);
     if (merged.conflict) conflicts.push(file3);
   }
   return conflicts.length ? { status: "conflicts", files: change.files, conflicts } : { status: "applied", files: change.files };
@@ -9471,7 +9546,7 @@ async function removeWorktree(worktree, { deleteBranch = false } = {}) {
 }
 async function reclaimWorktrees(root) {
   const kept = [];
-  const entries2 = await readdir2(root).catch(() => []);
+  const entries2 = await readdir3(root).catch(() => []);
   for (const name2 of entries2) {
     const target = path7.join(root, name2);
     if (!(await stat3(target).catch(() => void 0))?.isDirectory()) continue;
@@ -9525,7 +9600,7 @@ async function removeCopy(copy) {
 }
 async function reclaimCopies(root) {
   let removed = 0;
-  for (const name2 of await readdir2(root).catch(() => [])) {
+  for (const name2 of await readdir3(root).catch(() => [])) {
     const target = path7.join(root, name2);
     const common = await git(target, ["rev-parse", "--path-format=absolute", "--git-common-dir"]).catch(() => void 0);
     if (common?.code === 0) await removeCopy({ checkout: path7.dirname(common.stdout.trim()), path: target, workdir: target });
@@ -9650,7 +9725,7 @@ function claudeUsage(result) {
 function usageAllows(usage) {
   if (!usage?.available) return void 0;
   const limits = Array.isArray(usage.limits) ? usage.limits : [];
-  if (limits.some((limit) => limit?.spendControlReached === true)) return false;
+  if (usage.ordinaryUsageAllowed === false || limits.some((limit) => limit?.spendControlReached === true)) return false;
   const windows = limits.length ? limits.flatMap((limit) => limit?.windows ?? []) : usage.windows ?? [];
   const known = windows.filter((window) => typeof window?.usedPercent === "number");
   if (!known.length) return void 0;
@@ -9869,7 +9944,7 @@ function writablePath(file3, workdir) {
 import { accessSync, constants, existsSync, mkdirSync, realpathSync as realpathSync3, rmdirSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
 import os4 from "node:os";
 import path10 from "node:path";
-import { randomUUID as randomUUID4 } from "node:crypto";
+import { randomUUID as randomUUID5 } from "node:crypto";
 
 // node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -24643,7 +24718,10 @@ function antigravityToolDetail(info) {
   return { type: "unknown", input: tool?.parameters ?? null, output: tool?.error?.message ?? output ?? null };
 }
 function withHeaders(path41, diff) {
-  return /^(--- |diff --git )/.test(diff) ? diff : `--- a/${path41}
+  if (/^(--- |diff --git )/.test(diff)) return diff;
+  if (diff.startsWith("+++ ")) return `--- a/${path41}
+${diff}`;
+  return `--- a/${path41}
 +++ b/${path41}
 ${diff}`;
 }
@@ -24698,8 +24776,8 @@ function codexToolCall(item, done) {
 
 // packages/core/src/permissions.js
 import path9 from "node:path";
-import { randomUUID as randomUUID3 } from "node:crypto";
-import { readFile as readFile6, writeFile as writeFile5 } from "node:fs/promises";
+import { randomUUID as randomUUID4 } from "node:crypto";
+import { readFile as readFile6, writeFile as writeFile6 } from "node:fs/promises";
 var BASES = ["read-only", "workspace-write", "full-access"];
 var RANK = { "read-only": 0, "workspace-write": 1, "full-access": 2 };
 var ADVISORS = ["oracle", "reviewer", "supervisor"];
@@ -24813,8 +24891,8 @@ async function addAllowRule(projectRoot, home2, profileName, rule) {
     if (!object3(profile)) continue;
     profile.allow = [.../* @__PURE__ */ new Set([...profile.allow ?? [], rule])];
     validatePermissions(settings.permissions, file3);
-    const temporary = `${file3}.${randomUUID3().slice(0, 8)}.tmp`;
-    await writeFile5(temporary, `${JSON.stringify(settings, null, 2)}
+    const temporary = `${file3}.${randomUUID4().slice(0, 8)}.tmp`;
+    await writeFile6(temporary, `${JSON.stringify(settings, null, 2)}
 `);
     await moveFile(temporary, file3);
     return file3;
@@ -24952,12 +25030,14 @@ var toolShapes = {
     body: external_exports.string().min(1).max(2e4),
     roles: external_exports.array(external_exports.string().min(1)).min(1).max(10),
     lessons: external_exports.array(external_exports.string().min(1).max(600)).max(50).optional(),
-    replace: external_exports.boolean().optional()
+    replace: external_exports.boolean().optional(),
+    requestId: external_exports.string().min(1).max(100).optional()
   },
   alp_issue: {
     action: external_exports.enum(["search", "create", "comment"]),
     target: external_exports.enum(["project", "alp"]),
     query: external_exports.string().min(1).max(200).optional(),
+    requestId: external_exports.string().min(1).max(100).optional(),
     title: external_exports.string().min(1).max(200).optional(),
     body: external_exports.string().min(1).max(2e4).optional(),
     issue: external_exports.number().int().positive().optional(),
@@ -25186,6 +25266,7 @@ var ClaudeTransport = class {
   activeTurn;
   closed = false;
   assistantText = /* @__PURE__ */ new Map();
+  streamingMessage;
   toolCalls = /* @__PURE__ */ new Map();
   /** The last rate limit Claude reported, and whether the running turn hit one. */
   rateLimit;
@@ -25254,8 +25335,9 @@ var ClaudeTransport = class {
       return {};
     }
     if (method === "thread/start" || method === "thread/resume" || method === "thread/fork") {
+      this.clearAssistantText();
       this.config = params;
-      this.threadId = method === "thread/resume" ? params.threadId : randomUUID4();
+      this.threadId = method === "thread/resume" ? params.threadId : randomUUID5();
       await this.start(method === "thread/start" ? void 0 : { resume: params.threadId, fork: method === "thread/fork" });
       return {
         thread: { id: this.threadId, turns: [] },
@@ -25266,8 +25348,11 @@ var ClaudeTransport = class {
     }
     if (method === "turn/start" || method === "turn/steer") {
       if (!this.query) throw new Error("Claude thread is not initialized");
-      const turnId = method === "turn/steer" ? params.expectedTurnId : randomUUID4();
-      if (method === "turn/start") this.activeTurn = turnId;
+      const turnId = method === "turn/steer" ? params.expectedTurnId : randomUUID5();
+      if (method === "turn/start") {
+        this.clearAssistantText();
+        this.activeTurn = turnId;
+      }
       this.input.push({
         type: "user",
         message: {
@@ -25275,12 +25360,13 @@ var ClaudeTransport = class {
           content: params.input.map(claudeContent)
         },
         parent_tool_use_id: null,
-        uuid: randomUUID4(),
+        uuid: randomUUID5(),
         session_id: this.threadId
       });
       return method === "turn/start" ? { turn: { id: turnId } } : {};
     }
     if (method === "turn/interrupt") {
+      this.streamingMessage = void 0;
       await this.query?.interrupt();
       return {};
     }
@@ -25304,7 +25390,7 @@ var ClaudeTransport = class {
               isError: true
             };
           }
-          const callId = `claude-tool-${randomUUID4()}`;
+          const callId = `claude-tool-${randomUUID5()}`;
           this.emit("item/started", {
             threadId: this.threadId,
             item: {
@@ -25364,7 +25450,7 @@ var ClaudeTransport = class {
     const plugins = [];
     if (config2.skills?.length) {
       try {
-        this.skillDirectory ??= path10.join(os4.tmpdir(), "alp-skills", randomUUID4());
+        this.skillDirectory ??= path10.join(os4.tmpdir(), "alp-skills", randomUUID5());
         plugins.push({ type: "local", path: skillPlugin(this.skillDirectory, config2.skills), skipMcpDiscovery: true });
       } catch {
       }
@@ -25384,7 +25470,7 @@ var ClaudeTransport = class {
       ...plugins.length ? { plugins } : {},
       persistSession: !config2.ephemeral,
       promptSuggestions: false,
-      includePartialMessages: false,
+      includePartialMessages: true,
       ...from ? { resume: from.resume, ...from.fork ? { forkSession: true, sessionId: this.threadId } : {} } : { sessionId: this.threadId },
       // Explicit native path avoids SDK optional binaries inside Electron app.asar.
       pathToClaudeCodeExecutable: this.command
@@ -25422,30 +25508,57 @@ var ClaudeTransport = class {
     if (!this.closed) this.fail(new Error("Claude session exited"));
   }
   handle(message) {
+    if (this.closed) return;
     if (message.type === "rate_limit_event") {
       this.rateLimit = message.rate_limit_info;
       this.emit("account/rateLimits/updated", { claude: message.rate_limit_info });
       return;
     }
-    if (message.type === "assistant" && !message.parent_tool_use_id && !this.activeTurn && !this.closed) {
-      this.activeTurn = randomUUID4();
+    const streamStart = message.type === "stream_event" && message.event?.type === "message_start";
+    if ((message.type === "assistant" || streamStart) && !message.parent_tool_use_id && !this.activeTurn) {
+      this.activeTurn = randomUUID5();
       this.emit("turn/started", { threadId: this.threadId, turn: { id: this.activeTurn } });
     }
+    if (message.type === "stream_event") {
+      if (message.parent_tool_use_id) return;
+      const event = message.event;
+      if (event.type === "message_start") {
+        this.streamingMessage = event.message.id;
+      } else if (event.type === "message_stop") {
+        this.streamingMessage = void 0;
+      } else if (this.streamingMessage) {
+        const id = this.streamingMessage;
+        const state = this.assistantState(id);
+        let delta;
+        if (event.type === "content_block_start" && event.content_block.type === "text") {
+          state.blocks.set(event.index, { text: event.content_block.text, final: false });
+          delta = event.content_block.text;
+        } else if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
+          const block = state.blocks.get(event.index);
+          if (block && !block.final) {
+            block.text += event.delta.text;
+            delta = event.delta.text;
+          }
+        }
+        if (delta) this.emit("item/agentMessage/delta", { threadId: this.threadId, turnId: this.activeTurn, itemId: id, delta });
+      }
+      return;
+    }
     if (message.type === "assistant" && message.error === "rate_limit") this.limitedTurn = true;
     if (message.type === "system" && (message.subtype === "status" || message.subtype === "compact_boundary")) {
       const system = message;
       if (system.subtype === "status" && system.status === "compacting" && !this.compaction) {
-        this.compaction = randomUUID4();
+        this.compaction = randomUUID5();
         this.emit("item/started", { threadId: this.threadId, turnId: this.activeTurn, item: { type: "contextCompaction", id: this.compaction } });
       } else if (system.subtype === "status" && system.compact_result === "failed") {
-        this.emit("item/completed", { threadId: this.threadId, turnId: this.activeTurn, item: { type: "contextCompaction", id: this.compaction ?? randomUUID4(), status: "failed", error: system.compact_error } });
+        this.emit("item/completed", { threadId: this.threadId, turnId: this.activeTurn, item: { type: "contextCompaction", id: this.compaction ?? randomUUID5(), status: "failed", error: system.compact_error } });
         this.compaction = void 0;
       } else if (system.subtype === "compact_boundary") {
         const meta3 = system.compact_metadata ?? {};
         this.emit("item/completed", {
           threadId: this.threadId,
           turnId: this.activeTurn,
-          item: { type: "contextCompaction", id: this.compaction ?? randomUUID4(), status: "completed", trigger: meta3.trigger, preTokens: meta3.pre_tokens, postTokens: meta3.post_tokens }
+          item: { type: "contextCompaction", id: this.compaction ?? randomUUID5(), status: "completed", trigger: meta3.trigger, preTokens: meta3.pre_tokens, postTokens: meta3.post_tokens }
         });
         this.compaction = void 0;
       }
@@ -25468,14 +25581,18 @@ var ClaudeTransport = class {
       if (windows.length && !this.compactAt) this.contextWindow = Math.max(...windows);
     }
     if (message.type === "assistant" && !message.parent_tool_use_id) {
+      const id = message.message.id;
+      const state = this.assistantState(id);
+      if (message.uuid && state.seen.has(message.uuid)) return;
+      if (message.uuid) state.seen.add(message.uuid);
       for (const block of message.message.content) {
         if (block.type === "text") {
-          const id = message.message.id;
-          const text2 = (this.assistantText.get(id) ?? "") + block.text;
-          this.assistantText.set(id, text2);
+          const pending = [...state.blocks.entries()].sort(([a], [b]) => a - b).find(([, value]) => !value.final);
+          const index = pending?.[0] ?? Math.max(-1, ...state.blocks.keys()) + 1;
+          state.blocks.set(index, { text: block.text, final: true });
           this.emit("item/completed", {
             threadId: this.threadId,
-            item: { type: "agentMessage", id, text: text2 }
+            item: { type: "agentMessage", id, text: [...state.blocks.entries()].sort(([a], [b]) => a - b).map(([, block2]) => block2.text).join("") }
           });
         } else if (block.type === "tool_use") {
           const command = block.name === "Bash" ? String(block.input?.command ?? "") : `${block.name} ${JSON.stringify(block.input ?? {})}`;
@@ -25524,6 +25641,7 @@ var ClaudeTransport = class {
       }
       return;
     }
+    if (message.type === "result") this.clearAssistantText();
     if (message.type === "result" && this.activeTurn) {
       const turnId = this.activeTurn;
       this.activeTurn = void 0;
@@ -25546,14 +25664,25 @@ var ClaudeTransport = class {
   emit(method, params) {
     for (const listener of this.listeners) listener(method, params);
   }
+  assistantState(id) {
+    let state = this.assistantText.get(id);
+    if (!state) this.assistantText.set(id, state = { blocks: /* @__PURE__ */ new Map(), seen: /* @__PURE__ */ new Set() });
+    return state;
+  }
+  clearAssistantText() {
+    this.streamingMessage = void 0;
+    this.assistantText.clear();
+  }
   fail(value) {
     if (this.closed) return;
+    this.clearAssistantText();
     const error51 = value instanceof Error ? value : new Error(String(value));
     for (const listener of this.failures) listener(error51);
   }
   async close() {
     if (this.closed) return;
     this.closed = true;
+    this.clearAssistantText();
     this.input.close();
     this.query?.close();
     await this.pump?.catch(() => {
@@ -25574,7 +25703,7 @@ var ClaudeTransport = class {
 
 // packages/runtime/src/acp-transport.ts
 import { spawn as spawn4, execFile as execFile3 } from "node:child_process";
-import { randomBytes as randomBytes2, randomUUID as randomUUID5 } from "node:crypto";
+import { randomBytes as randomBytes2, randomUUID as randomUUID6 } from "node:crypto";
 import { rmSync as rmSync2 } from "node:fs";
 import net from "node:net";
 import os5 from "node:os";
@@ -25583,7 +25712,7 @@ import { createInterface as createInterface2 } from "node:readline";
 
 // packages/core/src/providers.js
 import { existsSync as existsSync2, readFileSync } from "node:fs";
-import { readdir as readdir3, readFile as readFile7 } from "node:fs/promises";
+import { readdir as readdir4, readFile as readFile7 } from "node:fs/promises";
 import path12 from "node:path";
 
 // packages/core/src/validation.js
@@ -25911,7 +26040,7 @@ async function listProviders(library) {
   if (!library) return [];
   let names = [];
   try {
-    names = await readdir3(path12.join(library, "providers"));
+    names = await readdir4(path12.join(library, "providers"));
   } catch (error51) {
     if (error51.code !== "ENOENT") throw error51;
   }
@@ -26132,7 +26261,7 @@ var AcpTransport = class {
       if (!this.sessionId) throw new Error(`${this.provider.label} session is not open`);
       if (this.prompting) await Promise.race([this.prompting, new Promise((resolve2) => setTimeout(resolve2, 1e4).unref())]);
       if (this.closed) throw new Error("Runtime is closed");
-      const turnId = randomUUID5();
+      const turnId = randomUUID6();
       this.activeTurn = turnId;
       this.message = void 0;
       const prompt = (params.input ?? []).map(acpContent).filter(Boolean);
@@ -26374,7 +26503,7 @@ ${this.config.developerInstructions}` });
     if (!this.requestHandler || !this.activeTurn || !this.tools.some((candidate) => candidate.name === tool)) {
       return { content: [{ type: "text", text: this.activeTurn ? `Unknown ALP tool '${tool}'` : "ALP tools are unavailable between turns" }], isError: true };
     }
-    const callId = `acp-tool-${randomUUID5()}`;
+    const callId = `acp-tool-${randomUUID6()}`;
     const item = { type: "dynamicToolCall", id: callId, callId, tool, arguments: args };
     this.closeMessage();
     this.emit("item/started", { threadId: this.sessionId, item: { ...item, status: "inProgress" } });
@@ -26438,9 +26567,9 @@ ${this.config.developerInstructions}` });
 
 // packages/runtime/src/antigravity-transport.ts
 import { spawn as spawn6, execFile as execFile4 } from "node:child_process";
-import { randomBytes as randomBytes3, randomUUID as randomUUID6 } from "node:crypto";
+import { randomBytes as randomBytes3, randomUUID as randomUUID7 } from "node:crypto";
 import { rmSync as rmSync3 } from "node:fs";
-import { mkdir as mkdir5, open as open2, readFile as readFile8, rename as rename2, writeFile as writeFile6, unlink as unlink3 } from "node:fs/promises";
+import { mkdir as mkdir5, open as open2, readFile as readFile8, rename as rename3, writeFile as writeFile7, unlink as unlink3 } from "node:fs/promises";
 import net2 from "node:net";
 import os6 from "node:os";
 import path14 from "node:path";
@@ -31828,7 +31957,7 @@ var AntigravityTransport = class {
       if (!this.conversationId) throw new Error("Antigravity session is not open");
       if (!this.child) await this.startProcess({ ...this.config, threadId: this.conversationId });
       if (this.activeTurn) throw new Error("Antigravity already has an active turn");
-      const turnId = randomUUID6();
+      const turnId = randomUUID7();
       this.activeTurn = turnId;
       this.messageText.clear();
       const parts = (params.input ?? []).filter((part) => typeof part?.text === "string").map((part) => part.text);
@@ -31974,7 +32103,7 @@ ${promptText}`;
       return;
     }
     if (frame.event === "init") {
-      this.conversationId = frame.conversation_id || frame.init?.conversation_id || randomUUID6();
+      this.conversationId = frame.conversation_id || frame.init?.conversation_id || randomUUID7();
       if (this.resolveReady) {
         this.resolveReady();
         this.resolveReady = void 0;
@@ -32134,7 +32263,7 @@ ${promptText}`;
       }
     }
     if (!lock) throw new Error(`Antigravity MCP configuration is locked: ${lockFile}`);
-    const temporary = `${configFile}.${randomUUID6()}.tmp`;
+    const temporary = `${configFile}.${randomUUID7()}.tmp`;
     try {
       let text2 = "{}";
       try {
@@ -32154,8 +32283,8 @@ ${promptText}`;
       const launcher = { command: process.execPath, args: ["-e", BRIDGE2], ...process.versions.electron ? { env: { ELECTRON_RUN_AS_NODE: "1" } } : {} };
       if (JSON.stringify(existing) === JSON.stringify(launcher)) return;
       config2.mcpServers.alp = launcher;
-      await writeFile6(temporary, JSON.stringify(config2, null, 2) + "\n", { mode: 384 });
-      await rename2(temporary, configFile);
+      await writeFile7(temporary, JSON.stringify(config2, null, 2) + "\n", { mode: 384 });
+      await rename3(temporary, configFile);
     } finally {
       await unlink3(temporary).catch(() => {
       });
@@ -32209,7 +32338,7 @@ ${promptText}`;
   }
   async toolCall(tool, args) {
     if (this.activeTurn && this.external?.has(tool)) {
-      const callId2 = `agy-mcp-tool-${randomUUID6()}`;
+      const callId2 = `agy-mcp-tool-${randomUUID7()}`;
       const item2 = { type: "dynamicToolCall", id: callId2, callId: callId2, tool, arguments: args };
       this.emit("item/started", { threadId: this.conversationId, item: { ...item2, status: "inProgress" } });
       const result2 = await this.external.call(tool, args).catch(() => ({ content: [{ type: "text", text: `External MCP tool '${tool}' failed` }], isError: true }));
@@ -32226,7 +32355,7 @@ ${promptText}`;
         isError: true
       };
     }
-    const callId = `agy-alp-tool-${randomUUID6()}`;
+    const callId = `agy-alp-tool-${randomUUID7()}`;
     const item = { type: "dynamicToolCall", id: callId, callId, tool, arguments: args };
     this.emit("item/started", { threadId: this.conversationId, item: { ...item, status: "inProgress" } });
     const result = await this.requestHandler("item/tool/call", {
@@ -32391,12 +32520,12 @@ function shippedTemplateRoot() {
 }
 
 // packages/core/src/resolver.js
-import { readFile as readFile10, readdir as readdir5, stat as stat4 } from "node:fs/promises";
+import { readFile as readFile10, readdir as readdir6, stat as stat4 } from "node:fs/promises";
 import path16 from "node:path";
 
 // packages/core/src/library.js
-import { mkdir as mkdir6, readFile as readFile9, readdir as readdir4, writeFile as writeFile7 } from "node:fs/promises";
-import { createHash as createHash6, randomUUID as randomUUID7 } from "node:crypto";
+import { mkdir as mkdir6, readFile as readFile9, readdir as readdir5, writeFile as writeFile8 } from "node:fs/promises";
+import { createHash as createHash6, randomUUID as randomUUID8 } from "node:crypto";
 import path15 from "node:path";
 var MANIFEST = "library.json";
 var sha = (text2) => createHash6("sha256").update(text2.replaceAll("\r\n", "\n")).digest("hex");
@@ -32413,7 +32542,7 @@ async function shippedFiles({ templateRoot: templateRoot2, templates }) {
   const root = templateRoot2 ?? shippedTemplateRoot();
   const files = { "role-skills.json": await readFile9(new URL("role-skills.json", root), "utf8") };
   async function walk(relative) {
-    for (const entry of await readdir4(new URL(`${relative}/`, root), { withFileTypes: true })) {
+    for (const entry of await readdir5(new URL(`${relative}/`, root), { withFileTypes: true })) {
       if (entry.isDirectory()) await walk(`${relative}/${entry.name}`);
       else if (entry.isFile()) files[`${relative}/${entry.name}`] = await readFile9(new URL(`${relative}/${entry.name}`, root), "utf8");
     }
@@ -32437,21 +32566,21 @@ async function seedLibrary(home2, options2 = {}) {
     if (seeded === void 0) {
       if (current !== void 0) continue;
       await mkdir6(path15.dirname(target), { recursive: true });
-      await writeFile7(target, content, { flag: "wx" }).catch((error51) => {
+      await writeFile8(target, content, { flag: "wx" }).catch((error51) => {
         if (error51.code !== "EEXIST") throw error51;
       });
       manifest.files[name2] = sha(content);
       created.push(name2);
     } else if (current !== void 0 && sha(current) === seeded && seeded !== sha(content)) {
-      await writeFile7(target, content);
+      await writeFile8(target, content);
       manifest.files[name2] = sha(content);
       updated.push(name2);
     }
   }
   if (created.length || updated.length || manifestText === void 0) {
     await mkdir6(home2, { recursive: true });
-    const temporary = `${manifestPath}.${randomUUID7().slice(0, 8)}.tmp`;
-    await writeFile7(temporary, JSON.stringify(manifest, null, 2) + "\n");
+    const temporary = `${manifestPath}.${randomUUID8().slice(0, 8)}.tmp`;
+    await writeFile8(temporary, JSON.stringify(manifest, null, 2) + "\n");
     await moveFile(temporary, manifestPath);
   }
   return { created, updated };
@@ -32512,7 +32641,7 @@ async function jsonObject(file3, code) {
 }
 async function entries(directory) {
   try {
-    return (await readdir5(directory, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name));
+    return (await readdir6(directory, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name));
   } catch (error51) {
     if (error51.code === "ENOENT") return [];
     throw error51;
@@ -32718,7 +32847,7 @@ import os7 from "node:os";
 import { createHash as createHash7 } from "node:crypto";
 
 // packages/core/src/teams.js
-import { readdir as readdir6 } from "node:fs/promises";
+import { readdir as readdir7 } from "node:fs/promises";
 import path17 from "node:path";
 var BUILTIN_TEAMS = ["pho", "cafe"];
 var TEAM_SETTINGS = ["$schema", "label", "description", "main", "members", "delegation", "maxPeers", "supervisor", "oracleModels", "oracleThinking", "modelSetup"];
@@ -32797,7 +32926,7 @@ function validateTeam(config2, source) {
 }
 async function directories(directory) {
   try {
-    return (await readdir6(directory, { withFileTypes: true })).filter((entry) => entry.isDirectory() && validName2(entry.name)).map((entry) => entry.name).sort();
+    return (await readdir7(directory, { withFileTypes: true })).filter((entry) => entry.isDirectory() && validName2(entry.name)).map((entry) => entry.name).sort();
   } catch (error51) {
     if (error51.code === "ENOENT") return [];
     throw error51;
@@ -32980,9 +33109,9 @@ async function resolveWorkflow(root, selected, restored, { library, templates, s
 }
 
 // packages/core/src/init.js
-import { mkdir as mkdir7, writeFile as writeFile8, lstat as lstat4, readFile as readFile11, rename as rename3, rm as rm3 } from "node:fs/promises";
+import { mkdir as mkdir7, writeFile as writeFile9, lstat as lstat4, readFile as readFile11, rename as rename4, rm as rm3 } from "node:fs/promises";
 import path20 from "node:path";
-import { randomUUID as randomUUID8 } from "node:crypto";
+import { randomUUID as randomUUID9 } from "node:crypto";
 async function initProject(projectRoot, { templateRoot: templateRoot2, templates, library, syncProfiles = true, onlyManagedProfiles = false, teamIds } = {}) {
   const root = path20.resolve(projectRoot);
   const sourceRoot = () => templateRoot2 ?? shippedTemplateRoot();
@@ -33014,7 +33143,7 @@ async function initProject(projectRoot, { templateRoot: templateRoot2, templates
   for (const [name2, content] of Object.entries(files)) {
     const target = path20.join(root, name2);
     try {
-      await writeFile8(target, content, { flag: "wx" });
+      await writeFile9(target, content, { flag: "wx" });
       created.push(name2);
     } catch (error51) {
       if (error51.code !== "EEXIST") throw error51;
@@ -33028,7 +33157,7 @@ async function initProject(projectRoot, { templateRoot: templateRoot2, templates
         validateSettings(next, target);
         if (JSON.stringify(next) !== JSON.stringify(settings)) {
           if (await readFile11(target, "utf8") !== before) throw new Error(`File changed during initialization: ${target}`);
-          await writeFile8(target, JSON.stringify(next, null, 2) + "\n");
+          await writeFile9(target, JSON.stringify(next, null, 2) + "\n");
           updated.push(name2);
         }
       }
@@ -33050,11 +33179,11 @@ async function syncProjectSettings(projectRoot, { library, templates, teamIds, r
   const next = await syncTemplateProfiles(settings, { root, library, templates, teamIds, replaceModels });
   validateSettings(next, file3);
   if (JSON.stringify(settings) === JSON.stringify(next)) return false;
-  const temporary = `${file3}.${randomUUID8()}.tmp`;
+  const temporary = `${file3}.${randomUUID9()}.tmp`;
   try {
-    await writeFile8(temporary, JSON.stringify(next, null, 2) + "\n", { flag: "wx", mode: info.mode });
+    await writeFile9(temporary, JSON.stringify(next, null, 2) + "\n", { flag: "wx", mode: info.mode });
     if (await readFile11(file3, "utf8") !== before) throw new Error(`Settings changed while saving the template: ${file3}`);
-    await rename3(temporary, file3);
+    await rename4(temporary, file3);
   } finally {
     await rm3(temporary, { force: true });
   }
@@ -33113,8 +33242,8 @@ async function compileAgent(adapter, agent) {
 }
 
 // packages/core/src/user-settings.js
-import { mkdir as mkdir8, readFile as readFile13, writeFile as writeFile9 } from "node:fs/promises";
-import { randomUUID as randomUUID9 } from "node:crypto";
+import { mkdir as mkdir8, readFile as readFile13, writeFile as writeFile10 } from "node:fs/promises";
+import { randomUUID as randomUUID10 } from "node:crypto";
 import path22 from "node:path";
 var DEFAULT_LANGUAGE = "Vietnamese";
 var LANGUAGE_CHARS = 40;
@@ -33158,8 +33287,8 @@ async function setLanguage(home2, language) {
   else next.language = language.trim();
   validateUserSettings(next, file3);
   await mkdir8(home2, { recursive: true, mode: 448 });
-  const temporary = `${file3}.${randomUUID9().slice(0, 8)}.tmp`;
-  await writeFile9(temporary, JSON.stringify(next, null, 2) + "\n");
+  const temporary = `${file3}.${randomUUID10().slice(0, 8)}.tmp`;
+  await writeFile10(temporary, JSON.stringify(next, null, 2) + "\n");
   await moveFile(temporary, file3);
   return languageSetting(home2);
 }
@@ -33382,7 +33511,7 @@ ${project}` : "");
 }
 
 // packages/runtime/src/recall.ts
-import { mkdir as mkdir9, readFile as readFile15, rename as rename4, writeFile as writeFile10 } from "node:fs/promises";
+import { mkdir as mkdir9, readFile as readFile15, rename as rename5, writeFile as writeFile11 } from "node:fs/promises";
 import { randomBytes as randomBytes4 } from "node:crypto";
 import path24 from "node:path";
 var RECALL_KEEP_MS = 14 * 24 * 60 * 60 * 1e3;
@@ -33400,8 +33529,8 @@ function createRecallBook(file3) {
     writes2 = writes2.then(async () => {
       await mkdir9(path24.dirname(file3), { recursive: true, mode: 448 });
       const temporary = `${file3}.${process.pid}.${randomBytes4(4).toString("hex")}.tmp`;
-      await writeFile10(temporary, body, { mode: 384 });
-      await rename4(temporary, file3);
+      await writeFile11(temporary, body, { mode: 384 });
+      await rename5(temporary, file3);
     }).catch(() => {
     });
     return writes2;
@@ -33559,7 +33688,7 @@ var HANDOFF_TOOL = {
 var WAIT_TOOL = {
   type: "function",
   name: "alp_wait",
-  description: "Wait for mail from your assignments: results, questions, notes, and stall reports. Returns as soon as any arrives, or with an empty list and a status snapshot on timeout.",
+  description: "Wait for mail from your assignments: results, questions, notes, and stall reports. Returns as soon as any arrives, a check-in comes or the user writes to you; otherwise with an empty list and a status snapshot after timeoutMs (default 5 minutes, at most 15). Ending your turn instead never cancels your assignments.",
   inputSchema: {
     type: "object",
     properties: {
@@ -33691,7 +33820,7 @@ var UNPIN_TOOL = {
 var ASK_TOOL = {
   type: "function",
   name: "alp_ask",
-  description: "Ask a question and wait for the answer: your requester, or the user. Only main talks to the user, unless the user has written to you. Returns unanswered after the ask timeout.",
+  description: "Ask a question and wait for the answer: your requester, or the user. Only main talks to the user, unless the user has written to you. Holds your turn until answered; returns unanswered after the ask timeout (15 minutes for a requester, 30 for the user), and user_wrote when the user writes in the chat instead of answering.",
   inputSchema: {
     type: "object",
     properties: {
@@ -33720,7 +33849,7 @@ var LESSON_TOOL = {
 var SKILL_TOOL = {
   type: "function",
   name: "alp_skill",
-  description: "Propose a skill distilled from your lessons. ALP shows the whole skill to the user, and saves it to the user's skill library and gives it to the roles only when the user approves; any other answer comes back as feedback.",
+  description: "Propose a skill distilled from your lessons. ALP shows the whole skill to the user, and saves it to the user's skill library and gives it to the roles only when the user approves. Returns pending_approval with approvalId immediately; the decision (saved, or not saved with the user's feedback) arrives once by mail, even after your turn ends. Continue other work. A retry of the same draft returns its existing pending/result in this session; use a fresh requestId only to propose an identical draft again.",
   inputSchema: {
     type: "object",
     properties: {
@@ -33729,7 +33858,8 @@ var SKILL_TOOL = {
       body: { type: "string", description: "The SKILL.md body in Markdown, without frontmatter: when to use it, the method as steps, and the checks." },
       roles: { type: "array", items: { type: "string" }, description: "The roles whose work the skill guides, and only those: any of main (yourself), lead, peer, oracle, reviewer, supervisor, or a custom agent of this project." },
       lessons: { type: "array", items: { type: "string" }, description: "The exact text of the lessons this skill replaces; they leave the lessons files once it is saved." },
-      replace: { type: "boolean", description: "Propose a new version of an existing skill of this name." }
+      replace: { type: "boolean", description: "Propose a new version of an existing skill of this name." },
+      requestId: { type: "string", description: "Optional session-scoped idempotency key (1-100 characters). Reuse with the same draft on retries; a fresh key explicitly proposes a new operation." }
     },
     required: ["name", "description", "body", "roles"],
     additionalProperties: false
@@ -33738,7 +33868,7 @@ var SKILL_TOOL = {
 var ISSUE_TOOL = {
   type: "function",
   name: "alp_issue",
-  description: "GitHub issues of this project (target project, from its origin remote) or of ALP itself (target alp). search needs no approval. create and comment show the whole draft to the user and post it only when the user approves; any other answer comes back as feedback.",
+  description: "GitHub issues of this project (target project, from its origin remote) or of ALP itself (target alp). search needs no approval. create and comment show the whole draft to the user and post it only when the user approves; create/comment return pending_approval with approvalId immediately, then send one decision/posting result by mail, even after your turn ends. Continue other work. Draft retries return the existing pending/result in this session. Use a fresh requestId only to intentionally propose an identical draft again; reuse one requestId with the exact draft to replay safely.",
   inputSchema: {
     type: "object",
     properties: {
@@ -33748,6 +33878,7 @@ var ISSUE_TOOL = {
       title: { type: "string", description: "For create." },
       body: { type: "string", description: "For create and comment: Markdown. Facts, reproduction and evidence; no secrets." },
       issue: { type: "integer", description: "For comment: the issue number." },
+      requestId: { type: "string", description: "Optional session-scoped idempotency key (1-100 characters). Reuse with the same draft on retries; a fresh key explicitly proposes a new operation." },
       labels: { type: "array", items: { type: "string" }, description: "For create: existing labels of the repository." }
     },
     required: ["action", "target"],
@@ -34181,7 +34312,7 @@ function nativeSessionConfig(runtimeKind, mapping, targets, parentAgent, role, s
       dynamicTools: [SEND_TOOL, BOARD_TOOL, taskTool(taskActions(mapping, parentAgent, role))]
     };
   }
-  const delegationInstruction = targets.length ? `Use alp_delegate to assign bounded work to: ${targets.join(", ")}. Work runs in the background: by default alp_delegate starts the assignment and returns its assignmentId at once, and its result, questions and stall reports come to you as mail. Pass wait: true only when your very next step cannot go on without the result; it then returns the result, or early with the child's first question. A result carries the child's structured handoff (null if it filed none) and output, its final message. While assignments run, go on with work that does not depend on them; when only their results are left, alp_wait for them (mail from your requester or the user ends the wait early), or end your turn and ALP wakes you with their results and questions. Answer questions with alp_send kind answer and replyTo; use kind steer to change an instruction, note for information. To stop an assignment, for example one parked on a usage limit whose work should go on now, use alp_cancel and delegate the rest, on another runtime (pass a model of claude: or codex:); its changes stay in the checkout or its worktree. At most ${mapping.workflow.maxPeers} peers may run concurrently. Concurrent peers must be read-only or isolated: pass isolation "worktree" to give a writing peer its own git worktree. A worktree result lists its branch and changed files; apply it with alp_merge (uncommitted, conflicts left as markers) or drop it with alp_discard, then verify. Writers in this shared checkout run one at a time. To learn why a finished assignment did something, ask it with alp_recall rather than guessing from its handoff. When the project configures verify commands, ALP runs them before alp_merge applies a change, and after a writer in your checkout finishes; a failed check applies nothing. To fix a failed worktree change, delegate again with continueFrom set to its assignmentId. Do not run shell/file mutations in parallel with delegation. Include scope, constraints, verification, and required handoff in task. Child inherits your mode unless you request read-only. Review its returned evidence before answering. Do not use native spawn tools or shell-launched agents to bypass this route.` : "No delegation targets are authorized. Do not spawn agents or use shell-launched agents. Complete your assigned scope and return evidence.";
+  const delegationInstruction = targets.length ? `Use alp_delegate to assign bounded work to: ${targets.join(", ")}. Delegation has two finite budgets shared by the entire root session tree: 16 implementation starts (lead/peer) and separately 16 read-only advisor starts (reviewer/oracle). Only a new accepted user prompt in root, including steering, resets both; child turns, mail wakes and approval answers do not. Started assignments count even when they fail. Work runs in the background: by default alp_delegate starts the assignment and returns its assignmentId at once, and its result, questions and stall reports come to you as mail. Pass wait: true only when your very next step cannot go on without the result; it then returns the result, or early with the child's first question. A result carries the child's structured handoff (null if it filed none) and output, its final message. While assignments run, go on with work that does not depend on them; when only their results are left, alp_wait for them (mail from your requester or the user ends the wait early), or end your turn and ALP wakes you with their results and questions. Answer questions with alp_send kind answer and replyTo; use kind steer to change an instruction, note for information. To stop an assignment, for example one parked on a usage limit whose work should go on now, use alp_cancel and delegate the rest, on another runtime (pass a model of claude: or codex:); its changes stay in the checkout or its worktree. At most ${mapping.workflow.maxPeers} peers may run concurrently. Concurrent peers must be read-only or isolated: pass isolation "worktree" to give a writing peer its own git worktree. A worktree result lists its branch and changed files; apply it with alp_merge (uncommitted, conflicts left as markers) or drop it with alp_discard, then verify. Writers in this shared checkout run one at a time. To learn why a finished assignment did something, ask it with alp_recall rather than guessing from its handoff. When the project configures verify commands, ALP runs them before alp_merge applies a change, and after a writer in your checkout finishes; a failed check applies nothing. To fix a failed worktree change, delegate again with continueFrom set to its assignmentId. Do not run shell/file mutations in parallel with delegation. Include scope, constraints, verification, and required handoff in task. Child inherits your mode unless you request read-only. Review its returned evidence before answering. Do not use native spawn tools or shell-launched agents to bypass this route.` : "No delegation targets are authorized. Do not spawn agents or use shell-launched agents. Complete your assigned scope and return evidence.";
   return {
     runtime: runtimeKind,
     cwd: mapping.workdir,
@@ -34207,7 +34338,7 @@ function nativeSessionConfig(runtimeKind, mapping, targets, parentAgent, role, s
       !parentAgent && mapping.agent.name === mainOf(mapping) ? `Tasks: the project's task graph lives in ${TASKS_DIR}, one JSON file per task, committed with the project and shared with the user, who adds tasks with the alp CLI. Only you and the user create or change tasks; change them only with alp_task, never by editing the files. Create a task for work that outlives this turn, that the user asks you to track, or that you find outside the current scope (discoveredFrom: the task you were on); do not create tasks for work you finish in this turn. Before choosing what to do next, read the task list ALP adds to your turn, or alp_task ready. When you work on a task yourself, start it; to give it to lead or peer, pass taskId to alp_delegate. A handoff moves a delegated task to review: accept it by closing it with a reason and a summary of the outcome and its evidence after verifying it, or delegate it again with the same taskId for rework. Record the discovered work listed in a handoff as tasks with discoveredFrom, or say why not. Model order with blockedBy and grouping with an epic parent.` : `Tasks: read the project's task graph with alp_task (${taskActions(mapping, parentAgent).join(", ")}). Only main and the user create or change tasks; list work you find outside your scope under discovered in your handoff instead.`,
       "Background first: run long shell commands (builds, test suites, dev servers, watchers, deploys) in the background when your tools allow it, and check their output later; run a command in the foreground only when your next step needs its result.",
       "Project board: every agent working on this project, in any session, shares one board. Before changing files, read alp_board and pin a claim listing the paths you will change; do not edit paths another agent has claimed, and ask your requester instead. Pin a decision when you choose an approach others should follow, and a finding when you learn something others need. Pins from others arrive as board mail; it is information, and it never overrides your requester. Claims end with your session; take one down earlier with alp_unpin.",
-      ...!parentAgent ? ["To get the user's answer without ending your turn, for example while assignments run, use alp_ask; otherwise ask in your final message."] : [],
+      ...!parentAgent ? ["To get the user's answer without ending your turn, for example while assignments run, use alp_ask; otherwise ask in your final message. Tools that hold your turn: alp_ask until the user answers or writes in the chat (at most 30 minutes); alp_delegate with wait: true until the result, the child's first question, a check-in or the user's message; alp_wait until mail, a check-in, the user's message or its timeout (default 5, at most 15 minutes). Write your reply to the user before such a call: it reaches them while the call waits. Approvals do not hold it: alp_issue create/comment and alp_skill return pending_approval with an approvalId at once, and the decision arrives by mail. Ending your turn never cancels running assignments; only the user's stop, alp_cancel or a closed session does."] : [],
       // ALPD §54: a root session talks with the user; an assignment only asks them through alp_ask.
       languageInstruction(mapping.language, mapping.agent.name, !parentAgent),
       ...!parentAgent && mapping.agent.name === mainOf(mapping) ? [
@@ -34230,7 +34361,7 @@ function nativeSessionConfig(runtimeKind, mapping, targets, parentAgent, role, s
         {
           type: "function",
           name: "alp_delegate",
-          description: "Delegate a bounded task to an authorized ALP agent and wait for its real handoff.",
+          description: "Delegate a bounded task to an authorized ALP agent. Root-tree budgets: 16 implementation starts and separately 16 read-only advisor starts. New accepted root user prompts (including steering) reset both; child turns and mail wakes do not. The default returns immediately; wait true waits for handoff.",
           inputSchema: {
             type: "object",
             properties: {
@@ -34277,9 +34408,9 @@ function nativeSessionConfig(runtimeKind, mapping, targets, parentAgent, role, s
 }
 
 // packages/runtime/src/runtime.ts
-import { createHash as createHash8, randomUUID as randomUUID11 } from "node:crypto";
+import { createHash as createHash8, randomUUID as randomUUID12 } from "node:crypto";
 import { readFileSync as readFileSync3, realpathSync as realpathSync5 } from "node:fs";
-import { appendFile as appendFile2, mkdir as mkdir12, open as open3, readFile as readFile18, realpath as realpath4, rm as rm4, stat as stat6, writeFile as writeFile13 } from "node:fs/promises";
+import { appendFile as appendFile2, mkdir as mkdir12, open as open3, readFile as readFile18, realpath as realpath4, rm as rm4, stat as stat6, writeFile as writeFile14 } from "node:fs/promises";
 import os8 from "node:os";
 import path30 from "node:path";
 
@@ -34355,8 +34486,8 @@ function runHook(hook, payload, { cwd, env = {}, timeoutMs } = {}) {
 }
 
 // packages/core/src/trust.js
-import { mkdir as mkdir10, readFile as readFile16, realpath as realpath3, writeFile as writeFile11 } from "node:fs/promises";
-import { randomUUID as randomUUID10 } from "node:crypto";
+import { mkdir as mkdir10, readFile as readFile16, realpath as realpath3, writeFile as writeFile12 } from "node:fs/promises";
+import { randomUUID as randomUUID11 } from "node:crypto";
 import path27 from "node:path";
 var file2 = (home2) => path27.join(home2, "state", "trust.json");
 var key = (root) => realpath3(path27.resolve(root)).catch(() => path27.resolve(root));
@@ -34371,8 +34502,8 @@ async function load(home2) {
 }
 async function store(home2, value) {
   await mkdir10(path27.dirname(file2(home2)), { recursive: true });
-  const temporary = `${file2(home2)}.${randomUUID10().slice(0, 8)}.tmp`;
-  await writeFile11(temporary, JSON.stringify(value, null, 2) + "\n");
+  const temporary = `${file2(home2)}.${randomUUID11().slice(0, 8)}.tmp`;
+  await writeFile12(temporary, JSON.stringify(value, null, 2) + "\n");
   await moveFile(temporary, file2(home2));
 }
 async function isTrusted(home2, projectRoot) {
@@ -34415,7 +34546,7 @@ ${event.body ?? JSON.stringify(event.result)}`;
 
 // packages/runtime/src/live.ts
 import { readFileSync as readFileSync2 } from "node:fs";
-import { mkdir as mkdir11, rename as rename5, writeFile as writeFile12 } from "node:fs/promises";
+import { mkdir as mkdir11, rename as rename6, writeFile as writeFile13 } from "node:fs/promises";
 import { randomBytes as randomBytes5 } from "node:crypto";
 import path28 from "node:path";
 var valid2 = (entry) => !!entry && typeof entry === "object" && ["assignmentId", "rootId", "parentId", "agent", "project", "runtime", "model", "threadId", "mode", "isolation", "epoch"].every((key2) => typeof entry[key2] === "string") && Array.isArray(entry.ancestry) && !!entry.spec && typeof entry.spec === "object" && typeof entry.startedAt === "number";
@@ -34434,8 +34565,8 @@ function createLiveBook(file3) {
     writes2 = writes2.then(async () => {
       await mkdir11(path28.dirname(file3), { recursive: true, mode: 448 });
       const temporary = `${file3}.${process.pid}.${randomBytes5(4).toString("hex")}.tmp`;
-      await writeFile12(temporary, body, { mode: 384 });
-      await rename5(temporary, file3);
+      await writeFile13(temporary, body, { mode: 384 });
+      await rename6(temporary, file3);
     }).catch((error51) => createLogger({ component: "runtime" }).error("could not save the live assignments", { code: "ALP_PERSISTENCE_WRITE_FAILED", operation: "live assignments", error: error51 }));
     return writes2;
   };
@@ -35332,7 +35463,7 @@ function parse3(toml, options2 = {}) {
 var HAS_WELLFORMED = !!"".isWellFormed;
 
 // packages/core/src/formulas.js
-import { readdir as readdir7, readFile as readFile17 } from "node:fs/promises";
+import { readdir as readdir8, readFile as readFile17 } from "node:fs/promises";
 import path29 from "node:path";
 var fail4 = (message) => {
   throw new AlpError("INVALID_FORMULA", message);
@@ -35354,7 +35485,7 @@ async function listFormulas(projectRoot, home2, { toml } = {}) {
   for (const dir of formulaDirs(projectRoot, home2)) {
     let names;
     try {
-      names = await readdir7(dir);
+      names = await readdir8(dir);
     } catch (error51) {
       if (error51.code === "ENOENT") continue;
       throw error51;
@@ -35480,7 +35611,7 @@ async function pourFormula(projectRoot, formula, given, by, { dryRun = false, pa
     title: fill(step.title, values, `Step ${step.id}`),
     ...step.description ? { description: fill(step.description, values, `Step ${step.id}`) } : {}
   }));
-  return batch(projectRoot, ({ add, link }) => {
+  return batch(projectRoot, ({ add, link: link2 }) => {
     const epic = add({
       title: title.slice(0, 200),
       type: "epic",
@@ -35513,7 +35644,7 @@ async function pourFormula(projectRoot, formula, given, by, { dryRun = false, pa
     }
     for (const step of steps) {
       for (const need of step.needs) {
-        const refused = link(made.get(step.id), "blockedBy", made.get(need).id);
+        const refused = link2(made.get(step.id), "blockedBy", made.get(need).id);
         if (refused) fail4(`Step ${step.id} cannot need ${need}: ${refused}`);
       }
     }
@@ -35525,6 +35656,7 @@ async function pourFormula(projectRoot, formula, given, by, { dryRun = false, pa
 var MAX_WAKES = 8;
 var USER_REPLY_MS = 6e4;
 var USER_WROTE = "The user just wrote to you; their message follows. Answer them first in a short message they can read (tool calls alone show them nothing), and steer an assignment with alp_send when their words change its brief. Your assignments keep running: then alp_wait again, or end your turn and ALP wakes you with their results.";
+var TURN_ENDED = "Turn ended before the result arrived. Running assignments keep running; ALP wakes you with their results as mail.";
 var CHECKED_IN = "Not a result: the assignment keeps running. Act on this mail first (a steer from your requester or the user's words may change what your assignments should do: pass that on with alp_send), then alp_wait again or end your turn.";
 var RESTART_LIMIT = 3;
 var RESTART_WINDOW_MS = 10 * 6e4;
@@ -35560,7 +35692,7 @@ function createAlpRuntime(options2 = {}) {
   const wordsFor = (session) => words(session.mapping.language);
   const childContexts = /* @__PURE__ */ new Map();
   const listeners = /* @__PURE__ */ new Set();
-  const epoch = randomUUID11();
+  const epoch = randomUUID12();
   const recalls = createRecallBook(options2.recallFile);
   const inFlight = createLiveBook(options2.liveFile);
   let inherited = inFlight.all().filter((entry) => entry.epoch !== epoch);
@@ -35617,11 +35749,12 @@ function createAlpRuntime(options2 = {}) {
       ...session.parent ? { parentId: session.parent } : {},
       ...session.toolCallId ? { toolCallId: session.toolCallId } : {},
       ...session.active ? { activeTurnId: session.active } : {},
-      ...session.parked ? { parked: session.parked.reason } : {},
+      // turn.ended listeners persist the intent before terminal() finishes parking it.
+      ...session.parked?.reason ?? session.parkReason ? { parked: session.parked?.reason ?? session.parkReason } : {},
       ...session.instructionsSha ? { instructionsSha: session.instructionsSha } : {},
       ...takesImages(session) ? { promptImages: true } : {},
       ...session.usage ? { usage: session.usage } : {},
-      busy: !!(session.active || session.pending || session.children.size || session.assignments.size || hasActiveMail(session) || reviewing(session))
+      busy: !!(session.active || session.pending || session.parked || session.parkReason || session.children.size || session.assignments.size || hasActiveMail(session) || reviewing(session))
     };
   }
   function terminal(sessionId, session, state, error51) {
@@ -35639,7 +35772,7 @@ function createAlpRuntime(options2 = {}) {
       clearTimeout(waiter.timer);
       waiter.resolve(null);
     }
-    cancelQuestions(sessionId);
+    cancelQuestions(sessionId, true);
     if (session.parent) sessions.get(session.parent)?.assignments.get(sessionId)?.ask?.resolve(toolResult(false, { error: "Turn ended" }));
     session.mail = session.mail.filter((event) => !(event.deliveredTurn === turnId && state === "completed"));
     for (const event of session.mail) {
@@ -35797,7 +35930,7 @@ function createAlpRuntime(options2 = {}) {
     if (method === "turn/completed" && params.turn.id === session.active) {
       const state = params.turn.status === "completed" ? "completed" : params.turn.status === "interrupted" ? "canceled" : "failed";
       if (state === "failed" && LIMIT_ERRORS.includes(params.turn.error?.codexErrorInfo)) {
-        if (session.parent && session.role !== "supervisor") session.parkReason = `the ${label(session.runtimeKind)} usage limit was reached`;
+        if (session.role !== "supervisor") session.parkReason = `the ${label(session.runtimeKind)} usage limit was reached`;
         void limitReached(session, params.turn.error);
       }
       terminal(
@@ -35813,6 +35946,7 @@ function createAlpRuntime(options2 = {}) {
     if (!session || session.closed) return;
     session.closed = true;
     cancelQuestions(sessionId);
+    approvalLedger.delete(sessionId);
     releaseClaims(sessionId, session.mapping.agent.projectRoot);
     await Promise.all(
       [...session.children, ...session.supervisor ? [session.supervisor] : []].map(closeSession)
@@ -36079,7 +36213,7 @@ ${output.slice(0, 4e3)}` : ""}`;
     const root = sessions.get(rootId);
     const watcher = root?.mapping.team?.supervisor ? root.mapping.team.supervisor.agent : "supervisor";
     if (!root?.supervisor || entry.from === "supervisor" || entry.agent === watcher) return;
-    const line = entry.event === "assignment.started" ? `${entry.parentAgent} \u2192 ${entry.agent} assignment ${entry.assignmentId}${entry.taskId ? ` for task ${entry.taskId}` : ""} (${entry.model}, ${entry.thinking ?? "default effort"}, ${entry.mode}, ${entry.isolation}${entry.wait ? "" : ", async"}): ${clip(entry.task)}` : entry.event === "assignment.finished" ? `${entry.agent} assignment ${entry.assignmentId} ${entry.status}${entry.handoff ? `, handoff ${entry.handoff.outcome}${entry.handoff.verdict ? `, ${verdictLine(entry.handoff.verdict)}` : ""}: ${clip(entry.handoff.summary)}` : ", no handoff"}${entry.error ? ` (${clip(entry.error, 200)})` : ""}${entry.handoff?.discovered?.length ? `; discovered: ${clip(entry.handoff.discovered.join("; "))}` : ""}` : entry.event === "mail" && entry.kind !== "result" && entry.kind !== "board" ? `mail ${entry.kind} from ${entry.from}${entry.replyTo ? ` (reply to ${entry.replyTo})` : ""}: ${clip(entry.body ?? "")}` : entry.event === "human.question" ? `${entry.agent} asked the user: ${clip(entry.body)}` : entry.event === "human.answer" ? `user ${entry.outcome} ${entry.questionId}${entry.answer ? `: ${clip(entry.answer)}` : ""}` : entry.event === "board.pin" ? `${entry.agent} pinned ${entry.kind}${entry.paths ? ` ${entry.paths.join(", ")}` : ""}: ${clip(entry.body)}` : entry.event === "lesson" ? `${entry.agent} recorded a ${entry.scope} lesson: ${clip(entry.lesson)}` : entry.event === "skill" && Array.isArray(entry.roles) ? `${entry.agent} saved skill ${entry.name} for ${entry.roles.join(", ")} with the user's approval` : entry.event === "task" ? `${entry.agent} ${TASK_PAST[entry.action] ?? entry.action} task ${entry.id} "${clip(entry.title, 120)}"${entry.status ? ` (now ${entry.status})` : ""}${entry.detail ? `: ${clip(entry.detail)}` : ""}` : entry.event === "epic.landed" ? `${entry.agent} closed ${entry.id} "${clip(entry.title, 120)}": ${entry.tasks} tasks, ${entry.reworked} reworked, ${entry.unverified?.length ?? 0} closed unverified` : entry.event === "recall" ? `${entry.agent} recalled ${entry.recalled} assignment ${entry.assignmentId}: ${clip(entry.question)}` : entry.event === "issue" ? `${entry.action === "create" ? `opened issue "${clip(entry.title, 200)}"` : `commented on issue #${entry.issue}`} in ${entry.repo} with the user's approval: ${entry.url}` : entry.event?.startsWith("worktree.") ? `${entry.event.slice("worktree.".length)} worktree of ${entry.assignmentId} (${entry.branch})${entry.status ? `: ${entry.status}` : ""}` : void 0;
+    const line = entry.event === "assignment.started" ? `${entry.parentAgent} \u2192 ${entry.agent} assignment ${entry.assignmentId}${entry.taskId ? ` for task ${entry.taskId}` : ""} (${entry.model}, ${entry.thinking ?? "default effort"}, ${entry.mode}, ${entry.isolation}${entry.wait ? "" : ", async"}): ${clip(entry.task)}` : entry.event === "assignment.finished" ? `${entry.agent} assignment ${entry.assignmentId} ${entry.status}${entry.handoff ? `, handoff ${entry.handoff.outcome}${entry.handoff.verdict ? `, ${verdictLine(entry.handoff.verdict)}` : ""}: ${clip(entry.handoff.summary)}` : ", no handoff"}${entry.error ? ` (${clip(entry.error, 200)})` : ""}${entry.handoff?.discovered?.length ? `; discovered: ${clip(entry.handoff.discovered.join("; "))}` : ""}` : entry.event === "mail" && entry.kind !== "result" && entry.kind !== "board" ? `mail ${entry.kind} from ${entry.from}${entry.replyTo ? ` (reply to ${entry.replyTo})` : ""}: ${clip(entry.body ?? "")}` : entry.event === "human.question" ? `${entry.agent} asked the user: ${clip(entry.body)}` : entry.event === "human.answer" ? `user ${entry.outcome} ${entry.questionId}${entry.answer ? `: ${clip(entry.answer)}` : ""}` : entry.event === "board.pin" ? `${entry.agent} pinned ${entry.kind}${entry.paths ? ` ${entry.paths.join(", ")}` : ""}: ${clip(entry.body)}` : entry.event === "lesson" ? `${entry.agent} recorded a ${entry.scope} lesson: ${clip(entry.lesson)}` : entry.event === "skill" && Array.isArray(entry.roles) ? `${entry.agent} saved skill ${entry.name} for ${entry.roles.join(", ")} with the user's approval` : entry.event === "task" ? `${entry.agent} ${TASK_PAST[entry.action] ?? entry.action} task ${entry.id} "${clip(entry.title, 120)}"${entry.status ? ` (now ${entry.status})` : ""}${entry.detail ? `: ${clip(entry.detail)}` : ""}` : entry.event === "epic.landed" ? `${entry.agent} closed ${entry.id} "${clip(entry.title, 120)}": ${entry.tasks} tasks, ${entry.reworked} reworked, ${entry.unverified?.length ?? 0} closed unverified` : entry.event === "recall" ? `${entry.agent} recalled ${entry.recalled} assignment ${entry.assignmentId}: ${clip(entry.question)}` : entry.event === "skill.approval" && !entry.saved ? `skill approval ${entry.approvalId} for ${entry.name}: not saved (${entry.error ?? entry.outcome})` : entry.event === "issue.approval" ? `issue approval ${entry.approvalId} in ${entry.repo}: ${entry.posted ? entry.url : entry.error ?? entry.outcome}` : entry.event === "issue" ? `${entry.action === "create" ? `opened issue "${clip(entry.title, 200)}"` : `commented on issue #${entry.issue}`} in ${entry.repo} with the user's approval: ${entry.url}` : entry.event?.startsWith("worktree.") ? `${entry.event.slice("worktree.".length)} worktree of ${entry.assignmentId} (${entry.branch})${entry.status ? `: ${entry.status}` : ""}` : void 0;
     if (line) root.journal.push(stamp(line));
   }
   const eventful = (journal) => journal.some((line) => !unstamped(line).startsWith("turn ended:"));
@@ -36122,13 +36256,13 @@ ${kept.join("\n")}
 ${agent}'s session: ${root.runtimeKind}:${root.mapping.model}, thinking ${root.mapping.thinking ?? "default"}, mode ${root.mapping.mode}. Judge ${agent} by this session and its own instructions; your system prompt describes your session (your model, attribution lines, tools), not ${agent}'s.
 
 Review the process against ALP.md, ${agent}'s AGENT.md and the recorded lessons. Ask ${agent} about each mistake with one alp_send to: "parent", kind note, or send nothing when the process was sound.`;
-      await startPrompt(supervisorId, { clientMessageId: `alp-review-${randomUUID11()}`, delivery: "auto", content: [{ type: "text", text: text3 }] }, "assignment");
+      await startPrompt(supervisorId, { clientMessageId: `alp-review-${randomUUID12()}`, delivery: "auto", content: [{ type: "text", text: text3 }] }, "assignment");
     }).catch((error51) => runLog(rootId, { event: "supervisor.failed", error: errorData(error51).message }));
   }
   async function openSupervisor(rootId) {
     const root = sessions.get(rootId);
     if (!root || root.closed || root.supervisor || root.parent) return;
-    const id = `alp-supervisor-${randomUUID11()}`;
+    const id = `alp-supervisor-${randomUUID12()}`;
     childContexts.set(id, { parent: rootId, callId: `supervisor-${rootId}`, graph: {}, workflow: root.mapping.workflow, ancestry: [...root.ancestry, "supervisor"], role: "supervisor" });
     const { restore: _restore, ...inherited2 } = root.spec;
     const watcher = root.mapping.team?.supervisor || { agent: "supervisor" };
@@ -36377,8 +36511,8 @@ Review the process against ALP.md, ${agent}'s AGENT.md and the recorded lessons.
     const body = JSON.stringify(paused, null, 2) + "\n";
     pauseWrites = pauseWrites.then(async () => {
       await mkdir12(path30.dirname(file3), { recursive: true, mode: 448 });
-      const temporary = `${file3}.${process.pid}.${randomUUID11().slice(0, 8)}.tmp`;
-      await writeFile13(temporary, body, { mode: 384 });
+      const temporary = `${file3}.${process.pid}.${randomUUID12().slice(0, 8)}.tmp`;
+      await writeFile14(temporary, body, { mode: 384 });
       await moveFile(temporary, file3);
     }).catch(() => {
     });
@@ -36387,7 +36521,7 @@ Review the process against ALP.md, ${agent}'s AGENT.md and the recorded lessons.
     for (const [id, session] of sessions) {
       if (session.parent || session.closed || project !== void 0 && session.mapping.agent.projectRoot !== project) continue;
       const text3 = typeof message === "string" ? message : message(wordsFor(session));
-      emit(id, { type: "item", item: { kind: "notice", id: `notice-${randomUUID11().slice(0, 8)}`, level, text: text3 } });
+      emit(id, { type: "item", item: { kind: "notice", id: `notice-${randomUUID12().slice(0, 8)}`, level, text: text3 } });
       runLog(id, { event: "notice", level, text: text3 });
     }
   }
@@ -36514,20 +36648,34 @@ Review the process against ALP.md, ${agent}'s AGENT.md and the recorded lessons.
     else post(session.parent, { kind: "stalled", from: assignment.agent, assignment: sessionId, body: `Parked: ${session.parked.reason}. ALP continues this assignment where it stopped when ${label(session.runtimeKind)} is resumed (${options2.autoResume !== false && (pauseOf(session.runtimeKind)?.by ?? "alpd") === "alpd" ? `ALP resumes it as soon as ${label(session.runtimeKind)} says the limit lifted` : "the user runs alp resume"}). Wait for it, start other work, or stop it with alp_cancel and give the rest to an agent on another runtime (pass model claude:\u2026 or codex:\u2026); what it changed stays in your checkout or its worktree.` });
   }
   function continueParked(sessionId, session) {
-    const { reason, prompt } = session.parked;
-    session.parked = void 0;
-    session.wakeHeld = false;
-    session.lastActivity = Date.now();
-    emit(sessionId, { type: "session.updated", session: snapshot(sessionId, session) });
-    const parent = session.parent ? sessions.get(session.parent) : void 0;
-    const assignment = parent?.assignments.get(sessionId);
-    runLog(rootOf2(sessionId), { event: "assignment.resumed", assignmentId: sessionId, agent: session.mapping.agent.name });
-    if (assignment) emit(session.parent, { type: "assignment", assignment: assignmentSnapshot(assignment, "running") });
-    void startPrompt(sessionId, {
-      clientMessageId: `alp-resume-${randomUUID11()}`,
-      delivery: "auto",
-      content: [{ type: "text", text: prompt ?? `ALP resumed this assignment; it had stopped because ${reason}. Continue where you left off: your earlier work in this session and its files are intact. Finish with alp_handoff as before.` }]
-    }, session.parent ? "assignment" : "wake").catch((error51) => session.settle?.("failed", error51));
+    void enqueue(async () => {
+      if (session.closed || session.active || session.pending || !session.parked || pauseOf(session.runtimeKind)) return;
+      const parked = session.parked;
+      const { reason, prompt } = parked;
+      session.parked = void 0;
+      session.wakeHeld = false;
+      session.lastActivity = Date.now();
+      const parent = session.parent ? sessions.get(session.parent) : void 0;
+      const assignment = parent?.assignments.get(sessionId);
+      runLog(rootOf2(sessionId), { event: "assignment.resumed", assignmentId: sessionId, agent: session.mapping.agent.name });
+      if (assignment) emit(session.parent, { type: "assignment", assignment: assignmentSnapshot(assignment, "running") });
+      try {
+        await startPrompt(sessionId, {
+          clientMessageId: `alp-resume-${randomUUID12()}`,
+          delivery: "auto",
+          content: [{ type: "text", text: prompt ?? (session.parent ? `ALP resumed this assignment; it had stopped because ${reason}. Continue where you left off: your earlier work in this session and its files are intact. Finish with alp_handoff as before.` : `ALP resumed this session; it had stopped because ${reason}. Continue the user's request where you left off: your earlier work in this thread and its files are intact.`) }]
+        }, session.parent ? "assignment" : "wake");
+        session.resumedTurn = session.active;
+        emit(sessionId, { type: "session.updated", session: snapshot(sessionId, session) });
+      } catch (error51) {
+        if (!session.closed && !session.active) {
+          session.parked = parked;
+          emit(sessionId, { type: "session.updated", session: snapshot(sessionId, session) });
+          if (assignment) emit(session.parent, { type: "assignment", assignment: assignmentSnapshot(assignment, "parked") });
+        }
+        notice("warning", `Could not resume ${session.mapping.agent.name}: ${errorData(error51).message}`);
+      }
+    });
   }
   async function limitReset(session, error51) {
     const at2 = (seconds) => typeof seconds === "number" && seconds > 0 ? new Date(seconds * 1e3).toISOString() : void 0;
@@ -36544,8 +36692,9 @@ Review the process against ALP.md, ${agent}'s AGENT.md and the recorded lessons.
   }
   async function limitReached(session, error51) {
     const kind = session.runtimeKind;
-    if (paused.runtimes[kind]?.by === "alpd") return;
+    if (pauseOf(kind)) return;
     const resetsAt = await limitReset(session, error51);
+    if (closed || session.closed || pauseOf(kind)) return;
     const pause = { since: (/* @__PURE__ */ new Date()).toISOString(), by: "alpd", reason: `${label(kind)} usage limit reached`, ...resetsAt ? { resetsAt } : {} };
     pauseRuntime(kind, pause);
     const other = RUNTIMES.find((candidate) => candidate !== kind && !pauseOf(candidate));
@@ -36681,15 +36830,15 @@ ${cut(session.brief, BRIEF_CHARS)}`);
     const shown = JSON.stringify(items);
     if (!items.length || shown === session.tasksShown || session.closed) return;
     session.tasksShown = shown;
-    emit(sessionId, { type: "item", item: { kind: "todo", id: `tasks-${randomUUID11().slice(0, 8)}`, items } });
+    emit(sessionId, { type: "item", item: { kind: "todo", id: `tasks-${randomUUID12().slice(0, 8)}`, items } });
   }
   function lessonFiles(mapping) {
     return [path30.join(mapping.agent.projectRoot, ".alp", LESSONS_FILE), ...options2.libraryDir ? [path30.join(options2.libraryDir, LESSONS_FILE)] : []];
   }
-  async function confirm(sessionId, session, body) {
+  async function confirm(sessionId, session, body, approval) {
     if ([...userQuestions.values()].some((pending) => pending.question.sessionId === sessionId)) return { approved: false, outcome: "busy", feedback: "A question is already waiting for the user" };
     const say = wordsFor(session);
-    const result = await askUser(sessionId, session, void 0, body, [say.approve, say.reject]);
+    const result = await askUser(sessionId, session, void 0, body, [say.approve, say.reject], approval);
     let value;
     try {
       value = JSON.parse(result.contentItems[0].text);
@@ -36700,25 +36849,45 @@ ${cut(session.brief, BRIEF_CHARS)}`);
     const answer = String(value.answer).trim();
     return APPROVALS.includes(answer.toLowerCase()) ? { approved: true } : { approved: false, outcome: "answered", feedback: answer };
   }
-  const declined = (decision) => toolResult(true, {
-    approved: false,
-    outcome: decision.outcome,
-    ...decision.feedback ? { feedback: decision.feedback } : {},
-    next: "Nothing was saved or posted. Revise from the feedback and propose again, or drop it."
-  });
   const text2 = (value, limit) => typeof value === "string" && !!value.trim() && value.length <= limit;
+  const approvalCancellation = /* @__PURE__ */ new WeakMap();
+  const approvalLedger = /* @__PURE__ */ new Map();
+  const approvalsOf = (sessionId) => {
+    let approvals = approvalLedger.get(sessionId);
+    if (!approvals) approvalLedger.set(sessionId, approvals = /* @__PURE__ */ new Map());
+    return approvals;
+  };
+  const approvalCanceled = (session, cancellation) => closed || session.closed || cancellation !== (approvalCancellation.get(session) ?? 0);
   async function skillTool(sessionId, session, args) {
-    if (!plainObject(args, ["name", "description", "body", "roles", "lessons", "replace"]) || typeof args.name !== "string" || !/^[a-z0-9][a-z0-9-]{1,62}$/.test(args.name) || !text2(args.description, 300) || !text2(args.body, SKILL_BODY_CHARS) || !Array.isArray(args.roles) || !args.roles.length || args.roles.length > 10 || !args.roles.every((role) => typeof role === "string" && /^[\w.-]+$/.test(role) && role !== "." && role !== "..") || args.lessons !== void 0 && (!Array.isArray(args.lessons) || args.lessons.length > 50 || !args.lessons.every((lesson) => text2(lesson, LESSON_CHARS2))) || args.replace !== void 0 && typeof args.replace !== "boolean") {
+    const cancellation = approvalCancellation.get(session) ?? 0;
+    args = structuredClone(args);
+    if (!plainObject(args, ["name", "description", "body", "roles", "lessons", "replace", "requestId"]) || typeof args.name !== "string" || !/^[a-z0-9][a-z0-9-]{1,62}$/.test(args.name) || !text2(args.description, 300) || !text2(args.body, SKILL_BODY_CHARS) || !Array.isArray(args.roles) || !args.roles.length || args.roles.length > 10 || !args.roles.every((role) => typeof role === "string" && /^[\w.-]+$/.test(role) && role !== "." && role !== "..") || args.lessons !== void 0 && (!Array.isArray(args.lessons) || args.lessons.length > 50 || !args.lessons.every((lesson) => text2(lesson, LESSON_CHARS2))) || args.replace !== void 0 && typeof args.replace !== "boolean") {
       return toolResult(false, { error: `A skill needs a name (lowercase letters, digits, hyphens), a one-line description, a body of at most ${SKILL_BODY_CHARS} characters, and the roles that get it` });
     }
-    if (!options2.libraryDir) return toolResult(false, { error: "This host keeps no user skill library" });
-    const known = /* @__PURE__ */ new Set([...STARTER_ROLES, ...await discoverAgents(session.mapping.agent.projectRoot, { library: options2.libraryDir, templates: options2.templates })]);
+    if (args.requestId !== void 0 && !text2(args.requestId, 100)) return toolResult(false, { error: "requestId must be a nonempty string of at most 100 characters" });
+    const library = options2.libraryDir;
+    if (!library) return toolResult(false, { error: "This host keeps no user skill library" });
+    const known = /* @__PURE__ */ new Set([...STARTER_ROLES, ...await discoverAgents(session.mapping.agent.projectRoot, { library, templates: options2.templates })]);
     const unknown2 = args.roles.filter((role) => !known.has(role));
     if (unknown2.length) return toolResult(false, { error: `Unknown roles: ${unknown2.join(", ")}. Roles are ${[...known].join(", ")}` });
-    const file3 = path30.join(options2.libraryDir, "skills", args.name, "SKILL.md");
+    const file3 = path30.join(library, "skills", args.name, "SKILL.md");
+    const content = `---
+name: ${args.name}
+description: ${JSON.stringify(args.description.replace(/\s+/g, " ").trim())}
+---
+
+${args.body.trim()}
+`;
+    const lessons2 = (args.lessons ?? []).map((lesson) => lesson.replace(/\s+/g, " ").trim());
+    const draftKey = JSON.stringify(["skill", content, args.roles, lessons2, !!args.replace]);
+    const key2 = `skill:${args.requestId ?? draftKey}`;
+    const approvals = approvalsOf(sessionId);
+    const previous = approvals.get(key2);
+    if (previous && previous.draftKey !== draftKey) return toolResult(false, { error: "requestId was already used for a different draft" });
+    if (previous) return toolResult(true, previous.result ?? { status: "pending_approval", approvalId: previous.approvalId, file: file3 });
     const existing = await readFile18(file3, "utf8").catch(() => void 0);
     if (existing !== void 0 && !args.replace) return toolResult(false, { error: `The library already has a skill named ${args.name} (${file3}); read it, then pass replace: true to propose a new version, or choose another name` });
-    const rolesFile = path30.join(options2.libraryDir, "role-skills.json");
+    const rolesFile = path30.join(library, "role-skills.json");
     const readRoles = async () => {
       const raw = await readFile18(rolesFile, "utf8").catch(() => "{}");
       const roles = JSON.parse(raw);
@@ -36730,62 +36899,77 @@ ${cut(session.brief, BRIEF_CHARS)}`);
     } catch (error51) {
       return toolResult(false, { error: errorData(error51).message });
     }
-    const content = `---
-name: ${args.name}
-description: ${JSON.stringify(args.description.replace(/\s+/g, " ").trim())}
----
-
-${args.body.trim()}
-`;
-    const lessons2 = (args.lessons ?? []).map((lesson) => lesson.replace(/\s+/g, " ").trim());
+    if (approvalCanceled(session, cancellation)) return toolResult(false, { error: "Skill proposal canceled or session closed; no approval was created" });
+    if ([...userQuestions.values()].some((pending) => pending.question.sessionId === sessionId)) return toolResult(false, { error: "A question is already waiting for the user; finish it before proposing a skill" });
+    const approvalId = `q-${randomUUID12()}`;
+    const record4 = { approvalId, draftKey };
+    approvals.set(key2, record4);
     const say = wordsFor(session);
-    const decision = await confirm(
+    const decision = confirm(
       sessionId,
       session,
       say.skill(session.mapping.agent.name, existing !== void 0, file3, args.roles.join(", "), lessons2) + `
 ${say.answerLine(session.mapping.agent.name)}
 
-${content}`
+${content}`,
+      { id: approvalId }
     );
-    if (!decision.approved) return declined(decision);
-    try {
-      await mkdir12(path30.dirname(file3), { recursive: true });
-      await writeFile13(file3, content);
-      const roles = await readRoles();
-      for (const role of args.roles) {
-        const list2 = Array.isArray(roles[role]) ? roles[role] : [];
-        if (!list2.includes(args.name)) list2.push(args.name);
-        roles[role] = list2;
-      }
-      await writeFile13(rolesFile, JSON.stringify(roles, null, 2) + "\n");
-    } catch (error51) {
-      return toolResult(false, { error: errorData(error51).message });
-    }
-    const removed = /* @__PURE__ */ new Set();
-    for (const lessonFile of lessonFiles(session.mapping)) {
-      const current = await readFile18(lessonFile, "utf8").catch(() => void 0);
-      if (current === void 0) continue;
-      const kept = current.split("\n").filter((line) => {
-        const match = /^- \d{4}-\d\d-\d\d: (.*)$/.exec(line);
-        if (!match || !lessons2.includes(match[1].trim())) return true;
-        removed.add(match[1].trim());
-        return false;
-      });
-      if (kept.length !== current.split("\n").length) await writeFile13(lessonFile, kept.join("\n")).catch(() => {
-      });
-    }
-    runLog(rootOf2(sessionId), { event: "skill", agent: session.mapping.agent.name, name: args.name, roles: args.roles, replaced: existing !== void 0, lessons: [...removed] });
-    return toolResult(true, {
-      approved: true,
-      saved: file3,
-      roles: args.roles,
-      lessonsRemoved: [...removed],
-      ...lessons2.length > removed.size ? { lessonsNotFound: lessons2.filter((lesson) => !removed.has(lesson)) } : {},
-      next: "New sessions of those roles list the skill; read the file now if you need it in this one."
-    });
+    const save2 = async () => {
+      if (existing === void 0 && !args.replace && await readFile18(file3, "utf8").then(() => true, () => false)) {
+        return { approved: true, saved: false, error: `A skill named ${args.name} was saved meanwhile (${file3}); nothing was overwritten`, next: "Read it, then propose again with replace: true if yours should replace it." };
+      }
+      try {
+        await mkdir12(path30.dirname(file3), { recursive: true });
+        await writeFile14(file3, content);
+        const roles = await readRoles();
+        for (const role of args.roles) {
+          const list2 = Array.isArray(roles[role]) ? roles[role] : [];
+          if (!list2.includes(args.name)) list2.push(args.name);
+          roles[role] = list2;
+        }
+        await writeFile14(rolesFile, JSON.stringify(roles, null, 2) + "\n");
+      } catch (error51) {
+        return { approved: true, saved: false, error: errorData(error51).message, next: "Tell the user; nothing is retried automatically." };
+      }
+      const removed = /* @__PURE__ */ new Set();
+      for (const lessonFile of lessonFiles(session.mapping)) {
+        const current = await readFile18(lessonFile, "utf8").catch(() => void 0);
+        if (current === void 0) continue;
+        const kept = current.split("\n").filter((line) => {
+          const match = /^- \d{4}-\d\d-\d\d: (.*)$/.exec(line);
+          if (!match || !lessons2.includes(match[1].trim())) return true;
+          removed.add(match[1].trim());
+          return false;
+        });
+        if (kept.length !== current.split("\n").length) await writeFile14(lessonFile, kept.join("\n")).catch(() => {
+        });
+      }
+      runLog(rootOf2(sessionId), { event: "skill", agent: session.mapping.agent.name, name: args.name, roles: args.roles, replaced: existing !== void 0, lessons: [...removed] });
+      return {
+        approved: true,
+        saved: file3,
+        roles: args.roles,
+        lessonsRemoved: [...removed],
+        ...lessons2.length > removed.size ? { lessonsNotFound: lessons2.filter((lesson) => !removed.has(lesson)) } : {},
+        next: "New sessions of those roles list the skill; read the file now if you need it in this one."
+      };
+    };
+    void (async () => {
+      const answer = await decision;
+      const canceled = approvalCanceled(session, cancellation);
+      const result = !answer.approved || canceled ? { approved: false, saved: false, outcome: canceled ? "canceled" : answer.outcome, ...answer.feedback ? { feedback: answer.feedback } : {}, next: "Nothing was saved. Revise from the feedback and propose again with a fresh requestId, or drop it." } : await save2();
+      record4.result = { status: "resolved", approvalId, name: args.name, ...result };
+      runLog(rootOf2(sessionId), { event: "skill.approval", agent: session.mapping.agent.name, ...record4.result });
+      if (!closed && !session.closed && sessions.get(sessionId) === session) {
+        post(sessionId, { kind: "result", from: "ALP", assignment: approvalId, body: `Skill approval result: ${JSON.stringify(record4.result)}` });
+      }
+    })();
+    return toolResult(true, { status: "pending_approval", approvalId, file: file3, next: "Continue other work or end your turn. ALP sends the user's decision, and whether the skill was saved, by mail; do not resubmit this draft." });
   }
   async function issueTool(sessionId, session, args) {
-    if (!plainObject(args, ["action", "target", "query", "title", "body", "issue", "labels"]) || !["search", "create", "comment"].includes(args.action) || !["project", "alp"].includes(args.target)) {
+    const cancellation = approvalCancellation.get(session) ?? 0;
+    args = structuredClone(args);
+    if (!plainObject(args, ["action", "target", "query", "title", "body", "issue", "labels", "requestId"]) || !["search", "create", "comment"].includes(args.action) || !["project", "alp"].includes(args.target)) {
       return toolResult(false, { error: "An issue call needs action (search, create or comment) and target (project or alp)" });
     }
     const project = session.mapping.agent.projectRoot;
@@ -36811,6 +36995,7 @@ ${content}`
     if (args.labels !== void 0 && (args.action !== "create" || !Array.isArray(args.labels) || args.labels.length > 10 || !args.labels.every((label2) => text2(label2, 50)))) {
       return toolResult(false, { error: "labels are up to 10 existing label names, for create" });
     }
+    if (args.requestId !== void 0 && !text2(args.requestId, 100)) return toolResult(false, { error: "requestId must be a nonempty string of at most 100 characters" });
     if (args.action === "create" && args.labels?.length) {
       try {
         const labels = JSON.parse(await github(["label", "list", "-R", repo, "--limit", "1000", "--json", "name"], { cwd: project }));
@@ -36821,9 +37006,20 @@ ${content}`
         return toolResult(false, { repo, error: `Could not validate issue labels: ${errorData(error51).message}` });
       }
     }
+    if (approvalCanceled(session, cancellation)) return toolResult(false, { error: "Issue proposal canceled or session closed; no approval was created" });
+    const draftKey = JSON.stringify([repo, args.action, args.title ?? null, args.issue ?? null, args.body, [...args.labels ?? []].sort()]);
+    const key2 = `issue:${args.requestId ?? draftKey}`;
+    const approvals = approvalsOf(sessionId);
+    const previous = approvals.get(key2);
+    if (previous && previous.draftKey !== draftKey) return toolResult(false, { error: "requestId was already used for a different draft" });
+    if (previous) return toolResult(true, previous.result ?? { status: "pending_approval", approvalId: previous.approvalId, repo });
+    if ([...userQuestions.values()].some((pending) => pending.question.sessionId === sessionId)) return toolResult(false, { error: "A question is already waiting for the user; finish it before proposing another issue draft" });
+    const approvalId = `q-${randomUUID12()}`;
+    const record4 = { approvalId, draftKey };
+    approvals.set(key2, record4);
     const where = `${repo}${args.target === "alp" ? " (ALP itself)" : ""}`;
     const say = wordsFor(session);
-    const decision = await confirm(
+    const decision = confirm(
       sessionId,
       session,
       say.issue(session.mapping.agent.name, args.action === "create", args.issue, where) + `
@@ -36832,18 +37028,31 @@ ${say.answerLine(session.mapping.agent.name)}
 ` + (args.action === "create" ? `${say.issueTitle}: ${args.title}
 ${args.labels?.length ? `${say.issueLabels}: ${args.labels.join(", ")}
 ` : ""}
-` : "") + args.body
+` : "") + args.body.trim() + ISSUE_FOOTER,
+      { id: approvalId }
     );
-    if (!decision.approved) return declined(decision);
-    const body = args.body.trim() + ISSUE_FOOTER;
-    try {
-      const output = args.action === "create" ? await github(["issue", "create", "-R", repo, "--title", args.title, "--body-file", "-", ...(args.labels ?? []).flatMap((label2) => ["--label", label2])], { cwd: project, input: body }) : await github(["issue", "comment", String(args.issue), "-R", repo, "--body-file", "-"], { cwd: project, input: body });
-      const url2 = output.trim().split("\n").at(-1) ?? "";
-      runLog(rootOf2(sessionId), { event: "issue", action: args.action, repo, ...args.title ? { title: args.title } : {}, ...args.issue ? { issue: args.issue } : {}, url: url2 });
-      return toolResult(true, { approved: true, posted: true, repo, url: url2 });
-    } catch (error51) {
-      return toolResult(false, { approved: true, posted: false, repo, error: errorData(error51).message, next: "Tell the user; the GitHub CLI may need `gh auth login`." });
-    }
+    void (async () => {
+      const answer = await decision;
+      let result;
+      const canceled = approvalCanceled(session, cancellation);
+      if (!answer.approved || canceled) {
+        result = { approved: false, posted: false, outcome: canceled ? "canceled" : answer.outcome, ...answer.feedback ? { feedback: answer.feedback } : {} };
+      } else {
+        try {
+          const body = args.body.trim() + ISSUE_FOOTER;
+          const output = args.action === "create" ? await github(["issue", "create", "-R", repo, "--title", args.title, "--body-file", "-", ...(args.labels ?? []).flatMap((label2) => ["--label", label2])], { cwd: project, input: body }) : await github(["issue", "comment", String(args.issue), "-R", repo, "--body-file", "-"], { cwd: project, input: body });
+          result = { approved: true, posted: true, url: output.trim().split("\n").at(-1) ?? "" };
+        } catch (error51) {
+          result = { approved: true, posted: false, error: errorData(error51).message, next: "Tell the user; do not retry this draft automatically: GitHub may have accepted it before reporting an error." };
+        }
+      }
+      record4.result = { status: "resolved", approvalId, repo, ...result };
+      runLog(rootOf2(sessionId), { event: "issue.approval", action: args.action, ...args.title ? { title: args.title } : {}, ...args.issue ? { issue: args.issue } : {}, ...record4.result });
+      if (!closed && !session.closed && sessions.get(sessionId) === session) {
+        post(sessionId, { kind: "result", from: "ALP", assignment: approvalId, body: `Issue approval result: ${JSON.stringify(record4.result)}` });
+      }
+    })();
+    return toolResult(true, { status: "pending_approval", approvalId, repo, next: "Continue other work. ALP sends the decision and posting result by mail; do not resubmit this draft." });
   }
   function touch(sessionId, session) {
     const now2 = Date.now();
@@ -36867,6 +37076,8 @@ ${args.labels?.length ? `${say.issueLabels}: ${args.labels.join(", ")}
     if (session && !session.closed) {
       emit(sessionId, { type: "mail", mail: publicEvent(mail) });
       session.mail.push(mail);
+      if (mail.kind === "result" || mail.kind === "question") session.wakes = 0;
+      if (mail.kind === "result" || mail.kind === "question" || mail.kind === "checkin") session.wakeFailures = 0;
       deliver(sessionId, session);
     }
     return mail;
@@ -36889,7 +37100,7 @@ ${args.labels?.length ? `${say.issueLabels}: ${args.labels.join(", ")}
       if (session.mail.some((event) => !event.deliveredTurn && !event.passive && !event.defer)) void steerMail(sessionId, session);
     } else if (!waking) {
       return;
-    } else if (!session.wakeBlocked && session.wakes < MAX_WAKES) {
+    } else if (!session.wakeBlocked && session.wakeFailures < MAX_WAKES && (session.wakes < MAX_WAKES || session.mail.some((event) => !event.deliveredTurn && event.kind === "checkin"))) {
       autoWake(sessionId, session);
     } else if (session.parent && !session.wakeBlocked && !held(session)) {
       session.settle?.("failed", `Wake limit (${MAX_WAKES}) reached with mail outstanding`);
@@ -36900,7 +37111,7 @@ ${args.labels?.length ? `${say.issueLabels}: ${args.labels.join(", ")}
     const batch2 = takeBatch(session.mail, (event) => !event.defer);
     if (!batch2.length) return;
     for (const event of batch2) event.deliveredTurn = STEERING;
-    const id = `alp-mail-${randomUUID11()}`;
+    const id = `alp-mail-${randomUUID12()}`;
     const text3 = promptSafe(renderMail(batch2, session.parentAgent));
     let steered = false;
     try {
@@ -36923,6 +37134,7 @@ ${args.labels?.length ? `${say.issueLabels}: ${args.labels.join(", ")}
       session.wakeHeld = true;
       return;
     }
+    const checkIn2 = session.mail.find((event) => !event.deliveredTurn && event.kind === "checkin");
     const batch2 = takeBatch(session.mail, () => true);
     if (!batch2.length) return;
     for (const event of batch2) event.deliveredTurn = STARTING;
@@ -36935,11 +37147,13 @@ ${args.labels?.length ? `${say.issueLabels}: ${args.labels.join(", ")}
         release();
         return deliver(sessionId, session);
       }
+      if (session.wakeFailures >= MAX_WAKES || session.wakes >= MAX_WAKES && (!checkIn2 || !session.mail.includes(checkIn2))) return release();
       if (!batch2.every((event) => event.kind === "checkin")) session.wakes++;
-      const id = `alp-wake-${randomUUID11()}`;
+      const id = `alp-wake-${randomUUID12()}`;
       try {
         await startPrompt(sessionId, { clientMessageId: id, delivery: "auto", content: [{ type: "text", text: renderMail(batch2, session.parentAgent) }] }, "wake", batch2);
       } catch {
+        session.wakeFailures++;
         release();
         deliver(sessionId, session);
       }
@@ -37039,6 +37253,17 @@ ${args.labels?.length ? `${say.issueLabels}: ${args.labels.join(", ")}
       waiter.resolve("user");
     }
   }
+  function releaseQuestions(sessionId) {
+    for (const { question, settle, asked } of [...userQuestions.values()]) {
+      if (question.sessionId !== sessionId || !asked) continue;
+      settle("canceled", void 0, "the user wrote instead of answering", toolResult(true, {
+        status: "user_wrote",
+        userMessage: true,
+        question: question.id,
+        next: `${USER_WROTE} Their message may be the answer to your question; if it is not, ask again later.`
+      }));
+    }
+  }
   const assignmentSnapshot = (assignment, status) => ({
     id: assignment.id,
     agent: assignment.agent,
@@ -37248,7 +37473,7 @@ ${refused}`, next: "Fix what it reports, then call alp_handoff again." });
     const pending = [...session.assignments.keys()].some((id) => !ids || ids.has(id)) || takeBatch(session.mail, (event) => event.kind !== "board" && !event.defer && accept(event)).length > 0;
     const events = pending ? await waitFor(sessionId, session, accept, Math.min(args.timeoutMs ?? 3e5, 9e5)) : [];
     if (events === "user") return toolResult(true, { events: [], userMessage: true, running: running2(session), next: USER_WROTE });
-    if (!events) return toolResult(false, { error: "Turn ended" });
+    if (!events) return toolResult(false, session.closed || session.wakeBlocked ? { error: "Turn ended" } : { error: TURN_ENDED, running: running2(session) });
     return toolResult(true, { events: events.map(publicEvent), running: running2(session) });
   }
   function sendTool(sessionId, session, args) {
@@ -37278,10 +37503,10 @@ ${refused}`, next: "Fix what it reports, then call alp_handoff again." });
     }
     return toolResult(true, { sent: post(assignment.id, { kind: args.kind, from, assignment: assignment.id, body: args.body, ...args.replyTo ? { replyTo: args.replyTo } : {} }).id });
   }
-  function askUser(sessionId, session, assignment, body, options3) {
+  function askUser(sessionId, session, assignment, body, options3, approval, asked = false) {
     const rootId = rootOf2(sessionId);
     const question = {
-      id: `q-${randomUUID11().slice(0, 8)}`,
+      id: approval?.id ?? `q-${randomUUID12().slice(0, 8)}`,
       sessionId,
       rootId,
       agent: session.mapping.agent.name,
@@ -37307,7 +37532,7 @@ The user answered: "${answer}"`);
           next: "Decide, and record the assumption in your handoff or final message; or report that you are blocked."
         })));
       };
-      userQuestions.set(question.id, { question, settle });
+      userQuestions.set(question.id, { question, settle, persistent: !!approval, asked });
       if (assignment) assignment.ask = { id: question.id, resolve: (result) => settle("canceled", void 0, void 0, result) };
       emit(sessionId, { type: "question", question });
       runLog(rootId, { event: "human.question", questionId: question.id, sessionId, agent: question.agent, body, ...options3?.length ? { options: options3 } : {} });
@@ -37320,9 +37545,9 @@ The user answered: "${answer}"`);
     if (!session.parent || !sessions.has(session.parent)) return;
     post(session.parent, { kind: "note", from: session.mapping.agent.name, assignment: sessionId, body: `[ALP, on behalf of ${session.mapping.agent.name}] ${body}` });
   }
-  function cancelQuestions(sessionId) {
-    for (const { question, settle } of [...userQuestions.values()]) {
-      if (question.sessionId === sessionId) settle("canceled", void 0, void 0, toolResult(false, { error: "Turn ended" }));
+  function cancelQuestions(sessionId, turnOnly = false) {
+    for (const { question, settle, persistent } of [...userQuestions.values()]) {
+      if (question.sessionId === sessionId && (!turnOnly || !persistent)) settle("canceled", void 0, void 0, toolResult(false, { error: "Turn ended" }));
     }
   }
   function askTool(sessionId, session, args) {
@@ -37342,7 +37567,7 @@ The user answered: "${answer}"`);
     if (to === "user" && session.parent && !session.userOpened) {
       return Promise.resolve(toolResult(false, { error: `Only main talks to the user; ask ${session.parentAgent ?? "your requester"} with alp_ask instead` }));
     }
-    if (to === "user") return askUser(sessionId, session, assignment, args.question, args.options);
+    if (to === "user") return askUser(sessionId, session, assignment, args.question, args.options, void 0, true);
     if (!session.parent || !parent || !assignment) return Promise.resolve(toolResult(false, { error: 'This session has no requester; ask the user with to: "user"' }));
     const parentId = session.parent;
     return new Promise((resolve2) => {
@@ -37489,9 +37714,11 @@ The user answered: "${answer}"`);
     }
     const rootId = rootOf2(sessionId);
     const root = sessions.get(rootId);
-    if (root.calls >= 16) {
+    const advisor = ["advisor", "reviewer"].includes(roleOf(session.mapping, args.agent) ?? "") && childMode === "read-only";
+    const budget = advisor ? "advisorCalls" : "calls";
+    if (root[budget] >= 16) {
       return toolResult(false, {
-        error: "Delegation limit reached for this turn"
+        error: `${advisor ? "Advisor" : "Implementation"} delegation budget exhausted (16 starts across the root session tree since its last new user turn). Mail wakes and child turns do not reset it; a new accepted user prompt in root (including steering) resets both budgets.`
       });
     }
     const peer = roleOf(session.mapping, args.agent) === "peer";
@@ -37504,9 +37731,9 @@ The user answered: "${answer}"`);
     const continued = args.continueFrom !== void 0 ? session.worktrees.get(args.continueFrom) : void 0;
     if (args.continueFrom !== void 0 && !continued && !sharedContinuation) return toolResult(false, { error: `${args.continueFrom} was merged or discarded meanwhile` });
     if (continued) session.worktrees.delete(args.continueFrom);
-    root.calls++;
+    root[budget]++;
     if (peer) root.peerCount++;
-    const childId = `alp-child-${randomUUID11()}`;
+    const childId = `alp-child-${randomUUID12()}`;
     const startedAt = Date.now();
     const assignment = { id: childId, agent: args.agent, mode: childMode, isolation, rootId, startedAt, warned: false, finished: false, ...writes(childMode) ? { writeCheckout: checkout } : {}, ...args.etaMinutes ? { eta: startedAt + args.etaMinutes * 6e4 } : {} };
     if (sharedWriter && !holder) {
@@ -37664,12 +37891,15 @@ ${digest2}` : "")
     const events = await waitFor(sessionId, session, (event2) => event2.assignment === childId && (event2.kind === "result" || event2.kind === "question"), void 0, true);
     if (events === "user") return toolResult(true, { assignmentId: childId, agent: args.agent, status: "running", userMessage: true, next: USER_WROTE });
     if (!events) {
-      return toolResult(false, {
-        agent: args.agent,
-        assignmentId: childId,
-        status: "canceled",
-        error: "Parent assignment stopped"
-      });
+      if (session.closed || session.wakeBlocked || !session.assignments.has(childId)) {
+        return toolResult(false, {
+          agent: args.agent,
+          assignmentId: childId,
+          status: "canceled",
+          error: "Parent assignment stopped"
+        });
+      }
+      return toolResult(false, { agent: args.agent, assignmentId: childId, status: "running", error: TURN_ENDED });
     }
     const event = events.find((candidate) => candidate.kind === "result") ?? events.find((candidate) => candidate.kind === "question");
     if (!event) return toolResult(true, { assignmentId: childId, agent: args.agent, status: "running", events: events.map(publicEvent), next: CHECKED_IN });
@@ -37735,10 +37965,12 @@ ${digest2}` : "")
       peerCount: 0,
       assignments: /* @__PURE__ */ new Map(),
       calls: 0,
+      advisorCalls: 0,
       mail: [],
       waiters: [],
       lastActivity: Date.now(),
       wakes: 0,
+      wakeFailures: 0,
       wakeBlocked: false,
       toolCalls: /* @__PURE__ */ new Map(),
       acknowledged: Promise.resolve(),
@@ -38043,7 +38275,7 @@ Write scope: change files only under ${session.spec.writeRoot}. Your working dir
     runLog(entry.rootId, { event: "assignment.finished", assignmentId: entry.assignmentId, reconciled: true, ...result });
     if (parent && !parent.closed) post(entry.parentId, { kind: "result", from: entry.agent, assignment: entry.assignmentId, result });
   }
-  async function recoverTree(rootId, continueRoot) {
+  async function recoverTree(rootId, continueRoot, parkedRoot) {
     const root = sessions.get(rootId);
     if (!root || root.closed) throw new Error(`Session ${rootId} is not open`);
     const entries2 = inherited.filter((entry) => entry.rootId === rootId).sort((a, b) => a.ancestry.length - b.ancestry.length);
@@ -38072,7 +38304,7 @@ Write scope: change files only under ${session.spec.writeRoot}. Your working dir
         if (outcome) outcome.outcome = "parked";
         return;
       }
-      void startPrompt(sessionId, { clientMessageId: `alp-recover-${randomUUID11()}`, delivery: "auto", content: [{ type: "text", text: text3 }] }, session.parent ? "assignment" : "wake").catch((error51) => session.settle?.("failed", error51));
+      void startPrompt(sessionId, { clientMessageId: `alp-recover-${randomUUID12()}`, delivery: "auto", content: [{ type: "text", text: text3 }] }, session.parent ? "assignment" : "wake").catch((error51) => session.settle?.("failed", error51));
     };
     for (const entry of entries2) {
       const child = sessions.get(entry.assignmentId);
@@ -38080,7 +38312,11 @@ Write scope: change files only under ${session.spec.writeRoot}. Your working dir
       runLog(rootId, { event: "assignment.recovered", assignmentId: entry.assignmentId, agent: entry.agent, ...entry.taskId ? { taskId: entry.taskId } : {} });
       proceed(entry.assignmentId, child, `ALP: ${cause} while you worked on this assignment, and reopened this session. Your earlier work in it${entry.worktree ? " and your worktree" : ""} is intact; check where you stopped (for example with git status), then continue. Finish with alp_handoff as before.${listed(resumed.get(entry.assignmentId))}`);
     }
-    if (continueRoot) proceed(rootId, root, `ALP: ${cause} during your turn, and reopened this session. Continue the user's request where you stopped.${listed(resumed.get(rootId))}`);
+    if (parkedRoot) {
+      root.parked = { reason: parkedRoot, since: Date.now() };
+      emit(rootId, { type: "session.updated", session: snapshot(rootId, root) });
+      if (options2.autoResume !== false && options2.recoveryResume !== false && !pauseOf(root.runtimeKind)) continueParked(rootId, root);
+    } else if (continueRoot) proceed(rootId, root, `ALP: ${cause} during your turn, and reopened this session. Continue the user's request where you stopped.${listed(resumed.get(rootId))}`);
     else for (const assignment of resumed.get(rootId) ?? []) post(rootId, { kind: "note", from: assignment.agent, assignment: assignment.id, passive: true, body: `${cause}; ALP reopened this assignment and it continues. It reports when done.` });
     const failed = outcomes.filter((outcome) => outcome.outcome === "failed");
     if (entries2.length || continueRoot) {
@@ -38127,6 +38363,11 @@ Write scope: change files only under ${session.spec.writeRoot}. Your working dir
     const activeTurn = session.active;
     session.wakeBlocked = true;
     session.userStopped = true;
+    session.parked = void 0;
+    session.parkReason = void 0;
+    emit(sessionId, { type: "session.updated", session: snapshot(sessionId, session) });
+    approvalCancellation.set(session, (approvalCancellation.get(session) ?? 0) + 1);
+    cancelQuestions(sessionId);
     if (activeTurn && session.runtimeKind === "codex" && session.threadId) {
       const partial2 = [...session.text.values()].join("\n").trim();
       if (partial2) interruptedThreads.set(session.threadId, partial2.slice(-4e3));
@@ -38199,11 +38440,9 @@ Write scope: change files only under ${session.spec.writeRoot}. Your working dir
       if (!wake) {
         session.handoff = void 0;
         session.wakes = 0;
+        session.wakeFailures = 0;
         session.wakeBlocked = false;
         session.userStopped = false;
-        if (!session.parent) {
-          session.calls = 0;
-        }
       }
     }
     try {
@@ -38245,6 +38484,10 @@ ${interrupted}`), text_elements: [] }] : [],
       );
       const turnId = prompt.delivery === "steer" ? session.active : result.turn.id;
       for (const event of mail) event.deliveredTurn = turnId;
+      if (!session.parent && origin === "user") {
+        session.calls = 0;
+        session.advisorCalls = 0;
+      }
       session.seen.add(
         prompt.clientMessageId
       );
@@ -38260,7 +38503,10 @@ ${interrupted}`), text_elements: [] }] : [],
       });
       if (origin === "user" && !session.parent) session.userWaiting ??= Date.now();
       if (session.supervisor && origin === "user") session.journal.push(stamp(`user ${prompt.delivery === "steer" ? "steered" : "asked"} ${session.mapping.agent.name}: ${clip(text3, 1500)}`));
-      if (prompt.delivery === "steer" && origin === "user" && !session.parent) releaseWaiters(session);
+      if (prompt.delivery === "steer" && origin === "user" && !session.parent) {
+        releaseWaiters(session);
+        releaseQuestions(sessionId);
+      }
       emit(sessionId, {
         type: "prompt.accepted",
         clientMessageId: prompt.clientMessageId,
@@ -38301,12 +38547,19 @@ ${interrupted}`), text_elements: [] }] : [],
       return opened;
     }),
     prompt: (sessionId, input) => enqueue(async () => {
+      const session = sessions.get(sessionId);
+      const parked = session?.parked;
       try {
-        await startPrompt(sessionId, input, "user");
+        const prompt = session?.active && session.resumedTurn === session.active && input.delivery === "auto" ? { ...input, delivery: "steer" } : input;
+        await startPrompt(sessionId, prompt, "user");
+        if (session && parked && session.parked === parked) {
+          session.parked = void 0;
+          emit(sessionId, { type: "session.updated", session: snapshot(sessionId, session) });
+        }
       } catch (error51) {
-        const session = sessions.get(sessionId);
-        if (session?.seen.has(input.clientMessageId)) return;
-        session?.seen.add(input.clientMessageId);
+        const session2 = sessions.get(sessionId);
+        if (session2?.seen.has(input.clientMessageId)) return;
+        session2?.seen.add(input.clientMessageId);
         emit(sessionId, { type: "prompt.failed", clientMessageId: input.clientMessageId, error: errorData(error51) });
       }
     }),
@@ -38450,8 +38703,8 @@ ${interrupted}`), text_elements: [] }] : [],
     recoverable() {
       return [...inherited];
     },
-    recover(rootId, { continueRoot = false } = {}) {
-      return enqueue(() => recoverTree(rootId, continueRoot));
+    recover(rootId, { continueRoot = false, parkedRoot } = {}) {
+      return enqueue(() => recoverTree(rootId, continueRoot, parkedRoot));
     },
     async abandon(rootId, reason) {
       const entries2 = inherited.filter((entry) => entry.rootId === rootId);
@@ -38484,13 +38737,13 @@ ${interrupted}`), text_elements: [] }] : [],
 
 // packages/daemon/src/server.ts
 import { createHash as createHash11, randomBytes as randomBytes7 } from "node:crypto";
-import { appendFile as appendFile3, chmod, mkdir as mkdir14, readFile as readFile19, unlink as unlink4, lstat as lstat7, rename as rename7 } from "node:fs/promises";
+import { appendFile as appendFile3, chmod, mkdir as mkdir14, readFile as readFile19, unlink as unlink4, lstat as lstat8, rename as rename8 } from "node:fs/promises";
 import net3 from "node:net";
 import os9 from "node:os";
 import path35 from "node:path";
 
 // packages/protocol/src/contract-v1.js
-var METHODS_V1 = { "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://alp.dev/schemas/methods-v1.json", "protocolVersion": 1, "errors": { "parseError": -32700, "invalidRequest": -32600, "methodNotFound": -32601, "invalidParams": -32602, "failed": 1e3, "notFound": 1001, "forbidden": 1003, "conflict": 1004, "unavailable": 1005, "protocol": 1006 }, "capabilities": { "attach.after": "session.attach accepts `after` and answers `cursor`/`reset`; envelopes kept in a tree timeline carry `cursor`.", "prompt.receipts": "session.prompt is answered at most once per (sessionId, clientMessageId) from a durable receipt; repeats answer the first outcome or outcome_unknown.", "extension.methods": "extension.register/unregister, and the daemon sends extension.invoke requests to the owning connection.", "team": "team.list: the teams a project can use, from the daemon host's built-ins, library and project.", "task": "task.list, task.create, task.update and task.gate.resolve on a project's .alp/tasks, written by the daemon under the task lock.", "library": "library.list/get/save/delete/duplicate/rename, library.skills.set and library.models on the daemon user's library and a project's .alp overrides; secrets are redacted on read.", "settings.language": "settings.language.get/set: the language the daemon user reads, in the daemon's ALP_HOME/settings.json.", "session.list.page": "session.list accepts `limit`, `cursor` and `query` and answers `nextCursor` while more sessions follow; without them it answers every session as before.", "question.watch": "question.watch: the connection is told of `question` and `question.resolved` in every tree (of a projectRoot when given), attached or not.", "question.watch.turns": "question.watch accepts `turns`: the connection is also told of `turn.ended` of every root in the trees it watches.", "workspace.files": "workspace.files.search: files under a directory whose relative path matches a query; read-only, names only, links never followed.", "workspace.files.read": "workspace.files.list and workspace.files.read: the entries of a directory and the content of a UTF-8 text file (at most 1 MiB) under a directory; read-only, links never followed, .git, .env* and key or credential files refused, .gitignore'd paths hidden unless asked.", "prompt.images": 'session.prompt takes inline image parts { type: "image", mimeType, data } (base64, no paths or URLs) within the image limits; a session snapshot says whether its runtime takes them in promptImages.' }, "methods": { "assignment.recall": { "x-alp": { "effect": "mutation", "scope": { "kind": "project", "param": "projectRoot", "required": false, "alternatives": ["assignmentId", "taskId"] }, "idempotent": false, "risks": ["model call"] }, "params": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "taskId": { "type": "string" }, "projectRoot": { "type": "string" }, "question": { "type": "string" } }, "required": ["question"], "additionalProperties": true }, "result": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "agent": { "type": "string" }, "taskId": { "type": "string" }, "finishedAt": { "type": "string" }, "answer": { "type": "string" } }, "required": ["assignmentId", "agent", "finishedAt", "answer"], "additionalProperties": true } }, "board.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "pins": { "type": "array", "items": { "$ref": "#/$defs/pin" } } }, "required": ["pins"], "additionalProperties": true } }, "catalog.get": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object" } }, "modes": { "type": "array", "items": { "type": "object" } }, "thinkingOptions": {}, "defaultModel": { "type": "string" } }, "required": ["models", "modes", "defaultModel"], "additionalProperties": true } }, "daemon.hello": { "x-alp": { "effect": "query", "scope": { "kind": "connection" }, "idempotent": true }, "params": { "type": "object", "properties": { "protocolVersion": { "const": 1 }, "client": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" } }, "required": ["name", "version"], "additionalProperties": true }, "capabilities": { "type": "array", "items": { "type": "string" } } }, "required": ["protocolVersion"], "additionalProperties": true }, "result": { "type": "object", "properties": { "protocolVersion": { "const": 1 }, "daemonVersion": { "type": "string" }, "pid": { "type": "integer" }, "hostname": { "type": "string" }, "capabilities": { "type": "array", "items": { "type": "string" } } }, "required": ["protocolVersion"], "additionalProperties": true } }, "daemon.pause": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": { "runtime": { "enum": ["codex", "claude", "acp", "antigravity"] }, "now": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.pauses": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.resume": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": { "runtime": { "enum": ["codex", "claude", "acp", "antigravity"] } }, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.shutdown": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "daemon.status": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "pid": { "type": "integer" }, "startedAt": { "type": "string" }, "version": { "type": "string" }, "protocolVersion": { "type": "integer" }, "sessions": { "type": "integer" }, "questions": { "type": "integer" }, "previousExit": { "type": "object", "properties": { "kind": { "enum": ["clean", "crash"] }, "at": { "type": "string" } }, "required": ["kind"], "additionalProperties": true }, "persistence": { "type": "object" }, "health": { "$ref": "#/$defs/health" } }, "required": ["pid", "startedAt", "version", "protocolVersion", "sessions", "questions", "health"], "additionalProperties": true } }, "daemon.usage": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true, "risks": ["refresh asks every provider (spawns on the daemon host)"] }, "params": { "type": "object", "properties": { "refresh": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "object" } } }, "required": ["providers"], "additionalProperties": true } }, "extension.register": { "x-alp": { "effect": "mutation", "scope": { "kind": "connection" }, "idempotent": false, "risks": ["admin"] }, "params": { "type": "object", "properties": { "method": { "type": "string" } }, "required": ["method"], "additionalProperties": true }, "result": { "type": "object", "properties": { "registered": { "type": "string" } }, "required": ["registered"], "additionalProperties": true } }, "extension.unregister": { "x-alp": { "effect": "mutation", "scope": { "kind": "connection" }, "idempotent": false, "risks": ["admin"] }, "params": { "type": "object", "properties": { "method": { "type": "string" } }, "required": ["method"], "additionalProperties": true }, "result": { "type": "object", "properties": { "unregistered": { "type": "string" } }, "required": ["unregistered"], "additionalProperties": true } }, "library.delete": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": false }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "revision": { "type": "string" } }, "required": ["kind", "name", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "removed": { "const": true }, "now": { "enum": ["builtin", "library"] } }, "required": ["removed"], "additionalProperties": true } }, "library.duplicate": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope", "reads": ["builtin", "library"] }, "idempotent": false, "risks": ["exec-config when kind is mcp, hooks or providers"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "from": { "$ref": "#/$defs/entryName" }, "to": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["kind", "from", "to", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" } }, "required": ["revision"], "additionalProperties": true } }, "library.get": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true, "redacts": ["mcp /server/env/*", "mcp /server/headers/*", "providers /provider/env/*"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "scope": { "$ref": "#/$defs/libraryScope" } }, "required": ["kind", "name"], "additionalProperties": true }, "result": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "content": { "type": "object" }, "revision": { "$ref": "#/$defs/libraryRevision" }, "usedBy": { "type": "array", "items": { "type": "string" } }, "librarySkills": { "type": "array", "items": { "type": "string" } }, "secrets": { "type": "array", "items": { "type": "string" } } }, "required": ["kind", "name", "source", "content", "revision", "usedBy"], "additionalProperties": true } }, "library.list": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["kind"], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": ["string", "null"] }, "entries": { "type": "array", "items": { "$ref": "#/$defs/libraryEntryRow" } } }, "required": ["projectRoot", "entries"], "additionalProperties": true } }, "library.models": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "efforts": { "type": "array", "items": { "type": "string" } }, "effort": { "type": "string" } }, "required": ["id", "label", "efforts"], "additionalProperties": true } } }, "required": ["models"], "additionalProperties": true } }, "library.rename": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": false, "risks": ["exec-config when kind is mcp, hooks or providers"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "from": { "$ref": "#/$defs/entryName" }, "to": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["kind", "from", "to", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" } }, "required": ["revision"], "additionalProperties": true } }, "library.save": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": "with revision (a repeat fails revision_conflict)", "risks": ["exec-config when kind is mcp, hooks or providers, or agents naming mcp/hooks/provider", "writes every known project's .alp/settings.json when kind is teams and sync is known-projects"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "content": { "type": "object" }, "revision": { "$ref": "#/$defs/libraryRevision" }, "sync": { "enum": ["none", "known-projects"] } }, "required": ["kind", "name", "scope", "content"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" }, "syncedProjects": { "type": "integer", "minimum": 0 }, "syncErrors": { "type": "array", "items": { "type": "string" } } }, "required": ["revision"], "additionalProperties": true } }, "library.skills.set": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "host" }, "writes": ["ALP_HOME/role-skills.json"], "idempotent": true }, "params": { "type": "object", "properties": { "agent": { "$ref": "#/$defs/entryName" }, "skills": { "type": "array", "items": { "$ref": "#/$defs/entryName" }, "maxItems": 100 } }, "required": ["agent", "skills"], "additionalProperties": true }, "result": { "type": "object", "properties": { "skills": { "type": "array", "items": { "type": "string" } } }, "required": ["skills"], "additionalProperties": true } }, "question.answer": { "x-alp": { "effect": "mutation", "scope": { "kind": "question", "param": "questionId", "prefix": true }, "idempotent": false }, "params": { "type": "object", "properties": { "questionId": { "type": "string" }, "text": { "type": "string" }, "dismiss": { "type": "boolean" }, "reason": { "type": "string" } }, "required": ["questionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "questionId": { "type": "string" } }, "required": ["questionId"], "additionalProperties": true } }, "question.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } } }, "required": ["questions"], "additionalProperties": true } }, "question.watch": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true, "capability": "question.watch" }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "turns": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } } }, "required": ["questions"], "additionalProperties": true } }, "session.archive": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "archived": { "type": "boolean" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.attach": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "replay": { "type": "boolean" }, "after": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "cursor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "reset": { "const": true } }, "required": ["session", "cursor"], "additionalProperties": true } }, "session.close": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": false }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.configure": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "mode": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/session" } }, "required": ["session"], "additionalProperties": true } }, "session.create": { "x-alp": { "effect": "mutation", "scope": { "kind": "project", "param": "spec.cwd" }, "idempotent": false, "risks": ["exec: spec.env and stdio spec.mcpServers run on the daemon host", "spec.workdir/writeRoot/copy*/restore/keepThread are internal"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,128}$" }, "spec": { "$ref": "#/$defs/spec" }, "history": { "enum": ["skip", "replay"] }, "delegation": { "type": "boolean" }, "resume": { "type": "boolean" } }, "required": ["spec"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/session" }, "attached": { "type": "boolean" }, "resumed": { "const": true }, "durable": { "type": "boolean" } }, "required": ["session", "attached"], "additionalProperties": true } }, "session.get": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.interrupt": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "rootsOnly": { "type": "boolean" }, "includeClosed": { "type": "boolean" }, "includeArchived": { "type": "boolean" }, "limit": { "type": "integer", "minimum": 1, "maximum": 1e3 }, "cursor": { "type": "string", "minLength": 1, "maxLength": 1024 }, "query": { "type": "string", "maxLength": 200 }, "projectRoots": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 1024 } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "$ref": "#/$defs/sessionSummary" } }, "nextCursor": { "type": "string", "minLength": 1 } }, "required": ["sessions"], "additionalProperties": true } }, "session.log": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "rootId": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object" } } }, "required": ["rootId", "entries"], "additionalProperties": true } }, "session.message": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": false }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "text": { "type": "string" } }, "required": ["sessionId", "text"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.preview": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "spec.cwd" }, "idempotent": true }, "params": { "type": "object", "properties": { "spec": { "$ref": "#/$defs/spec" } }, "required": ["spec"], "additionalProperties": true }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/preview" } }, "required": ["preview"], "additionalProperties": true } }, "session.prompt": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": "with prompt.receipts" }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "clientMessageId": { "type": "string" }, "delivery": { "enum": ["auto", "steer"] }, "content": { "type": "array", "items": { "anyOf": [{ "type": "object", "properties": { "type": { "const": "text" }, "text": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "$ref": "#/$defs/promptImage" }, { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["text", "image"] } } }, "required": ["type"], "additionalProperties": true }] } } }, "required": ["sessionId", "clientMessageId", "content"], "additionalProperties": true }, "result": { "type": "object", "properties": { "outcome": { "enum": ["accepted", "failed"] }, "error": { "$ref": "#/$defs/alpError" }, "duplicate": { "type": "boolean" }, "durable": { "type": "boolean" } }, "required": [], "additionalProperties": true } }, "session.release": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "closed": { "type": "boolean" } }, "required": ["closed"], "additionalProperties": true } }, "session.rename": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "title": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" } }, "required": ["sessionId", "title"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.status": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "status": { "$ref": "#/$defs/treeStatus" } }, "required": ["status"], "additionalProperties": true } }, "settings.language.get": { "x-alp": { "effect": "query", "capability": "settings.language", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/languageSetting" } }, "settings.language.set": { "x-alp": { "effect": "mutation", "capability": "settings.language", "scope": { "kind": "host" }, "writes": ["ALP_HOME/settings.json"], "idempotent": true }, "params": { "type": "object", "properties": { "language": { "anyOf": [{ "type": "string", "minLength": 1, "maxLength": 40, "pattern": "\\S" }, { "type": "null" }] } }, "required": ["language"], "additionalProperties": true }, "result": { "$ref": "#/$defs/languageSetting" } }, "task.create": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": "per requestId within one alpd process (10 minutes)" }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "title": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" }, "priority": { "type": "integer", "minimum": 0, "maximum": 4 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": ["projectRoot", "title"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "duplicate": { "const": true } }, "required": ["id"], "additionalProperties": true } }, "task.gate.resolve": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "id": { "$ref": "#/$defs/taskId" }, "gate": { "type": "string", "minLength": 1, "maxLength": 128 }, "note": { "type": "string", "maxLength": 2e3 }, "ifRev": { "type": "integer", "minimum": 0 } }, "required": ["projectRoot", "id", "gate"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "status": { "type": "string" }, "rev": { "type": "integer", "minimum": 0 } }, "required": ["id", "status", "rev"], "additionalProperties": true } }, "task.list": { "x-alp": { "effect": "query", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "tasks": { "type": "array", "items": { "$ref": "#/$defs/taskRow" } }, "unreadable": { "type": "array", "items": { "type": "object", "properties": { "file": { "type": "string" }, "error": { "type": "string" } }, "required": ["file", "error"], "additionalProperties": true } }, "revision": { "type": "string" } }, "required": ["projectRoot", "tasks", "unreadable", "revision"], "additionalProperties": true } }, "task.update": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "id": { "$ref": "#/$defs/taskId" }, "action": { "enum": ["close", "reopen"] }, "note": { "type": "string", "maxLength": 2e3 }, "ifRev": { "type": "integer", "minimum": 0 } }, "required": ["projectRoot", "id", "action"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "status": { "type": "string" }, "rev": { "type": "integer", "minimum": 0 }, "landed": { "type": "string" } }, "required": ["id", "status", "rev"], "additionalProperties": true } }, "team.list": { "x-alp": { "effect": "query", "capability": "team", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": ["string", "null"] }, "teams": { "type": "array", "items": { "$ref": "#/$defs/teamRow" } } }, "required": ["projectRoot", "teams"], "additionalProperties": true } }, "workspace.files.search": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files", "risks": ["lists file names of the directory (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "query": { "type": "string", "maxLength": 200 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "files": { "type": "array", "maxItems": 100, "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 } }, "required": ["path"], "additionalProperties": true } }, "truncated": { "type": "boolean" } }, "required": ["files"], "additionalProperties": true } }, "workspace.files.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.read", "risks": ["lists names, kinds, sizes and times of a directory's entries (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "entries": { "type": "array", "maxItems": 1e3, "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "path": { "type": "string", "minLength": 1 }, "kind": { "enum": ["file", "directory"] }, "size": { "type": "integer", "minimum": 0 }, "modifiedAt": { "type": "string" } }, "required": ["name", "path", "kind"], "additionalProperties": true } }, "truncated": { "type": "boolean" } }, "required": ["entries"], "additionalProperties": true } }, "workspace.files.read": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.read", "risks": ["returns the content of a text file under the directory"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" } }, "required": ["projectRoot", "path"], "additionalProperties": true }, "result": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "content": { "type": "string" }, "size": { "type": "integer", "minimum": 0, "maximum": 1048576 }, "modifiedAt": { "type": "string" } }, "required": ["path", "content", "size"], "additionalProperties": true } } }, "$defs": { "error": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": {} }, "required": ["code", "message"], "additionalProperties": true }, "session": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "promptImages": { "type": "boolean" }, "usage": { "$ref": "#/$defs/usage" } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy"], "additionalProperties": true }, "usage": { "type": "object", "properties": { "contextWindowUsedTokens": { "type": "integer", "minimum": 0 }, "contextWindowMaxTokens": { "type": "integer", "minimum": 1 }, "inputTokens": { "type": "integer", "minimum": 0 }, "cachedInputTokens": { "type": "integer", "minimum": 0 }, "outputTokens": { "type": "integer", "minimum": 0 }, "totalCostUsd": { "type": "number", "minimum": 0 } }, "additionalProperties": true }, "assignment": { "type": "object", "properties": { "id": { "type": "string" }, "agent": { "type": "string" }, "mode": { "type": "string" }, "status": { "type": "string" }, "startedAt": { "type": "string" }, "worktree": { "type": "object", "properties": { "branch": { "type": "string" }, "path": { "type": "string" } }, "required": ["branch", "path"], "additionalProperties": true } }, "required": ["id", "agent", "mode", "status", "startedAt"], "additionalProperties": true }, "mail": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "enum": ["question", "answer", "note", "steer", "result", "stalled", "board", "checkin"] }, "from": { "type": "string" }, "assignment": { "type": "string" }, "body": { "type": "string" }, "replyTo": { "type": "string" }, "result": { "type": "object" }, "redelivered": { "type": "boolean" } }, "required": ["id", "kind", "from", "assignment"], "additionalProperties": true }, "pin": { "type": "object", "properties": { "id": { "type": "string" }, "project": { "type": "string" }, "kind": { "enum": ["claim", "decision", "finding"] }, "body": { "type": "string" }, "paths": { "type": "array", "items": { "type": "string" } }, "agent": { "type": "string" }, "sessionId": { "type": "string" }, "rootId": { "type": "string" }, "at": { "type": "string" }, "released": { "type": "string" }, "task": { "type": "string" } }, "required": ["id", "project", "kind", "body", "agent", "sessionId", "rootId", "at"], "additionalProperties": true }, "question": { "type": "object", "properties": { "id": { "type": "string" }, "sessionId": { "type": "string" }, "rootId": { "type": "string" }, "agent": { "type": "string" }, "body": { "type": "string" }, "options": { "type": "array", "items": { "type": "string" } }, "askedAt": { "type": "string" } }, "required": ["id", "sessionId", "rootId", "agent", "body", "askedAt"], "additionalProperties": true }, "spec": { "type": "object", "properties": { "cwd": { "type": "string" }, "agent": { "type": "string" }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "persist": { "type": "boolean" }, "restore": { "type": "object" } }, "required": ["cwd"], "additionalProperties": true }, "item": { "anyOf": [{ "$ref": "#/$defs/knownItem" }, { "$ref": "#/$defs/unknownItem" }] }, "event": { "anyOf": [{ "$ref": "#/$defs/knownEvent" }, { "$ref": "#/$defs/unknownEvent" }] }, "envelope": { "type": "object", "properties": { "sessionId": { "type": "string" }, "epoch": { "type": "string" }, "seq": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "ts": { "type": "string" }, "event": { "$ref": "#/$defs/event" }, "cursor": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": ["sessionId", "epoch", "seq", "ts", "event"], "additionalProperties": true }, "request": { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }] }, "method": { "type": "string" }, "params": { "type": "object" } }, "required": ["jsonrpc", "method", "id"], "additionalProperties": true }, "response": { "oneOf": [{ "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" }] }, "result": {} }, "required": ["jsonrpc", "id", "result"], "additionalProperties": true }, { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" }] }, "error": { "$ref": "#/$defs/error" } }, "required": ["jsonrpc", "id", "error"], "additionalProperties": true }] }, "notification": { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "method": { "const": "event" }, "params": { "$ref": "#/$defs/envelope" } }, "required": ["jsonrpc", "method", "params"], "additionalProperties": true }, "knownEvent": { "oneOf": [{ "type": "object", "properties": { "type": { "const": "session.opened" }, "session": { "$ref": "#/$defs/session" }, "cwd": { "type": "string" }, "effective": { "type": "object", "properties": { "model": { "type": "string" }, "thinking": { "type": "string" } }, "required": ["model", "thinking"], "additionalProperties": true } }, "required": ["type", "session", "cwd", "effective"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.ready" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.updated" }, "session": { "$ref": "#/$defs/session" } }, "required": ["type", "session"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.closed" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.failed" }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "error"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "prompt.accepted" }, "clientMessageId": { "type": "string" }, "result": { "enum": ["turn", "steer"] }, "turnId": { "type": "string" } }, "required": ["type", "clientMessageId", "result", "turnId"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "prompt.failed" }, "clientMessageId": { "type": "string" }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "clientMessageId", "error"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "turn.started" }, "turnId": { "type": "string" }, "origin": { "enum": ["user", "wake", "assignment", "runtime"] } }, "required": ["type", "turnId", "origin"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "turn.ended" }, "turnId": { "type": "string" }, "state": { "enum": ["completed", "failed", "canceled"] }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "turnId", "state"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "item" }, "item": { "$ref": "#/$defs/item" } }, "required": ["type", "item"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "usage" }, "usage": { "$ref": "#/$defs/usage" } }, "required": ["type", "usage"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "mail" }, "mail": { "$ref": "#/$defs/mail" } }, "required": ["type", "mail"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "assignment" }, "assignment": { "$ref": "#/$defs/assignment" } }, "required": ["type", "assignment"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "question" }, "question": { "$ref": "#/$defs/question" } }, "required": ["type", "question"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "question.resolved" }, "questionId": { "type": "string" }, "outcome": { "enum": ["answered", "dismissed", "timeout", "canceled"] }, "answer": { "type": "string" } }, "required": ["type", "questionId", "outcome"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "pin" }, "pin": { "$ref": "#/$defs/pin" } }, "required": ["type", "pin"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "unpin" }, "pinId": { "type": "string" }, "reason": { "enum": ["unpinned", "session_ended"] } }, "required": ["type", "pinId", "reason"], "additionalProperties": true }] }, "unknownEvent": { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["session.opened", "session.ready", "session.updated", "session.closed", "session.failed", "prompt.accepted", "prompt.failed", "turn.started", "turn.ended", "item", "usage", "mail", "assignment", "question", "question.resolved", "pin", "unpin"] } } }, "required": ["type"], "additionalProperties": true }, "knownItem": { "oneOf": [{ "type": "object", "properties": { "kind": { "const": "user_message" }, "id": { "type": "string" }, "text": { "type": "string" }, "clientMessageId": { "type": "string" }, "images": { "type": "integer", "minimum": 1 } }, "required": ["kind", "id", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "assistant_message" }, "id": { "type": "string" }, "text": { "type": "string" } }, "required": ["kind", "id", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "notice" }, "id": { "type": "string" }, "level": { "enum": ["info", "warning", "error"] }, "text": { "type": "string" } }, "required": ["kind", "id", "level", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "compaction" }, "id": { "type": "string" }, "status": { "enum": ["running", "completed", "failed"] }, "trigger": { "type": "string" }, "preTokens": { "type": "integer" }, "postTokens": { "type": "integer" } }, "required": ["kind", "id", "status"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "todo" }, "id": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "status": { "enum": ["pending", "in_progress", "completed"] } }, "required": ["id", "text", "status"], "additionalProperties": true } } }, "required": ["kind", "id", "items"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "tool_call" }, "id": { "type": "string" }, "callId": { "type": "string" }, "name": { "type": "string" }, "status": { "enum": ["running", "completed", "failed"] }, "error": { "type": "string" }, "detail": { "$ref": "#/$defs/toolCallDetail" } }, "required": ["kind", "id", "callId", "name", "status", "detail"], "additionalProperties": true }] }, "unknownItem": { "type": "object", "properties": { "kind": { "type": "string", "not": { "enum": ["user_message", "assistant_message", "notice", "compaction", "todo", "tool_call"] } }, "id": { "type": "string" } }, "required": ["kind", "id"], "additionalProperties": true }, "toolCallDetail": { "oneOf": [{ "type": "object", "properties": { "type": { "const": "shell" }, "command": { "type": "string" }, "cwd": { "type": "string" }, "output": { "type": "string" }, "exitCode": { "type": ["integer", "null"] } }, "required": ["type", "command", "output"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "read" }, "filePath": { "type": "string" }, "content": { "type": "string" }, "offset": { "type": "integer" }, "limit": { "type": "integer" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "edit" }, "filePath": { "type": "string" }, "oldString": { "type": "string" }, "newString": { "type": "string" }, "unifiedDiff": { "type": "string" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "write" }, "filePath": { "type": "string" }, "content": { "type": "string" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "search" }, "query": { "type": "string" }, "toolName": { "enum": ["search", "grep", "glob", "web_search"] }, "content": { "type": "string" }, "filePaths": { "type": "array", "items": { "type": "string" } }, "webResults": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "url": { "type": "string" } }, "required": ["title", "url"], "additionalProperties": true } }, "numFiles": { "type": "integer" }, "numMatches": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": ["type", "query"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "fetch" }, "url": { "type": "string" }, "prompt": { "type": "string" }, "result": { "type": "string" }, "code": { "type": "integer" } }, "required": ["type", "url"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "sub_agent" }, "subAgentType": { "type": "string" }, "description": { "type": "string" }, "log": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "plan" }, "text": { "type": "string" } }, "required": ["type", "text"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "plain_text" }, "label": { "type": "string" }, "text": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "unknown" }, "input": {}, "output": {} }, "required": ["type", "input", "output"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["shell", "read", "edit", "write", "search", "fetch", "sub_agent", "plan", "plain_text", "unknown"] } } }, "required": ["type"], "additionalProperties": true }] }, "alpError": { "type": "object", "properties": { "message": { "type": "string" }, "code": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "sessionSummary": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "status": { "enum": ["initializing", "idle", "running", "error", "closed"] }, "title": { "type": "string" }, "archived": { "type": "boolean" }, "lastError": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy", "status"], "additionalProperties": true }, "pause": { "type": "object", "properties": { "since": { "type": "string" }, "by": { "type": "string" }, "reason": { "type": "string" }, "resetsAt": { "type": "string" }, "checkedAt": { "type": "string" } }, "required": ["since", "by", "reason"], "additionalProperties": true }, "pauseState": { "type": "object", "properties": { "all": { "$ref": "#/$defs/pause" }, "runtimes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/pause" } }, "parked": { "type": "array", "items": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "type": "string" }, "rootId": { "type": "string" }, "reason": { "type": "string" }, "since": { "type": "string" } }, "required": ["assignmentId", "agent", "runtime", "rootId", "reason", "since"], "additionalProperties": true } } }, "required": ["runtimes", "parked"], "additionalProperties": true }, "preview": { "type": "object", "properties": { "teams": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["id", "label"], "additionalProperties": true } }, "team": { "type": "string" }, "teamLabel": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" } }, "required": ["teams", "team", "agent", "runtime", "model", "mode", "thinking"], "additionalProperties": true }, "treeStatus": { "type": "object", "properties": { "rootId": { "type": "string" }, "sessions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "state": { "enum": ["running", "waiting", "waiting_parent", "waiting_user", "idle"] }, "idleMs": { "type": "number" }, "workdir": { "type": "string" }, "unreadMail": { "type": "integer", "minimum": 0 } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy", "state", "idleMs", "workdir", "unreadMail"], "additionalProperties": true } }, "assignments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "requester": { "type": "string" }, "isolation": { "enum": ["shared", "worktree"] }, "idleMs": { "type": "number" } }, "required": ["id", "requester", "isolation", "idleMs"], "additionalProperties": true } }, "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } }, "worktrees": { "type": "array", "items": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "requester": { "type": "string" }, "agent": { "type": "string" }, "branch": { "type": "string" }, "files": { "type": "array", "items": { "type": "string" } }, "stat": { "type": "string" } }, "required": ["assignmentId", "requester", "agent", "branch", "files", "stat"], "additionalProperties": true } }, "leases": { "type": "array", "items": { "type": "object", "properties": { "checkout": { "type": "string" }, "assignmentId": { "type": "string" }, "agent": { "type": "string" } }, "required": ["checkout", "assignmentId", "agent"], "additionalProperties": true } }, "claims": { "type": "array", "items": { "$ref": "#/$defs/pin" } } }, "required": ["rootId", "sessions", "assignments", "questions", "worktrees", "leases", "claims"], "additionalProperties": true }, "health": { "type": "object", "properties": { "live": { "type": "boolean" }, "ready": { "type": "boolean" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "ok": { "type": "boolean" }, "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["id", "ok"], "additionalProperties": true } } }, "required": ["live", "ready", "checks"], "additionalProperties": true }, "projectRoot": { "type": "string", "minLength": 1, "maxLength": 4096, "description": "An absolute, normalized path on the daemon host to a directory holding .alp/. Compared as is: the daemon never walks up to a parent." }, "taskId": { "type": "string", "pattern": "^t-[0-9a-f]{4,12}(?:\\.\\d+)*$" }, "taskRow": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "title": { "type": "string" }, "type": { "type": "string" }, "priority": { "type": "integer" }, "status": { "enum": ["open", "in_progress", "review", "closed"] }, "rev": { "type": "integer", "minimum": 0 }, "parent": { "type": "string" }, "assignee": { "type": "string" }, "ready": { "type": "boolean" }, "blockedBy": { "type": "array", "items": { "type": "string" } }, "waits": { "type": "array", "items": { "type": "string" } }, "approvals": { "type": "array", "items": { "type": "object", "properties": { "gate": { "type": "string" }, "note": { "type": "string" } }, "required": ["gate", "note"], "additionalProperties": true } }, "handoff": { "type": "object", "properties": { "outcome": { "type": "string" }, "summary": { "type": "string" }, "agent": { "type": "string" } }, "required": ["outcome", "summary"], "additionalProperties": true }, "closed": { "type": "object", "properties": { "reason": { "type": "string" }, "summary": { "type": "string" }, "at": { "type": "string" } }, "required": ["reason", "at"], "additionalProperties": true }, "description": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "paths": { "type": "array", "items": { "type": "string" } }, "progress": { "type": "object", "properties": { "done": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 } }, "required": ["done", "total"], "additionalProperties": true }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": ["id", "title", "type", "priority", "status", "rev", "ready", "updatedAt"], "additionalProperties": true }, "libraryKind": { "enum": ["agents", "skills", "mcp", "hooks", "teams", "providers"] }, "libraryScope": { "enum": ["library", "project"] }, "librarySource": { "enum": ["builtin", "library", "project"] }, "entryName": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.-]+$", "not": { "enum": [".", ".."] } }, "libraryRevision": { "type": ["string", "null"] }, "libraryEntryRow": { "type": "object", "properties": { "name": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "description": { "type": "string" }, "usedBy": { "type": "array", "items": { "type": "string" } } }, "required": ["name", "source"], "additionalProperties": true }, "secretMarker": { "type": "object", "properties": { "$secret": { "const": "keep" } }, "required": ["$secret"], "additionalProperties": false, "description": "Stands for a stored secret value: read results carry it in place of the value; a save that sends it back keeps the stored value." }, "languageSetting": { "type": "object", "properties": { "language": { "type": ["string", "null"] }, "applies": { "type": "string" }, "default": { "type": "string" } }, "required": ["language", "applies", "default"], "additionalProperties": true }, "teamRow": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "error": { "type": "string" } }, "required": ["id", "source"], "additionalProperties": true }, "promptImage": { "type": "object", "properties": { "type": { "const": "image" }, "mimeType": { "enum": ["image/png", "image/jpeg", "image/gif", "image/webp"] }, "data": { "type": "string", "minLength": 4, "maxLength": 6990508, "pattern": "^[A-Za-z0-9+/]+={0,2}$" }, "name": { "type": "string", "maxLength": 255 } }, "required": ["type", "mimeType", "data"], "additionalProperties": false } } };
+var METHODS_V1 = { "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://alp.dev/schemas/methods-v1.json", "protocolVersion": 1, "errors": { "parseError": -32700, "invalidRequest": -32600, "methodNotFound": -32601, "invalidParams": -32602, "failed": 1e3, "notFound": 1001, "forbidden": 1003, "conflict": 1004, "unavailable": 1005, "protocol": 1006 }, "capabilities": { "attach.after": "session.attach accepts `after` and answers `cursor`/`reset`; envelopes kept in a tree timeline carry `cursor`.", "prompt.receipts": "session.prompt is answered at most once per (sessionId, clientMessageId) from a durable receipt; repeats answer the first outcome or outcome_unknown.", "extension.methods": "extension.register/unregister, and the daemon sends extension.invoke requests to the owning connection.", "team": "team.list: the teams a project can use, from the daemon host's built-ins, library and project.", "task": "task.list, task.create, task.update and task.gate.resolve on a project's .alp/tasks, written by the daemon under the task lock.", "library": "library.list/get/save/delete/duplicate/rename, library.skills.set and library.models on the daemon user's library and a project's .alp overrides; secrets are redacted on read.", "settings.language": "settings.language.get/set: the language the daemon user reads, in the daemon's ALP_HOME/settings.json.", "session.list.page": "session.list accepts `limit`, `cursor` and `query` and answers `nextCursor` while more sessions follow; without them it answers every session as before.", "question.watch": "question.watch: the connection is told of `question` and `question.resolved` in every tree (of a projectRoot when given), attached or not.", "question.watch.turns": "question.watch accepts `turns`: the connection is also told of `turn.ended` of every root in the trees it watches.", "workspace.files": "workspace.files.search: files under a directory whose relative path matches a query; read-only, names only, links never followed.", "workspace.files.read": "workspace.files.list and workspace.files.read: the entries of a directory and the content of a UTF-8 text file (at most 1 MiB) under a directory; read-only, links never followed, .git, .env* and key or credential files refused, .gitignore'd paths hidden unless asked.", "prompt.images": 'session.prompt takes inline image parts { type: "image", mimeType, data } (base64, no paths or URLs) within the image limits; a session snapshot says whether its runtime takes them in promptImages.', "library.project.write": "library save/delete/duplicate/rename accept policy project-data: only project-only pure-data agents and skills, no executable configuration, sidecars or library/built-in collisions." }, "methods": { "assignment.recall": { "x-alp": { "effect": "mutation", "scope": { "kind": "project", "param": "projectRoot", "required": false, "alternatives": ["assignmentId", "taskId"] }, "idempotent": false, "risks": ["model call"] }, "params": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "taskId": { "type": "string" }, "projectRoot": { "type": "string" }, "question": { "type": "string" } }, "required": ["question"], "additionalProperties": true }, "result": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "agent": { "type": "string" }, "taskId": { "type": "string" }, "finishedAt": { "type": "string" }, "answer": { "type": "string" } }, "required": ["assignmentId", "agent", "finishedAt", "answer"], "additionalProperties": true } }, "board.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "pins": { "type": "array", "items": { "$ref": "#/$defs/pin" } } }, "required": ["pins"], "additionalProperties": true } }, "catalog.get": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object" } }, "modes": { "type": "array", "items": { "type": "object" } }, "thinkingOptions": {}, "defaultModel": { "type": "string" } }, "required": ["models", "modes", "defaultModel"], "additionalProperties": true } }, "daemon.hello": { "x-alp": { "effect": "query", "scope": { "kind": "connection" }, "idempotent": true }, "params": { "type": "object", "properties": { "protocolVersion": { "const": 1 }, "client": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" } }, "required": ["name", "version"], "additionalProperties": true }, "capabilities": { "type": "array", "items": { "type": "string" } } }, "required": ["protocolVersion"], "additionalProperties": true }, "result": { "type": "object", "properties": { "protocolVersion": { "const": 1 }, "daemonVersion": { "type": "string" }, "pid": { "type": "integer" }, "hostname": { "type": "string" }, "capabilities": { "type": "array", "items": { "type": "string" } }, "promptImageLimits": { "type": "object", "description": "Optional effective inline image limits for this connection, when prompt.images is advertised. Missing on older peers. Byte limits count decoded bytes.", "properties": { "maxCount": { "type": "integer", "minimum": 0 }, "maxBytes": { "type": "integer", "minimum": 0 }, "maxTotalBytes": { "type": "integer", "minimum": 0 } }, "required": ["maxCount", "maxBytes", "maxTotalBytes"], "additionalProperties": false } }, "required": ["protocolVersion"], "additionalProperties": true } }, "daemon.pause": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": { "runtime": { "enum": ["codex", "claude", "acp", "antigravity"] }, "now": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.pauses": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.resume": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": { "runtime": { "enum": ["codex", "claude", "acp", "antigravity"] } }, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.shutdown": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "daemon.status": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "pid": { "type": "integer" }, "startedAt": { "type": "string" }, "version": { "type": "string" }, "protocolVersion": { "type": "integer" }, "sessions": { "type": "integer" }, "questions": { "type": "integer" }, "previousExit": { "type": "object", "properties": { "kind": { "enum": ["clean", "crash"] }, "at": { "type": "string" } }, "required": ["kind"], "additionalProperties": true }, "persistence": { "type": "object" }, "health": { "$ref": "#/$defs/health" } }, "required": ["pid", "startedAt", "version", "protocolVersion", "sessions", "questions", "health"], "additionalProperties": true } }, "daemon.usage": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true, "risks": ["refresh asks every provider (spawns on the daemon host)"] }, "params": { "type": "object", "properties": { "refresh": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "object" } } }, "required": ["providers"], "additionalProperties": true } }, "extension.register": { "x-alp": { "effect": "mutation", "scope": { "kind": "connection" }, "idempotent": false, "risks": ["admin"] }, "params": { "type": "object", "properties": { "method": { "type": "string" } }, "required": ["method"], "additionalProperties": true }, "result": { "type": "object", "properties": { "registered": { "type": "string" } }, "required": ["registered"], "additionalProperties": true } }, "extension.unregister": { "x-alp": { "effect": "mutation", "scope": { "kind": "connection" }, "idempotent": false, "risks": ["admin"] }, "params": { "type": "object", "properties": { "method": { "type": "string" } }, "required": ["method"], "additionalProperties": true }, "result": { "type": "object", "properties": { "unregistered": { "type": "string" } }, "required": ["unregistered"], "additionalProperties": true } }, "library.delete": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": false }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "revision": { "type": "string" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "name", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "removed": { "const": true }, "now": { "enum": ["builtin", "library"] } }, "required": ["removed"], "additionalProperties": true } }, "library.duplicate": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope", "reads": ["builtin", "library"] }, "idempotent": false, "risks": ["exec-config when kind is mcp, hooks or providers"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "from": { "$ref": "#/$defs/entryName" }, "to": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "from", "to", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" } }, "required": ["revision"], "additionalProperties": true } }, "library.get": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true, "redacts": ["mcp /server/env/*", "mcp /server/headers/*", "providers /provider/env/*"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "scope": { "$ref": "#/$defs/libraryScope" } }, "required": ["kind", "name"], "additionalProperties": true }, "result": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "content": { "type": "object" }, "revision": { "$ref": "#/$defs/libraryRevision" }, "usedBy": { "type": "array", "items": { "type": "string" } }, "librarySkills": { "type": "array", "items": { "type": "string" } }, "secrets": { "type": "array", "items": { "type": "string" } } }, "required": ["kind", "name", "source", "content", "revision", "usedBy"], "additionalProperties": true } }, "library.list": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["kind"], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": ["string", "null"] }, "entries": { "type": "array", "items": { "$ref": "#/$defs/libraryEntryRow" } } }, "required": ["projectRoot", "entries"], "additionalProperties": true } }, "library.models": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "efforts": { "type": "array", "items": { "type": "string" } }, "effort": { "type": "string" } }, "required": ["id", "label", "efforts"], "additionalProperties": true } } }, "required": ["models"], "additionalProperties": true } }, "library.rename": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": false, "risks": ["exec-config when kind is mcp, hooks or providers"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "from": { "$ref": "#/$defs/entryName" }, "to": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "from", "to", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" } }, "required": ["revision"], "additionalProperties": true } }, "library.save": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": "with revision (a repeat fails revision_conflict)", "risks": ["exec-config when kind is mcp, hooks or providers, or agents naming mcp/hooks/provider", "writes every known project's .alp/settings.json when kind is teams and sync is known-projects"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "content": { "type": "object" }, "revision": { "$ref": "#/$defs/libraryRevision" }, "sync": { "enum": ["none", "known-projects"] }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "name", "scope", "content"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" }, "syncedProjects": { "type": "integer", "minimum": 0 }, "syncErrors": { "type": "array", "items": { "type": "string" } } }, "required": ["revision"], "additionalProperties": true } }, "library.skills.set": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "host" }, "writes": ["ALP_HOME/role-skills.json"], "idempotent": true }, "params": { "type": "object", "properties": { "agent": { "$ref": "#/$defs/entryName" }, "skills": { "type": "array", "items": { "$ref": "#/$defs/entryName" }, "maxItems": 100 } }, "required": ["agent", "skills"], "additionalProperties": true }, "result": { "type": "object", "properties": { "skills": { "type": "array", "items": { "type": "string" } } }, "required": ["skills"], "additionalProperties": true } }, "question.answer": { "x-alp": { "effect": "mutation", "scope": { "kind": "question", "param": "questionId", "prefix": true }, "idempotent": false }, "params": { "type": "object", "properties": { "questionId": { "type": "string" }, "text": { "type": "string" }, "dismiss": { "type": "boolean" }, "reason": { "type": "string" } }, "required": ["questionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "questionId": { "type": "string" } }, "required": ["questionId"], "additionalProperties": true } }, "question.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } } }, "required": ["questions"], "additionalProperties": true } }, "question.watch": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true, "capability": "question.watch" }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "turns": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } } }, "required": ["questions"], "additionalProperties": true } }, "session.archive": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "archived": { "type": "boolean" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.attach": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "replay": { "type": "boolean" }, "after": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "cursor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "reset": { "const": true } }, "required": ["session", "cursor"], "additionalProperties": true } }, "session.close": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": false }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.configure": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "mode": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/session" } }, "required": ["session"], "additionalProperties": true } }, "session.create": { "x-alp": { "effect": "mutation", "scope": { "kind": "project", "param": "spec.cwd" }, "idempotent": false, "risks": ["exec: spec.env and stdio spec.mcpServers run on the daemon host", "spec.workdir/writeRoot/copy*/restore/keepThread are internal"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,128}$" }, "spec": { "$ref": "#/$defs/spec" }, "history": { "enum": ["skip", "replay"] }, "delegation": { "type": "boolean" }, "resume": { "type": "boolean" } }, "required": ["spec"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/session" }, "attached": { "type": "boolean" }, "resumed": { "const": true }, "durable": { "type": "boolean" } }, "required": ["session", "attached"], "additionalProperties": true } }, "session.get": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.interrupt": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "rootsOnly": { "type": "boolean" }, "includeClosed": { "type": "boolean" }, "includeArchived": { "type": "boolean" }, "limit": { "type": "integer", "minimum": 1, "maximum": 1e3 }, "cursor": { "type": "string", "minLength": 1, "maxLength": 1024 }, "query": { "type": "string", "maxLength": 200 }, "projectRoots": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 1024 } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "$ref": "#/$defs/sessionSummary" } }, "nextCursor": { "type": "string", "minLength": 1 } }, "required": ["sessions"], "additionalProperties": true } }, "session.log": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "rootId": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object" } } }, "required": ["rootId", "entries"], "additionalProperties": true } }, "session.message": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": false }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "text": { "type": "string" } }, "required": ["sessionId", "text"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.preview": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "spec.cwd" }, "idempotent": true }, "params": { "type": "object", "properties": { "spec": { "$ref": "#/$defs/spec" } }, "required": ["spec"], "additionalProperties": true }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/preview" } }, "required": ["preview"], "additionalProperties": true } }, "session.prompt": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": "with prompt.receipts" }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "clientMessageId": { "type": "string" }, "delivery": { "enum": ["auto", "steer"] }, "content": { "type": "array", "items": { "anyOf": [{ "type": "object", "properties": { "type": { "const": "text" }, "text": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "$ref": "#/$defs/promptImage" }, { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["text", "image"] } } }, "required": ["type"], "additionalProperties": true }] } } }, "required": ["sessionId", "clientMessageId", "content"], "additionalProperties": true }, "result": { "type": "object", "properties": { "outcome": { "enum": ["accepted", "failed"] }, "error": { "$ref": "#/$defs/alpError" }, "duplicate": { "type": "boolean" }, "durable": { "type": "boolean" } }, "required": [], "additionalProperties": true } }, "session.release": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "closed": { "type": "boolean" } }, "required": ["closed"], "additionalProperties": true } }, "session.rename": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "title": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" } }, "required": ["sessionId", "title"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.status": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "status": { "$ref": "#/$defs/treeStatus" } }, "required": ["status"], "additionalProperties": true } }, "settings.language.get": { "x-alp": { "effect": "query", "capability": "settings.language", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/languageSetting" } }, "settings.language.set": { "x-alp": { "effect": "mutation", "capability": "settings.language", "scope": { "kind": "host" }, "writes": ["ALP_HOME/settings.json"], "idempotent": true }, "params": { "type": "object", "properties": { "language": { "anyOf": [{ "type": "string", "minLength": 1, "maxLength": 40, "pattern": "\\S" }, { "type": "null" }] } }, "required": ["language"], "additionalProperties": true }, "result": { "$ref": "#/$defs/languageSetting" } }, "task.create": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": "per requestId within one alpd process (10 minutes)" }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "title": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" }, "priority": { "type": "integer", "minimum": 0, "maximum": 4 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": ["projectRoot", "title"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "duplicate": { "const": true } }, "required": ["id"], "additionalProperties": true } }, "task.gate.resolve": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "id": { "$ref": "#/$defs/taskId" }, "gate": { "type": "string", "minLength": 1, "maxLength": 128 }, "note": { "type": "string", "maxLength": 2e3 }, "ifRev": { "type": "integer", "minimum": 0 } }, "required": ["projectRoot", "id", "gate"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "status": { "type": "string" }, "rev": { "type": "integer", "minimum": 0 } }, "required": ["id", "status", "rev"], "additionalProperties": true } }, "task.list": { "x-alp": { "effect": "query", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "tasks": { "type": "array", "items": { "$ref": "#/$defs/taskRow" } }, "unreadable": { "type": "array", "items": { "type": "object", "properties": { "file": { "type": "string" }, "error": { "type": "string" } }, "required": ["file", "error"], "additionalProperties": true } }, "revision": { "type": "string" } }, "required": ["projectRoot", "tasks", "unreadable", "revision"], "additionalProperties": true } }, "task.update": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "id": { "$ref": "#/$defs/taskId" }, "action": { "enum": ["close", "reopen"] }, "note": { "type": "string", "maxLength": 2e3 }, "ifRev": { "type": "integer", "minimum": 0 } }, "required": ["projectRoot", "id", "action"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "status": { "type": "string" }, "rev": { "type": "integer", "minimum": 0 }, "landed": { "type": "string" } }, "required": ["id", "status", "rev"], "additionalProperties": true } }, "team.list": { "x-alp": { "effect": "query", "capability": "team", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": ["string", "null"] }, "teams": { "type": "array", "items": { "$ref": "#/$defs/teamRow" } } }, "required": ["projectRoot", "teams"], "additionalProperties": true } }, "workspace.files.search": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files", "risks": ["lists file names of the directory (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "query": { "type": "string", "maxLength": 200 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "files": { "type": "array", "maxItems": 100, "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 } }, "required": ["path"], "additionalProperties": true } }, "truncated": { "type": "boolean" } }, "required": ["files"], "additionalProperties": true } }, "workspace.files.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.read", "risks": ["lists names, kinds, sizes and times of a directory's entries (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "entries": { "type": "array", "maxItems": 1e3, "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "path": { "type": "string", "minLength": 1 }, "kind": { "enum": ["file", "directory"] }, "size": { "type": "integer", "minimum": 0 }, "modifiedAt": { "type": "string" } }, "required": ["name", "path", "kind"], "additionalProperties": true } }, "truncated": { "type": "boolean" } }, "required": ["entries"], "additionalProperties": true } }, "workspace.files.read": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.read", "risks": ["returns the content of a text file under the directory"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" } }, "required": ["projectRoot", "path"], "additionalProperties": true }, "result": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "content": { "type": "string" }, "size": { "type": "integer", "minimum": 0, "maximum": 1048576 }, "modifiedAt": { "type": "string" } }, "required": ["path", "content", "size"], "additionalProperties": true } } }, "$defs": { "error": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": {} }, "required": ["code", "message"], "additionalProperties": true }, "session": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "promptImages": { "type": "boolean" }, "usage": { "$ref": "#/$defs/usage" } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy"], "additionalProperties": true }, "usage": { "type": "object", "properties": { "contextWindowUsedTokens": { "type": "integer", "minimum": 0 }, "contextWindowMaxTokens": { "type": "integer", "minimum": 1 }, "inputTokens": { "type": "integer", "minimum": 0 }, "cachedInputTokens": { "type": "integer", "minimum": 0 }, "outputTokens": { "type": "integer", "minimum": 0 }, "totalCostUsd": { "type": "number", "minimum": 0 } }, "additionalProperties": true }, "assignment": { "type": "object", "properties": { "id": { "type": "string" }, "agent": { "type": "string" }, "mode": { "type": "string" }, "status": { "type": "string" }, "startedAt": { "type": "string" }, "worktree": { "type": "object", "properties": { "branch": { "type": "string" }, "path": { "type": "string" } }, "required": ["branch", "path"], "additionalProperties": true } }, "required": ["id", "agent", "mode", "status", "startedAt"], "additionalProperties": true }, "mail": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "enum": ["question", "answer", "note", "steer", "result", "stalled", "board", "checkin"] }, "from": { "type": "string" }, "assignment": { "type": "string" }, "body": { "type": "string" }, "replyTo": { "type": "string" }, "result": { "type": "object" }, "redelivered": { "type": "boolean" } }, "required": ["id", "kind", "from", "assignment"], "additionalProperties": true }, "pin": { "type": "object", "properties": { "id": { "type": "string" }, "project": { "type": "string" }, "kind": { "enum": ["claim", "decision", "finding"] }, "body": { "type": "string" }, "paths": { "type": "array", "items": { "type": "string" } }, "agent": { "type": "string" }, "sessionId": { "type": "string" }, "rootId": { "type": "string" }, "at": { "type": "string" }, "released": { "type": "string" }, "task": { "type": "string" } }, "required": ["id", "project", "kind", "body", "agent", "sessionId", "rootId", "at"], "additionalProperties": true }, "question": { "type": "object", "properties": { "id": { "type": "string" }, "sessionId": { "type": "string" }, "rootId": { "type": "string" }, "agent": { "type": "string" }, "body": { "type": "string" }, "options": { "type": "array", "items": { "type": "string" } }, "askedAt": { "type": "string" } }, "required": ["id", "sessionId", "rootId", "agent", "body", "askedAt"], "additionalProperties": true }, "spec": { "type": "object", "properties": { "cwd": { "type": "string" }, "agent": { "type": "string" }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "persist": { "type": "boolean" }, "restore": { "type": "object" } }, "required": ["cwd"], "additionalProperties": true }, "item": { "anyOf": [{ "$ref": "#/$defs/knownItem" }, { "$ref": "#/$defs/unknownItem" }] }, "event": { "anyOf": [{ "$ref": "#/$defs/knownEvent" }, { "$ref": "#/$defs/unknownEvent" }] }, "envelope": { "type": "object", "properties": { "sessionId": { "type": "string" }, "epoch": { "type": "string" }, "seq": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "ts": { "type": "string" }, "event": { "$ref": "#/$defs/event" }, "cursor": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": ["sessionId", "epoch", "seq", "ts", "event"], "additionalProperties": true }, "request": { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }] }, "method": { "type": "string" }, "params": { "type": "object" } }, "required": ["jsonrpc", "method", "id"], "additionalProperties": true }, "response": { "oneOf": [{ "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" }] }, "result": {} }, "required": ["jsonrpc", "id", "result"], "additionalProperties": true }, { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" }] }, "error": { "$ref": "#/$defs/error" } }, "required": ["jsonrpc", "id", "error"], "additionalProperties": true }] }, "notification": { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "method": { "const": "event" }, "params": { "$ref": "#/$defs/envelope" } }, "required": ["jsonrpc", "method", "params"], "additionalProperties": true }, "knownEvent": { "oneOf": [{ "type": "object", "properties": { "type": { "const": "session.opened" }, "session": { "$ref": "#/$defs/session" }, "cwd": { "type": "string" }, "effective": { "type": "object", "properties": { "model": { "type": "string" }, "thinking": { "type": "string" } }, "required": ["model", "thinking"], "additionalProperties": true } }, "required": ["type", "session", "cwd", "effective"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.ready" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.updated" }, "session": { "$ref": "#/$defs/session" } }, "required": ["type", "session"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.closed" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.failed" }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "error"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "prompt.accepted" }, "clientMessageId": { "type": "string" }, "result": { "enum": ["turn", "steer"] }, "turnId": { "type": "string" } }, "required": ["type", "clientMessageId", "result", "turnId"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "prompt.failed" }, "clientMessageId": { "type": "string" }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "clientMessageId", "error"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "turn.started" }, "turnId": { "type": "string" }, "origin": { "enum": ["user", "wake", "assignment", "runtime"] } }, "required": ["type", "turnId", "origin"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "turn.ended" }, "turnId": { "type": "string" }, "state": { "enum": ["completed", "failed", "canceled"] }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "turnId", "state"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "item" }, "item": { "$ref": "#/$defs/item" } }, "required": ["type", "item"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "usage" }, "usage": { "$ref": "#/$defs/usage" } }, "required": ["type", "usage"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "mail" }, "mail": { "$ref": "#/$defs/mail" } }, "required": ["type", "mail"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "assignment" }, "assignment": { "$ref": "#/$defs/assignment" } }, "required": ["type", "assignment"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "question" }, "question": { "$ref": "#/$defs/question" } }, "required": ["type", "question"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "question.resolved" }, "questionId": { "type": "string" }, "outcome": { "enum": ["answered", "dismissed", "timeout", "canceled"] }, "answer": { "type": "string" } }, "required": ["type", "questionId", "outcome"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "pin" }, "pin": { "$ref": "#/$defs/pin" } }, "required": ["type", "pin"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "unpin" }, "pinId": { "type": "string" }, "reason": { "enum": ["unpinned", "session_ended"] } }, "required": ["type", "pinId", "reason"], "additionalProperties": true }] }, "unknownEvent": { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["session.opened", "session.ready", "session.updated", "session.closed", "session.failed", "prompt.accepted", "prompt.failed", "turn.started", "turn.ended", "item", "usage", "mail", "assignment", "question", "question.resolved", "pin", "unpin"] } } }, "required": ["type"], "additionalProperties": true }, "knownItem": { "oneOf": [{ "type": "object", "properties": { "kind": { "const": "user_message" }, "id": { "type": "string" }, "text": { "type": "string" }, "clientMessageId": { "type": "string" }, "images": { "type": "integer", "minimum": 1 } }, "required": ["kind", "id", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "assistant_message" }, "id": { "type": "string" }, "text": { "type": "string" } }, "required": ["kind", "id", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "notice" }, "id": { "type": "string" }, "level": { "enum": ["info", "warning", "error"] }, "text": { "type": "string" } }, "required": ["kind", "id", "level", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "compaction" }, "id": { "type": "string" }, "status": { "enum": ["running", "completed", "failed"] }, "trigger": { "type": "string" }, "preTokens": { "type": "integer" }, "postTokens": { "type": "integer" } }, "required": ["kind", "id", "status"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "todo" }, "id": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "status": { "enum": ["pending", "in_progress", "completed"] } }, "required": ["id", "text", "status"], "additionalProperties": true } } }, "required": ["kind", "id", "items"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "tool_call" }, "id": { "type": "string" }, "callId": { "type": "string" }, "name": { "type": "string" }, "status": { "enum": ["running", "completed", "failed"] }, "error": { "type": "string" }, "detail": { "$ref": "#/$defs/toolCallDetail" } }, "required": ["kind", "id", "callId", "name", "status", "detail"], "additionalProperties": true }] }, "unknownItem": { "type": "object", "properties": { "kind": { "type": "string", "not": { "enum": ["user_message", "assistant_message", "notice", "compaction", "todo", "tool_call"] } }, "id": { "type": "string" } }, "required": ["kind", "id"], "additionalProperties": true }, "toolCallDetail": { "oneOf": [{ "type": "object", "properties": { "type": { "const": "shell" }, "command": { "type": "string" }, "cwd": { "type": "string" }, "output": { "type": "string" }, "exitCode": { "type": ["integer", "null"] } }, "required": ["type", "command", "output"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "read" }, "filePath": { "type": "string" }, "content": { "type": "string" }, "offset": { "type": "integer" }, "limit": { "type": "integer" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "edit" }, "filePath": { "type": "string" }, "oldString": { "type": "string" }, "newString": { "type": "string" }, "unifiedDiff": { "type": "string" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "write" }, "filePath": { "type": "string" }, "content": { "type": "string" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "search" }, "query": { "type": "string" }, "toolName": { "enum": ["search", "grep", "glob", "web_search"] }, "content": { "type": "string" }, "filePaths": { "type": "array", "items": { "type": "string" } }, "webResults": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "url": { "type": "string" } }, "required": ["title", "url"], "additionalProperties": true } }, "numFiles": { "type": "integer" }, "numMatches": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": ["type", "query"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "fetch" }, "url": { "type": "string" }, "prompt": { "type": "string" }, "result": { "type": "string" }, "code": { "type": "integer" } }, "required": ["type", "url"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "sub_agent" }, "subAgentType": { "type": "string" }, "description": { "type": "string" }, "log": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "plan" }, "text": { "type": "string" } }, "required": ["type", "text"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "plain_text" }, "label": { "type": "string" }, "text": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "unknown" }, "input": {}, "output": {} }, "required": ["type", "input", "output"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["shell", "read", "edit", "write", "search", "fetch", "sub_agent", "plan", "plain_text", "unknown"] } } }, "required": ["type"], "additionalProperties": true }] }, "alpError": { "type": "object", "properties": { "message": { "type": "string" }, "code": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "sessionSummary": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "status": { "enum": ["initializing", "idle", "running", "error", "closed"] }, "title": { "type": "string" }, "archived": { "type": "boolean" }, "lastError": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy", "status"], "additionalProperties": true }, "pause": { "type": "object", "properties": { "since": { "type": "string" }, "by": { "type": "string" }, "reason": { "type": "string" }, "resetsAt": { "type": "string" }, "checkedAt": { "type": "string" } }, "required": ["since", "by", "reason"], "additionalProperties": true }, "pauseState": { "type": "object", "properties": { "all": { "$ref": "#/$defs/pause" }, "runtimes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/pause" } }, "parked": { "type": "array", "items": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "type": "string" }, "rootId": { "type": "string" }, "reason": { "type": "string" }, "since": { "type": "string" } }, "required": ["assignmentId", "agent", "runtime", "rootId", "reason", "since"], "additionalProperties": true } } }, "required": ["runtimes", "parked"], "additionalProperties": true }, "preview": { "type": "object", "properties": { "teams": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["id", "label"], "additionalProperties": true } }, "team": { "type": "string" }, "teamLabel": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" } }, "required": ["teams", "team", "agent", "runtime", "model", "mode", "thinking"], "additionalProperties": true }, "treeStatus": { "type": "object", "properties": { "rootId": { "type": "string" }, "sessions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "state": { "enum": ["running", "waiting", "waiting_parent", "waiting_user", "idle"] }, "idleMs": { "type": "number" }, "workdir": { "type": "string" }, "unreadMail": { "type": "integer", "minimum": 0 } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy", "state", "idleMs", "workdir", "unreadMail"], "additionalProperties": true } }, "assignments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "requester": { "type": "string" }, "isolation": { "enum": ["shared", "worktree"] }, "idleMs": { "type": "number" } }, "required": ["id", "requester", "isolation", "idleMs"], "additionalProperties": true } }, "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } }, "worktrees": { "type": "array", "items": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "requester": { "type": "string" }, "agent": { "type": "string" }, "branch": { "type": "string" }, "files": { "type": "array", "items": { "type": "string" } }, "stat": { "type": "string" } }, "required": ["assignmentId", "requester", "agent", "branch", "files", "stat"], "additionalProperties": true } }, "leases": { "type": "array", "items": { "type": "object", "properties": { "checkout": { "type": "string" }, "assignmentId": { "type": "string" }, "agent": { "type": "string" } }, "required": ["checkout", "assignmentId", "agent"], "additionalProperties": true } }, "claims": { "type": "array", "items": { "$ref": "#/$defs/pin" } } }, "required": ["rootId", "sessions", "assignments", "questions", "worktrees", "leases", "claims"], "additionalProperties": true }, "health": { "type": "object", "properties": { "live": { "type": "boolean" }, "ready": { "type": "boolean" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "ok": { "type": "boolean" }, "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["id", "ok"], "additionalProperties": true } } }, "required": ["live", "ready", "checks"], "additionalProperties": true }, "projectRoot": { "type": "string", "minLength": 1, "maxLength": 4096, "description": "An absolute, normalized path on the daemon host to a directory holding .alp/. Compared as is: the daemon never walks up to a parent." }, "taskId": { "type": "string", "pattern": "^t-[0-9a-f]{4,12}(?:\\.\\d+)*$" }, "taskRow": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "title": { "type": "string" }, "type": { "type": "string" }, "priority": { "type": "integer" }, "status": { "enum": ["open", "in_progress", "review", "closed"] }, "rev": { "type": "integer", "minimum": 0 }, "parent": { "type": "string" }, "assignee": { "type": "string" }, "ready": { "type": "boolean" }, "blockedBy": { "type": "array", "items": { "type": "string" } }, "waits": { "type": "array", "items": { "type": "string" } }, "approvals": { "type": "array", "items": { "type": "object", "properties": { "gate": { "type": "string" }, "note": { "type": "string" } }, "required": ["gate", "note"], "additionalProperties": true } }, "handoff": { "type": "object", "properties": { "outcome": { "type": "string" }, "summary": { "type": "string" }, "agent": { "type": "string" } }, "required": ["outcome", "summary"], "additionalProperties": true }, "closed": { "type": "object", "properties": { "reason": { "type": "string" }, "summary": { "type": "string" }, "at": { "type": "string" } }, "required": ["reason", "at"], "additionalProperties": true }, "description": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "paths": { "type": "array", "items": { "type": "string" } }, "progress": { "type": "object", "properties": { "done": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 } }, "required": ["done", "total"], "additionalProperties": true }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": ["id", "title", "type", "priority", "status", "rev", "ready", "updatedAt"], "additionalProperties": true }, "libraryKind": { "enum": ["agents", "skills", "mcp", "hooks", "teams", "providers"] }, "libraryScope": { "enum": ["library", "project"] }, "librarySource": { "enum": ["builtin", "library", "project"] }, "entryName": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.-]+$", "not": { "enum": [".", ".."] } }, "libraryRevision": { "type": ["string", "null"] }, "libraryEntryRow": { "type": "object", "properties": { "name": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "description": { "type": "string" }, "usedBy": { "type": "array", "items": { "type": "string" } } }, "required": ["name", "source"], "additionalProperties": true }, "secretMarker": { "type": "object", "properties": { "$secret": { "const": "keep" } }, "required": ["$secret"], "additionalProperties": false, "description": "Stands for a stored secret value: read results carry it in place of the value; a save that sends it back keeps the stored value." }, "languageSetting": { "type": "object", "properties": { "language": { "type": ["string", "null"] }, "applies": { "type": "string" }, "default": { "type": "string" } }, "required": ["language", "applies", "default"], "additionalProperties": true }, "teamRow": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "error": { "type": "string" } }, "required": ["id", "source"], "additionalProperties": true }, "promptImage": { "type": "object", "properties": { "type": { "const": "image" }, "mimeType": { "enum": ["image/png", "image/jpeg", "image/gif", "image/webp"] }, "data": { "type": "string", "minLength": 4, "maxLength": 6990508, "pattern": "^[A-Za-z0-9+/]+={0,2}$" }, "name": { "type": "string", "maxLength": 255 } }, "required": ["type", "mimeType", "data"], "additionalProperties": false } } };
 
 // packages/protocol/src/validate.js
 var MAX_ISSUES = 8;
@@ -38663,7 +38916,7 @@ var RpcError = class extends Error {
 
 // packages/daemon/src/operations.ts
 import { createHash as createHash10, createHmac, randomBytes as randomBytes6 } from "node:crypto";
-import { lstat as lstat5, stat as stat8 } from "node:fs/promises";
+import { lstat as lstat6, stat as stat8 } from "node:fs/promises";
 import path32 from "node:path";
 
 // packages/core/src/task-rows.js
@@ -38709,8 +38962,8 @@ async function taskRows(projectRoot) {
 }
 
 // packages/core/src/library-edit.js
-import { mkdir as mkdir13, rename as rename6, rm as rm5, stat as stat7, writeFile as writeFile14 } from "node:fs/promises";
-import { createHash as createHash9, randomUUID as randomUUID12 } from "node:crypto";
+import { lstat as lstat5, mkdir as mkdir13, readdir as readdir9, rename as rename7, rm as rm5, stat as stat7, writeFile as writeFile15 } from "node:fs/promises";
+import { createHash as createHash9, randomUUID as randomUUID13 } from "node:crypto";
 import path31 from "node:path";
 var EDIT_KINDS = ["agents", "skills", "mcp", "hooks", "teams", "providers"];
 var validName3 = (name2) => typeof name2 === "string" && /^[\w.-]+$/.test(name2) && name2 !== "." && name2 !== "..";
@@ -38742,6 +38995,42 @@ function base(scope, { root, library }, kind) {
   return fail5("INVALID_SCOPE", `Scope must be library or project, not '${scope}'`);
 }
 var revisionOf = (content) => content === void 0 ? null : createHash9("sha256").update(JSON.stringify(content)).digest("hex").slice(0, 16);
+function assertProjectDataContent(kind, content) {
+  const deny = () => fail5("UNSAFE_LIBRARY_WRITE", "Project-data writes allow only instruction entries and non-executable agent configuration");
+  if (!object8(content) || !["agents", "skills"].includes(kind)) deny();
+  const keys2 = kind === "skills" ? ["body"] : ["instructions", "config"];
+  if (Object.keys(content).some((key2) => !keys2.includes(key2))) deny();
+  const text2 = kind === "skills" ? content.body : content.instructions;
+  if (typeof text2 !== "string" || !text2.trim()) deny();
+  if (content.config !== void 0) {
+    const config2 = content.config;
+    if (!object8(config2)) deny();
+    const allowed = ["description", "model", "thinking", "context", "autocompact"];
+    if (Object.keys(config2).some((key2) => !allowed.includes(key2))) deny();
+    for (const key2 of ["description", "thinking"]) if (config2[key2] !== void 0 && typeof config2[key2] !== "string") deny();
+    if (config2.model !== void 0 && (typeof config2.model !== "string" || !/^(codex|claude):[^\s/\\:]{1,240}$/.test(config2.model))) deny();
+    for (const key2 of ["context", "autocompact"]) if (config2[key2] !== void 0 && !(typeof config2[key2] === "string" || typeof config2[key2] === "number" && Number.isFinite(config2[key2]))) deny();
+  }
+}
+async function projectDataEntry(kind, name2, { scope, root, library, templates }) {
+  if (scope !== "project" || !root || !["agents", "skills"].includes(kind)) fail5("UNSAFE_LIBRARY_WRITE", "Project-data writes require project scope and agents or skills");
+  nameOf(name2);
+  const directory = base(scope, { root, library }, kind);
+  await safeEntryPaths(directory, kind, name2);
+  const found = await layers(kind, name2, { root, library, templates });
+  if (found.library !== void 0 || found.builtin !== void 0) fail5("UNSAFE_LIBRARY_WRITE", "Project-data writes cannot shadow or reveal a library or built-in entry");
+  if (found.project !== void 0) assertProjectDataContent(kind, found.project);
+  const owned = path31.join(directory, kind, name2);
+  const files = await readdir9(owned).catch((error51) => {
+    if (error51.code === "ENOENT") return [];
+    throw error51;
+  });
+  const allowed = new Set(FILES[kind](name2).map(([file3]) => path31.basename(file3)));
+  for (const file3 of files) {
+    const info = await lstat5(path31.join(owned, file3));
+    if (!allowed.has(file3) || !info.isFile() || info.isSymbolicLink() || info.nlink !== 1) fail5("UNSAFE_LIBRARY_WRITE", "Project-data entries cannot contain sidecars, links or executable assets");
+  }
+}
 async function safeEntryPaths(directory, kind, name2) {
   for (const [file3] of FILES[kind](name2)) {
     await assertNoSymlinks(directory, path31.join(kind, file3));
@@ -38934,14 +39223,18 @@ async function check3(kind, name2, content, { scope, root, library, templates })
 }
 async function writeAtomic2(file3, text2) {
   await mkdir13(path31.dirname(file3), { recursive: true });
-  const temporary = `${file3}.${randomUUID12().slice(0, 8)}.tmp`;
-  await writeFile14(temporary, text2);
+  const temporary = `${file3}.${randomUUID13().slice(0, 8)}.tmp`;
+  await writeFile15(temporary, text2);
   await moveFile(temporary, file3);
 }
 var exists2 = (target) => stat7(target).then(() => true, () => false);
-async function saveEntry(kind, name2, content, { scope, root, library, templates, revision } = {}) {
+async function saveEntry(kind, name2, content, { scope, root, library, templates, revision, policy } = {}) {
   kindOf(kind);
   nameOf(name2);
+  if (policy === "project-data") {
+    assertProjectDataContent(kind, content);
+    await projectDataEntry(kind, name2, { scope, root, library, templates });
+  }
   const directory = base(scope, { root, library }, kind);
   await safeEntryPaths(directory, kind, name2);
   await check3(kind, name2, content, { scope, root, library, templates });
@@ -38963,9 +39256,10 @@ async function saveEntry(kind, name2, content, { scope, root, library, templates
   }
   return { revision: revisionOf(await readLayer(kind, name2, directory)) };
 }
-async function deleteEntry(kind, name2, { scope, root, library, templates, revision } = {}) {
+async function deleteEntry(kind, name2, { scope, root, library, templates, revision, policy } = {}) {
   kindOf(kind);
   nameOf(name2);
+  if (policy === "project-data") await projectDataEntry(kind, name2, { scope, root, library, templates });
   const directory = base(scope, { root, library }, kind);
   const current = await readLayer(kind, name2, directory);
   if (current === void 0) fail5("NOT_FOUND", `No ${kind} entry '${name2}' in the ${scope}`);
@@ -38981,14 +39275,25 @@ async function deleteEntry(kind, name2, { scope, root, library, templates, revis
   const now2 = scope === "project" && found.library !== void 0 ? "library" : "builtin";
   return { removed: true, ...fallback !== void 0 ? { now: now2 } : {} };
 }
-async function duplicateEntry(kind, from, to, { scope, root, library, templates } = {}) {
+async function duplicateEntry(kind, from, to, { scope, root, library, templates, policy } = {}) {
+  kindOf(kind);
+  nameOf(from);
+  nameOf(to);
+  if (policy === "project-data") {
+    await projectDataEntry(kind, from, { scope, root, library, templates });
+    await projectDataEntry(kind, to, { scope, root, library, templates });
+  }
   const { content } = await getEntry(kind, from, { root, library, templates });
-  return saveEntry(kind, to, structuredClone(content), { scope, root, library, templates, revision: null });
+  return saveEntry(kind, to, structuredClone(content), { scope, root, library, templates, revision: null, policy });
 }
-async function renameEntry(kind, from, to, { scope, root, library, templates } = {}) {
+async function renameEntry(kind, from, to, { scope, root, library, templates, policy } = {}) {
   kindOf(kind);
   nameOf(from);
   nameOf(to);
+  if (policy === "project-data") {
+    await projectDataEntry(kind, from, { scope, root, library, templates });
+    await projectDataEntry(kind, to, { scope, root, library, templates });
+  }
   const directory = base(scope, { root, library }, kind);
   const content = await readLayer(kind, from, directory);
   if (content === void 0) fail5("NOT_FOUND", `No ${kind} entry '${from}' in the ${scope}`);
@@ -38998,9 +39303,9 @@ async function renameEntry(kind, from, to, { scope, root, library, templates } =
   await check3(kind, to, content, { scope, root, library, templates });
   if (ownDirectory(kind)) {
     if (await exists2(path31.join(directory, kind, to))) fail5("REVISION_CONFLICT", `${path31.join(directory, kind, to)} already exists`);
-    await rename6(path31.join(directory, kind, from), path31.join(directory, kind, to));
+    await rename7(path31.join(directory, kind, from), path31.join(directory, kind, to));
   } else {
-    await rename6(path31.join(directory, kind, `${from}.json`), path31.join(directory, kind, `${to}.json`));
+    await rename7(path31.join(directory, kind, `${from}.json`), path31.join(directory, kind, `${to}.json`));
   }
   return { revision: revisionOf(await readLayer(kind, to, directory)) };
 }
@@ -39019,6 +39324,8 @@ function fromCore(error51, context = {}) {
   if (error51 instanceof RpcError || typeof error51?.code !== "string" || error51?.name !== "AlpError") return error51;
   const message = error51.message;
   switch (error51.code) {
+    case "UNSAFE_LIBRARY_WRITE":
+      return failure(ERROR.forbidden, "library_policy", message);
     case "UNSAFE_PATH":
       return failure(ERROR.forbidden, "unsafe_path", message);
     case "TASK_NOT_FOUND":
@@ -39108,7 +39415,7 @@ function createOperations({ home: home2, templates, knownProjects = () => [] } =
   async function project(value) {
     if (!path32.isAbsolute(value) || path32.resolve(value) !== value) throw failure(RPC_ERROR.invalidParams, "invalid_path", "projectRoot must be an absolute, normalized path");
     if (!(await stat8(value).catch(() => void 0))?.isDirectory()) throw failure(ERROR.notFound, "not_alp_project", `${value} is not a directory`);
-    const alp = await lstat5(path32.join(value, ".alp")).catch(() => void 0);
+    const alp = await lstat6(path32.join(value, ".alp")).catch(() => void 0);
     if (alp?.isSymbolicLink()) throw failure(ERROR.forbidden, "unsafe_path", `${path32.join(value, ".alp")} is a symlink`);
     if (!alp?.isDirectory()) throw failure(ERROR.notFound, "not_alp_project", `${value} is not an ALP project; run alp init there`);
     return value;
@@ -39194,7 +39501,8 @@ function createOperations({ home: home2, templates, knownProjects = () => [] } =
       const { content, secrets } = redact2(kind, entry.content);
       return { ...entry, content, revision: toWire(entry.revision), ...secrets.length ? { secrets } : {} };
     }),
-    "library.save": guard(({ kind, name: name2, scope, projectRoot, content, revision, sync = "none" }) => serial(async () => {
+    "library.save": guard(({ kind, name: name2, scope, projectRoot, content, revision, policy, sync = "none" }) => serial(async () => {
+      if (policy === "project-data" && sync !== "none") throw failure(ERROR.forbidden, "library_policy", "Project-data writes cannot synchronize projects");
       const options2 = await where(projectRoot, scope);
       const current = await layer(kind, name2, options2, scope);
       if (revision !== void 0 && revision !== toWire(current?.revision ?? null)) {
@@ -39202,7 +39510,7 @@ function createOperations({ home: home2, templates, knownProjects = () => [] } =
       }
       const previous = current?.content ?? (await layer(kind, name2, options2))?.content;
       const next = unredact(kind, content, previous);
-      const saved = await saveEntry(kind, name2, next, { ...options2, scope, ...revision !== void 0 ? { revision: current?.revision ?? null } : {} });
+      const saved = await saveEntry(kind, name2, next, { ...options2, scope, policy, ...revision !== void 0 ? { revision: current?.revision ?? null } : {} });
       if (kind !== "teams" || sync !== "known-projects") return { revision: toWire(saved.revision) };
       const roots = new Set(options2.root ? [options2.root] : []);
       if (scope === "library") {
@@ -39219,25 +39527,25 @@ function createOperations({ home: home2, templates, knownProjects = () => [] } =
       }
       return { revision: toWire(saved.revision), syncedProjects, syncErrors };
     }), { notFound: "invalid_entry" }),
-    "library.delete": guard(({ kind, name: name2, scope, projectRoot, revision }) => serial(async () => {
+    "library.delete": guard(({ kind, name: name2, scope, projectRoot, revision, policy }) => serial(async () => {
       const options2 = await where(projectRoot, scope);
       const current = await layer(kind, name2, options2, scope);
       if (!current) throw failure(ERROR.notFound, "not_found", `No ${kind} entry '${name2}' in the ${scope}`);
       if (revision !== void 0 && revision !== toWire(current.revision)) throw failure(ERROR.conflict, "revision_conflict", `${kind} '${name2}' changed in the ${scope} since you opened it`);
-      return deleteEntry(kind, name2, { ...options2, scope, ...revision !== void 0 ? { revision: current.revision } : {} });
+      return deleteEntry(kind, name2, { ...options2, scope, policy, ...revision !== void 0 ? { revision: current.revision } : {} });
     })),
-    "library.duplicate": guard(({ kind, from, to, scope, projectRoot }) => serial(async () => {
+    "library.duplicate": guard(({ kind, from, to, scope, projectRoot, policy }) => serial(async () => {
       const options2 = await where(projectRoot, scope);
       try {
         await getEntry(kind, from, options2);
       } catch (error51) {
         throw fromCore(error51, { notFound: "not_found" });
       }
-      return { revision: toWire((await duplicateEntry(kind, from, to, { ...options2, scope })).revision) };
+      return { revision: toWire((await duplicateEntry(kind, from, to, { ...options2, scope, policy })).revision) };
     }), { notFound: "invalid_entry" }),
-    "library.rename": guard(({ kind, from, to, scope, projectRoot }) => serial(async () => {
+    "library.rename": guard(({ kind, from, to, scope, projectRoot, policy }) => serial(async () => {
       const options2 = await where(projectRoot, scope);
-      return { revision: toWire((await renameEntry(kind, from, to, { ...options2, scope })).revision) };
+      return { revision: toWire((await renameEntry(kind, from, to, { ...options2, scope, policy })).revision) };
     })),
     "library.skills.set": guard(({ agent, skills }) => serial(() => setGivenSkills(agent, skills, { library: home2 })), { notFound: "invalid_entry" }),
     "library.models": guard(async () => {
@@ -39258,13 +39566,13 @@ function createOperations({ home: home2, templates, knownProjects = () => [] } =
   const library = home2 !== void 0;
   return {
     handlers: { ...taskHandlers, ...library ? libraryHandlers : {} },
-    capabilities: [CAPABILITY.task, ...library ? [CAPABILITY.team, CAPABILITY.library, CAPABILITY.settingsLanguage] : []]
+    capabilities: [CAPABILITY.task, ...library ? [CAPABILITY.team, CAPABILITY.library, CAPABILITY.libraryProjectWrite, CAPABILITY.settingsLanguage] : []]
   };
 }
 
 // packages/daemon/src/files.ts
 import { constants as constants3 } from "node:fs";
-import { lstat as lstat6, open as open4, opendir, realpath as realpath5, stat as stat9 } from "node:fs/promises";
+import { lstat as lstat7, open as open4, opendir, realpath as realpath5, stat as stat9 } from "node:fs/promises";
 import path34 from "node:path";
 
 // packages/daemon/src/gitignore.ts
@@ -39367,7 +39675,8 @@ function hasGitEntry(root) {
     try {
       lstatSync2(path33.join(directory, ".git"));
       return true;
-    } catch {
+    } catch (error51) {
+      if (error51.code !== "ENOENT") throw new IgnoreUnknown("cannot examine .git");
     }
     if (path33.dirname(directory) === directory) return false;
   }
@@ -39463,22 +39772,34 @@ function check4(git2, root, paths, deadline, timeoutMs) {
       if (err.length < GIT_CHECK.maxErrorBytes) err += chunk.toString("utf8");
     });
     child.on("error", (error51) => finish(() => {
-      if (error51.code === "ENOENT") resolve2(null);
-      else reject(new IgnoreUnknown(error51.message));
+      reject(new IgnoreUnknown(error51.message));
     }));
     child.on("close", (code) => finish(() => {
       if (code === 128 && /not a git repository/i.test(err)) {
-        if (hasGitEntry(root)) reject(new IgnoreUnknown("a .git Git cannot use"));
-        else resolve2(null);
+        try {
+          if (hasGitEntry(root)) reject(new IgnoreUnknown("a .git Git cannot use"));
+          else resolve2(null);
+        } catch (error51) {
+          reject(error51);
+        }
         return;
       }
       if (code !== 0 && code !== 1) {
         reject(new IgnoreUnknown(`exit ${code}`));
         return;
       }
+      if (err.length || code === 1 && outBytes || code === 0 && !outBytes) {
+        reject(new IgnoreUnknown("inconsistent exit status or diagnostics"));
+        return;
+      }
+      const output = Buffer.concat(out).toString("utf8");
+      if (outBytes && !output.endsWith("\0")) {
+        reject(new IgnoreUnknown("unterminated answer"));
+        return;
+      }
       const asked = new Set(paths);
       const ignored = /* @__PURE__ */ new Set();
-      for (const entry of Buffer.concat(out).toString("utf8").split("\0")) {
+      for (const entry of output.split("\0")) {
         if (!entry) continue;
         const relative = entry.startsWith("./") ? entry.slice(2) : void 0;
         if (relative === void 0 || !asked.has(relative)) {
@@ -39511,7 +39832,7 @@ var HIDDEN_DIRECTORIES = /* @__PURE__ */ new Set([".agents", ".alp", ".claude",
 var IGNORED_DIRECTORIES = /* @__PURE__ */ new Set(["node_modules", "venv", "env", "virtualenv", "dist", "build", "target", "out", "coverage", "vendor", "__pycache__", ".git"]);
 var NONE = Number.MAX_SAFE_INTEGER;
 async function identity2(directory) {
-  const info = await lstat6(directory, { bigint: true });
+  const info = await lstat7(directory, { bigint: true });
   if (!info.isDirectory() || await realpath5(directory) !== directory) return null;
   return `${info.dev}:${info.ino}`;
 }
@@ -39552,7 +39873,7 @@ function rank2(relative, query) {
 var compare = (a, b) => a.tier - b.tier || a.segment - b.segment || a.offset - b.offset || a.fuzzy - b.fuzzy || a.depth - b.depth || (a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
 var FilesError = class extends Error {
 };
-async function searchWorkspaceFiles(projectRoot, { query = "", limit = LIMITS.defaultLimit, now: now2 = Date.now } = {}) {
+async function searchWorkspaceFiles(projectRoot, { query = "", limit = LIMITS.defaultLimit, now: now2 = Date.now, git: git2 } = {}) {
   if (!path34.isAbsolute(projectRoot)) throw new FilesError("projectRoot must be an absolute path");
   let root;
   try {
@@ -39564,12 +39885,14 @@ async function searchWorkspaceFiles(projectRoot, { query = "", limit = LIMITS.de
   const wanted = query.trim().replace(/\\/g, "/").replace(/^\.?\/+/, "").toLowerCase();
   const count = Math.max(1, Math.min(LIMITS.maxLimit, Math.trunc(limit)));
   const deadline = now2() + LIMITS.ms;
+  const realDeadline = Date.now() + LIMITS.ms;
   const found = [];
   let scanned = 0;
   let truncated = false;
   let level = [""];
   for (let depth = 0; level.length && !truncated; depth++) {
     const next = [];
+    const levelFiles = [];
     for (const relative of level) {
       if (scanned >= LIMITS.scanned || now2() > deadline) {
         truncated = true;
@@ -39588,6 +39911,7 @@ async function searchWorkspaceFiles(projectRoot, { query = "", limit = LIMITS.de
           }
           const name2 = entry.name;
           const child = relative ? `${relative}/${name2}` : name2;
+          if (name2.includes("\\") || blockedFilePath(child)) continue;
           if (entry.isFile()) {
             if (name2.startsWith(".")) continue;
             const ranked = rank2(child, wanted);
@@ -39601,11 +39925,27 @@ async function searchWorkspaceFiles(projectRoot, { query = "", limit = LIMITS.de
       } catch {
         continue;
       }
-      found.push(...files);
+      levelFiles.push(...files);
       next.push(...directories2);
       if (truncated) break;
     }
-    level = next;
+    const remaining = Math.min(deadline - now2(), realDeadline - Date.now());
+    if (remaining <= 0) {
+      truncated = true;
+      break;
+    }
+    let ignored;
+    try {
+      ignored = await gitIgnored(root, [...levelFiles.map((file3) => file3.path), ...next], {
+        ...git2,
+        timeoutMs: Math.min(git2?.timeoutMs ?? GIT_CHECK.timeoutMs, remaining)
+      });
+    } catch (error51) {
+      if (!(error51 instanceof IgnoreUnknown)) throw error51;
+      return { files: [], truncated: true };
+    }
+    found.push(...levelFiles.filter((file3) => !ignored?.has(file3.path)));
+    level = next.filter((directory) => !ignored?.has(directory));
   }
   found.sort(compare);
   return { files: found.slice(0, count).map((entry) => ({ path: entry.path })), ...truncated ? { truncated: true } : {} };
@@ -39652,7 +39992,7 @@ async function directoryChain(root, segments, relative) {
 async function directoryIdentity(directory, relative) {
   let info;
   try {
-    info = await lstat6(directory, { bigint: true });
+    info = await lstat7(directory, { bigint: true });
   } catch {
     throw notFound(relative);
   }
@@ -39688,7 +40028,7 @@ async function ignoredOf(root, paths, git2) {
   }
 }
 async function readConfined(file3, maxBytes, probe) {
-  const before = await lstat6(file3, { bigint: true });
+  const before = await lstat7(file3, { bigint: true });
   if (before.isSymbolicLink()) throw Object.assign(new Error("link"), { linked: true });
   if (!before.isFile()) throw new Error("not a file");
   if (before.nlink > 1n) throw Object.assign(new Error("hard link"), { linked: true });
@@ -39714,7 +40054,7 @@ async function readConfined(file3, maxBytes, probe) {
     }
     if (length > maxBytes) return void 0;
     await probe?.("read");
-    const after = await lstat6(file3, { bigint: true });
+    const after = await lstat7(file3, { bigint: true });
     if (after.dev !== before.dev || after.ino !== before.ino) throw Object.assign(new Error("changed"), { linked: true });
     return { bytes: buffer.subarray(0, length), modifiedAt: opened.mtime };
   } finally {
@@ -39771,7 +40111,7 @@ async function listWorkspaceDirectory(projectRoot, { path: relative, includeIgno
     }
     let info;
     try {
-      info = await lstat6(path34.join(directory, name2));
+      info = await lstat7(path34.join(directory, name2));
     } catch {
       continue;
     }
@@ -39912,13 +40252,19 @@ function createDaemonServer({ runtime, socketPath, version: version2, onShutdown
     if (event.type === "session.opened") {
       record3 ??= { version: 1, id: sessionId, rootId: root, status: "initializing", createdAt: now2, updatedAt: now2 };
       const usage = event.session.usage ?? record3.session?.usage;
-      save2(record3, { rootId: root, session: { ...event.session, ...usage ? { usage } : {} }, status: "idle", lastError: void 0, activeTurnId: void 0 });
+      const parked = recovering.has(root) ? record3.session?.parked : event.session.parked;
+      save2(record3, { rootId: root, session: { ...event.session, ...usage ? { usage } : {}, ...parked ? { parked } : {} }, status: "idle", lastError: void 0, activeTurnId: void 0 });
       return false;
     }
     if (!record3) return false;
     if (event.type === "session.updated") save2(record3, { session: { ...record3.session, ...event.session, ...event.session.parked ? {} : { parked: void 0 } } });
     else if (event.type === "turn.started") save2(record3, { status: "running", activeTurnId: event.turnId, archived: void 0 });
-    else if (event.type === "turn.ended") save2(record3, { status: "idle", activeTurnId: void 0, ...event.state === "failed" ? { lastError: { message: event.error?.message ?? "Turn failed" } } : {} });
+    else if (event.type === "turn.ended") save2(record3, {
+      status: "idle",
+      activeTurnId: void 0,
+      ...record3.session ? { session: { ...record3.session, parked: event.state === "failed" ? runtime.snapshot(sessionId)?.parked : void 0 } } : {},
+      ...event.state === "failed" ? { lastError: { message: event.error?.message ?? "Turn failed" } } : {}
+    });
     else if (event.type === "usage" && record3.session) record3.session = { ...record3.session, usage: event.usage };
     else if (event.type === "session.failed") save2(record3, { status: "error", lastError: event.error });
     else if (event.type === "session.closed") save2(record3, { status: record3.status === "error" ? "error" : "closed", activeTurnId: void 0 });
@@ -39983,7 +40329,7 @@ function createDaemonServer({ runtime, socketPath, version: version2, onShutdown
     for (const [root, tree] of byRoot) {
       const head = tree.find((record3) => record3.id === root);
       if (removed.has(root)) continue;
-      if (head && resumable(head) && (head.status === "running" || tree.some((record3) => continuing.has(record3.id)))) reopen.push({ record: head, working: head.status === "running" });
+      if (head && resumable(head) && (head.status === "running" || head.status === "idle" && head.session?.parked || tree.some((record3) => continuing.has(record3.id)))) reopen.push({ record: head, working: head.status === "running" });
       if (tree.some((record3) => LIVE.includes(record3.status))) seen(root, await store2.timeline(root));
       for (const record3 of tree) {
         records.set(record3.id, record3);
@@ -39991,7 +40337,7 @@ function createDaemonServer({ runtime, socketPath, version: version2, onShutdown
         const envelope = (event) => ({ sessionId: record3.id, epoch, seq: 0, ts: (/* @__PURE__ */ new Date()).toISOString(), event });
         if (record3.activeTurnId) keep(root, envelope({ type: "turn.ended", turnId: record3.activeTurnId, state: "failed", error: { message: ended.message, code: ended.code } }));
         if (record3.id === root) {
-          save2(record3, record3.status === "idle" ? { status: "closed", activeTurnId: void 0 } : { status: "error", lastError: ended, activeTurnId: void 0 });
+          if (!(record3.status === "idle" && record3.session?.parked)) save2(record3, record3.status === "idle" ? { status: "closed", activeTurnId: void 0 } : { status: "error", lastError: ended, activeTurnId: void 0 });
         } else if (continuing.has(record3.id) && reopen.some((entry) => entry.record.id === root)) {
           save2(record3, { status: "closed", activeTurnId: void 0 });
         } else {
@@ -40086,7 +40432,7 @@ function createDaemonServer({ runtime, socketPath, version: version2, onShutdown
         persist: true,
         restore: { agent: session.agent, threadId: session.threadId, runtime: session.runtime, model: session.model, workflow: session.workflow }
       }, { history: "skip", delegation: record3.delegation ?? true });
-      const outcomes = await runtime.recover(record3.id, { continueRoot: working });
+      const outcomes = await runtime.recover(record3.id, { continueRoot: working, parkedRoot: session.parked });
       recoveryLog.info(`recovered ${record3.id}: ${outcomes.map((outcome) => `${outcome.agent} ${outcome.outcome}`).join(", ") || "root"}`, { event: "recovered", sessionId: record3.id, rootId: record3.rootId });
     } catch (error51) {
       recoveryLog.error(`could not recover ${record3.id}`, { code: "ALP_RECOVERY_FAILED", sessionId: record3.id, rootId: record3.rootId, error: error51 });
@@ -40809,7 +41155,7 @@ ${session.id}`.toLowerCase().includes(word))).sort((a, b) => listCursor.compare(
     async listen() {
       if (process.platform !== "win32") {
         await assertPrivateDirectory(path35.dirname(socketPath), { create: true });
-        const existing = await lstat7(socketPath).catch((error51) => {
+        const existing = await lstat8(socketPath).catch((error51) => {
           if (error51.code === "ENOENT") return void 0;
           throw error51;
         });
@@ -40848,8 +41194,8 @@ ${session.id}`.toLowerCase().includes(word))).sort((a, b) => listCursor.compare(
       if (process.platform !== "win32") {
         try {
           await chmod(bindPath, 384);
-          const info = await lstat7(bindPath);
-          await rename7(bindPath, socketPath);
+          const info = await lstat8(bindPath);
+          await rename8(bindPath, socketPath);
           socketIdentity = { dev: info.dev, ino: info.ino };
         } catch (error51) {
           await new Promise((resolve2) => server.close(() => resolve2()));
@@ -40932,7 +41278,7 @@ ${session.id}`.toLowerCase().includes(word))).sort((a, b) => listCursor.compare(
       for (const connection of connections) connection.socket?.destroy();
       await stopped;
       if (socketIdentity) {
-        const current2 = await lstat7(socketPath).catch((error51) => {
+        const current2 = await lstat8(socketPath).catch((error51) => {
           if (error51.code === "ENOENT") return void 0;
           throw error51;
         });
@@ -40945,14 +41291,14 @@ ${session.id}`.toLowerCase().includes(word))).sort((a, b) => listCursor.compare(
 }
 
 // packages/daemon/src/lock.ts
-import { unlink as unlink5, utimes, writeFile as writeFile15, rename as rename8 } from "node:fs/promises";
+import { unlink as unlink5, utimes, writeFile as writeFile16, rename as rename9 } from "node:fs/promises";
 async function acquireLock(home2, contents) {
   return acquireDaemonLock(home2, contents);
 }
 async function replaceFile(temporary, file3) {
   for (let attempt = 0; ; attempt++) {
     try {
-      return await rename8(temporary, file3);
+      return await rename9(temporary, file3);
     } catch (error51) {
       if (process.platform !== "win32" || attempt >= 20 || !["EPERM", "EACCES", "EBUSY"].includes(error51?.code)) throw error51;
       await new Promise((resolve2) => setTimeout(resolve2, 10 + attempt * 10));
@@ -40962,7 +41308,7 @@ async function replaceFile(temporary, file3) {
 async function updateLock(home2, lock) {
   const file3 = daemonPaths(home2).lock;
   const temporary = `${file3}.${process.pid}.tmp`;
-  await writeFile15(temporary, JSON.stringify(lock), { mode: 384 });
+  await writeFile16(temporary, JSON.stringify(lock), { mode: 384 });
   await replaceFile(temporary, file3);
 }
 async function heartbeat(home2) {
@@ -40980,7 +41326,7 @@ async function releaseLock(home2) {
 }
 
 // packages/daemon/src/store.ts
-import { appendFile as appendFile4, mkdir as mkdir15, open as open5, readdir as readdir8, readFile as readFile20, rm as rm6, stat as stat10, writeFile as writeFile16 } from "node:fs/promises";
+import { appendFile as appendFile4, mkdir as mkdir15, open as open5, readdir as readdir10, readFile as readFile20, rm as rm6, stat as stat10, writeFile as writeFile17 } from "node:fs/promises";
 import { randomBytes as randomBytes8 } from "node:crypto";
 import path36 from "node:path";
 var log3 = createLogger({ component: "store" });
@@ -41009,7 +41355,7 @@ function createStore(root) {
   async function writeAtomic3(file3, body) {
     const temporary = `${file3}.${process.pid}.${randomBytes8(4).toString("hex")}.tmp`;
     try {
-      await writeFile16(temporary, body, { mode: 384 });
+      await writeFile17(temporary, body, { mode: 384 });
       await replaceFile(temporary, file3);
     } catch (error51) {
       await rm6(temporary, { force: true }).catch(() => {
@@ -41126,7 +41472,7 @@ function createStore(root) {
     async receipts() {
       await prepare2();
       const found = [];
-      for (const name2 of await readdir8(receiptsDir)) {
+      for (const name2 of await readdir10(receiptsDir)) {
         if (!name2.endsWith(".json")) continue;
         const key2 = name2.slice(0, -".json".length);
         try {
@@ -41152,7 +41498,7 @@ function createStore(root) {
       await prepare2();
       const now2 = Date.now();
       for (const directory of [sessionsDir, receiptsDir]) {
-        for (const name2 of await readdir8(directory)) {
+        for (const name2 of await readdir10(directory)) {
           const file3 = path36.join(directory, name2);
           if (name2.endsWith(".tmp")) {
             if (temporaries) await rm6(file3, { force: true });
@@ -41167,7 +41513,7 @@ function createStore(root) {
     async list() {
       await prepare2();
       const records = [];
-      for (const name2 of await readdir8(sessionsDir)) {
+      for (const name2 of await readdir10(sessionsDir)) {
         if (!name2.endsWith(".json")) continue;
         try {
           const record3 = JSON.parse(await readFile20(path36.join(sessionsDir, name2), "utf8"));
@@ -41219,7 +41565,7 @@ function createStore(root) {
       let step = "write";
       try {
         await prepare2();
-        await writeFile16(file3, token, { mode: 384 });
+        await writeFile17(file3, token, { mode: 384 });
         step = "read";
         if (await readFile20(file3, "utf8") !== token) throw new Error("what was written is not what was read back");
         return { ok: true };
@@ -41257,7 +41603,7 @@ function createStore(root) {
 // packages/core/src/backup.js
 import { createHash as createHash12, randomBytes as randomBytes9 } from "node:crypto";
 import { createReadStream, createWriteStream } from "node:fs";
-import { chmod as chmod2, lstat as lstat8, mkdir as mkdir17, open as open6, readdir as readdir10, readFile as readFile22, readlink as readlink2, rm as rm7, rmdir as rmdir2, stat as stat11, symlink as symlink2, utimes as utimes2 } from "node:fs/promises";
+import { chmod as chmod2, lstat as lstat9, mkdir as mkdir17, open as open6, readdir as readdir12, readFile as readFile22, readlink as readlink2, rm as rm7, rmdir as rmdir3, stat as stat11, symlink as symlink2, utimes as utimes2 } from "node:fs/promises";
 import path38 from "node:path";
 import { Readable } from "node:stream";
 import { StringDecoder } from "node:string_decoder";
@@ -41265,7 +41611,7 @@ import { pipeline } from "node:stream/promises";
 import { createGunzip, createGzip } from "node:zlib";
 
 // packages/core/src/state-schema.js
-import { readdir as readdir9, readFile as readFile21, mkdir as mkdir16 } from "node:fs/promises";
+import { readdir as readdir11, readFile as readFile21, mkdir as mkdir16 } from "node:fs/promises";
 import path37 from "node:path";
 var STATE_SCHEMA = 2;
 var stateDir = (home2) => path37.join(home2, "state");
@@ -41279,7 +41625,7 @@ async function readStateSchema(home2) {
   } catch (error51) {
     if (error51?.code !== "ENOENT") throw error51;
     for (const name2 of DATA) {
-      const entries2 = await readdir9(path37.join(stateDir(home2), name2)).catch((error52) => {
+      const entries2 = await readdir11(path37.join(stateDir(home2), name2)).catch((error52) => {
         if (error52?.code === "ENOENT") return [];
         throw error52;
       });
@@ -41336,7 +41682,7 @@ var transient = (name2) => name2.endsWith(".tmp") || name2 === ".lock" || /\.pre
 var backupsDir = (home2) => path38.join(home2, "backups");
 var journalFile = (home2) => path38.join(home2, JOURNAL);
 var stamp2 = () => (/* @__PURE__ */ new Date()).toISOString().replace(/[-:]/g, "").replace(/\.\d+Z$/, "Z");
-var exists3 = (file3) => lstat8(file3).then(() => true, () => false);
+var exists3 = (file3) => lstat9(file3).then(() => true, () => false);
 var invalid = (message, options2) => new AlpError("BACKUP_INVALID", message, options2);
 function safeRelative(value) {
   return typeof value === "string" && value.length > 0 && value.length < 4096 && !value.startsWith("/") && !/^[A-Za-z]:/.test(value) && !value.includes("\\") && !value.includes("\0") && value.split("/").every((part) => part && part !== "." && part !== "..");
@@ -41344,7 +41690,7 @@ function safeRelative(value) {
 async function sessionRecords(home2) {
   const directory = path38.join(home2, "state", "sessions");
   const records = [];
-  for (const name2 of await readdir10(directory).catch(() => [])) {
+  for (const name2 of await readdir12(directory).catch(() => [])) {
     if (!name2.endsWith(".json")) continue;
     try {
       records.push(JSON.parse(await readFile22(path38.join(directory, name2), "utf8")));
@@ -41363,7 +41709,7 @@ async function externalReferences(home2) {
 }
 async function* unitEntries(base2, unit) {
   const full = path38.join(base2, unit);
-  const info = await lstat8(full).catch((error51) => {
+  const info = await lstat9(full).catch((error51) => {
     if (error51?.code === "ENOENT") return void 0;
     throw error51;
   });
@@ -41373,9 +41719,9 @@ async function* unitEntries(base2, unit) {
     if (info2.isSymbolicLink()) yield { t: "link", path: relative, target: await readlink2(file3) };
     else if (info2.isDirectory()) {
       yield { t: "dir", path: relative, mode: info2.mode & 511 };
-      for (const name2 of (await readdir10(file3)).sort()) {
+      for (const name2 of (await readdir12(file3)).sort()) {
         if (transient(name2)) continue;
-        const child = await lstat8(path38.join(file3, name2)).catch(() => void 0);
+        const child = await lstat9(path38.join(file3, name2)).catch(() => void 0);
         if (child) yield* walk(`${relative}/${name2}`, child);
       }
     } else if (info2.isFile()) yield { t: "file", path: relative, mode: info2.mode & 511, file: file3 };
@@ -41383,7 +41729,7 @@ async function* unitEntries(base2, unit) {
   yield* walk(unit, info);
 }
 async function unitKind(base2, unit) {
-  const info = await lstat8(path38.join(base2, unit)).catch((error51) => {
+  const info = await lstat9(path38.join(base2, unit)).catch((error51) => {
     if (error51?.code === "ENOENT") return void 0;
     throw error51;
   });
@@ -41459,7 +41805,7 @@ async function automaticBackup(home2, kind, { units = HOME_UNITS, projects = [],
   const out = path38.join(directory, `${kind}-${stamp2()}-${randomBytes9(2).toString("hex")}${BACKUP_EXTENSION}`);
   await createBackup({ home: home2, out, units, projects, by, kind });
   const prefix = `${kind}-`;
-  const same2 = (await readdir10(directory)).filter((name2) => name2.startsWith(prefix) && name2.endsWith(BACKUP_EXTENSION)).sort();
+  const same2 = (await readdir12(directory)).filter((name2) => name2.startsWith(prefix) && name2.endsWith(BACKUP_EXTENSION)).sort();
   for (const name2 of same2.slice(0, Math.max(0, same2.length - AUTOMATIC_KEEP))) await rm7(path38.join(directory, name2), { force: true });
   return out;
 }
@@ -41522,7 +41868,7 @@ async function readBackup(file3, { onHeader, visit }) {
     const unit = units.find((candidate) => record3.path === candidate.path || record3.path.startsWith(`${candidate.path}/`));
     if (!unit || unit.kind === "absent" || record3.path !== unit.path && unit.kind !== "dir") throw invalid(`${record3.path} lies outside the units the backup declares`);
     const seen = written.get(area) ?? written.set(area, { paths: /* @__PURE__ */ new Set(), links: [] }).get(area);
-    if (seen.paths.has(record3.path) || seen.links.some((link) => record3.path.startsWith(`${link}/`))) throw invalid(`${record3.path} comes twice, or lies under a link`);
+    if (seen.paths.has(record3.path) || seen.links.some((link2) => record3.path.startsWith(`${link2}/`))) throw invalid(`${record3.path} comes twice, or lies under a link`);
     seen.paths.add(record3.path);
     if (record3.t === "link") seen.links.push(record3.path);
     if (record3.t === "dir" || record3.t === "link") {
@@ -41597,9 +41943,9 @@ async function settleJournal(journal, { releaseLocks = false } = {}) {
     if (journal.marker) await rm7(journal.marker, { force: true });
   }
   for (const directory of journal.staging) await rm7(directory, { recursive: true, force: true });
-  for (const directory of journal.created ?? []) await rmdir2(directory).catch(() => {
+  for (const directory of journal.created ?? []) await rmdir3(directory).catch(() => {
   });
-  if (releaseLocks) for (const lock of journal.locks ?? []) await rmdir2(lock).catch(() => {
+  if (releaseLocks) for (const lock of journal.locks ?? []) await rmdir3(lock).catch(() => {
   });
 }
 async function recoverInterruptedRestore(home2) {
@@ -41711,7 +42057,7 @@ async function restoreBackup({ home: home2, file: file3, projects = true, safety
   }
   for (const [area, root] of staging) {
     const base2 = area === "home" ? "state/sessions" : ".alp/tasks";
-    for (const name2 of await readdir10(path38.join(root, ...base2.split("/"))).catch(() => [])) {
+    for (const name2 of await readdir12(path38.join(root, ...base2.split("/"))).catch(() => [])) {
       if (!name2.endsWith(".json")) continue;
       try {
         JSON.parse(await readFile22(path38.join(root, ...base2.split("/"), name2), "utf8"));
@@ -41825,11 +42171,11 @@ async function clearRestoredMarker(home2) {
 }
 
 // packages/core/src/migrations.js
-import { readdir as readdir11, readFile as readFile23, rm as rm8, stat as stat12 } from "node:fs/promises";
+import { readdir as readdir13, readFile as readFile23, rm as rm8, stat as stat12 } from "node:fs/promises";
 import path39 from "node:path";
 async function timelineCursors(home2) {
   const directory = path39.join(stateDir(home2), "timeline");
-  const names = await readdir11(directory).catch((error51) => {
+  const names = await readdir13(directory).catch((error51) => {
     if (error51?.code === "ENOENT") return [];
     throw error51;
   });
@@ -41913,7 +42259,7 @@ async function migrateState(home2, { by = "alp", migrations = MIGRATIONS, target
 }
 
 // packages/daemon/src/main.ts
-var VERSION = true ? "0.0.0-beta.2" : "0.0.0-dev";
+var VERSION = true ? "0.0.1-beta.3" : "0.0.0-dev";
 var LOG_BYTES = 10 * 1024 * 1024;
 var LOG_FILES = 3;
 var log4 = createLogger({ component: "alpd" });
@@ -41921,7 +42267,7 @@ async function rotate(log5) {
   const size = await stat13(log5).then((info) => info.size, () => 0);
   if (size < LOG_BYTES) return;
   for (let index = LOG_FILES - 1; index >= 1; index--) {
-    await rename9(index === 1 ? log5 : `${log5}.${index - 1}`, `${log5}.${index}`).catch(() => {
+    await rename10(index === 1 ? log5 : `${log5}.${index - 1}`, `${log5}.${index}`).catch(() => {
     });
   }
 }
@@ -41933,12 +42279,39 @@ async function detach(home2) {
   const output = await open7(log5, "a", 384);
   const child = spawn9(process.execPath, [fileURLToPath(import.meta.url)], {
     detached: true,
-    stdio: ["ignore", output.fd, output.fd],
+    stdio: ["ignore", output.fd, output.fd, "ipc"],
     env: process.env,
     windowsHide: true
   });
-  child.unref();
   await output.close();
+  await new Promise((resolve2, reject) => {
+    const requested = Number(process.argv.find((arg) => arg.startsWith("--startup-timeout="))?.split("=")[1]);
+    const timeoutMs = Number.isFinite(requested) && requested > 0 ? requested : 15e3;
+    let timedOut = false;
+    let force;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      child.kill();
+      force = setTimeout(() => child.kill("SIGKILL"), 1e3);
+    }, timeoutMs);
+    child.once("error", (error51) => {
+      clearTimeout(timer);
+      clearTimeout(force);
+      reject(error51);
+    });
+    child.once("exit", (code, signal) => {
+      clearTimeout(timer);
+      clearTimeout(force);
+      reject(new Error(timedOut ? `alpd startup timed out after ${timeoutMs} ms` : `alpd exited during startup (${code ?? signal})`));
+    });
+    child.once("message", (message) => {
+      if (message !== "alpd.ready" || timedOut) return;
+      clearTimeout(timer);
+      child.disconnect();
+      child.unref();
+      resolve2();
+    });
+  });
 }
 async function serviceLog(home2) {
   await assertPrivateDirectory(home2, { create: true });
@@ -42042,14 +42415,12 @@ async function run2(home2) {
     await stopLeftovers(await readFile24(marker, "utf8").then(JSON.parse).catch(() => void 0));
   }
   await mkdir18(path40.dirname(marker), { recursive: true, mode: 448 });
-  await writeFile17(marker, JSON.stringify({ pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString(), groupLeader: leadsGroup() }), { mode: 384 });
+  await writeFile18(marker, JSON.stringify({ pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString(), groupLeader: leadsGroup() }), { mode: 384 });
   const runLogDir = process.env.ALP_RUN_LOG_DIR || path40.join(home2, "runs");
   const worktreeDir = path40.join(home2, "worktrees");
   for (const branch of await reclaimWorktrees(worktreeDir).catch(() => [])) log4.info(`kept interrupted work on branch ${branch}`, { event: "worktree.kept", branch });
   const copyDir = path40.join(home2, "copies");
   await reclaimCopies(copyDir).catch(() => 0);
-  await unlink6(path40.join(home2, "state", "alpd.held")).catch(() => {
-  });
   const settings = await userSettings(home2);
   const runtime = createAlpRuntime({
     templates: templates_default,
@@ -42114,16 +42485,24 @@ async function run2(home2) {
   phase = "ready";
   await updateLock(home2, { ...lock, ready: true });
   const { install } = daemonPaths(home2);
-  await writeFile17(`${install}.tmp`, JSON.stringify({ entry: fileURLToPath(import.meta.url), version: VERSION }), { mode: 384 }).then(() => rename9(`${install}.tmp`, install)).catch((error51) => log4.warn("could not record alpd's location", { code: "ALP_INSTALL_RECORD_FAILED", error: error51 }));
+  await writeFile18(`${install}.tmp`, JSON.stringify({ entry: fileURLToPath(import.meta.url), version: VERSION }), { mode: 384 }).then(() => rename10(`${install}.tmp`, install)).catch((error51) => log4.warn("could not record alpd's location", { code: "ALP_INSTALL_RECORD_FAILED", error: error51 }));
   if (opened.restored) await clearRestoredMarker(home2).catch((error51) => log4.warn("could not clear the restore marker", { code: "ALP_STATE_RESTORED", error: error51 }));
+  if (process.connected) process.send?.("alpd.ready");
   log4.info(`alpd ${VERSION} ready on ${socket} (pid ${process.pid})`, { event: "ready", version: VERSION, pid: process.pid });
 }
 var home = alpHome();
 try {
   if (process.argv.includes("--detach")) await detach(home);
   else {
+    if (!process.connected) await unlink6(path40.join(home, "state", "alpd.held")).catch(() => {
+    });
     if (process.argv.includes("--service")) await serviceLog(home);
-    await run2(home);
+    if (process.connected) await run2(home);
+    else {
+      await withDaemonLifecycle(home, "start", async () => {
+        await run2(home);
+      }, { joinStart: true });
+    }
   }
 } catch (error51) {
   const stoppedIn = phase;