@tranhoangnguyen0310/pi-flow-external 3.2.0-external.0 → 4.0.0-external.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/CHANGELOG.md +17 -0
- package/README.md +132 -649
- package/docs/README.md +60 -0
- package/docs/configuration-reference.md +189 -0
- package/docs/harness-reference.md +133 -0
- package/docs/migration-agent-to-external-delegate.md +69 -0
- package/docs/migration-v4-to-v5.md +85 -0
- package/docs/public-contract.md +5 -5
- package/docs/supervision-and-runtime.md +156 -0
- package/docs/troubleshooting.md +81 -0
- package/docs/workflows.md +114 -0
- package/package.json +12 -10
- package/src/contract/agent.ts +3 -2
- package/src/core/progress.ts +2 -1
- package/src/core/run-projection.ts +1 -1
- package/src/core/spawn.ts +2 -2
- package/src/external-help.ts +2 -2
- package/src/external-runs.ts +1 -1
- package/src/pi-subagent.ts +4 -3
- package/src/profile-creator.ts +2 -2
- package/src/profiles.ts +3 -3
- package/src/prompts.ts +6 -6
- package/src/tool-names.ts +2 -0
- package/src/workflow/tool.ts +2 -2
- package/AGENTS.md +0 -78
- package/CLAUDE.md +0 -1
- package/CONTEXT.md +0 -69
- package/docs/ARCHITECTURE_SNAPSHOT.md +0 -113
- package/docs/field-testing.md +0 -245
- package/docs/releasing.md +0 -185
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to pi-flow external are documented here.
|
|
4
4
|
|
|
5
|
+
## [4.0.0-external.0] - 2026-10-13
|
|
6
|
+
|
|
7
|
+
### Breaking
|
|
8
|
+
- Renamed the direct delegation tool **`Agent` → `external_delegate`** (#85). Flow no longer registers `Agent`; there is no alias or automatic translation. Update `tools.Agent(...)` → `tools.external_delegate(...)`, `describeTool("Agent")` → `describeTool("external_delegate")`, exact-name hooks, tool allow-lists, and receipt checks. Stale calls may reach another extension's `Agent` tool rather than fail.
|
|
9
|
+
- New direct receipts report `tool: "external_delegate"`. Envelope `contractVersion: 1`, `action: "delegate"`, run `kind: "agent"`, and workflow `agent()` remain unchanged. Settings remain version 5; no settings conversion or saved-run rewrite is required.
|
|
10
|
+
- Update Flow's entry in `pi-cc-extensions` `excludeRenderers` to `"external_delegate"` (alongside `"workflow"` and `"external_runs"`). Preserve unrelated entries, including `"Agent"` if another extension needs it, and restart Pi. See the [tool migration guide](docs/migration-agent-to-external-delegate.md).
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
- Current documentation, coordinator guidance, and help use the namespaced direct tool name. Background guidance explicitly states that runs do not notify or resume the parent session: collect them through `external_runs` (`wait`, then `inspect` with `view: "final"` for a successful answer; inspect outcomes and diagnostics for failures).
|
|
14
|
+
|
|
15
|
+
## [3.2.1-external.0] - 2026-10-05
|
|
16
|
+
|
|
17
|
+
### Changed
|
|
18
|
+
- Reorganized documentation suite: user guides remain in `docs/`, maintainer specifications and runbooks moved to `docs/maintainer/`, and historical planning documents moved to `docs/archive/`.
|
|
19
|
+
- Published package no longer includes internal agent instructions (`AGENTS.md`, `CONTEXT.md`, `CLAUDE.md`), maintainer runbooks, or historical plans.
|
|
20
|
+
- Explicit file listing in `package.json` replaces globs to ensure strict CI release check tracking.
|
|
21
|
+
|
|
5
22
|
## [3.2.0-external.0] - 2026-10-02
|
|
6
23
|
|
|
7
24
|
### Added
|