pi-better-subagents 0.1.31 → 0.3.0
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.
- package/README.md +3 -3
- package/agent-commands.ts +711 -0
- package/agent-inspection.ts +408 -0
- package/agent-operations.ts +56 -0
- package/agents-catalog-tool.ts +102 -0
- package/batch.mjs +20 -0
- package/catalog-identity.ts +258 -0
- package/catalog-resolver.ts +460 -0
- package/catalog-runtime.ts +576 -0
- package/catalog-schema.ts +1426 -0
- package/catalog-store.ts +787 -0
- package/codex-import.ts +717 -0
- package/config.ts +15 -0
- package/docs/agent-catalog-acceptance.md +89 -0
- package/docs/agent-catalog-lifecycle.md +39 -0
- package/docs/agent-catalog-operations.md +68 -0
- package/docs/agent-catalog.md +145 -0
- package/docs/agent-model-resolution.md +85 -0
- package/docs/failure-observations.md +11 -0
- package/failures.ts +188 -0
- package/finalization.ts +14 -0
- package/index.ts +361 -35
- package/list.mjs +4 -1
- package/model-resolution.ts +1071 -0
- package/navigator.mjs +3 -0
- package/package.json +13 -2
- package/permission-policy.ts +106 -0
- package/registry.ts +630 -6
- package/role-assignment.ts +141 -0
- package/roles/role.architect.md +13 -0
- package/roles/role.developer.md +13 -0
- package/roles/role.explorer.md +14 -0
- package/roles/role.product-manager.md +14 -0
- package/roles/role.researcher.md +14 -0
- package/roles/role.reviewer.md +13 -0
- package/sandbox.ts +26 -5
- package/shared-callback-batcher.ts +42 -16
- package/shared-failure-observations.ts +205 -0
- package/shared-navigator.ts +67 -0
- package/shared-sandbox-core.ts +283 -11
- package/tier-policy.ts +126 -0
- package/tools.ts +9 -4
package/README.md
CHANGED
|
@@ -11,10 +11,10 @@ Use `pi-better-subagents` when you want Pi to launch independent agent work with
|
|
|
11
11
|
<p><img src="https://raw.githubusercontent.com/1aboveio/pi-better-harness/main/docs/images/package-gallery/pi-better-subagents.png" alt="pi-better-subagents rendered in Pi" width="49%" /><img src="https://raw.githubusercontent.com/1aboveio/pi-better-harness/main/docs/images/package-gallery/overview/pi-better-subagents.png" alt="pi-better-subagents package overview" width="49%" /></p>
|
|
12
12
|
|
|
13
13
|
## Core Features
|
|
14
|
-
- Non-blocking subagent launches.
|
|
14
|
+
- Non-blocking subagent launches, with an optional role and named-agent catalog (`docs/agent-catalog.md`, `docs/agent-catalog-lifecycle.md`).
|
|
15
15
|
- Default OS write sandboxing on macOS and Linux.
|
|
16
16
|
- Explicit tool allowlists for child sessions.
|
|
17
|
-
- Durable logs
|
|
17
|
+
- Durable logs, result retrieval, and [failure observations](docs/failure-observations.md) independent of lifecycle status.
|
|
18
18
|
- Live background-work navigator for active runs.
|
|
19
19
|
|
|
20
20
|
## Install
|
|
@@ -29,7 +29,7 @@ Try it for one run:
|
|
|
29
29
|
pi -e npm:pi-better-subagents
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
Linux sandboxing uses `bubblewrap` when available, for example from `sudo apt-get install bubblewrap`.
|
|
32
|
+
Linux sandboxing uses `bubblewrap` when available, for example from `sudo apt-get install bubblewrap`. With [`pi-better-sandbox`](https://github.com/1aboveio/pi-better-harness/tree/main/packages/pi-better-sandbox#readme) installed, `/sandbox` controls the independent Subagents profile. Each launch snapshots that profile; `sandbox:false` cannot bypass a human-enabled sandbox. Commands Off or Network access Off prevents a detached Pi launch, because the child runtime still needs its provider connection. Session/temp writes use a private directory for that run. Without published permission settings, the legacy default remains write confinement with unrestricted reads and network. See [usage notes](https://github.com/1aboveio/pi-better-harness/blob/main/packages/pi-better-subagents/docs/usage.md#write-sandbox).
|
|
33
33
|
|
|
34
34
|
## When To Use
|
|
35
35
|
|