@ponythewhite/base-context 1.0.15 → 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":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE1E,MAAM,UAAU,uBAAuB,CACtC,QAAgB,EAChB,QAAQ,GAAG,EAAE,GAAG,IAAI,EACpB,eAAe,GAAG,KAAK,EACF;IACrB,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,QAAQ,GAAG,QAAQ,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC9F,IAAI,KAAK,KAAK,CAAC;gBAAE,MAAM;YACvB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAChC,QAAQ,IAAI,KAAK,CAAC;QACnB,CAAC;IACF,CAAC;YAAS,CAAC;QACV,SAAS,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IACD,OAAO,eAAe,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAAA,CAChF;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY,GAAG,KAAK,EAAsB;IACnH,OAAO,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC;QAChE,EAAE,QAAQ,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAAA,CACrB;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CACxC,QAAgB,EAChB,OAAO,GAAgF,EAAE,EAChE;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,IAAI,QAAQ,CAAC;IAClD,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC1C,IAAI,YAAY,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACvF,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBAChB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC;gBAC5B,MAAM;YACP,CAAC;YACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;gBACxB,YAAY,GAAG,CAAC,CAAC;gBACjB,MAAM,IAAI,CAAC;YACZ,CAAC;;gBAAM,MAAM,IAAI,CAAC;YAClB,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACvD,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,YAAY,GAAG,CAAC,CAAC;QACjB,MAAM,IAAI,CAAC;IACZ,CAAC;AAAA,CACD","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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ponythewhite/base-context",
-	"version": "1.0.15",
+	"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.15",
-		"@ponythewhite/base-context-ai": "1.0.15",
-		"@ponythewhite/base-context-tui": "1.0.15",
+		"@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"]

package/skills/bounded-inspect/src/bounded_inspect/__init__.py

@@ -0,0 +1,313 @@
+"""Bounded file evidence. Select lazily; emit one shared-budget JSON bundle."""
+
+import argparse
+import json
+import os
+import stat
+import sys
+from dataclasses import dataclass
+
+__all__ = ["text", "json_fields", "emit"]
+
+
+@dataclass(frozen=True)
+class _Selection:
+    kind: str
+    path: str
+    options: dict
+
+
+def text(path, *, head_lines=None, tail_lines=None, start_line=None, end_line=None, cursor=None):
+    """Select UTF-8 lines (1-based, inclusive), or resume a returned byte cursor."""
+    modes = sum(value is not None for value in (head_lines, tail_lines, start_line, cursor))
+    if modes > 1 or (end_line is not None and start_line is None):
+        raise ValueError("choose head, tail, line range, or cursor")
+    for value in (head_lines, tail_lines, start_line, end_line):
+        if value is not None and (not isinstance(value, int) or value < 1):
+            raise ValueError("line counts must be positive integers")
+    if start_line is not None and end_line is not None and end_line < start_line:
+        raise ValueError("end_line precedes start_line")
+    if modes == 0:
+        head_lines = 25
+    return _Selection("text", os.fspath(path), dict(head=head_lines, tail=tail_lines,
+                      start=start_line, end=end_line, cursor=dict(cursor) if cursor else cursor))
+
+
+def json_fields(path, *, pointers, max_source_bytes=65536):
+    """Select exact RFC 6901 pointers; missing is distinct from JSON null."""
+    pointers = tuple(pointers)
+    if any(not isinstance(p, str) or (p and not p.startswith("/")) for p in pointers):
+        raise ValueError("pointers must be empty (root) or start with /")
+    if max_source_bytes < 0:
+        raise ValueError("max_source_bytes must be nonnegative")
+    return _Selection("json", os.fspath(path), dict(pointers=pointers, cap=max_source_bytes))
+
+
+def _version(info):
+    return [info.st_dev, info.st_ino, info.st_size, info.st_mtime_ns, info.st_ctime_ns]
+
+
+class _JsonNumber(str):
+    """A number token validated by json.loads, not converted through float/int."""
+
+
+def _serialized(value):
+    if isinstance(value, _JsonNumber):
+        return str(value)
+    if isinstance(value, dict):
+        return "{" + ",".join(_serialized(key) + ":" + _serialized(item) for key, item in value.items()) + "}"
+    if isinstance(value, list):
+        return "[" + ",".join(_serialized(item) for item in value) + "]"
+    return json.dumps(value, ensure_ascii=True, allow_nan=False, separators=(",", ":"))
+
+
+def _encoded(bundle):
+    # Count the complete wire envelope, including escaping and the final newline.
+    while True:
+        rendered = _serialized(bundle) + "\n"
+        size = len(rendered.encode("utf-8"))
+        if bundle["output_bytes"] == size:
+            return rendered
+        bundle["output_bytes"] = size
+
+
+def _read(handle, count, bundle):
+    data = handle.read(max(0, min(count, bundle["limits"]["source_bytes"] - bundle["source_bytes"])))
+    bundle["source_bytes"] += len(data)
+    return data
+
+
+def _cursor(path, version, offset, line, start, end, warnings):
+    return dict(path=path, version=version, offset=offset, line=line,
+                start_line=start, end_line=end, warnings=warnings)
+
+
+def _text(handle, selection, version, bundle):
+    options = selection.options
+    size = version[2]
+    cap = bundle["limits"]["source_bytes"] - bundle["source_bytes"]
+    cursor = options["cursor"]
+    warnings = []
+    offset, line = 0, 1
+    start, end = options["start"] or 1, options["end"] or options["head"]
+    if cursor is not None:
+        if cursor.get("path") != selection.path or cursor.get("version") != version:
+            return {"status": "changed_source", "next": None}, None
+        try:
+            offset, line = cursor["offset"], cursor["line"]
+            start, end = cursor["start_line"], cursor["end_line"]
+            warnings = cursor["warnings"]
+            if not isinstance(offset, int) or not 0 <= offset <= size:
+                raise ValueError()
+        except (KeyError, TypeError, ValueError):
+            return {"status": "invalid_cursor", "next": None}, None
+    elif options["tail"] is not None:
+        offset = max(0, size - cap)
+        line = 1 if offset == 0 else None
+        end = None
+    handle.seek(offset)
+    raw = _read(handle, size - offset, bundle)
+    if options["tail"] is not None:
+        # Work backwards only within the bounded suffix, never scan the prefix.
+        boundaries = [i + 1 for i, value in enumerate(raw) if value == 10 and i + 1 < len(raw)]
+        needed = options["tail"]
+        cut = boundaries[-needed] if len(boundaries) >= needed else 0
+        if offset and not cut:
+            warnings.append("tail_prefix_unread; absolute_line_unavailable")
+            while cut < len(raw) and raw[cut] & 0xC0 == 0x80:
+                cut += 1
+        if line is not None:
+            line += raw[:cut].count(b"\n")
+        offset += cut
+        raw = raw[cut:]
+    # Seek a requested line in bounded chunks. Cursors can advance without text.
+    if line is not None:
+        while line < start:
+            newline = raw.find(b"\n")
+            if newline < 0:
+                offset += len(raw)
+                raw = b""
+                break
+            offset += newline + 1
+            raw = raw[newline + 1:]
+            line += 1
+        if end is not None:
+            limit = end - line + 1
+            if limit <= 0:
+                raw = b""
+            else:
+                pos = 0
+                for _ in range(limit):
+                    newline = raw.find(b"\n", pos)
+                    if newline < 0:
+                        break
+                    pos = newline + 1
+                else:
+                    raw = raw[:pos]
+    try:
+        decoded = raw.decode("utf-8")
+    except UnicodeDecodeError as error:
+        if error.reason != "unexpected end of data" or offset + len(raw) == size:
+            return {"status": "invalid_utf8", "byte": offset + error.start, "next": None}, None
+        decoded = raw[:error.start].decode("utf-8")
+    context = (selection.path, version, offset, line, start, end, warnings)
+    if not decoded:
+        seeking = line is not None and line < start and offset < size
+        done = offset == size or (end is not None and line is not None and line > end)
+        status = "complete" if done else "seeking" if seeking and raw == b"" and cap else "source_limit"
+        next_cursor = _cursor(*context) if status == "seeking" else None
+        return dict(status=status, text="", range={"bytes": [offset, offset], "line": line},
+                    next=next_cursor, warnings=warnings), None
+    return {}, (decoded, context)
+
+
+def _text_prefix(decoded, context, length):
+    path, version, offset, line, start, end, warnings = context
+    value = decoded[:length]
+    stop = offset + len(value.encode("utf-8"))
+    next_line = None if line is None else line + value.count("\n")
+    done = stop == version[2] or (end is not None and next_line is not None and next_line > end)
+    status = ("tail_window_limit" if warnings else "complete") if done else "partial" if length else "output_limit"
+    following = None if done or not length else _cursor(path, version, stop, next_line, start, end, warnings)
+    return dict(status=status, text=value, range={"bytes": [offset, stop], "line": line},
+                next=following, warnings=warnings)
+
+
+def _constant(value):
+    raise ValueError("nonstandard JSON constant")
+
+
+def _json(handle, selection, version, bundle):
+    cap = min(selection.options["cap"], bundle["limits"]["source_bytes"] - bundle["source_bytes"])
+    if version[2] > cap:
+        return {"status": "source_limit", "size_bytes": version[2], "source_ceiling": cap}, None
+    raw = _read(handle, version[2], bundle)
+    try:
+        data = json.loads(raw, parse_float=_JsonNumber, parse_int=_JsonNumber, parse_constant=_constant)
+    except (ValueError, UnicodeError, RecursionError):
+        return {"status": "invalid_json"}, None
+    fields = []
+    for pointer in selection.options["pointers"]:
+        value = data
+        try:
+            for part in pointer.split("/")[1:] if pointer else []:
+                if any(part[i:i + 2] not in ("~0", "~1") for i, ch in enumerate(part) if ch == "~"):
+                    raise ValueError()
+                part = part.replace("~1", "/").replace("~0", "~")
+                if isinstance(value, list):
+                    if not part.isascii() or not part.isdigit() or (len(part) > 1 and part[0] == "0"):
+                        raise KeyError()
+                    value = value[int(part)]
+                elif isinstance(value, dict):
+                    value = value[part]
+                else:
+                    raise KeyError()
+            fields.append(dict(pointer=pointer, status="ok", value=value))
+        except (KeyError, IndexError):
+            fields.append(dict(pointer=pointer, status="missing"))
+        except ValueError:
+            fields.append(dict(pointer=pointer, status="invalid_pointer"))
+    return {"status": "complete", "fields": [], "omitted_fields": len(fields)}, fields
+
+
+def emit(*selections, max_bytes=4096, max_source_bytes=65536):
+    """Print one JSON bundle, within shared source/output byte limits. Return None."""
+    if not isinstance(max_bytes, int) or max_bytes < 128:
+        raise ValueError("max_bytes must be at least 128 (refusal envelope)")
+    if not isinstance(max_source_bytes, int) or max_source_bytes < 0:
+        raise ValueError("max_source_bytes must be nonnegative")
+    if any(not isinstance(selection, _Selection) for selection in selections):
+        raise TypeError("emit accepts text/json_fields selectors")
+    bundle = dict(items=[], omitted={"from": 0, "count": len(selections), "reason": "output_budget"},
+                  source_bytes=0, output_bytes=0,
+                  limits={"output_bytes": max_bytes, "source_bytes": max_source_bytes})
+    if len(_encoded(bundle).encode("utf-8")) > max_bytes:
+        bundle = dict(status="output_limit", omitted_count=len(selections), source_bytes=0, output_bytes=0)
+        print(_encoded(bundle), end="")
+        return None
+    for index, selection in enumerate(selections):
+        before = bundle["source_bytes"]
+        item = dict(index=index, path=selection.path, kind=selection.kind)
+        details = None
+        try:
+            # Unbuffered regular files: the counter is actual bytes read, not requested bytes.
+            with open(selection.path, "rb", buffering=0) as handle:
+                info = os.fstat(handle.fileno())
+                if not stat.S_ISREG(info.st_mode):
+                    result = {"status": "not_regular_file"}
+                else:
+                    version = _version(info)
+                    item["version"] = version
+                    if selection.kind == "text":
+                        result, details = _text(handle, selection, version, bundle)
+                    else:
+                        result, details = _json(handle, selection, version, bundle)
+                    if _version(os.fstat(handle.fileno())) != version or _version(os.stat(selection.path)) != version:
+                        result, details = {"status": "changed_source", "next": None}, None
+                item.update(result)
+        except OSError as error:
+            item.update(status="unavailable", error=error.__class__.__name__, errno=error.errno)
+        item["source_bytes"] = bundle["source_bytes"] - before
+        bundle["items"].append(item)
+        bundle["omitted"].update({"from": index + 1, "count": len(selections) - index - 1})
+
+        def fits():
+            return len(_encoded(bundle).encode("utf-8")) <= max_bytes
+
+        if details is not None and selection.kind == "text":
+            decoded, context = details
+            item.update(_text_prefix(decoded, context, len(decoded)))
+            if not fits():
+                low, high = 0, len(decoded)
+                while low < high:
+                    middle = (low + high + 1) // 2
+                    item.update(_text_prefix(decoded, context, middle))
+                    if fits():
+                        low = middle
+                    else:
+                        high = middle - 1
+                item.update(_text_prefix(decoded, context, low))
+        elif details is not None:
+            for field_index, field in enumerate(details):
+                item["fields"].append(field)
+                item["omitted_fields"] = len(details) - field_index - 1
+                if not fits():
+                    item["fields"][-1] = dict(pointer=field["pointer"], status="value_limit")
+                    item["status"] = "partial"
+                    if not fits():
+                        item["fields"].pop()
+                        item["omitted_fields"] += 1
+                        break
+        if not fits():
+            bundle["items"].pop()
+            bundle["omitted"].update({"from": index, "count": len(selections) - index})
+            break
+    # Budget refusal may follow real I/O, so keep those source bytes in the envelope.
+    rendered = _encoded(bundle)
+    if len(rendered.encode("utf-8")) > max_bytes:
+        bundle = dict(status="output_limit", omitted_count=len(selections),
+                      source_bytes=bundle["source_bytes"], output_bytes=0)
+        rendered = _encoded(bundle)
+    print(rendered, end="")
+    return None
+
+
+def main():
+    """Standalone: stage this file once, then pass a small JSON request on stdin."""
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--max-bytes", type=int, default=4096)
+    parser.add_argument("--max-source-bytes", type=int, default=65536)
+    args = parser.parse_args()
+    request = json.load(sys.stdin)
+    selections = []
+    for entry in request:
+        entry = dict(entry)
+        kind, path = entry.pop("kind"), entry.pop("path")
+        if kind not in ("text", "json"):
+            parser.error("kind must be text or json")
+        selections.append((text if kind == "text" else json_fields)(path, **entry))
+    emit(*selections, max_bytes=args.max_bytes, max_source_bytes=args.max_source_bytes)
+
+
+if __name__ == "__main__":
+    main()

package/skills/bounded-inspect/src/bounded_inspect/__main__.py

@@ -0,0 +1,3 @@
+from . import main
+
+main()