@ponythewhite/base-context 1.0.14 → 1.0.16

package/dist/utils/file-lines.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-lines.js","sourceRoot":"","sources":["../../src/utils/file-lines.ts"],"names":[],"mappings":"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","sourcesContent":["import { closeSync, createReadStream, openSync, readSync } from \"node:fs\";\n\nexport function readFirstLineBufferSync(\n\tfilePath: string,\n\tmaxBytes = 64 * 1024,\n\tallowIncomplete = false,\n): Buffer | undefined {\n\tconst fd = openSync(filePath, \"r\");\n\tconst chunks: Buffer[] = [];\n\tlet position = 0;\n\ttry {\n\t\tconst buffer = Buffer.alloc(1024);\n\t\twhile (position < maxBytes) {\n\t\t\tconst count = readSync(fd, buffer, 0, Math.min(buffer.length, maxBytes - position), position);\n\t\t\tif (count === 0) break;\n\t\t\tconst chunk = buffer.subarray(0, count);\n\t\t\tconst newline = chunk.indexOf(0x0a);\n\t\t\tif (newline !== -1) {\n\t\t\t\tchunks.push(Buffer.from(chunk.subarray(0, newline + 1)));\n\t\t\t\treturn Buffer.concat(chunks);\n\t\t\t}\n\t\t\tchunks.push(Buffer.from(chunk));\n\t\t\tposition += count;\n\t\t}\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n\treturn allowIncomplete && chunks.length > 0 ? Buffer.concat(chunks) : undefined;\n}\n\nexport function readFirstLineSync(filePath: string, maxBytes = 64 * 1024, completeOnly = false): string | undefined {\n\treturn readFirstLineBufferSync(filePath, maxBytes, !completeOnly)\n\t\t?.toString(\"utf8\")\n\t\t.replace(/\\n$/, \"\")\n\t\t.replace(/\\r$/, \"\");\n}\n\nexport async function* readLinesAsBuffers(\n\tfilePath: string,\n\toptions: { maxLineBytes?: number; includeNewline?: boolean; completeOnly?: boolean } = {},\n): AsyncGenerator<Buffer> {\n\tconst maxBytes = options.maxLineBytes ?? Infinity;\n\tif (maxBytes <= 0 || (maxBytes !== Infinity && !Number.isSafeInteger(maxBytes)))\n\t\tthrow new Error(\"Invalid line byte limit\");\n\tconst pendingParts: Buffer[] = [];\n\tlet pendingBytes = 0;\n\tfor await (const chunk of createReadStream(filePath)) {\n\t\tconst buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n\t\tlet start = 0;\n\t\twhile (start < buffer.length) {\n\t\t\tconst end = buffer.indexOf(0x0a, start);\n\t\t\tconst stop = end === -1 ? buffer.length : end + (options.includeNewline ? 1 : 0);\n\t\t\tconst part = buffer.subarray(start, stop);\n\t\t\tif (pendingBytes + part.length > maxBytes) throw new Error(\"Line byte limit exceeded\");\n\t\t\tif (end === -1) {\n\t\t\t\tpendingParts.push(part);\n\t\t\t\tpendingBytes += part.length;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (pendingParts.length > 0) {\n\t\t\t\tpendingParts.push(part);\n\t\t\t\tconst line = Buffer.concat(pendingParts, pendingBytes + part.length);\n\t\t\t\tpendingParts.length = 0;\n\t\t\t\tpendingBytes = 0;\n\t\t\t\tyield line;\n\t\t\t} else yield part;\n\t\t\tstart = end + 1;\n\t\t}\n\t}\n\tif (pendingParts.length > 0 && !options.completeOnly) yield Buffer.concat(pendingParts, pendingBytes);\n}\n"]}
+{"version":3,"file":"file-lines.js","sourceRoot":"","sources":["../../src/utils/file-lines.ts"],"names":[],"mappings":"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","sourcesContent":["import { closeSync, createReadStream, openSync, readSync } from \"node:fs\";\n\nexport function readFirstLineBufferSync(\n\tfilePath: string,\n\tmaxBytes = 64 * 1024,\n\tallowIncomplete = false,\n): Buffer | undefined {\n\tconst fd = openSync(filePath, \"r\");\n\tconst chunks: Buffer[] = [];\n\tlet position = 0;\n\ttry {\n\t\tconst buffer = Buffer.alloc(1024);\n\t\twhile (position < maxBytes) {\n\t\t\tconst count = readSync(fd, buffer, 0, Math.min(buffer.length, maxBytes - position), position);\n\t\t\tif (count === 0) break;\n\t\t\tconst chunk = buffer.subarray(0, count);\n\t\t\tconst newline = chunk.indexOf(0x0a);\n\t\t\tif (newline !== -1) {\n\t\t\t\tchunks.push(Buffer.from(chunk.subarray(0, newline + 1)));\n\t\t\t\treturn Buffer.concat(chunks);\n\t\t\t}\n\t\t\tchunks.push(Buffer.from(chunk));\n\t\t\tposition += count;\n\t\t}\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n\treturn allowIncomplete && chunks.length > 0 ? Buffer.concat(chunks) : undefined;\n}\n\nexport function readFirstLineSync(filePath: string, maxBytes = 64 * 1024, completeOnly = false): string | undefined {\n\treturn readFirstLineBufferSync(filePath, maxBytes, !completeOnly)\n\t\t?.toString(\"utf8\")\n\t\t.replace(/\\n$/, \"\")\n\t\t.replace(/\\r$/, \"\");\n}\n\nexport async function* readLinesAsBuffers(\n\tfilePath: string,\n\toptions: { maxLineBytes?: number; includeNewline?: boolean; completeOnly?: boolean } = {},\n): AsyncGenerator<Buffer> {\n\tconst maxBytes = options.maxLineBytes ?? Infinity;\n\tif (maxBytes <= 0 || (maxBytes !== Infinity && !Number.isSafeInteger(maxBytes)))\n\t\tthrow new Error(\"Invalid line byte limit\");\n\tconst pendingParts: Buffer[] = [];\n\tlet pendingBytes = 0;\n\tfor await (const chunk of createReadStream(filePath)) {\n\t\tconst buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n\t\tlet start = 0;\n\t\twhile (start < buffer.length) {\n\t\t\tconst end = buffer.indexOf(0x0a, start);\n\t\t\tconst stop = end === -1 ? buffer.length : end + (options.includeNewline ? 1 : 0);\n\t\t\tconst part = buffer.subarray(start, stop);\n\t\t\tif (pendingBytes + part.length > maxBytes) throw new Error(\"Line byte limit exceeded\");\n\t\t\tif (end === -1) {\n\t\t\t\tpendingParts.push(part);\n\t\t\t\tpendingBytes += part.length;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (pendingParts.length > 0) {\n\t\t\t\tpendingParts.push(part);\n\t\t\t\tconst line = Buffer.concat(pendingParts, pendingBytes + part.length);\n\t\t\t\tpendingParts.length = 0;\n\t\t\t\tpendingBytes = 0;\n\t\t\t\tyield line;\n\t\t\t} else yield part;\n\t\t\tstart = end + 1;\n\t\t}\n\t}\n\tif (pendingParts.length > 0 && !options.completeOnly) {\n\t\tconst line = Buffer.concat(pendingParts, pendingBytes);\n\t\tpendingParts.length = 0;\n\t\tpendingBytes = 0;\n\t\tyield line;\n\t}\n}\n"]}

package/docs/rlm-runtime.md

@@ -90,6 +90,7 @@ Requests flow to the runtime on stdin and events return on stdout, one JSON obje
 
 ```text
 requests  execute, interrupt, host_reply, snapshot, restore, list_names, shutdown
+optional  job_watch_probe (job_watch_probe_v1 capability)
 events    ready, stdout, stderr, result, display, host_request, error, done
 ```
 
@@ -97,6 +98,8 @@ Output events carry the id of the cell that was running when the bytes were prod
 
 Calls to `ReplKernelManager.execute()` are serialized. One kernel has one shared namespace and does not run two ordinary Python cells concurrently. RLM child agents can still run concurrently because each delegation uses a distinct host request and child runtime.
 
+The optional `job_watch_probe_v1` ready capability supports contained read-only probes outside the cell FIFO and passive Bash completion callbacks. `AgentSession` schedules and compares observations before model admission, then uses ordinary prepared follow-ups. Explicit parking gates goal and autonomous continuation, not user input or unrelated work. No daemon protocol version changes; an older runtime without the capability is refused locally. See [job-watch](../skills/job-watch/SKILL.md) for reporting, restoration, and supported backlog limits.
+
 ## Host-Request Event Flow
 
 A running cell can await task admission:
@@ -173,7 +176,7 @@ test_review = await rlm("review the tests", name="test-reviewer")
 audit = await rlm("slow independent audit", name="audit-reviewer")
 ```
 
-End the turn instead of waiting for completion. Children send requested answers with `await agent_message.send(message, receiver_role="parent")`, and replies arrive as ordinary agent messages over later turns. A child may instead write results to files for the parent to read. The host runs each admitted child as an independent `AgentSession`; daemon-backed children can be retained as independently addressable session workers.
+End the turn instead of waiting for completion. Use `agent_message.send` for short coordination and `await agent_message.send_result(summary, findings, receiver_role="parent")` for substantial findings or final reports. Replies arrive over later turns; recover capsule details only when needed. Without that capability, use files for fan-in. The host runs each admitted child as an independent `AgentSession`; daemon-backed children can be retained as independently addressable session workers.
 
 ## Parent-Scoped Sub-Agent Registry
 

package/docs/skills.md

@@ -51,6 +51,8 @@ Base Context ships with built-in skills that load by default:
 
 - `skill-creator` - teaches the agent to create new skills: markdown skill layout, frontmatter rules, placement and precedence, and the full Python-backed skill contract (package layout, `run()` convention, optional CLI, kernel venv behavior) with a working template in `references/python-skills.md`.
 - `websearch` - a Python-backed Google search skill using the [Serper](https://serper.dev) API.
+- [`job-watch`](../skills/job-watch/SKILL.md) - native job completion/probe monitoring, prepared reports, and scoped goal/autonomous waiting. Launch jobs through `bash()` or existing authorized helpers.
+- [`bounded-inspect`](../skills/bounded-inspect/SKILL.md) - selected text/JSON evidence under shared source and serialized-output budgets. Historical conversation recovery remains with `prime_context`.
 
 Built-in skills behave like any other skill but have the lowest precedence: a user, project, package, or `--skill` skill with the same name overrides the built-in one.
 
@@ -138,8 +140,9 @@ This is progressive disclosure: only descriptions are always in context, full in
 
 For native epochs, select an advertised skill with
 `prime_context` using `{"action":"skill","name":"..."}`. The response gives its
-captured body and canonical source reference. Use the returned ref and field with
-`action="read"` for bounded recovery; do not reopen the mutable location to replace
+captured body and canonical source reference. If the complete body is already
+in context, no duplicate read is needed. For later bounded recovery, use the
+returned ref and field with `action="read"`; do not reopen the mutable location to replace
 a selected version. A committed epoch keeps that selected descriptor and instruction
 body. After an existing context transition commits a new epoch, a later selection
 can capture updated contents. The original captured body remains recoverable from
@@ -157,18 +160,19 @@ Skills with `disable-model-invocation: true` are hidden from the startup skill l
 
 For repeated multi-step work, start with an ordinary named Python function in
 `ipython`. Keep one-off operations inline and prefer an existing project command
-when it already does the work. Give changing paths, selectors, output paths and
-options explicit parameters. Reuse the code, not its previous answer: read current
+when it already does the work. Pass the current commit, configuration, paths,
+resource identity, selectors and limits explicitly where applicable. Reuse the code, not its previous answer: read current
 inputs on every call. Do not capture an open handle or hidden mutable REPL state.
 
-After two useful occurrences across tasks, or an explicit request for reuse, save
-the function in an editable `.py` file with a short project markdown skill. This
-is a practical heuristic, not a repetition detector. A small helper needs no
+After two useful occurrences, or an explicit request for reuse, save the function
+in a small editable project `.py` file. Short project instructions are optional;
+no new global skill is needed. This is a practical heuristic, not a repetition
+detector. A small helper needs no
 `pyproject.toml`, package installation, manifest or promotion step. Use the standard
 library and dependencies already available in the selected environment.
 
-For example, save `scripts/matching_lines.py` in
-`.base-context/skills/matching-lines/`:
+For example, save `scripts/matching_lines.py` in the project. This example is
+for small files; use `bounded-inspect` for potentially large evidence:
 
 ```python
 from pathlib import Path
@@ -188,26 +192,13 @@ def matching_lines(path: str, needle: str, limit: int = 20) -> list[tuple[int, s
     return matches
 ```
 
-Add the ordinary `SKILL.md` next to `scripts/`:
-
-```markdown
----
-name: matching-lines
-description: Read current UTF-8 files for repeated literal line lookups. Inputs are path, needle and limit; output is a list of one-based line numbers and text.
----
-Load scripts/matching_lines.py afresh with runpy.run_path, then call
-matching_lines(path, needle, limit=20). Resolve the script path against this
-skill directory. No matches returns an empty list; ordinary errors propagate.
-```
-
-Only the short skill description enters discovery. Load the instructions and code
-when the active task needs them. For this standard-library helper, a fresh load
-and call in `ipython` can be:
+For this standard-library helper, load the saved file afresh and call it in
+`ipython`. No registration or package installation is needed:
 
 ```python
 from runpy import run_path
 
-matching_lines = run_path("/repo/.base-context/skills/matching-lines/scripts/matching_lines.py")["matching_lines"]
+matching_lines = run_path("/repo/scripts/matching_lines.py")["matching_lines"]
 matches = matching_lines("/repo/current.txt", "needle", limit=20)
 ```
 
@@ -217,7 +208,8 @@ use the project's own environment instead of installing them into the kernel.
 Fresh execution of editable code does not replace the captured instruction body
 of an active native skill epoch.
 
-Saving a helper does not schedule or authorize execution. Invocation still needs
+Repetition never authorizes another deployment or experiment. Saving a helper
+does not schedule or authorize execution. Invocation still needs
 the normal model/tool decision or an explicit user workflow, under the existing
 permissions. Do not add an import manager, dependency snapshots or per-call setup.
 

package/docs/upstream-1.0.15.md

@@ -0,0 +1,83 @@
+# Prime Agent selection for Base Context 1.0.15
+
+This is a selective adaptation, not an upstream merge.
+
+Base Context forked Prime Agent 0.9.3 at
+`915c78f42c248b08238dd27fcd4bcab32c60beab`. This review screened all 222
+subsequent commits through `2d24ad4e6b2d1ee8e6919af6f108e980a14d550e`
+(2026-09-27): 10 through 0.9.4, the 113 commits covered by the prior
+[0.9.5 selection](upstream-0.9.5.md), and 99 after 0.9.5. Relevant runtime,
+compaction, goal, and workflow changes received focused source comparison;
+this is not a full audit of every changed function.
+
+The latest stable release in this review was Prime Agent 0.9.6,
+`e260085dd8f742e0def3d871860c9a888b114851`, published 2026-09-24. Six later
+main commits were also screened. A commit can be absent from fork ancestry
+while its selected behavior is already implemented locally.
+
+## Selected small fixes
+
+| Exact upstream commit | Adaptation |
+|---|---|
+| `a0660bb5f823bcd9490a83ca3e822d7d53f36e24` | Clear a failed direct daemon-worker connection's socket and channel references, so the same client can retry after a connection error or timeout. Keep Base Context's native-owner, compatibility, and probe-timeout handling. Do not refactor the already-correct daemon-client connection path merely to share a helper. |
+| `b6b94c78a7747997e0ec6c690c0e8f2a563dbe14` | Add the missing kernel stderr stream error listener, matching the existing stdin/stdout listeners. Record the diagnostic without taking cleanup ownership from pending writes and child exit. |
+
+These changes add no provider, model, daemon command, wire shape, or protocol
+version. Focused coverage belongs in the existing `daemon-client.test.ts` and
+`repl-kernel-pipe-errors.test.ts` files. Test outcomes belong to the change's
+validation record, not to this upstream-selection rationale.
+
+## Relevant decisions
+
+Upstream commits can be viewed at
+`https://github.com/PrimeIntellect-ai/prime-agent/commit/<commit>`.
+
+| Exact upstream commit | Decision | Reason |
+|---|---|---|
+| `90ca4a457e0fef0bd925215d4c973abd6264f067` | Already adapted | Kernel stdin/stdout pipe errors are already handled. Keep that behavior; only stderr was missing. |
+| `55ade48b73f636d992855b7cab797d71dc1f6f1c` | Already adapted | LiteLLM overflow recognition and rate-limit exclusions already match upstream. A local history-source limit is not a provider context overflow. |
+| `8eaa00c37385c6b25fed9d46584b50ffc2e87f9c` | Already adapted | Blocked input-pump idle waits already yield, with additional native settlement/admission guards. |
+| `b3e04b58b358ae9adc02387e6d01937ef9f8064f` | Defer native adaptation | Restoring non-durable next-turn prefixes from every cancelled turn is relevant, but must preserve the native action/source owner. Not part of the two isolated runtime patches. |
+| `c4afa57352e71a8532f04ef04a09ce14720ddeca` | Defer | Deriving displayed activity from actual session activity rather than summary freshness is useful, but is a separate UI/state change. |
+| `bcdcd6e65e10959c9904ec4467747528303493b0` | Defer native adaptation | Manual-compaction goal resume must use Base Context's captured-owner continuation lifecycle, not upstream queue scheduling. |
+| `215e7a7409b2931b49d3aad62d29fa8e94345973` | Defer native adaptation | Same-goal accounting should remain monotonic across summary moves, without applying maxima across unrelated goals or deliberate branch navigation. The upstream reload helper has been replaced locally. |
+| `9bd6a9bc0fbc1e4072cfd7162f855a305c39efb0` | Defer native adaptation | Refresh queued goal accounting at a native admission/capture boundary; do not copy upstream in-place mutation of accepted message content. |
+| `2e43ebca3753c82ed0ef2064cb14081588ebd4d3`, `b08f08efad6830856318e994447162ba3fd4c6ee` | Reject as-is | Blanket continuation pauses while children or background shells run prevent independent work. A running resource does not establish a dependency. |
+| `5fb3d9acbafa06ae9228c49a4b8a4eca9abc0997` | Defer summary adaptation | Tool name, error status, and matching call indices improve summary input, but change prompt representation and need to fit native context budgets. |
+| `27f32ddb7e99803555c4654c9ce38edad3e90e22` | Defer summary adaptation | Strip repeated mechanical file lists if adopted. Kept-tail recency must not promote assistant statements over user constraints or TaskFrame authority. Silent list caps are not acceptable substitutes for visible limits. |
+| `6be5d4f297f112df8b57b6807de9405c5444fc0f`, `f31c440c788499a4ba49736acbf1504a25e3ad4c` | Retain prior deferral | Head/tail excerpts and kernel-reported file paths change summary selection. Retain recoverable original evidence; do not silently cap file lists or promote tool observations to task authority. |
+| `4f6df9d14385368a148c22e65dfc6050fbb984f1` | Reject routing policy | Automatic auxiliary-model fallback and suppressed reasoning would override explicit compaction model/effort selection. Native request budgeting remains authoritative. |
+| `c91e6e991fc006098ea21c3640eed3bdd268c222`, `0e3c900225f8beea4ecd57180902d437cd394117`, `2d24ad4e6b2d1ee8e6919af6f108e980a14d550e` | Defer larger runtime change | Bounded frames/payloads and linear protocol reading are a coherent later adaptation, not part of the stderr listener fix. They do not fix full-parent history hydration. |
+| `8ee46be35b6fcc4ab28aa6d524aeed1fff69ffe4` | Defer larger runtime change | Restored functions need live namespace globals, but the revival change must preserve native staged restore and interrupt behavior. No dill/restore rewrite is included here. |
+| `561401b273b5affa3877aae51e3b44ce201cc2d5` | Defer | Bound attached cell-source metadata separately from complete execution/canonical source. The upstream cap is characters plus a marker, not a byte limit. |
+| `d73349d508075cb4d6c3d9d6eec677f029e294c8` | Defer legacy-only adaptation | The retained opt-in owned-worker frontend differs from normal daemon startup. Its cleanup may throw on corrupt tracking; copying upstream's error callback would bypass native cleanup reporting. |
+| `ecd60e3cd4313643dede3cb2fcf13b4e2e9a2a75`, `66df06fc12d721c919d61c5ce4d6fb3ef0da479f` | Defer together | Consumed shell-notice withdrawal and its ordering fix form one optional workflow change. Preserve native action/source semantics. |
+| `e2fb7bfa1372552d81c33e9b3261d6a9cf82d30f` | Defer product decision | Interrupt-and-send-queued changes user controls and adds a capability-gated command. It requires explicit selection and compatibility coverage, not a protocol-version transplant. |
+
+## Native context and command boundaries
+
+Upstream does not implement Base Context's framed source/indexed working-view
+architecture. Full-transcript branch caches and JSONL parse optimizations are
+not repairs for a native source-byte refusal. Compaction must select required
+source-backed views before hydrating unrelated old payloads. Captured owners,
+replay groups, accepted epochs, recovery authorization, and acknowledged writes
+must remain intact. A `baseContextEpoch` record is not necessarily a model-written
+summary.
+
+The `/goal` text parser is unchanged from upstream at the reviewed revisions.
+Single-line objectives are supported; session slash commands reject multiline
+input, and the command name must start at column zero. Changing that grammar is
+a local product decision, not an upstream bug-fix transplant. Historical goal
+regressions added by the commits above were removed in upstream
+`cf07c5a3f5eca98e7744f2df83050044c920252a`; they are useful test vectors, not
+claims about current upstream test coverage.
+
+## What stays out
+
+All PrimeRL/Prime product provider, subscription, model, account, team, and
+catalog integrations remain excluded. No implicit backup models, credential
+migration, compiled installer migration, `rlm.spawn`/`collect` API replacement,
+new ledger/audit system, or benchmark pipeline is introduced. Base Context keeps
+explicit provider/auth/model/effort selection, its package and state roots,
+callable `await rlm(...)`, native context authority, and independent-work policy.
+Lawful upstream copyright and MIT attribution remain intact.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ponythewhite/base-context",
-	"version": "1.0.14",
+	"version": "1.0.16",
 	"description": "Synerise base-context: a coding and research agent with durable context and a persistent Python REPL",
 	"type": "module",
 	"bin": {
@@ -42,9 +42,9 @@
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "^1.3.0",
-		"@ponythewhite/base-context-agent": "1.0.14",
-		"@ponythewhite/base-context-ai": "1.0.14",
-		"@ponythewhite/base-context-tui": "1.0.14",
+		"@ponythewhite/base-context-agent": "1.0.16",
+		"@ponythewhite/base-context-ai": "1.0.16",
+		"@ponythewhite/base-context-tui": "1.0.16",
 		"@silvia-odwyer/photon-node": "^0.3.4",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",

package/skills/agent-message/SKILL.md

@@ -62,7 +62,8 @@ if child is not None:
 
 ## Result capsules
 
-Use `send()` for short coordination. Use `send_result()` for a full public report:
+Use `send()` for short steering, blockers, and decisions. Use `send_result()`
+for substantial findings or a final public report, not for a short message:
 
 ```python
 from pathlib import Path
@@ -74,7 +75,9 @@ receipt = await agent_message.send_result(
 )
 ```
 
-State conclusions, caveats, and decisions in the capsule. If it revises or
+State the outcome, important caveats, decisions, and evidence references in the
+capsule. Child findings are evidence, not independently verified truth. Retrieve
+details only when needed. If it revises or
 replaces earlier reports, name their exact report refs in the summary. With
 several updates, skim the capsules first, then retrieve the last relevant
 report or reports. Older reports remain readable. Do not treat unrelated
@@ -83,6 +86,9 @@ arrived. There is no automatic latest-wins, dropping, or coalescing.
 
 ## Safety
 
+- Avoid routine acknowledgements and repeated status broadcasts. Messaging an
+  idle child can start another turn; not every message needs a reply.
+
 - Do not delete a child immediately after `send`: delivered follow-ups may still
   be running and queued receipts have not run yet. Wait until observation shows
   the child is idle and its context is no longer needed before calling

package/skills/bounded-inspect/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: bounded-inspect
+description: Inspect selected text windows and JSON fields from project files under shared source and serialized-output byte budgets. Emit one source-linked bundle; continue within oversized lines without repeating full reads.
+---
+
+# Bounded Inspect
+
+Use for repeated, selective file inspection. Keep tiny one-off reads inline.
+Historical conversation evidence belongs to `prime_context`, not this skill.
+Filesystem paths and byte cursors are **not native recovery refs**.
+
+```python
+bounded_inspect.emit(
+    bounded_inspect.text("runs/example/train.log", tail_lines=25),
+    bounded_inspect.json_fields("runs/example/metrics.json",
+        pointers=["/run", "/config", "/seed", "/eligible", "/failures",
+                  "/units", "/updates", "/skips", "/wall"]),
+    max_bytes=4096, max_source_bytes=65536,
+)
+```
+
+Selectors are lazy; only `emit` reads. It prints one JSON object and returns
+`None`, so a final cell expression does not duplicate the result. Stateless
+extraction works in ordinary, goal, and AUTONOMOUS sessions. It does not park,
+finish, or change autonomous limits. Consume the supplied evidence; do not
+rerun its generating command merely to get a smaller answer.
+
+## API and coverage
+
+- `text(path)` selects the first 25 lines. Choose one of `head_lines=N`,
+  `tail_lines=N`, `start_line=N, end_line=M`, or `cursor=item["next"]`.
+  Line ranges are 1-based and inclusive; omitted `end_line` means through EOF.
+- `json_fields(path, pointers=[...], max_source_bytes=65536)` uses exact JSON
+  pointers, including `~0` and `~1` escapes. An empty pointer selects the root.
+  Null stays null. Missing fields, invalid JSON, unavailable files, and oversized
+  values have distinct statuses. Selected values are never string-sliced. Numeric
+  tokens stay exact, including exponents and nested values; no float conversion.
+- `emit(*selectors, max_bytes=4096, max_source_bytes=65536)` shares both budgets
+  across all selectors, in order. `max_bytes` must be at least 128 for refusal
+  metadata. Raise explicit limits when necessary, not by an unbounded retry.
+
+`output_bytes` counts the complete UTF-8 JSON serialization, escaping, metadata,
+paths, warnings, and final newline. `source_bytes` counts bytes actually read,
+not file size or OS device traffic. The enclosing tool/protocol envelope is
+outside this budget; normal `ipython` retention still applies. `omitted` identifies
+unreturned selector indices in the original call; `omitted_fields` counts the
+unreturned suffix of requested pointers. Order important metadata first.
+
+Text includes a stat version, half-open byte range, starting line (or null),
+and next byte cursor. Partial Unicode lines advance at UTF-8 boundaries.
+A continuation advances, finishes, or explicitly refuses. Source-limited line
+seeking can return an empty window with an advancing cursor. Reuse the same
+path and returned cursor; modification or replacement returns `changed_source`.
+Stat tokens are practical guards, not immutable captures.
+
+Tail reads only a bounded suffix. If it cannot establish the requested start,
+`tail_prefix_unread` marks missing prefix coverage; terminal `tail_window_limit`
+means that coverage is incomplete. Absolute line numbers may be unknown. JSON parsing refuses files above the explicit source ceiling before
+reading. Large histories need a project-native summary producer, not larger
+unbounded `json.load` calls. Select scientific units, run/config/seed identifiers,
+eligibility, and failures together. Extraction does not infer quality crossings,
+repair failed controls, or turn unavailable measurements into zero.
+
+## Run where the data lives
+
+Use `python -m bounded_inspect`, or stage `src/bounded_inspect/__init__.py` once
+and execute that file with standard-library Python through existing authorized
+remote execution. Pass a JSON list on stdin:
+
+```json
+[{"kind":"text","path":"train.log","tail_lines":25},
+ {"kind":"json","path":"metrics.json","pointers":["/run","/units","/wall"]}]
+```
+
+CLI flags: `--max-bytes` and `--max-source-bytes`. No SSH setup is provided.
+Save a small parameterized project parser after demonstrated reuse. Log full
+execution evidence to explicit files when needed: this skill cannot recover
+bytes that Bash or another capture already discarded.

package/skills/bounded-inspect/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "bounded-inspect"
+version = "0.1.0"
+description = "Bounded text and selected JSON file evidence"
+requires-python = ">=3.10"
+dependencies = []
+
+[project.scripts]
+bounded-inspect = "bounded_inspect:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/bounded_inspect"]