@inventarch/runner 3.1.0 → 3.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +56 -4
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -1,13 +1,65 @@
1
1
  # @inventarch/runner
2
2
 
3
- Run an admitted native agent profile with bounded execution and a durable local journal.
3
+ [![npm](https://img.shields.io/npm/v/@inventarch/runner?label=npm)](https://www.npmjs.com/package/@inventarch/runner) [![Public quality](https://github.com/inventarch/ia/actions/workflows/platform-quality.yml/badge.svg?branch=main)](https://github.com/inventarch/ia/actions/workflows/platform-quality.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-green)](LICENSE) [![Node](https://img.shields.io/badge/node-22.x-brightgreen)](package.json)
4
+
5
+ > `ia-runner` runs one admitted `@agent-profile` locally, with bounded execution and a durable journal. It composes the agent-system engine, session-system's SQLite journal and replay, the composition compiler and the runtime Door.
6
+ >
7
+ > It selects no model provider and creates no credentials. Each model turn waits for a response that you, or a host that embeds the runner, supply.
8
+
9
+ ## ⚡ Quick start
10
+
11
+ ```sh
12
+ npm install --global @inventarch/runner
13
+ ```
14
+
15
+ Before you start, the workspace must select the installed `runner-local-v1` host contract, the `runner-read-v1` mandate contract and the `runner-entry-v1` entry mapping, and must admit `agent-composition-system`'s own `@operation read-captured-source`; a copy authored outside that system refuses with `IA-COMPOSITION-CONFLICT`. A workspace created by `ia init` alone provides none of these. The conformance composition's [`runner.ia`](../../examples/conformance/composition/.ia/src/systems/agent-composition-system/records/runner.ia) shows the `@agent`, `@mandate`, `@capability`, `@agent-profile`, entry `@execution-binding` and `@harness` declarations; the runner tests run it with this repository's public systems adopted.
16
+
17
+ Run a profile, answer its pending model request, then step it to the end:
4
18
 
5
19
  ```sh
6
20
  ia-runner run --root . --profile reader-profile --task "Read the captured task source"
7
- ia-runner step --root . --profile reader-profile --id <run-id>
8
21
  ia-runner submit --root . --profile reader-profile --id <run-id> --attempt <attempt-id> --response response.json
22
+ ia-runner step --root . --profile reader-profile --id <run-id>
9
23
  ```
10
24
 
11
- The workspace must select the installed `runner-local-v1` host contract, `runner-read-v1` mandate contract, and `runner-entry-v1` entry mapping. The conformance composition under `examples/conformance/composition` demonstrates these declarations. Installation alone supplies no authority. The default model waits for an explicit local response and creates no credentials.
25
+ Each command prints one JSON line, `{id, sequence, run, pending}`. `run` captures the workspace, compiles the profile's harness, opens a durable run and advances it until it finishes or waits. A waiting run lists its model request under `pending`, with the attempt id and the position packet for that turn. `submit` takes one response for that attempt from a file such as:
26
+
27
+ ```json
28
+ {"action":{"type":"outcome","kind":"answer","message":"Captured source read.","continuation":"finish"},"usage":1,"model":"runner/external","provider":"local"}
29
+ ```
30
+
31
+ Repeat `step`, which advances one scheduler action, until `run.status` is `completed`. A refusal prints `{code, message, next}` on stderr and exits 1. Node 22 also prints an `ExperimentalWarning` for SQLite on stderr. `ia-runner --help` gives the full syntax, including `--harness` and `--entry`, which pick one when the composition offers several.
32
+
33
+ ## 🧭 What it does
34
+
35
+ | Surface | What it does |
36
+ | --- | --- |
37
+ | `ia-runner run` | Captures source, compiles the harness, starts a run (`--id` names it) with `--task`, and advances it until it finishes, waits or reaches its step bound. |
38
+ | `ia-runner step` | Resumes the run `--id` names and advances one scheduler action. |
39
+ | `ia-runner submit` | Accepts one model response for a pending attempt, from an unchanged regular file of at most 64 KiB. |
40
+ | `openRunner(options)` | For hosts: opens `profile` under `root`, with an optional trusted `model` adapter, `authorize` and `evaluate` callbacks, and returns `start`, `step`, `run`, `resume`, `submit` and `close`. |
41
+ | `runnerCatalog()` | The installed contracts above and their defaults. |
42
+ | `RunnerError` | A refusal with a stable `code` and a `next` command. |
43
+
44
+ - **Bounded.** The `runner-local-v1` ceiling is 64 steps, 16 model calls, 16 operations, 200,000 tokens, 8 MB, one hour and no child runs. A governing `@mandate`'s `execution` limits narrow it, as `limit-operations 1` does in the conformance mandate.
45
+ - **Positioned.** Every model turn gets a phase-specific position through the Door, and the request journal keeps its key, body and host note.
46
+ - **Durable.** Journals live under `.ia/work/runs/` with hash-chain replay. Resume requires the original principal, manifest and source capture, and keeps the original deadline.
47
+ - **Evidence.** Receipts under `.ia/work/runner-evidence/` can be admitted as runtime-placed `@run` and `@observation` records. They never move the authored revision or change mandate authority.
48
+
49
+ ## ⚖️ What it does not do
50
+
51
+ - **No live model provider and no credentials.** The default model defers to you and only records the pending request.
52
+ - **Installation supplies no authority.** Native source never selects an import, executable or credential. Observation permission is required before each model turn, and the applicable `@mandate` moves and excluded words are checked before each operation dispatch.
53
+ - **The built-in grant is read-only.** The local host installs only the captured-source read. Host authorization can narrow that ceiling, never widen it.
54
+ - **No writes, delegation, publication or review.** This host implements no write operations, delegated execution, external publication or independent review authority.
55
+ - **A journal is not proof.** Journal integrity is not external attestation, execution authorization or proof of real-world effects. Runtime files are local evidence, not committed source or release artifacts.
56
+
57
+ ## 📚 Learn more
12
58
 
13
- Hosts can import `openRunner` and `runnerCatalog`, supply a trusted model adapter, and call `start`, `step`, `run`, `resume`, `submit` and `close`. See [SPEC.md](SPEC.md) for execution, context, persistence and evidence boundaries.
59
+ - [SPEC.md](SPEC.md): execution, context, persistence and evidence boundaries
60
+ - [LANGUAGE.md](LANGUAGE.md): the packaged summary of the words this release ships
61
+ - [Conformance fixtures](../../examples/conformance/SPEC.md)
62
+ - [agent-system](../../.ia/src/systems/agent-system/SPEC.md), [session-system](../../.ia/src/systems/session-system/SPEC.md) and [agent-composition-system](../../.ia/src/systems/agent-composition-system/SPEC.md): the engine, journal and compiler it composes
63
+ - [`@inventarch/runtime`](../../packages/runtime/README.md): the Door that delivers each position
64
+ - [Architecture reference](../../docs/reference/architecture/README.md)
65
+ - [Root README](../../README.md)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inventarch/runner",
3
- "version": "3.1.0",
3
+ "version": "3.1.1",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",
@@ -22,12 +22,12 @@
22
22
  "LANGUAGE.md"
23
23
  ],
24
24
  "dependencies": {
25
- "@inventarch/agent-system": "3.1.0",
26
- "@inventarch/session-system": "3.1.0",
27
- "@inventarch/agent-composition-system": "3.1.0",
28
- "@inventarch/workspace-runtime": "3.1.0",
29
- "@inventarch/runtime": "3.1.0",
30
- "@inventarch/db": "3.1.0"
25
+ "@inventarch/agent-system": "3.1.1",
26
+ "@inventarch/session-system": "3.1.1",
27
+ "@inventarch/agent-composition-system": "3.1.1",
28
+ "@inventarch/workspace-runtime": "3.1.1",
29
+ "@inventarch/runtime": "3.1.1",
30
+ "@inventarch/db": "3.1.1"
31
31
  },
32
32
  "devDependencies": {
33
33
  "@types/node": "^22.19.0",