@narumitw/pi-subagents 2.1.2 → 2.1.4

package/README.md

@@ -8,6 +8,11 @@ Use the built-in `explorer` for read-only evidence and `worker` for a clearly ow
 
 The compatibility default exposes background and blocking methods, while **Keep Pi available (async)** is an optional smaller background-only surface.
 
+> [!WARNING]
+> `@narumitw/pi-subagents` 3.0.0 will replace this implementation with the bounded-job runtime currently developed as `pi-subagents-v3`.
+> The release will remove `/subagents`, extension settings, local usage recording, the current `subagent` and underscore-named tool APIs, custom agent catalogs and per-agent configuration, retained conversations and messaging, persisted recovery, auto-resume completion, advanced orchestration and verification, alternate transports, trust-aware cwd policy, and extension-owned worktree isolation.
+> It will instead expose `subagent-spawn`, `subagent-inspect`, `subagent-cancel`, `subagent-wait`, and `subagent-reply` for bounded background jobs.
+
 ## ✨ Features
 
 - Provides blocking batches, detached reusable agents, read-only consultation, metadata inspection, and queue-only mailboxes.
@@ -1189,38 +1194,6 @@ Truncated text includes a `truncated by pi-subagents` marker and details expose
 Inspection and consultation model-facing content also stops at 2,000 lines, whichever limit is reached first.
 `PI_SUBAGENT_MAX_DEPTH` controls nested delegation depth and defaults to 1; child processes receive `PI_SUBAGENT_DEPTH` automatically.
 
-## 📡 Runtime status
-
-Run the offline transport benchmark from the repository root when comparing startup overhead:
-
-```bash
-just benchmark-subagents
-```
-
-It reports serial median and median absolute deviation for deterministic fake fresh-subprocess and retained-RPC turns plus isolated real Pi RPC readiness, retained commands, in-process session creation, and retained in-process state access without making a provider request.
-Queue time starts when the registry accepts work, transport startup starts when execution begins, RPC readiness comes from `get_state`, RPC acceptance comes from the correlated `prompt` response, first activity comes from a bounded lifecycle event, settlement comes from `agent_settled`, and delivery is recorded after the parent accepts the completion message.
-Subprocess and in-process timing fields use the nearest public lifecycle boundary and may be coarser than RPC.
-Timing and progress are current-session diagnostics and are not persisted.
-The benchmark measures transport overhead rather than model latency or output quality.
-
-Preview the paired quality benchmark without making provider requests:
-
-```bash
-just benchmark-async-subagents --model provider/model
-```
-
-Run three paired trials with isolated sync-only and async-only tool surfaces, fixed model and thinking settings, redacted raw records, and a hard per-trial deadline:
-
-```bash
-just benchmark-async-subagents --run --mode quick --model provider/model --output /tmp/subagent-quick.json
-```
-
-Use `--mode extended` for ten paired trials before any further sync deprecation decision.
-The runner alternates arm order, starts work deadlines only after RPC readiness, runs at most three pairs concurrently, and reports completion coverage, evidence score, premature finals, terminal outcomes, median and P95 latency, and cost when available.
-Quick mode targets completion within five minutes under normal provider capacity but reports external timeouts and entitlement failures rather than silently reducing the sample.
-Live results remain provider- and model-dependent evidence rather than deterministic CI or proof of causality.
-The synchronous `subagent` tool remains available whenever a quality gate fails or detached chain, fan-in, panel, or workflow compatibility is unmatched.
-
 While the `subagent` tool is running, `pi-subagents` publishes compact activity status with `ctx.ui.setStatus("subagents", "...")`.
 Any statusline extension that reads Pi's generic extension status API can display it; no package-to-package dependency is required.
 
@@ -1311,7 +1284,6 @@ packages/pi-subagents/
 │   ├── verification-harness.ts   # Disposable deterministic check execution
 │   ├── verification-receipt.ts   # Strict executor-owned managed receipts
 │   ├── verified-execution-benchmark.ts # Matched offline acceptance/cost fixture
-│   ├── async-subagent-benchmark.ts # Paired live-quality planning, scoring, and summaries
 │   ├── workflow-tree-identity.ts # Bounded exact Git-visible tree identities
 │   ├── integration-controller.ts # Fail-closed canonical integration admission
 │   ├── adaptive-scheduler.ts     # Dependency, capacity, budget, and conflict scheduling

package/dist/index.ts

@@ -1458,6 +1458,17 @@ function numericFields(record, fields) {
 }
 
 // src/subagents-extension.ts
+var VERSION_3_MIGRATION_WARNING = [
+  "pi-subagents 3.0.0 will replace this runtime with the bounded-job design currently developed as pi-subagents-v3.",
+  "The release will remove:",
+  "\u2022 /subagents, extension settings, and local usage recording;",
+  "\u2022 the current subagent tool and underscore-named lifecycle and consultation tools;",
+  "\u2022 custom agent catalogs, per-agent model settings, and custom agent prompts;",
+  "\u2022 retained conversations, follow-up turns, mailboxes, peer and nested messaging, persisted recovery, and auto-resume completion;",
+  "\u2022 chains, fan-in, panels, workflow DAGs, dynamic scheduling, structured result contracts, and verification orchestration;",
+  "\u2022 alternate transports, trust-aware cwd policy, and extension-owned worktree isolation.",
+  "3.0.0 will instead expose subagent-spawn, subagent-inspect, subagent-cancel, subagent-wait, and subagent-reply for bounded background jobs."
+].join("\n");
 function subagents_extension_default(pi, dependencies = {}) {
   pi.registerMessageRenderer(SUBAGENT_COMPLETION_MESSAGE_TYPE, renderCompletionMessage);
   const loadBlockingExecution = cachedModuleLoader(
@@ -1468,6 +1479,7 @@ function subagents_extension_default(pi, dependencies = {}) {
   const settings = readSubagentSettings();
   let currentSettings = settings;
   let currentCatalog = "";
+  let migrationWarningShown = false;
   const blockingEnabled = settings?.blocking?.enabled !== false;
   const statefulEnabled = settings?.stateful?.enabled !== false;
   if (blockingEnabled) {
@@ -1482,6 +1494,10 @@ function subagents_extension_default(pi, dependencies = {}) {
       ...new Set([loadNotice, refreshedNotice].filter((value) => value !== void 0))
     ].join("\n");
     if (notice) ctx.ui.notify(notice, "warning");
+    if (ctx.hasUI && !migrationWarningShown) {
+      migrationWarningShown = true;
+      ctx.ui.notify(VERSION_3_MIGRATION_WARNING, "warning");
+    }
     currentCatalog = formatAgentCatalog(
       discoverAgentCatalog(ctx.cwd, ctx.isProjectTrusted(), refreshedSettings)
     ).text;