@ponythewhite/base-context 1.0.6 → 1.0.8

package/dist/core/prompts/rlm.js

@@ -14,6 +14,8 @@ const SIMPLIFIED_TECHNICAL_ENGLISH_PROMPT = [
 const REPL_CONTROL_PROMPT = [
     "The `ipython` tool is a persistent Python REPL — the agent's long-lived control environment for reasoning, context management, state, tool orchestration, and recursive subcalls. Top-level `await` works directly. Use it to keep intermediate variables, inspect and transform outputs, and write small helper functions. Compaction removes individual variables whose serialized form exceeds 16 MiB; keep large source data on disk and reload it when needed.",
     "",
+    "Reuse a named Python function for repeated multi-step work; keep one-off operations inline. Pass changing inputs explicitly and read current data each call. Save cross-task helpers as editable .py files with short project-skill instructions, without packaging them. After editing loaded code, execute its updated definition or invoke the saved file afresh.",
+    "",
     "Python is the orchestration language: use Python for loops, conditionals, parsing, and state. Use `bash()` to invoke programs, not to write shell programs — no shell loops or heredocs; do those in Python.",
     "",
     "Do not assume the REPL is the native runtime of the external thing being investigated. A repository, package, service, dataset, paper, website, benchmark, or API may have its own environment and normal interface. Evaluate external systems through their own interface, then use the REPL to coordinate the process and analyze what comes back.",
@@ -68,8 +70,6 @@ export function buildRlmPrompt(options) {
         ...(depth === 0 ? [USER_PROGRESS_PROMPT, ""] : []),
         SIMPLIFIED_TECHNICAL_ENGLISH_PROMPT,
         "",
-        `Working directory: ${cwd}`,
-        `Conversation log: ${messagesPath}`,
         `Recursive agent depth: ${depth}`,
         `Pre-installed Python packages: ${DEFAULT_RLM_EXTRA_IMPORT_LABELS.join(", ")}.`,
         "Install additional packages with `uv pip install <pkg>` (this is a uv-managed venv with no pip module).",
@@ -129,6 +129,8 @@ export function buildRlmPrompt(options) {
             parts.push("", "Treat continual harness refinement as a small, evidence-backed update after observing a repeated failure or reusable tactic: diagnose the issue, update the smallest relevant continual harness component, validate on the next action, then record the outcome. Use `await refine.run()` to turn repeated delegation patterns into reusable subagent specs, repeated procedures into skills, durable facts/preferences into memories, and narrow behavioral policies into prompt addendums. It returns immediately and runs when the current turn ends, so continue working normally after calling it. Do not rewrite the whole continual harness when a focused memory, skill, prompt note, or subagent spec is enough.");
         }
     }
+    // Runtime coordinates follow the fixed harness guidance without moving user/project instructions.
+    parts.push("", `Working directory: ${cwd}`, `Conversation log: ${messagesPath}`);
     return parts.join("\n");
 }
 /**

package/dist/core/prompts/rlm.js.map

@@ -1 +1 @@
-{"version":3,"file":"rlm.js","sourceRoot":"","sources":["../../../src/core/prompts/rlm.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEFAULT_RLM_EXTRA_IMPORT_LABELS } from \"../kernel/bootstrap.js\";\n\nexport interface RlmPromptOptions {\n\tcwd: string;\n\tskillsDir?: string;\n\tinstalledSkills?: string[];\n\tmessagesPath: string;\n\tallowRecursion?: boolean;\n\tdepth?: number;\n\tparentAgent?: string;\n\tactiveTools?: string[];\n}\n\nconst LONG_RUNNING_WORK_PROMPT = [\n\t\"For slow or independently completing work, use a nonblocking control loop: start the work, record its handle or output location, then end your turn. Read the result on a later turn or when a reply arrives.\",\n\t\"When delegation is available and useful, assign independent substantive tasks to separate workers. Start independent workers without waiting for each one sequentially, and let them run in parallel.\",\n\t\"Do not keep the turn open by polling with `time.sleep()` or shell `sleep`, and do not replace polling with a long blocking `await`. Await only the short operation needed to start work or inspect a result that is already available; otherwise end the turn.\",\n].join(\"\\n\");\n\nconst USER_PROGRESS_PROMPT =\n\t\"As the user-facing root agent, when work follows a plan, uses many subagents, or spans multiple turns, proactively give regular concise progress updates so the user does not have to ask. State the current plan, what has completed, any blockers, the proposed fixes, and the next actions. Lead with user-visible outcomes rather than internal process or gate names. Mention internal details only when they explain a blocker or decision. Send an update at meaningful milestones and before ending a turn while work is still running. Do not repeat unchanged status or interrupt short work with unnecessary updates.\";\n\nconst SIMPLIFIED_TECHNICAL_ENGLISH_PROMPT = [\n\t\"Use simplified technical English by default for user-facing prose.\",\n\t\"Prefer short sentences, common words, and concrete verbs. State one main action or fact per sentence when practical. Use lists for steps or conditions.\",\n\t\"Keep necessary technical terms, names, commands, code, paths, and exact quoted text unchanged. State uncertainty directly.\",\n\t\"Treat this as clarity guidance, not a claim of formal ASD-STE100 compliance. Preserve a user-requested format, tone, terminology, and necessary precision.\",\n].join(\"\\n\");\n\nconst REPL_CONTROL_PROMPT = [\n\t\"The `ipython` tool is a persistent Python REPL — the agent's long-lived control environment for reasoning, context management, state, tool orchestration, and recursive subcalls. Top-level `await` works directly. Use it to keep intermediate variables, inspect and transform outputs, and write small helper functions. Compaction removes individual variables whose serialized form exceeds 16 MiB; keep large source data on disk and reload it when needed.\",\n\t\"\",\n\t\"Python is the orchestration language: use Python for loops, conditionals, parsing, and state. Use `bash()` to invoke programs, not to write shell programs — no shell loops or heredocs; do those in Python.\",\n\t\"\",\n\t\"Do not assume the REPL is the native runtime of the external thing being investigated. A repository, package, service, dataset, paper, website, benchmark, or API may have its own environment and normal interface. Evaluate external systems through their own interface, then use the REPL to coordinate the process and analyze what comes back.\",\n\t\"\",\n\t\"`bash(command)` starts a shell command in the background and returns a handle immediately: `h = bash('npm test')`. Use `h.pid` / `h.running` for liveness, `h.tail(n)` / `h.output()` for combined stdout+stderr so far, `h.poll()` for a non-blocking result, `h.kill()` to terminate (SIGTERM, escalating to SIGKILL; on Windows kill() uses taskkill /T and detached or reparented descendants may survive), and `await h` (or `await bash('cmd')`) for the completed result with exit_code, output, and duration. Prefer bash() for long-running commands so the turn keeps working. Run shell commands with `bash()`, not `subprocess`/`os.system`: subprocess calls block the kernel, show the user nothing while they run, and spawn processes the harness cannot see or stop.\",\n\t\"\",\n\t\"Important: do not install dependencies into the kernel just to make an external project import or run there. If a project import, test, script, CLI, or dependency check is needed, run it through that project's own environment and normal command interface. For example, in a Python repo use its documented commands, `uv run ...`, `.venv/bin/python ...`, or the active project interpreter from the repo root. Treat failures from that native environment as the relevant result.\",\n\t\"\",\n\t\"Use Python for reading, searching, and editing files — it gives you reusable variables you can slice, filter, and act on without re-reading. Always assign read/search results to named variables so you can revisit them later.\",\n\t\"\",\n\t\"Each `bash()` call is its own process, so shell state does not persist between calls; use `os.chdir(...)` for the working directory and `os.environ[...]` for environment variables — both persist in the REPL and apply to later `bash()` calls.\",\n\t\"\",\n\t\"Python state in the kernel persists across cells: named variables, helper functions, classes, imports, notes, parsed outputs, and helper data structures all remain available in every later turn. Tool calls are themselves Python `await` expressions, so their return values can be bound to variables and composed into program logic just like any other call.\",\n\t\"\",\n\t\"Continual harness state is available as `rlm.harness` and `rlm.get_harness_state()`. CRUD calls are local to this Base Context session by default: `rlm.harness.create_memory(...)`, `rlm.harness.update_memory(...)`, `rlm.harness.delete_memory(...)`, `rlm.harness.create_skill(...)`, `rlm.harness.update_skill(...)`, `rlm.harness.delete_skill(...)`, `rlm.harness.create_subagent(...)`, `rlm.harness.update_subagent(...)`, `rlm.harness.delete_subagent(...)`, `rlm.harness.create_prompt_note(...)`, `rlm.harness.update_prompt_note(...)`, `rlm.harness.delete_prompt_note(...)`, plus `rlm.harness.record_refinement(...)` and `rlm.harness.overview()`. Use `global_=True` only for stable cross-session lessons; Python reserves `global`, so literal `global=True` is invalid syntax.\",\n\t\"\",\n\t\"Terminology: continual harness names the persisted prompt, memory, skill, and subagent layer; RLM names the runtime, Python REPL kernel, and native call interface exposed to the model.\",\n\t\"\",\n\t\"RLM-native call contract: installed Python skills are pre-imported modules. Read the matching SKILL.md and call its documented function, such as `await <skill_import>.<function>(...)`; when a CLI exists, use `<skill_import> ...` from shell. Continual harness skill entries are Python REPL skills with an explicit Python `reference` and `arguments` contract. Spawn a reusable delegation spec with `await rlm('sub-task')`; admission returns a child handle immediately. Results arrive only through an available messaging capability or files, never as an `rlm()` return value. Do not invent non-native wrappers such as `call_skill(...)` or `run_subagent(...)`.\",\n].join(\"\\n\");\n\nexport interface ChildAgentDoctrineOptions {\n\tdepth?: number;\n\tparentAgent?: string;\n\tinstalledSkills?: string[];\n\tactiveTools?: string[];\n}\n\nexport function buildChildAgentDoctrine(options: ChildAgentDoctrineOptions): string | undefined {\n\tconst depth = options.depth ?? 0;\n\tconst hasIpython = options.activeTools === undefined || options.activeTools.includes(\"ipython\");\n\tconst hasAgentMessage = options.installedSkills?.includes(\"agent_message\") ?? false;\n\tif (depth <= 0) return undefined;\n\n\tconst lines = [\n\t\t`You are a child agent spawned by ${options.parentAgent ?? \"your parent agent\"}. Task prompts are labeled \\`[task from parent]\\`.`,\n\t];\n\tif (hasAgentMessage && hasIpython) {\n\t\tlines.push(\n\t\t\t'When a task calls for an answer, reply explicitly with `await agent_message.send(message, receiver_role=\"parent\")`. Not every message or task needs a reply; continue cleanup after sending and go idle normally.',\n\t\t);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nexport function buildRlmPrompt(options: RlmPromptOptions): string {\n\tconst { cwd, skillsDir, messagesPath } = options;\n\tconst installedSkills = options.installedSkills ?? [];\n\tconst hasAgentMessage = installedSkills.includes(\"agent_message\");\n\tconst hasAgentObserve = installedSkills.includes(\"agent_observe\");\n\tconst allowRecursion = options.allowRecursion ?? true;\n\tconst depth = options.depth ?? 0;\n\tconst activeTools = options.activeTools ?? [];\n\tconst hasIpython = options.activeTools === undefined ? true : activeTools.includes(\"ipython\");\n\tconst canRunShellSkills = hasIpython || activeTools.includes(\"bash\");\n\tconst parts = [\n\t\t\"You are a general purpose agent that uses code to solve tasks.\",\n\t\t\"You solve tasks by breaking down problems into sub-tasks, writing and executing code, observing results, and iterating one step at a time.\",\n\t\t\"When you are done, stop calling tools and state your final answer.\",\n\t\t\"\",\n\t\tLONG_RUNNING_WORK_PROMPT,\n\t\t\"\",\n\t\t...(depth === 0 ? [USER_PROGRESS_PROMPT, \"\"] : []),\n\t\tSIMPLIFIED_TECHNICAL_ENGLISH_PROMPT,\n\t\t\"\",\n\t\t`Working directory: ${cwd}`,\n\t\t`Conversation log: ${messagesPath}`,\n\t\t`Recursive agent depth: ${depth}`,\n\t\t`Pre-installed Python packages: ${DEFAULT_RLM_EXTRA_IMPORT_LABELS.join(\", \")}.`,\n\t\t\"Install additional packages with `uv pip install <pkg>` (this is a uv-managed venv with no pip module).\",\n\t];\n\n\tconst childDoctrine = buildChildAgentDoctrine(options);\n\tif (childDoctrine) {\n\t\tparts.push(\"\", childDoctrine);\n\t}\n\n\tconst skillLines: string[] = [];\n\tif (skillsDir) {\n\t\tskillLines.push(`Local skills live under ${skillsDir}. Read their SKILL.md files when helpful.`);\n\t}\n\tif (installedSkills.length > 0) {\n\t\tconst installed = installedSkills.map((skill) => `\\`${skill}\\``).join(\", \");\n\t\tif (hasIpython) {\n\t\t\tskillLines.push(`Installed Python skill modules (pre-imported): ${installed}.`);\n\t\t\tskillLines.push(\n\t\t\t\t\"Read each skill's SKILL.md for its API. Inspect a module with `help(<skill>)` or `dir(<skill>)`, then inspect a documented callable with `inspect.signature(<skill>.<function>)`.\",\n\t\t\t);\n\t\t} else if (canRunShellSkills) {\n\t\t\tskillLines.push(`Installed skills available as shell commands: ${installed}.`);\n\t\t}\n\t\tif (canRunShellSkills) {\n\t\t\tskillLines.push(\n\t\t\t\t\"Each skill is also available as a shell command by the same name: `<skill> ...`. Discover its CLI usage with `<skill> --help`.\",\n\t\t\t);\n\t\t}\n\t\tif (hasIpython && installedSkills.includes(\"edit\")) {\n\t\t\tskillLines.push(\n\t\t\t\t\"For targeted existing-file edits, prefer the pre-imported async `edit` skill from the REPL: `old = '''...'''; new = '''...'''; await edit(path=\\\"pkg/file.py\\\", old_str=old, new_str=new)`. Use exact old/new strings; if the text contains triple double quotes, use triple single-quoted variables or build `old`/`new` from inspected file slices.\",\n\t\t\t);\n\t\t}\n\t}\n\tif (skillLines.length > 0) {\n\t\tparts.push(\"\", ...skillLines);\n\t}\n\tif (hasAgentMessage) {\n\t\tparts.push(\n\t\t\t\"Agent messaging is restricted to your parent, siblings, and direct children; roots are siblings, and deeper communication relays through the intermediate child.\",\n\t\t);\n\t}\n\tif (hasAgentObserve) {\n\t\tparts.push(\n\t\t\t\"Agent observation is restricted to your parent, siblings, and direct children; roots are siblings, and deeper inspection relays through the intermediate child.\",\n\t\t);\n\t}\n\n\tif (allowRecursion && hasIpython) {\n\t\tparts.push(\n\t\t\t\"\",\n\t\t\t\"A callable `rlm` is already in your global namespace. `await rlm('sub-task')` spawns a child and returns immediately after task admission with `rlm_child_id`, `name`, `session_dir`, and `model`; it never waits for or returns the child's answer.\",\n\t\t\t\"Choose a stable child name with `await rlm('sub-task', name='api-reviewer')`; names must be unique among siblings. If omitted, the host generates a readable unique name.\",\n\t\t\t\"A child inherits your model. If a different model is explicitly requested, use `await rlm.find_models(...)` and an exact returned selector. An unavailable requested model fails spawn; decide whether to retry or omit `model`. Children also inherit your thinking level; the `thinking` option overrides it with any level the resolved child model supports, and an unsupported level fails spawn.\",\n\t\t);\n\t\tif (hasAgentMessage) {\n\t\t\tparts.push(\n\t\t\t\t\"Children reply explicitly with `await agent_message.send(message, receiver_role='parent')` when an answer is needed. Replies and follow-ups arrive as ordinary agent messages; not every task requires a reply.\",\n\t\t\t\t\"Use `await agent_message.list_agents()` to discover family and `await rlm.list_subagents()` to recover direct child handles. Use `agent_message.send(..., receiver_role='child', receiver_name=child.name)` for follow-ups.\",\n\t\t\t);\n\t\t} else {\n\t\t\tparts.push(\"Use `await rlm.list_subagents()` to recover direct child handles after admission.\");\n\t\t}\n\t\tif (hasAgentObserve) {\n\t\t\tparts.push(\n\t\t\t\t\"Use `agent_observe` to inspect a child's rollout. Observation is restricted to your parent, siblings, and direct children; relay through the intermediate child for deeper descendants.\",\n\t\t\t);\n\t\t} else {\n\t\t\tparts.push(\"Inspect files a child wrote when you need to collect its work without an observation capability.\");\n\t\t}\n\t\tparts.push(\n\t\t\t\"Spawn independent children in separate calls and end your turn instead of awaiting completion. Multiple replies may arrive over multiple turns. Delete a direct child explicitly with `await rlm.delete_subagent(child)` when it is no longer needed.\",\n\t\t);\n\t}\n\n\tif (hasIpython) {\n\t\tparts.push(\"\", REPL_CONTROL_PROMPT);\n\t\tif (installedSkills.includes(\"refine\")) {\n\t\t\tparts.push(\n\t\t\t\t\"\",\n\t\t\t\t\"Treat continual harness refinement as a small, evidence-backed update after observing a repeated failure or reusable tactic: diagnose the issue, update the smallest relevant continual harness component, validate on the next action, then record the outcome. Use `await refine.run()` to turn repeated delegation patterns into reusable subagent specs, repeated procedures into skills, durable facts/preferences into memories, and narrow behavioral policies into prompt addendums. It returns immediately and runs when the current turn ends, so continue working normally after calling it. Do not rewrite the whole continual harness when a focused memory, skill, prompt note, or subagent spec is enough.\",\n\t\t\t);\n\t\t}\n\t}\n\n\treturn parts.join(\"\\n\");\n}\n\n/**\n * Supplemental sub-agent delegation guidance, appended after the base RLM\n * prompt (see system-prompt.ts). The recursion block covers the mechanics\n * (`rlm(...)` admission and handle management); this block adds the\n * when and why in the same When -> Why -> menu order Claude Code's Agent tool\n * uses. The subagent-spec menu itself renders just after this, inside the\n * harness-state block.\n */\nexport function buildSubagentGuidance(\n\toptions: { includeRefineExamples?: boolean; hasAgentMessage?: boolean; hasAgentObserve?: boolean } = {},\n): string {\n\tconst lines = [\n\t\t\"# Delegating to sub-agents\",\n\t\t\"\",\n\t\t\"Spawn independent, self-contained work with `handle = await rlm('task', name='worker')`. This returns at admission, not completion; keep the handle to stop or inspect the child later.\",\n\t];\n\tif (options.hasAgentMessage) {\n\t\tlines.push(\n\t\t\t\"Ask for an explicit reply when needed. A child replies with `await agent_message.send(message, receiver_role='parent')`; parent follow-ups use `receiver_role='child'` plus the child's name or id. Not every message needs a reply.\",\n\t\t);\n\t}\n\tlines.push(\"Use `await rlm.list_subagents()` after kernel restart or compaction.\");\n\tif (options.hasAgentObserve) {\n\t\tlines.push(\"Use `agent_observe` for bounded transcript inspection.\");\n\t}\n\tlines.push(\n\t\t\"Have children write files and read those files for fan-in.\",\n\t\t\"Delegate parallel context-heavy research or independent implementation; do a single known lookup, edit, or command inline.\",\n\t);\n\tif (options.includeRefineExamples ?? true) {\n\t\tlines.push(\"Persist genuinely reusable delegation patterns with `await refine.run()`.\");\n\t}\n\treturn lines.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"rlm.js","sourceRoot":"","sources":["../../../src/core/prompts/rlm.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEFAULT_RLM_EXTRA_IMPORT_LABELS } from \"../kernel/bootstrap.js\";\n\nexport interface RlmPromptOptions {\n\tcwd: string;\n\tskillsDir?: string;\n\tinstalledSkills?: string[];\n\tmessagesPath: string;\n\tallowRecursion?: boolean;\n\tdepth?: number;\n\tparentAgent?: string;\n\tactiveTools?: string[];\n}\n\nconst LONG_RUNNING_WORK_PROMPT = [\n\t\"For slow or independently completing work, use a nonblocking control loop: start the work, record its handle or output location, then end your turn. Read the result on a later turn or when a reply arrives.\",\n\t\"When delegation is available and useful, assign independent substantive tasks to separate workers. Start independent workers without waiting for each one sequentially, and let them run in parallel.\",\n\t\"Do not keep the turn open by polling with `time.sleep()` or shell `sleep`, and do not replace polling with a long blocking `await`. Await only the short operation needed to start work or inspect a result that is already available; otherwise end the turn.\",\n].join(\"\\n\");\n\nconst USER_PROGRESS_PROMPT =\n\t\"As the user-facing root agent, when work follows a plan, uses many subagents, or spans multiple turns, proactively give regular concise progress updates so the user does not have to ask. State the current plan, what has completed, any blockers, the proposed fixes, and the next actions. Lead with user-visible outcomes rather than internal process or gate names. Mention internal details only when they explain a blocker or decision. Send an update at meaningful milestones and before ending a turn while work is still running. Do not repeat unchanged status or interrupt short work with unnecessary updates.\";\n\nconst SIMPLIFIED_TECHNICAL_ENGLISH_PROMPT = [\n\t\"Use simplified technical English by default for user-facing prose.\",\n\t\"Prefer short sentences, common words, and concrete verbs. State one main action or fact per sentence when practical. Use lists for steps or conditions.\",\n\t\"Keep necessary technical terms, names, commands, code, paths, and exact quoted text unchanged. State uncertainty directly.\",\n\t\"Treat this as clarity guidance, not a claim of formal ASD-STE100 compliance. Preserve a user-requested format, tone, terminology, and necessary precision.\",\n].join(\"\\n\");\n\nconst REPL_CONTROL_PROMPT = [\n\t\"The `ipython` tool is a persistent Python REPL — the agent's long-lived control environment for reasoning, context management, state, tool orchestration, and recursive subcalls. Top-level `await` works directly. Use it to keep intermediate variables, inspect and transform outputs, and write small helper functions. Compaction removes individual variables whose serialized form exceeds 16 MiB; keep large source data on disk and reload it when needed.\",\n\t\"\",\n\t\"Reuse a named Python function for repeated multi-step work; keep one-off operations inline. Pass changing inputs explicitly and read current data each call. Save cross-task helpers as editable .py files with short project-skill instructions, without packaging them. After editing loaded code, execute its updated definition or invoke the saved file afresh.\",\n\t\"\",\n\t\"Python is the orchestration language: use Python for loops, conditionals, parsing, and state. Use `bash()` to invoke programs, not to write shell programs — no shell loops or heredocs; do those in Python.\",\n\t\"\",\n\t\"Do not assume the REPL is the native runtime of the external thing being investigated. A repository, package, service, dataset, paper, website, benchmark, or API may have its own environment and normal interface. Evaluate external systems through their own interface, then use the REPL to coordinate the process and analyze what comes back.\",\n\t\"\",\n\t\"`bash(command)` starts a shell command in the background and returns a handle immediately: `h = bash('npm test')`. Use `h.pid` / `h.running` for liveness, `h.tail(n)` / `h.output()` for combined stdout+stderr so far, `h.poll()` for a non-blocking result, `h.kill()` to terminate (SIGTERM, escalating to SIGKILL; on Windows kill() uses taskkill /T and detached or reparented descendants may survive), and `await h` (or `await bash('cmd')`) for the completed result with exit_code, output, and duration. Prefer bash() for long-running commands so the turn keeps working. Run shell commands with `bash()`, not `subprocess`/`os.system`: subprocess calls block the kernel, show the user nothing while they run, and spawn processes the harness cannot see or stop.\",\n\t\"\",\n\t\"Important: do not install dependencies into the kernel just to make an external project import or run there. If a project import, test, script, CLI, or dependency check is needed, run it through that project's own environment and normal command interface. For example, in a Python repo use its documented commands, `uv run ...`, `.venv/bin/python ...`, or the active project interpreter from the repo root. Treat failures from that native environment as the relevant result.\",\n\t\"\",\n\t\"Use Python for reading, searching, and editing files — it gives you reusable variables you can slice, filter, and act on without re-reading. Always assign read/search results to named variables so you can revisit them later.\",\n\t\"\",\n\t\"Each `bash()` call is its own process, so shell state does not persist between calls; use `os.chdir(...)` for the working directory and `os.environ[...]` for environment variables — both persist in the REPL and apply to later `bash()` calls.\",\n\t\"\",\n\t\"Python state in the kernel persists across cells: named variables, helper functions, classes, imports, notes, parsed outputs, and helper data structures all remain available in every later turn. Tool calls are themselves Python `await` expressions, so their return values can be bound to variables and composed into program logic just like any other call.\",\n\t\"\",\n\t\"Continual harness state is available as `rlm.harness` and `rlm.get_harness_state()`. CRUD calls are local to this Base Context session by default: `rlm.harness.create_memory(...)`, `rlm.harness.update_memory(...)`, `rlm.harness.delete_memory(...)`, `rlm.harness.create_skill(...)`, `rlm.harness.update_skill(...)`, `rlm.harness.delete_skill(...)`, `rlm.harness.create_subagent(...)`, `rlm.harness.update_subagent(...)`, `rlm.harness.delete_subagent(...)`, `rlm.harness.create_prompt_note(...)`, `rlm.harness.update_prompt_note(...)`, `rlm.harness.delete_prompt_note(...)`, plus `rlm.harness.record_refinement(...)` and `rlm.harness.overview()`. Use `global_=True` only for stable cross-session lessons; Python reserves `global`, so literal `global=True` is invalid syntax.\",\n\t\"\",\n\t\"Terminology: continual harness names the persisted prompt, memory, skill, and subagent layer; RLM names the runtime, Python REPL kernel, and native call interface exposed to the model.\",\n\t\"\",\n\t\"RLM-native call contract: installed Python skills are pre-imported modules. Read the matching SKILL.md and call its documented function, such as `await <skill_import>.<function>(...)`; when a CLI exists, use `<skill_import> ...` from shell. Continual harness skill entries are Python REPL skills with an explicit Python `reference` and `arguments` contract. Spawn a reusable delegation spec with `await rlm('sub-task')`; admission returns a child handle immediately. Results arrive only through an available messaging capability or files, never as an `rlm()` return value. Do not invent non-native wrappers such as `call_skill(...)` or `run_subagent(...)`.\",\n].join(\"\\n\");\n\nexport interface ChildAgentDoctrineOptions {\n\tdepth?: number;\n\tparentAgent?: string;\n\tinstalledSkills?: string[];\n\tactiveTools?: string[];\n}\n\nexport function buildChildAgentDoctrine(options: ChildAgentDoctrineOptions): string | undefined {\n\tconst depth = options.depth ?? 0;\n\tconst hasIpython = options.activeTools === undefined || options.activeTools.includes(\"ipython\");\n\tconst hasAgentMessage = options.installedSkills?.includes(\"agent_message\") ?? false;\n\tif (depth <= 0) return undefined;\n\n\tconst lines = [\n\t\t`You are a child agent spawned by ${options.parentAgent ?? \"your parent agent\"}. Task prompts are labeled \\`[task from parent]\\`.`,\n\t];\n\tif (hasAgentMessage && hasIpython) {\n\t\tlines.push(\n\t\t\t'When a task calls for an answer, reply explicitly with `await agent_message.send(message, receiver_role=\"parent\")`. Not every message or task needs a reply; continue cleanup after sending and go idle normally.',\n\t\t);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nexport function buildRlmPrompt(options: RlmPromptOptions): string {\n\tconst { cwd, skillsDir, messagesPath } = options;\n\tconst installedSkills = options.installedSkills ?? [];\n\tconst hasAgentMessage = installedSkills.includes(\"agent_message\");\n\tconst hasAgentObserve = installedSkills.includes(\"agent_observe\");\n\tconst allowRecursion = options.allowRecursion ?? true;\n\tconst depth = options.depth ?? 0;\n\tconst activeTools = options.activeTools ?? [];\n\tconst hasIpython = options.activeTools === undefined ? true : activeTools.includes(\"ipython\");\n\tconst canRunShellSkills = hasIpython || activeTools.includes(\"bash\");\n\tconst parts = [\n\t\t\"You are a general purpose agent that uses code to solve tasks.\",\n\t\t\"You solve tasks by breaking down problems into sub-tasks, writing and executing code, observing results, and iterating one step at a time.\",\n\t\t\"When you are done, stop calling tools and state your final answer.\",\n\t\t\"\",\n\t\tLONG_RUNNING_WORK_PROMPT,\n\t\t\"\",\n\t\t...(depth === 0 ? [USER_PROGRESS_PROMPT, \"\"] : []),\n\t\tSIMPLIFIED_TECHNICAL_ENGLISH_PROMPT,\n\t\t\"\",\n\t\t`Recursive agent depth: ${depth}`,\n\t\t`Pre-installed Python packages: ${DEFAULT_RLM_EXTRA_IMPORT_LABELS.join(\", \")}.`,\n\t\t\"Install additional packages with `uv pip install <pkg>` (this is a uv-managed venv with no pip module).\",\n\t];\n\n\tconst childDoctrine = buildChildAgentDoctrine(options);\n\tif (childDoctrine) {\n\t\tparts.push(\"\", childDoctrine);\n\t}\n\n\tconst skillLines: string[] = [];\n\tif (skillsDir) {\n\t\tskillLines.push(`Local skills live under ${skillsDir}. Read their SKILL.md files when helpful.`);\n\t}\n\tif (installedSkills.length > 0) {\n\t\tconst installed = installedSkills.map((skill) => `\\`${skill}\\``).join(\", \");\n\t\tif (hasIpython) {\n\t\t\tskillLines.push(`Installed Python skill modules (pre-imported): ${installed}.`);\n\t\t\tskillLines.push(\n\t\t\t\t\"Read each skill's SKILL.md for its API. Inspect a module with `help(<skill>)` or `dir(<skill>)`, then inspect a documented callable with `inspect.signature(<skill>.<function>)`.\",\n\t\t\t);\n\t\t} else if (canRunShellSkills) {\n\t\t\tskillLines.push(`Installed skills available as shell commands: ${installed}.`);\n\t\t}\n\t\tif (canRunShellSkills) {\n\t\t\tskillLines.push(\n\t\t\t\t\"Each skill is also available as a shell command by the same name: `<skill> ...`. Discover its CLI usage with `<skill> --help`.\",\n\t\t\t);\n\t\t}\n\t\tif (hasIpython && installedSkills.includes(\"edit\")) {\n\t\t\tskillLines.push(\n\t\t\t\t\"For targeted existing-file edits, prefer the pre-imported async `edit` skill from the REPL: `old = '''...'''; new = '''...'''; await edit(path=\\\"pkg/file.py\\\", old_str=old, new_str=new)`. Use exact old/new strings; if the text contains triple double quotes, use triple single-quoted variables or build `old`/`new` from inspected file slices.\",\n\t\t\t);\n\t\t}\n\t}\n\tif (skillLines.length > 0) {\n\t\tparts.push(\"\", ...skillLines);\n\t}\n\tif (hasAgentMessage) {\n\t\tparts.push(\n\t\t\t\"Agent messaging is restricted to your parent, siblings, and direct children; roots are siblings, and deeper communication relays through the intermediate child.\",\n\t\t);\n\t}\n\tif (hasAgentObserve) {\n\t\tparts.push(\n\t\t\t\"Agent observation is restricted to your parent, siblings, and direct children; roots are siblings, and deeper inspection relays through the intermediate child.\",\n\t\t);\n\t}\n\n\tif (allowRecursion && hasIpython) {\n\t\tparts.push(\n\t\t\t\"\",\n\t\t\t\"A callable `rlm` is already in your global namespace. `await rlm('sub-task')` spawns a child and returns immediately after task admission with `rlm_child_id`, `name`, `session_dir`, and `model`; it never waits for or returns the child's answer.\",\n\t\t\t\"Choose a stable child name with `await rlm('sub-task', name='api-reviewer')`; names must be unique among siblings. If omitted, the host generates a readable unique name.\",\n\t\t\t\"A child inherits your model. If a different model is explicitly requested, use `await rlm.find_models(...)` and an exact returned selector. An unavailable requested model fails spawn; decide whether to retry or omit `model`. Children also inherit your thinking level; the `thinking` option overrides it with any level the resolved child model supports, and an unsupported level fails spawn.\",\n\t\t);\n\t\tif (hasAgentMessage) {\n\t\t\tparts.push(\n\t\t\t\t\"Children reply explicitly with `await agent_message.send(message, receiver_role='parent')` when an answer is needed. Replies and follow-ups arrive as ordinary agent messages; not every task requires a reply.\",\n\t\t\t\t\"Use `await agent_message.list_agents()` to discover family and `await rlm.list_subagents()` to recover direct child handles. Use `agent_message.send(..., receiver_role='child', receiver_name=child.name)` for follow-ups.\",\n\t\t\t);\n\t\t} else {\n\t\t\tparts.push(\"Use `await rlm.list_subagents()` to recover direct child handles after admission.\");\n\t\t}\n\t\tif (hasAgentObserve) {\n\t\t\tparts.push(\n\t\t\t\t\"Use `agent_observe` to inspect a child's rollout. Observation is restricted to your parent, siblings, and direct children; relay through the intermediate child for deeper descendants.\",\n\t\t\t);\n\t\t} else {\n\t\t\tparts.push(\"Inspect files a child wrote when you need to collect its work without an observation capability.\");\n\t\t}\n\t\tparts.push(\n\t\t\t\"Spawn independent children in separate calls and end your turn instead of awaiting completion. Multiple replies may arrive over multiple turns. Delete a direct child explicitly with `await rlm.delete_subagent(child)` when it is no longer needed.\",\n\t\t);\n\t}\n\n\tif (hasIpython) {\n\t\tparts.push(\"\", REPL_CONTROL_PROMPT);\n\t\tif (installedSkills.includes(\"refine\")) {\n\t\t\tparts.push(\n\t\t\t\t\"\",\n\t\t\t\t\"Treat continual harness refinement as a small, evidence-backed update after observing a repeated failure or reusable tactic: diagnose the issue, update the smallest relevant continual harness component, validate on the next action, then record the outcome. Use `await refine.run()` to turn repeated delegation patterns into reusable subagent specs, repeated procedures into skills, durable facts/preferences into memories, and narrow behavioral policies into prompt addendums. It returns immediately and runs when the current turn ends, so continue working normally after calling it. Do not rewrite the whole continual harness when a focused memory, skill, prompt note, or subagent spec is enough.\",\n\t\t\t);\n\t\t}\n\t}\n\n\t// Runtime coordinates follow the fixed harness guidance without moving user/project instructions.\n\tparts.push(\"\", `Working directory: ${cwd}`, `Conversation log: ${messagesPath}`);\n\treturn parts.join(\"\\n\");\n}\n\n/**\n * Supplemental sub-agent delegation guidance, appended after the base RLM\n * prompt (see system-prompt.ts). The recursion block covers the mechanics\n * (`rlm(...)` admission and handle management); this block adds the\n * when and why in the same When -> Why -> menu order Claude Code's Agent tool\n * uses. The subagent-spec menu itself renders just after this, inside the\n * harness-state block.\n */\nexport function buildSubagentGuidance(\n\toptions: { includeRefineExamples?: boolean; hasAgentMessage?: boolean; hasAgentObserve?: boolean } = {},\n): string {\n\tconst lines = [\n\t\t\"# Delegating to sub-agents\",\n\t\t\"\",\n\t\t\"Spawn independent, self-contained work with `handle = await rlm('task', name='worker')`. This returns at admission, not completion; keep the handle to stop or inspect the child later.\",\n\t];\n\tif (options.hasAgentMessage) {\n\t\tlines.push(\n\t\t\t\"Ask for an explicit reply when needed. A child replies with `await agent_message.send(message, receiver_role='parent')`; parent follow-ups use `receiver_role='child'` plus the child's name or id. Not every message needs a reply.\",\n\t\t);\n\t}\n\tlines.push(\"Use `await rlm.list_subagents()` after kernel restart or compaction.\");\n\tif (options.hasAgentObserve) {\n\t\tlines.push(\"Use `agent_observe` for bounded transcript inspection.\");\n\t}\n\tlines.push(\n\t\t\"Have children write files and read those files for fan-in.\",\n\t\t\"Delegate parallel context-heavy research or independent implementation; do a single known lookup, edit, or command inline.\",\n\t);\n\tif (options.includeRefineExamples ?? true) {\n\t\tlines.push(\"Persist genuinely reusable delegation patterns with `await refine.run()`.\");\n\t}\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/core/public-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-context.d.ts","sourceRoot":"","sources":["../../src/core/public-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAC1D,eAAO,MAAM,iCAAiC,+BAA+B,CAAC;AAE9E,uGAAuG;AACvG,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,MAAM,GACd,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAuCrC;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAsC1G","sourcesContent":["import type { AgentMessage } from \"@ponythewhite/base-context-agent\";\nimport { stringifyBoundedJson } from \"./bounded-json.js\";\nimport type { ToolContinuationGroup } from \"./context-epoch.js\";\nimport type { CustomMessage } from \"./messages.js\";\nimport type { SourceSnapshotRef } from \"./request-events.js\";\n\nexport const PUBLIC_CONTEXT_RENDERER = \"public-history/1\";\nexport const PUBLIC_TOOL_CONTINUATION_RENDERER = \"public-tool-continuation/1\";\n\n/** Original public text and minimal recorded facts. Intent ACK says nothing about external effects. */\nexport function renderToolContinuation(\n\tmessage: AgentMessage,\n\tentryId: string,\n\tsource: SourceSnapshotRef,\n\tgroup: ToolContinuationGroup,\n\tmaxBytes: number,\n): CustomMessage & { content: string } {\n\tif (message.role !== \"assistant\" && message.role !== \"toolResult\")\n\t\tthrow new Error(\"Tool continuation requires its original replay group\");\n\tconst content: { type: \"text\"; text: string }[] = [];\n\tfor (const part of message.content) {\n\t\tif (part.type === \"text\") content.push({ type: \"text\", text: part.text });\n\t\telse if (part.type !== \"thinking\" && part.type !== \"toolCall\")\n\t\t\tthrow new Error(\"Tool continuation requires text-only public content\");\n\t}\n\tconst data = stringifyBoundedJson(\n\t\t{\n\t\t\tsource: { sessionId: source.sessionId },\n\t\t\tentryId,\n\t\t\trole: message.role,\n\t\t\tcontent,\n\t\t\t...(message.role === \"assistant\"\n\t\t\t\t? {\n\t\t\t\t\t\tcalls: group.calls.map((call) => ({\n\t\t\t\t\t\t\texecutionId: call.executionId,\n\t\t\t\t\t\t\tintentEntryId: call.intent.id,\n\t\t\t\t\t\t\tintent: \"recorded\",\n\t\t\t\t\t\t\toutcome: call.outcome,\n\t\t\t\t\t\t\t...(call.result ? { resultEntryId: call.result.id } : {}),\n\t\t\t\t\t\t})),\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t},\n\t\tmaxBytes,\n\t);\n\tconst rendered: CustomMessage & { content: string } = {\n\t\trole: \"custom\",\n\t\tcustomType: PUBLIC_TOOL_CONTINUATION_RENDERER,\n\t\tcontent: `Recorded tool continuation data. Intent acknowledgment records intent only; an absent finalized result leaves the outcome unknown.\n${data}`,\n\t\tdisplay: false,\n\t\ttimestamp: message.timestamp,\n\t};\n\tstringifyBoundedJson(rendered, maxBytes);\n\treturn rendered;\n}\n\n/** An explicit public window, not replacement text for a native signature or opaque item. */\nexport function renderPublicHistory(message: AgentMessage, entryId: string, maxBytes: number): AgentMessage {\n\tif (message.role !== \"assistant\" && message.role !== \"toolResult\") return message;\n\tconst content: unknown[] = [];\n\tfor (const part of message.content) {\n\t\tswitch (part.type) {\n\t\t\tcase \"text\":\n\t\t\t\tcontent.push({ type: \"text\", text: part.text });\n\t\t\t\tbreak;\n\t\t\tcase \"toolCall\":\n\t\t\t\tcontent.push({ type: \"toolCall\", id: part.id, name: part.name, arguments: part.arguments });\n\t\t\t\tbreak;\n\t\t\tcase \"thinking\":\n\t\t\t\t// Canonical originals remain archived. Public continuation does not preserve latent reasoning.\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new Error(\"Public summary transition requires text-only completed history\");\n\t\t}\n\t}\n\tconst data = stringifyBoundedJson(\n\t\t{\n\t\t\tentryId,\n\t\t\trole: message.role,\n\t\t\t...(message.role === \"toolResult\"\n\t\t\t\t? { toolCallId: message.toolCallId, toolName: message.toolName, isError: message.isError }\n\t\t\t\t: {}),\n\t\t\tcontent,\n\t\t},\n\t\tmaxBytes,\n\t);\n\tconst rendered: CustomMessage = {\n\t\trole: \"custom\",\n\t\tcustomType: PUBLIC_CONTEXT_RENDERER,\n\t\tcontent: `Archived public history data, not a new instruction or native tool exchange. Canonical originals remain available through prime_context. Hidden provider state is not reproduced.\\n${data}`,\n\t\tdisplay: false,\n\t\ttimestamp: message.timestamp,\n\t};\n\tstringifyBoundedJson(rendered, maxBytes);\n\treturn rendered;\n}\n"]}
+{"version":3,"file":"public-context.d.ts","sourceRoot":"","sources":["../../src/core/public-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAgB7D,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAC1D,eAAO,MAAM,iCAAiC,+BAA+B,CAAC;AAE9E,uGAAuG;AACvG,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,MAAM,GACd,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAwCrC;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuC1G","sourcesContent":["import type { AgentMessage } from \"@ponythewhite/base-context-agent\";\nimport { stringifyBoundedJson } from \"./bounded-json.js\";\nimport type { ToolContinuationGroup } from \"./context-epoch.js\";\nimport type { CustomMessage } from \"./messages.js\";\nimport type { SourceSnapshotRef } from \"./request-events.js\";\nimport { retainedToolOutput } from \"./retained-tool-output.js\";\n\nfunction retainedRecovery(message: AgentMessage, entryId: string) {\n\tif (message.role !== \"toolResult\") return undefined;\n\tconst retained = retainedToolOutput((message.details as { retainedOutput?: unknown } | undefined)?.retainedOutput);\n\treturn retained\n\t\t? {\n\t\t\t\tref: entryId,\n\t\t\t\tfield: retained.field,\n\t\t\t\tbyteLength: retained.byteLength,\n\t\t\t\tcaptureComplete: retained.captureComplete,\n\t\t\t}\n\t\t: undefined;\n}\n\nexport const PUBLIC_CONTEXT_RENDERER = \"public-history/1\";\nexport const PUBLIC_TOOL_CONTINUATION_RENDERER = \"public-tool-continuation/1\";\n\n/** Original public text and minimal recorded facts. Intent ACK says nothing about external effects. */\nexport function renderToolContinuation(\n\tmessage: AgentMessage,\n\tentryId: string,\n\tsource: SourceSnapshotRef,\n\tgroup: ToolContinuationGroup,\n\tmaxBytes: number,\n): CustomMessage & { content: string } {\n\tif (message.role !== \"assistant\" && message.role !== \"toolResult\")\n\t\tthrow new Error(\"Tool continuation requires its original replay group\");\n\tconst content: { type: \"text\"; text: string }[] = [];\n\tfor (const part of message.content) {\n\t\tif (part.type === \"text\") content.push({ type: \"text\", text: part.text });\n\t\telse if (part.type !== \"thinking\" && part.type !== \"toolCall\")\n\t\t\tthrow new Error(\"Tool continuation requires text-only public content\");\n\t}\n\tconst data = stringifyBoundedJson(\n\t\t{\n\t\t\tsource: { sessionId: source.sessionId },\n\t\t\tentryId,\n\t\t\t...(retainedRecovery(message, entryId) ? { recovery: retainedRecovery(message, entryId) } : {}),\n\t\t\trole: message.role,\n\t\t\tcontent,\n\t\t\t...(message.role === \"assistant\"\n\t\t\t\t? {\n\t\t\t\t\t\tcalls: group.calls.map((call) => ({\n\t\t\t\t\t\t\texecutionId: call.executionId,\n\t\t\t\t\t\t\tintentEntryId: call.intent.id,\n\t\t\t\t\t\t\tintent: \"recorded\",\n\t\t\t\t\t\t\toutcome: call.outcome,\n\t\t\t\t\t\t\t...(call.result ? { resultEntryId: call.result.id } : {}),\n\t\t\t\t\t\t})),\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t},\n\t\tmaxBytes,\n\t);\n\tconst rendered: CustomMessage & { content: string } = {\n\t\trole: \"custom\",\n\t\tcustomType: PUBLIC_TOOL_CONTINUATION_RENDERER,\n\t\tcontent: `Recorded tool continuation data. Intent acknowledgment records intent only; an absent finalized result leaves the outcome unknown.\n${data}`,\n\t\tdisplay: false,\n\t\ttimestamp: message.timestamp,\n\t};\n\tstringifyBoundedJson(rendered, maxBytes);\n\treturn rendered;\n}\n\n/** An explicit public window, not replacement text for a native signature or opaque item. */\nexport function renderPublicHistory(message: AgentMessage, entryId: string, maxBytes: number): AgentMessage {\n\tif (message.role !== \"assistant\" && message.role !== \"toolResult\") return message;\n\tconst content: unknown[] = [];\n\tfor (const part of message.content) {\n\t\tswitch (part.type) {\n\t\t\tcase \"text\":\n\t\t\t\tcontent.push({ type: \"text\", text: part.text });\n\t\t\t\tbreak;\n\t\t\tcase \"toolCall\":\n\t\t\t\tcontent.push({ type: \"toolCall\", id: part.id, name: part.name, arguments: part.arguments });\n\t\t\t\tbreak;\n\t\t\tcase \"thinking\":\n\t\t\t\t// Canonical originals remain archived. Public continuation does not preserve latent reasoning.\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new Error(\"Public summary transition requires text-only completed history\");\n\t\t}\n\t}\n\tconst data = stringifyBoundedJson(\n\t\t{\n\t\t\tentryId,\n\t\t\t...(retainedRecovery(message, entryId) ? { recovery: retainedRecovery(message, entryId) } : {}),\n\t\t\trole: message.role,\n\t\t\t...(message.role === \"toolResult\"\n\t\t\t\t? { toolCallId: message.toolCallId, toolName: message.toolName, isError: message.isError }\n\t\t\t\t: {}),\n\t\t\tcontent,\n\t\t},\n\t\tmaxBytes,\n\t);\n\tconst rendered: CustomMessage = {\n\t\trole: \"custom\",\n\t\tcustomType: PUBLIC_CONTEXT_RENDERER,\n\t\tcontent: `Archived public history data, not a new instruction or native tool exchange. Canonical originals remain available through prime_context. Hidden provider state is not reproduced.\\n${data}`,\n\t\tdisplay: false,\n\t\ttimestamp: message.timestamp,\n\t};\n\tstringifyBoundedJson(rendered, maxBytes);\n\treturn rendered;\n}\n"]}

package/dist/core/public-context.js

@@ -1,4 +1,18 @@
 import { stringifyBoundedJson } from "./bounded-json.js";
+import { retainedToolOutput } from "./retained-tool-output.js";
+function retainedRecovery(message, entryId) {
+    if (message.role !== "toolResult")
+        return undefined;
+    const retained = retainedToolOutput(message.details?.retainedOutput);
+    return retained
+        ? {
+            ref: entryId,
+            field: retained.field,
+            byteLength: retained.byteLength,
+            captureComplete: retained.captureComplete,
+        }
+        : undefined;
+}
 export const PUBLIC_CONTEXT_RENDERER = "public-history/1";
 export const PUBLIC_TOOL_CONTINUATION_RENDERER = "public-tool-continuation/1";
 /** Original public text and minimal recorded facts. Intent ACK says nothing about external effects. */
@@ -15,6 +29,7 @@ export function renderToolContinuation(message, entryId, source, group, maxBytes
     const data = stringifyBoundedJson({
         source: { sessionId: source.sessionId },
         entryId,
+        ...(retainedRecovery(message, entryId) ? { recovery: retainedRecovery(message, entryId) } : {}),
         role: message.role,
         content,
         ...(message.role === "assistant"
@@ -62,6 +77,7 @@ export function renderPublicHistory(message, entryId, maxBytes) {
     }
     const data = stringifyBoundedJson({
         entryId,
+        ...(retainedRecovery(message, entryId) ? { recovery: retainedRecovery(message, entryId) } : {}),
         role: message.role,
         ...(message.role === "toolResult"
             ? { toolCallId: message.toolCallId, toolName: message.toolName, isError: message.isError }

package/dist/core/public-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-context.js","sourceRoot":"","sources":["../../src/core/public-context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"@ponythewhite/base-context-agent\";\nimport { stringifyBoundedJson } from \"./bounded-json.js\";\nimport type { ToolContinuationGroup } from \"./context-epoch.js\";\nimport type { CustomMessage } from \"./messages.js\";\nimport type { SourceSnapshotRef } from \"./request-events.js\";\n\nexport const PUBLIC_CONTEXT_RENDERER = \"public-history/1\";\nexport const PUBLIC_TOOL_CONTINUATION_RENDERER = \"public-tool-continuation/1\";\n\n/** Original public text and minimal recorded facts. Intent ACK says nothing about external effects. */\nexport function renderToolContinuation(\n\tmessage: AgentMessage,\n\tentryId: string,\n\tsource: SourceSnapshotRef,\n\tgroup: ToolContinuationGroup,\n\tmaxBytes: number,\n): CustomMessage & { content: string } {\n\tif (message.role !== \"assistant\" && message.role !== \"toolResult\")\n\t\tthrow new Error(\"Tool continuation requires its original replay group\");\n\tconst content: { type: \"text\"; text: string }[] = [];\n\tfor (const part of message.content) {\n\t\tif (part.type === \"text\") content.push({ type: \"text\", text: part.text });\n\t\telse if (part.type !== \"thinking\" && part.type !== \"toolCall\")\n\t\t\tthrow new Error(\"Tool continuation requires text-only public content\");\n\t}\n\tconst data = stringifyBoundedJson(\n\t\t{\n\t\t\tsource: { sessionId: source.sessionId },\n\t\t\tentryId,\n\t\t\trole: message.role,\n\t\t\tcontent,\n\t\t\t...(message.role === \"assistant\"\n\t\t\t\t? {\n\t\t\t\t\t\tcalls: group.calls.map((call) => ({\n\t\t\t\t\t\t\texecutionId: call.executionId,\n\t\t\t\t\t\t\tintentEntryId: call.intent.id,\n\t\t\t\t\t\t\tintent: \"recorded\",\n\t\t\t\t\t\t\toutcome: call.outcome,\n\t\t\t\t\t\t\t...(call.result ? { resultEntryId: call.result.id } : {}),\n\t\t\t\t\t\t})),\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t},\n\t\tmaxBytes,\n\t);\n\tconst rendered: CustomMessage & { content: string } = {\n\t\trole: \"custom\",\n\t\tcustomType: PUBLIC_TOOL_CONTINUATION_RENDERER,\n\t\tcontent: `Recorded tool continuation data. Intent acknowledgment records intent only; an absent finalized result leaves the outcome unknown.\n${data}`,\n\t\tdisplay: false,\n\t\ttimestamp: message.timestamp,\n\t};\n\tstringifyBoundedJson(rendered, maxBytes);\n\treturn rendered;\n}\n\n/** An explicit public window, not replacement text for a native signature or opaque item. */\nexport function renderPublicHistory(message: AgentMessage, entryId: string, maxBytes: number): AgentMessage {\n\tif (message.role !== \"assistant\" && message.role !== \"toolResult\") return message;\n\tconst content: unknown[] = [];\n\tfor (const part of message.content) {\n\t\tswitch (part.type) {\n\t\t\tcase \"text\":\n\t\t\t\tcontent.push({ type: \"text\", text: part.text });\n\t\t\t\tbreak;\n\t\t\tcase \"toolCall\":\n\t\t\t\tcontent.push({ type: \"toolCall\", id: part.id, name: part.name, arguments: part.arguments });\n\t\t\t\tbreak;\n\t\t\tcase \"thinking\":\n\t\t\t\t// Canonical originals remain archived. Public continuation does not preserve latent reasoning.\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new Error(\"Public summary transition requires text-only completed history\");\n\t\t}\n\t}\n\tconst data = stringifyBoundedJson(\n\t\t{\n\t\t\tentryId,\n\t\t\trole: message.role,\n\t\t\t...(message.role === \"toolResult\"\n\t\t\t\t? { toolCallId: message.toolCallId, toolName: message.toolName, isError: message.isError }\n\t\t\t\t: {}),\n\t\t\tcontent,\n\t\t},\n\t\tmaxBytes,\n\t);\n\tconst rendered: CustomMessage = {\n\t\trole: \"custom\",\n\t\tcustomType: PUBLIC_CONTEXT_RENDERER,\n\t\tcontent: `Archived public history data, not a new instruction or native tool exchange. Canonical originals remain available through prime_context. Hidden provider state is not reproduced.\\n${data}`,\n\t\tdisplay: false,\n\t\ttimestamp: message.timestamp,\n\t};\n\tstringifyBoundedJson(rendered, maxBytes);\n\treturn rendered;\n}\n"]}
+{"version":3,"file":"public-context.js","sourceRoot":"","sources":["../../src/core/public-context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"@ponythewhite/base-context-agent\";\nimport { stringifyBoundedJson } from \"./bounded-json.js\";\nimport type { ToolContinuationGroup } from \"./context-epoch.js\";\nimport type { CustomMessage } from \"./messages.js\";\nimport type { SourceSnapshotRef } from \"./request-events.js\";\nimport { retainedToolOutput } from \"./retained-tool-output.js\";\n\nfunction retainedRecovery(message: AgentMessage, entryId: string) {\n\tif (message.role !== \"toolResult\") return undefined;\n\tconst retained = retainedToolOutput((message.details as { retainedOutput?: unknown } | undefined)?.retainedOutput);\n\treturn retained\n\t\t? {\n\t\t\t\tref: entryId,\n\t\t\t\tfield: retained.field,\n\t\t\t\tbyteLength: retained.byteLength,\n\t\t\t\tcaptureComplete: retained.captureComplete,\n\t\t\t}\n\t\t: undefined;\n}\n\nexport const PUBLIC_CONTEXT_RENDERER = \"public-history/1\";\nexport const PUBLIC_TOOL_CONTINUATION_RENDERER = \"public-tool-continuation/1\";\n\n/** Original public text and minimal recorded facts. Intent ACK says nothing about external effects. */\nexport function renderToolContinuation(\n\tmessage: AgentMessage,\n\tentryId: string,\n\tsource: SourceSnapshotRef,\n\tgroup: ToolContinuationGroup,\n\tmaxBytes: number,\n): CustomMessage & { content: string } {\n\tif (message.role !== \"assistant\" && message.role !== \"toolResult\")\n\t\tthrow new Error(\"Tool continuation requires its original replay group\");\n\tconst content: { type: \"text\"; text: string }[] = [];\n\tfor (const part of message.content) {\n\t\tif (part.type === \"text\") content.push({ type: \"text\", text: part.text });\n\t\telse if (part.type !== \"thinking\" && part.type !== \"toolCall\")\n\t\t\tthrow new Error(\"Tool continuation requires text-only public content\");\n\t}\n\tconst data = stringifyBoundedJson(\n\t\t{\n\t\t\tsource: { sessionId: source.sessionId },\n\t\t\tentryId,\n\t\t\t...(retainedRecovery(message, entryId) ? { recovery: retainedRecovery(message, entryId) } : {}),\n\t\t\trole: message.role,\n\t\t\tcontent,\n\t\t\t...(message.role === \"assistant\"\n\t\t\t\t? {\n\t\t\t\t\t\tcalls: group.calls.map((call) => ({\n\t\t\t\t\t\t\texecutionId: call.executionId,\n\t\t\t\t\t\t\tintentEntryId: call.intent.id,\n\t\t\t\t\t\t\tintent: \"recorded\",\n\t\t\t\t\t\t\toutcome: call.outcome,\n\t\t\t\t\t\t\t...(call.result ? { resultEntryId: call.result.id } : {}),\n\t\t\t\t\t\t})),\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t},\n\t\tmaxBytes,\n\t);\n\tconst rendered: CustomMessage & { content: string } = {\n\t\trole: \"custom\",\n\t\tcustomType: PUBLIC_TOOL_CONTINUATION_RENDERER,\n\t\tcontent: `Recorded tool continuation data. Intent acknowledgment records intent only; an absent finalized result leaves the outcome unknown.\n${data}`,\n\t\tdisplay: false,\n\t\ttimestamp: message.timestamp,\n\t};\n\tstringifyBoundedJson(rendered, maxBytes);\n\treturn rendered;\n}\n\n/** An explicit public window, not replacement text for a native signature or opaque item. */\nexport function renderPublicHistory(message: AgentMessage, entryId: string, maxBytes: number): AgentMessage {\n\tif (message.role !== \"assistant\" && message.role !== \"toolResult\") return message;\n\tconst content: unknown[] = [];\n\tfor (const part of message.content) {\n\t\tswitch (part.type) {\n\t\t\tcase \"text\":\n\t\t\t\tcontent.push({ type: \"text\", text: part.text });\n\t\t\t\tbreak;\n\t\t\tcase \"toolCall\":\n\t\t\t\tcontent.push({ type: \"toolCall\", id: part.id, name: part.name, arguments: part.arguments });\n\t\t\t\tbreak;\n\t\t\tcase \"thinking\":\n\t\t\t\t// Canonical originals remain archived. Public continuation does not preserve latent reasoning.\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new Error(\"Public summary transition requires text-only completed history\");\n\t\t}\n\t}\n\tconst data = stringifyBoundedJson(\n\t\t{\n\t\t\tentryId,\n\t\t\t...(retainedRecovery(message, entryId) ? { recovery: retainedRecovery(message, entryId) } : {}),\n\t\t\trole: message.role,\n\t\t\t...(message.role === \"toolResult\"\n\t\t\t\t? { toolCallId: message.toolCallId, toolName: message.toolName, isError: message.isError }\n\t\t\t\t: {}),\n\t\t\tcontent,\n\t\t},\n\t\tmaxBytes,\n\t);\n\tconst rendered: CustomMessage = {\n\t\trole: \"custom\",\n\t\tcustomType: PUBLIC_CONTEXT_RENDERER,\n\t\tcontent: `Archived public history data, not a new instruction or native tool exchange. Canonical originals remain available through prime_context. Hidden provider state is not reproduced.\\n${data}`,\n\t\tdisplay: false,\n\t\ttimestamp: message.timestamp,\n\t};\n\tstringifyBoundedJson(rendered, maxBytes);\n\treturn rendered;\n}\n"]}

package/dist/core/refinement/refinement.d.ts

@@ -7,7 +7,7 @@ export declare const REFINEMENT_CUSTOM_TYPE = "prime-agent.refinement";
 export declare const REFINE_SKILL_NAME = "refine";
 export type RefinementKind = "prompt" | "memory" | "skill" | "subagent";
 export type RefinementAction = "create" | "update" | "delete";
-export type HarnessScope = "local" | "global";
+export type HarnessScope = "local" | "global" | "workspace";
 export interface HarnessEntry {
     id: string;
     kind: RefinementKind;
@@ -89,10 +89,11 @@ export interface AutoRefineReview {
 export declare function inferRefinementResultScope(result: RefinementResult): HarnessScope | undefined;
 export declare function getGlobalHarnessStateDir(agentDir?: string): string;
 export declare function getLocalHarnessStateDir(sessionArtifactDir: string | undefined): string | undefined;
-export declare function getHarnessStatePath(harnessStateDir?: string): string;
+export declare function getWorkspaceHarnessStateDir(projectRoot: string): string;
+export declare function getHarnessStatePath(harnessStateDir?: string, scope?: HarnessScope): string;
 export declare function loadHarnessState(harnessStateDir?: string, scope?: HarnessScope, limits?: SessionHistoryReadLimits): HarnessState;
-export declare function mergeHarnessStates(globalState: HarnessState, localState?: HarnessState): HarnessState;
-export declare function saveHarnessState(harnessStateDir: string, state: HarnessState, limits?: SessionHistoryReadLimits): string;
+export declare function mergeHarnessStates(globalState: HarnessState, localState?: HarnessState, workspaceState?: HarnessState): HarnessState;
+export declare function saveHarnessState(harnessStateDir: string, state: HarnessState, limits?: SessionHistoryReadLimits, scope?: HarnessScope): string;
 export declare function getRefinementHistoryPath(harnessStateDir?: string): string;
 /**
  * Append a global-scope refinement to the cross-session history log so it can be
@@ -106,13 +107,26 @@ export declare function loadGlobalRefinementHistory(harnessStateDir?: string, li
  * win on conflict so a session that is mid-flight still resolves its own latest result.
  */
 export declare function mergeRefinementHistory(global: readonly RefinementResult[], session: readonly RefinementResult[]): RefinementResult[];
+export interface ErrorFixSelectionOptions {
+    enabled: boolean;
+    /** Captured available tool names; this does not predict the next tool call. */
+    tools: readonly string[];
+    operation?: string;
+    goal?: string;
+    /** Only values already known to the owner; retrieval never probes the environment. */
+    environment?: Readonly<Record<string, string>>;
+    /** Local request-meter text cost, including the complete rendered advice wrapper. */
+    countTokens: (text: string) => number;
+}
+/** Optional contextual advice, never a replacement for current task evidence or policy. */
+export declare function selectErrorFixAdvice(state: HarnessState, options: ErrorFixSelectionOptions): string;
 export declare function formatHarnessStateForPrompt(state: HarnessState, options?: {
     maxEntriesPerKind?: number;
-    maxRefinements?: number;
     maxContentLength?: number;
     includeIpythonExamples?: boolean;
     includeShellExamples?: boolean;
     includeRefineExamples?: boolean;
+    errorFixSelection?: ErrorFixSelectionOptions;
 }): string;
 /**
  * Normalizes an untrusted refinement proposal while preserving invalid edit