pi-ptc-subagents 0.1.3 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,69 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-09-29
+
+### Fixed
+
+- **Background dispatch children no longer reap their parent's tasks (field
+  report, 2026-09-29).** Background children share the session's task storage
+  via `--session-dir`; a child's startup reconcile and exit sweep used to be
+  directory-wide, so a dispatch child — or any `pi` process started in the same
+  directory — flipped every running task to `lost`. Task records now carry an
+  owner identity (`ownerPid` / `ownerBootMs`) and reaping is owner-scoped
+  (ADR-0023); `lost_on_session_restart` now means the owner process died
+  before the task finished, or the record predates ownership (pre-upgrade
+  ownerless rows, which any process binding the directory reaps).
+- **`pi.dispatch` refusals are actionable.** A missing `agent` argument is
+  reported distinctly (`agent is required (there is no default agent)`) and
+  both the missing- and unknown-agent results list the agents registered under
+  the effective scope plus the two lookup paths and the agent-file shape. The
+  binding now runs its arguments through pi's own `validateToolArguments`
+  (the same validation the built-in bindings use) and a validation failure
+  comes back as a `rejected` DispatchResult instead of reaching the
+  subprocess layer.
+
+### Changed
+
+- **PTC program prompts name the dispatch binding precisely.** The
+  `ptc_run_code` / `ptc_workflow` descriptions and the `/ptc` briefing state
+  that `pi.dispatch` is always bound under its literal dot name (call it as
+  `tools["pi.dispatch"](...)`; `tools.pi.dispatch` does not exist), and each
+  run exposes its actual bound names on the new `ptcBindings` global so
+  programs never guess the binding surface.
+- **Docs**: `ptc_run_code`'s `timeoutMs` description and `docs/usage/bgdispatch.md`
+  now state that a run timeout terminates in-flight foreground dispatches, and
+  the guide gains prerequisites (no default agent) and an output-compactness
+  convention (page via `ptc_task_output` instead of truncating).
+
+## [1.0.0] - 2026-09-24
+
+### Added
+
+- **Background dispatch: PTC programs can fan out to long-lived children.**
+  `pi.dispatch(...)` gains an opt-in `{ background: true }` path: instead of
+  awaiting the child, the binding returns a `DispatchHandle`
+  (`{ taskId, label, status: "running" }`) immediately, and a detached pump
+  drives a session-level `TaskRecord` through
+  `running / stopping / succeeded / failed / canceled / lost`, past the end of
+  the program and of the turn. The handle is a frozen spawn-time projection;
+  live state comes from three model-facing tools that stay on when PTC mode is
+  off (`/ptc off` only blocks new spawns):
+  - **`ptc_task_list`** — list this session's tasks (`status?`, `limit?`,
+    default 100, newest first);
+  - **`ptc_task_output`** — read a task's captured output (`taskId`,
+    `sinceBytes?`), tail-truncated to pi's 50 KB / 2000-line contract
+    (ADR-0015) with the full text written to a temp file;
+  - **`ptc_task_stop`** — ask a running task to stop (`taskId`, `reason?`,
+    default `"model stop"`), moving it `running -> stopping -> canceled`.
+
+  Lifecycle changes arrive as user-role `<bg-task-notification>` events under a
+  `<bg-task-notifications>` batch, cursor-delivered per subscriber with a
+  2048-byte inline-preview ceiling. Background tasks count against the existing
+  `dispatchConcurrency` (8) for their whole lifetime and share the
+  `maxDispatchDepth` (3) recursion bound. Existing foreground `pi.dispatch`
+  keeps its `DispatchResult` shape unchanged. ADR-0022.
+
 ## [0.1.3] - 2026-09-23
 
 ### Added

package/README.md

@@ -32,6 +32,9 @@ required — install it and the extension is on for the next pi startup.
 - `ptc_workflow` — structured variant with `meta` + plain-JSON `args`, plus the
   workflow helpers (`log`, `phase`, `parallel`, `pipeline`). There is no
   `agent()` helper on either surface.
+- `ptc_task_list` / `ptc_task_output` / `ptc_task_stop` — manage background
+  dispatches (see [Background dispatch](#background-dispatch)). They stay
+  available when PTC mode is off.
 
 Long output follows pi's own truncation contract ([ADR-0015](./docs/adr/0015-pi-truncation-contract.md)):
 
@@ -43,9 +46,11 @@ the next program can `tools.read`; the collapsed row then shows `truncated` in i
 
 PTC programs can spawn a fresh `pi` subprocess per call via the **`pi.dispatch(...)`** binding ([ADR-0016](./docs/adr/0016-ptc-dispatch-binding.md)). Use it to fan out to a specialist agent — the child subprocess loads the named agent's markdown from `~/.pi/agent/agents/<name>.md` (or `.pi/agents/<name>.md` for project-scope agents), runs that agent's tool set and system prompt in isolation, and returns a structured result.
 
+Bindings are reached through the one `tools` table — there is no `pi` global in the worker — so the binding named `pi.dispatch` is called as `tools["pi.dispatch"]({ … })` with a single object argument.
+
 ```ts
 // inside a ptc_run_code program
-const result = await pi.dispatch({
+const result = await tools["pi.dispatch"]({
   agent: "scout",
   task: "find all auth code in src/",
   cwd: process.cwd(),
@@ -62,8 +67,8 @@ const result = await pi.dispatch({
 ```ts
 const [read, scoutA, scoutB] = await Promise.all([
   tools.read({ path: "package.json" }),
-  pi.dispatch({ agent: "scout", task: "review auth" }),
-  pi.dispatch({ agent: "scout", task: "review db" }),
+  tools["pi.dispatch"]({ agent: "scout", task: "review auth" }),
+  tools["pi.dispatch"]({ agent: "scout", task: "review db" }),
 ]);
 ```
 
@@ -78,11 +83,36 @@ const [read, scoutA, scoutB] = await Promise.all([
 ```ts
 // in a hypothetical runner that wants to keep reads-only:
 createBuiltinBindings({ cwd: "/abs/path", names: ["read", "grep"] });
-// `pi.dispatch` is NOT in the resulting table.
+// `pi.dispatch` is NOT in the resulting `tools` table.
 ```
 
 **Not a subagent.** The term _subagent_ is overloaded in this field (DSH's `subagent` is a different thing; pi's `examples/extensions/subagent/` extension is also a different thing). pi-ptc uses _parallel binding_ and _concurrent tool call_ throughout; see `CONTEXT.md` for the canonical terms.
 
+### Background dispatch
+
+Foreground `pi.dispatch` blocks the program until the child exits. Pass `background: true` to spawn the child and return immediately with a `DispatchHandle` ([ADR-0022](./docs/adr/0022-background-dispatch.md)); the child outlives both the program and the turn:
+
+```ts
+// inside a ptc_run_code program — bindings are reached as tools["<name>"]
+const handle = await tools["pi.dispatch"]({
+  agent: "scout",
+  task: "audit the auth code",
+  background: true,
+  label: "auth audit", // defaults to task.slice(0, 64)
+});
+// handle: { taskId: "01J…", label: "auth audit", status: "running" }
+```
+
+(The binding's name is `pi.dispatch`; a program reaches it as `tools["pi.dispatch"]`.)
+
+A detached pump drives the task's lifecycle (`running` -> `succeeded` / `failed` / `canceled` / `lost`), and the model observes it with three always-on tools — they are not part of the PTC-mode loadout, so `/ptc off` (which only blocks new spawns) does not remove them. A background task is owned by the dispatching pi process (ADR-0023): it survives programs, turns, and `/ptc off`, ends when that session ends or the process dies, and no other pi process in the same directory can reap it (background dispatch children share the session's task storage, so pre-ADR-0023 any same-directory pi process — including a dispatch child itself — could reap every task on startup). Known edges: pre-upgrade ownerless records are still reaped by whichever process binds the directory first; a recycled pid can leave a record `running` after its owner died; and `ptc_task_stop` from another process can write a `stopping` state into your record even though the stop signal itself never crosses the process boundary:
+
+- `ptc_task_list({ status?, limit? })` — list this session's tasks, newest first (default limit 100).
+- `ptc_task_output({ taskId, sinceBytes? })` — read a task's captured output, tail-truncated to pi's 50 KB / 2000-line contract (ADR-0015).
+- `ptc_task_stop({ taskId, reason? })` — ask a running task to stop.
+
+Background tasks count against the same `dispatchConcurrency` (default 8) for their whole lifetime and share the `maxDispatchDepth` (default 3) recursion bound. A pre-spawn refusal (depth or concurrency cap, unknown agent) still comes back as the familiar `DispatchResult` with `status: "rejected"`. Full guide: [`docs/usage/bgdispatch.md`](./docs/usage/bgdispatch.md).
+
 ## TUI rendering
 
 Both tools register custom `renderCall` / `renderResult` hooks, so a PTC run reads as a program

package/dist/index.d.ts

@@ -1,5 +1,483 @@
-import { ExtensionAPI, Skill } from "@earendil-works/pi-coding-agent";
+import { ExtensionAPI, Skill, truncateTail } from "@earendil-works/pi-coding-agent";
+import "@earendil-works/pi-ai";
 import { MessagePort, Worker } from "node:worker_threads";
+//#region src/runtime/ulid.d.ts
+/**
+ * Lexically-sortable identifier (26-char Crockford base32). Brand-only: the runtime value is a
+ * plain `string`, the brand is a compile-time distinction that keeps a taskId from being
+ * passed into a cursor slot.
+ */
+type ULID = string & {
+  readonly __brand: "ULID";
+};
+//#endregion
+//#region src/runtime/child-process-lifecycle.d.ts
+/**
+ * One line of the child's stdout, parsed as JSON. The child emits the events described
+ * in examples/extensions/subagent/index.ts (message_end, tool_result_end, error).
+ * Anything unparseable is dropped: the line is one event the host cannot interpret,
+ * and the run continues.
+ */
+interface ParsedAgentEvent {
+  type: string;
+  message?: {
+    role?: string;
+    content?: ReadonlyArray<{
+      type?: string;
+      text?: string;
+    }>;
+    usage?: {
+      input?: number;
+      output?: number;
+      cacheRead?: number;
+      cacheWrite?: number;
+      cost?: {
+        total?: number;
+      };
+    };
+    model?: string;
+    stopReason?: string;
+    errorMessage?: string;
+  };
+  message_text?: string;
+}
+/**
+ * Opaque per-handle state owned by the adapter that produced it. The dispatch code
+ * never reads `opaque` directly; it only hands the handle back to adapter methods
+ * (`kill`, `events`, `exit`, `stderr`).
+ */
+interface ChildHandle {
+  readonly id: ULID;
+  readonly opaque: unknown;
+}
+/**
+ * Spawn options shared by both adapters. `promptFile` / `sessionDir` / `sessionId` /
+ * `sessionName` are the R1 fields the background dispatch consumes (ADR-0022 §1/R1). The
+ * foreground `pi.dispatch` path passes only `cwd` / `env` / `signal` / `promptFile`.
+ */
+interface ChildSpawnOptions {
+  cwd: string;
+  env?: NodeJS.ProcessEnv;
+  signal?: AbortSignal;
+  promptFile: string;
+  sessionDir?: string;
+  sessionId?: string;
+  sessionName?: string;
+}
+/** Process-exit shape the `close` event on `node:child_process.ChildProcess` produces. */
+interface ChildExitValue {
+  code: number | null;
+  signal: NodeJS.Signals | null;
+}
+/**
+ * The lifecycle contract. Implementations:
+ *   - `RealChildProcessLifecycle` - wraps `node:child_process.spawn` (production).
+ *   - `MockChildProcessLifecycle` - in-memory queue + exit signal (tests).
+ */
+interface ChildProcessLifecycle {
+  /**
+   * Launch one child process. The first element of `argv` is the executable; the rest
+   * are forwarded as command-line arguments. Returns an opaque handle the caller uses
+   * to talk to the same child via the other methods.
+   *
+   * `opts.env` is the full environment for the child; the caller is responsible for
+   * merging anything the child needs (e.g. `PI_PTC_DEPTH`) on top of `process.env`.
+   */
+  spawn(argv: readonly string[], opts: ChildSpawnOptions): ChildHandle;
+  /**
+   * Send `signal` to the child iff it is still attached. Absorbs "process already gone"
+   * throws so callers can fire-and-forget on cancel. Mirrors `safeKill` below.
+   */
+  kill(handle: ChildHandle, signal: "SIGTERM" | "SIGKILL"): void;
+  /**
+   * Async iterator over the child's stdout events. Yields one `ParsedAgentEvent` per
+   * JSONL line. The iterator ends after the child closes; callers should `await` it
+   * fully before reading `exit()`.
+   */
+  events(handle: ChildHandle): AsyncIterable<ParsedAgentEvent>;
+  /**
+   * Resolve when the child closes, with `(code, signal)` matching `node:child_process`'s
+   * `close` event. A clean exit is `(0, null)`; a signal kill is `(null, <signal>)`;
+   * a spawn failure surfaces as `(null, null)` once the error event has propagated.
+   */
+  exit(handle: ChildHandle): Promise<ChildExitValue>;
+  /**
+   * Resolve with the accumulated stderr text once the child has closed. Returns `""`
+   * when the child wrote nothing. Spawn failures append a `[spawn-error] ...` marker
+   * (same convention as the pre-BG-03 dispatch code) so callers can distinguish a
+   * failed spawn from a clean non-zero exit.
+   */
+  stderr(handle: ChildHandle): Promise<string>;
+}
+//#endregion
+//#region src/runtime/task-storage.d.ts
+/**
+ * The 6-state TaskRecord status (ADR-0022 §2). `queued` is deliberately absent in v1
+ * (spawn-or-reject, no in-task queue; cap=8 rejects above the limit immediately).
+ */
+type TaskStatus = "running" | "stopping" | "succeeded" | "failed" | "canceled" | "lost";
+/** Origin of the spawn — `ptc-program` from a PTC run, `ptc-batch` from a future batch entry. */
+interface TaskSpawnSource {
+  kind: "ptc-program" | "ptc-batch";
+  /** Caller id (PTC run id for `ptc-program`; batch id for `ptc-batch`). */
+  callerId: string;
+}
+/**
+ * Session-level row tracking the lifecycle of one background child. 19 ADR-0022 §3 fields (its
+ * "21 fields" heading is an authoring miscount) plus two optional ADR-0023 owner-identity
+ * fields — 21 today, persisted as-is. Optional fields are absent on
+ * records still `running` (e.g. `finishedAt` / `exitCode` / `outputRef` are written at
+ * transition time, not at spawn) and `ownerPid` / `ownerBootMs` are absent on pre-upgrade
+ * legacy records.
+ */
+interface TaskRecord {
+  id: ULID;
+  label: string;
+  agentName: string;
+  /** 0 = parent's direct, 1 = grandchild, etc. (ADR-0016 recursive section). */
+  depth: number;
+  status: TaskStatus;
+  /** ms epoch. */
+  createdAt: number;
+  startedAt: number;
+  finishedAt?: number;
+  durationMs?: number;
+  /** Last state transition ms epoch; used for cursor ordering of events. */
+  transitionAt: number;
+  /** `<sessionDir>/tasks/<id>/output.log` once the child has flushed any output. */
+  outputRef?: string;
+  outputBytes?: number;
+  /** ≤ 2 KB inline preview (Map+preview, ADR-0022 §3). */
+  outputPreview?: string;
+  stopReason?: string;
+  errorMessage?: string;
+  exitCode?: number;
+  spawnSource: TaskSpawnSource;
+  parentTaskId?: ULID;
+  /** `<sessionDir>/tasks/<id>.pi-*` session file (R1). */
+  sessionFile?: string;
+  /**
+   * ADR-0023 (task ownership): pid of the extension-runtime instance that created this record.
+   * Absent on pre-upgrade legacy records. The only writer is the registry's spawn command,
+   * stamping its configured owner; reaping is owner-scoped (startup reconcile sweeps a record
+   * only when this pid is dead; the shutdown sweep reaps only records that also match
+   * `ownerBootMs`).
+   */
+  ownerPid?: number;
+  /** ADR-0023: wall-clock ms when the owning runtime instance started; pairs with `ownerPid`. */
+  ownerBootMs?: number;
+}
+/**
+ * Per-subscriber cursor for one TaskRecord (ADR-0022 §5). Cursor is per-subscriber (not per-task)
+ * because fork semantics differ from single-session semantics: a forked branch observes events
+ * from `max(parent, child)` cursor onwards, not from task creation.
+ */
+interface Subscription {
+  subscriberId: ULID;
+  taskId: ULID;
+  /** Monotonic ULID; advances on every event delivered. */
+  cursor: ULID;
+  status: "active" | "closed";
+  /** ms epoch. */
+  createdAt: number;
+}
+/**
+ * Append-only event in a subscription buffer. The `eventId` IS the cursor: monotonic ULID, the
+ * `loadEvents(since)` filter slices `[strictly-after since, ...]`. Schema fields beyond the
+ * cursor carry enough state for the renderer to emit `<bg-task-notification>` (ADR-0022 §7)
+ * without re-reading the TaskRecord.
+ */
+interface TaskEvent {
+  /** Cursor / event id; the loadEvents(since) filter. */
+  eventId: ULID;
+  subscriptionId: ULID;
+  taskId: ULID;
+  /**
+   * Emit key per ADR-0022 §2 + §8, e.g. `task:<id>:running`, `task:<id>:->canceled`,
+   * `task:<id>:->lost`. Storage layer treats this as an opaque string.
+   */
+  type: string;
+  status: TaskStatus;
+  /** ms epoch; matches `TaskRecord.transitionAt` at the moment of emission. */
+  transitionAtMs: number;
+  outputBytes?: number;
+  /** ≤ 2 KB inline preview (only present when `outputBytes <= 2048`). */
+  outputPreview?: string;
+}
+//#endregion
+//#region src/runtime/task-registry.d.ts
+/** Minimal structured logger seam (ADR-0022 implementation spec §12). */
+interface RegistryLogger {
+  info(msg: string): void;
+  warn(msg: string): void;
+}
+/**
+ * Thin, frozen, spawn-time projection of a TaskRecord (ADR-0022 §4). The program carries
+ * this; the registry stores the TaskRecord. The handle is *not* updated on transition.
+ */
+interface DispatchHandle {
+  taskId: ULID;
+  label: string;
+  status: "running";
+}
+/**
+ * Per-call dependencies for one registry command. `callerId` is also the subscriber id
+ * (ADR-0022 §5, "Subscriber == owner"); `clock` must be the injected time source.
+ */
+interface TransitionContext {
+  clock: () => number;
+  logger?: RegistryLogger;
+  callerId: string;
+}
+/**
+ * The three `lost` reasons ADR-0022 §8 keeps distinct in the TaskRecord's
+ * `errorMessage` field for auditability.
+ */
+type LostReason = "session_ended_while_running" | "user_killed_via_esc" | "lost_on_session_restart";
+/** All state mutations the TaskRegistry accepts (single-terminal-writer invariant, this file). */
+type TaskCommand = {
+  kind: "spawn";
+  parentTaskId?: ULID;
+  handle: DispatchHandle;
+  record: Omit<TaskRecord, "id" | "status" | "createdAt" | "transitionAt">;
+} | {
+  kind: "transition";
+  taskId: ULID;
+  to: TaskStatus;
+  reason?: string;
+  stopReason?: string;
+  errorMessage?: string;
+  exitCode?: number;
+  /**
+   * ADR-0022 §3: the child's captured-output projection written on the terminal
+   * transition. The BG-04 pump drains stdout, persists it through `OutputStorage`, and
+   * passes these three so `ptc_task_output` can find it.
+   */
+  outputRef?: string;
+  outputBytes?: number;
+  outputPreview?: string;
+} | {
+  kind: "stop";
+  taskId: ULID;
+  reason: string;
+} | {
+  kind: "reconcile-lost";
+  taskId: ULID;
+  reason: LostReason;
+} | {
+  kind: "resolve-exit";
+  taskId: ULID;
+  exitCode: number;
+  outputRef?: string;
+  outputBytes?: number;
+  outputPreview?: string;
+};
+/** Outcome of one successful command: the persisted record, emitted events, and cursor. */
+interface TransitionResult {
+  record: TaskRecord;
+  events: TaskEvent[];
+  /** The event id of the last emitted event; equal to the subscription's new cursor. */
+  cursor: ULID;
+  /**
+   * The status the record held *before* this command applied. Absent on `spawn` (there is no
+   * prior state); present on every transition/stop/resolve so a caller can report the source
+   * state without a second, racing read (ADR-0022 §8 late-arrival stop).
+   */
+  fromStatus?: TaskStatus;
+}
+/**
+ * In-process transition observer (issue #68 §1). Fired synchronously by
+ * {@link TaskRegistry.transition} **after** the new record and its event have been persisted,
+ * with the post-transition record and the emitted event. Observers are best-effort: a throwing
+ * observer is warned about and never corrupts the transition. Registration returns an
+ * idempotent unsubscribe.
+ */
+type TaskTransitionObserver = (record: TaskRecord, event: TaskEvent) => void;
+/** Read-side filter (ADR-0022 §3). `limit` defaults to 100; `orderBy` defaults to desc. */
+interface TaskQuery {
+  status?: TaskStatus[];
+  label?: string;
+  limit?: number;
+  orderBy?: "createdAt-asc" | "createdAt-desc";
+}
+/** The five-method lifecycle surface from the BG-02 brief. */
+interface TaskRegistry {
+  transition(command: TaskCommand, ctx: TransitionContext): Promise<TransitionResult>;
+  query(view: TaskQuery): Promise<TaskRecord[]>;
+  /**
+   * Load one TaskRecord by id; `null` when the id is unknown. The O(1) complement of `query`,
+   * used by the background pump to see whether a stop was requested before it writes the
+   * terminal transition (ADR-0022 §8).
+   */
+  get(taskId: ULID): Promise<TaskRecord | null>;
+  /**
+   * Subscribe to every successfully persisted state write (spawn included). Returns an
+   * idempotent unsubscribe. Observers run synchronously, in-process; see
+   * {@link TaskTransitionObserver} for the best-effort contract and single-writer ordering.
+   */
+  onTransition(observer: TaskTransitionObserver): () => void;
+  reconcileLostTasks(): Promise<TaskRecord[]>;
+}
+//#endregion
+//#region src/runtime/output-storage.d.ts
+/**
+ * The persistence seam for one task's captured output.
+ *
+ * `readOutput` returning `null` and `writeOutput` accepting any string are the whole contract;
+ * ordering, framing and truncation are the caller's job.
+ */
+interface OutputStorage {
+  /** Load the task's raw output; `null` when nothing has been written for that id. */
+  readOutput(taskId: ULID): Promise<string | null>;
+  /** Persist (insert-or-replace) the task's raw output. */
+  writeOutput(taskId: ULID, content: string): Promise<void>;
+  /**
+   * The stable path/ref the dispatcher records on `TaskRecord.outputRef`. It exists even before
+   * the first `writeOutput` (the ref is the record's address, not the file's existence).
+   */
+  outputRef(taskId: ULID): string;
+}
+//#endregion
+//#region src/runtime/dispatch.d.ts
+/**
+ * Per-run in-flight `pi.dispatch` counter (ADR-0016 §2 + ADR-0022 §9). The dispatcher's
+ * foreground gate owns the canonical counter today; this class is the small exported seam
+ * ADR-0022 §9 asks for so the background branch can hold a slot for a child's whole
+ * lifetime and release it only on the terminal transition — a background task keeps
+ * counting against `dispatchConcurrency` after `dispatch()` has already returned. The
+ * dispatcher can adopt this type without a behaviour change.
+ */
+declare class DispatchSlotCounter {
+  #private;
+  readonly limit: number;
+  constructor(limit: number);
+  /** Number of slots currently held. */
+  get active(): number;
+  /** Reserve one in-flight slot (optionally keyed by a per-task holder token); `false` means the cap is reached (hard reject, no queue). */
+  tryAcquire(holder?: string): boolean;
+  /**
+   * Release one slot; per-token idempotent (a late release for the same task is a no-op) and
+   * never negative. An anonymous release only frees an anonymous reservation.
+   */
+  release(holder?: string): void;
+}
+/**
+ * Injected dependencies for the background branch. The foreground path ignores this object
+ * entirely (it uses the module-level {@link DISPATCH_LIFECYCLE}); every field is optional so
+ * existing zero-argument call sites keep working. Tests pass an in-memory registry and a
+ * mock lifecycle so no real `pi` process is ever spawned.
+ */
+interface DispatchDeps {
+  /** Session-level TaskRegistry (ADR-0022 §3). Defaults to a lazy in-memory registry. */
+  taskRegistry?: TaskRegistry;
+  /** Child lifecycle for the background spawn. Defaults to the shared real adapter. */
+  lifecycle?: ChildProcessLifecycle;
+  /** Per-run in-flight counter shared with the dispatcher's foreground gate (ADR-0022 §9). */
+  slots?: DispatchSlotCounter;
+  /** Time source for TaskRecord stamps. Defaults to `Date.now`. */
+  clock?: () => number;
+  /** Logger for the background pump's failure path. Defaults to a `console.warn` logger. */
+  logger?: RegistryLogger;
+  /**
+   * ADR-0022 §3: where the pump persists a task's drained stdout. When present, the terminal
+   * transition records `outputRef` / `outputBytes` / `outputPreview` so `ptc_task_output`
+   * can dereference the bytes (BG-07).
+   */
+  outputStorage?: OutputStorage;
+}
+//#endregion
+//#region src/runtime/notification-pipeline.d.ts
+/** Idle-wake callback: one subscriber's pending events, delivered in cursor order. */
+type IdleWakeHandler = (subscriberId: ULID, events: TaskEvent[]) => void;
+/**
+ * The five-method pipeline surface (Ticket BG-05). The concrete class adds the
+ * dispatcher-facing `notifyIdle` wake trigger on top of this interface.
+ */
+interface NotificationPipeline {
+  /** Create (or return the existing) subscription for one (subscriberId, taskId) pair. */
+  subscribe(subscriberId: ULID, taskId: ULID, since?: ULID): Promise<Subscription>;
+  /** Read pending events strictly newer than the cursor, WITHOUT advancing the cursor. */
+  drainPending(subscriberId: ULID, taskId: ULID): Promise<TaskEvent[]>;
+  /** Advance the cursor to `untilCursor`; never moves backwards (idempotent). */
+  acknowledgeEvents(subscriberId: ULID, taskId: ULID, untilCursor: ULID): Promise<void>;
+  /** Register an idle-wake handler; handlers fire in registration order. */
+  onIdleWake(handler: IdleWakeHandler): void;
+  /** Count events strictly newer than the cursor. */
+  pendingCount(subscriberId: ULID, taskId: ULID): Promise<number>;
+}
+//#endregion
+//#region src/runtime/task-notification.d.ts
+/**
+ * One drained event joined to the TaskRecord it describes. The join is required: the event
+ * lacks `label` / `agentName` / `depth` / `durationMs` / `outputRef` (see the module
+ * note above), all of which the ADR-0022 §7 child element must carry.
+ */
+interface TaskNotificationItem {
+  event: TaskEvent;
+  record: TaskRecord;
+}
+//#endregion
+//#region src/runtime/background-runtime.d.ts
+/** Best-effort reporter for a bind failure; the index notifies the user from it. */
+type BackgroundBindReporter = (message: string) => void;
+/** One cursor to advance after a drained batch has actually been delivered. */
+interface NotificationAck {
+  subscriberId: ULID;
+  taskId: ULID;
+  cursor: ULID;
+  /**
+   * The concrete session pipeline this drain READ from, carried so the ack lands on the same
+   * session even if a rebind happens between the drain and the send (P1). Without it the ack goes
+   * through the stable proxy's *current* delegate and targets a session that never knew the
+   * subscription, leaving the original cursor unadvanced and re-delivering the batch.
+   */
+  sink: NotificationPipeline;
+}
+/**
+ * One drain: the events to render plus the cursors the caller acknowledges after a successful
+ * send. The split is what lets a failed send leave the cursor unadvanced (ADR-0022 §5/§6).
+ */
+interface NotificationDrain {
+  items: TaskNotificationItem[];
+  acks: readonly NotificationAck[];
+}
+/**
+ * The holder. `registry` / `outputStorage` / `pipeline` are stable objects safe to capture
+ * before any session exists; `bindSession` swaps the session delegate underneath them.
+ */
+interface BackgroundTaskRuntime {
+  readonly registry: TaskRegistry;
+  readonly outputStorage: OutputStorage;
+  readonly pipeline: NotificationPipeline;
+  readonly slots: DispatchSlotCounter;
+  readonly lifecycle: ChildProcessLifecycle;
+  /** Stable deps the two PTC tools hand to `runPtcProgram` (ADR-0022 §9). */
+  readonly dispatchDeps: DispatchDeps;
+  /** Session clock (`Date.now` unless injected); passed to `ptc_task_stop`. */
+  readonly clock: () => number;
+  /**
+   * (Re)bind to a session: build the session storage/registry/pipeline, swap the delegates, then
+   * reconcile. Returns the records marked `lost`. A bind failure (storage construction or the
+   * reconcile sweep) is reported via `reporter` and the logger, and leaves the previous delegate
+   * usable; it never rejects and never partially swaps.
+   */
+  bindSession(sessionDir: string | undefined, reporter?: BackgroundBindReporter): Promise<TaskRecord[]>;
+  /** Drain undelivered events for a subscriber as `{event, record}` pairs ready for the renderer. */
+  drainNotifications(subscriberId: ULID): Promise<NotificationDrain>;
+  /**
+   * Advance the subscription cursor for a drained batch. The caller invokes this ONLY after the
+   * batch's message was actually delivered (ADR-0022 §5/§6); a failed send leaves the cursor
+   * where it was so the next drain re-delivers the event.
+   */
+  acknowledgeNotifications(acks: readonly NotificationAck[]): Promise<void>;
+  /**
+   * Mark every non-terminal task this runtime OWNS lost (given reason) and release resources.
+   * ADR-0023: records owned by another runtime instance — e.g. a sibling pi process sharing
+   * the session dir — are never reaped here, and their children are never signaled.
+   */
+  shutdown(reason: LostReason): Promise<TaskRecord[]>;
+}
+//#endregion
 //#region src/mode/ptc-mode.d.ts
 /** The two surfaces this package exposes. `/ptc on` needs at least one of them active. */
 export declare const PTC_MODE_TOOL_NAMES: readonly string[];
@@ -410,6 +888,29 @@ interface BindingContext {
   depth: number;
   /** Maximum allowed depth; passed through to `pi.dispatch` for the depth check. */
   maxDispatchDepth: number;
+  /**
+   * ADR-0022 §5: the TaskRecord owner / subscription subscriber. The dispatcher threads the
+   * run id here so a background task's events are addressed to the spawning run.
+   */
+  callerId?: string;
+  /**
+   * ADR-0022 R1: the session dir a background child persists into. Threaded from the
+   * dispatcher (see `RunPtcProgramOptions.sessionDir`); when no dir is available the spawn
+   * keeps the foreground no-session shape.
+   */
+  sessionDir?: string;
+  /**
+   * ADR-0022 §3/reopen R-m12: this process's own background task id, when this run is inside a
+   * background child. Threaded from the dispatcher (see `RunPtcProgramOptions.parentTaskId`)
+   * and forwarded to `pi.dispatch` so a nested spawn records `TaskRecord.parentTaskId`.
+   */
+  parentTaskId?: ULID;
+  /**
+   * ADR-0022 §9: per-run dispatch dependencies. The dispatcher supplies the run's shared
+   * `DispatchSlotCounter` here; a host may also pass session-level deps (registry / lifecycle /
+   * output storage) so the binding's `dispatch()` call shares them.
+   */
+  dispatchDeps?: DispatchDeps;
 }
 interface Binding {
   readonly name: string;
@@ -540,8 +1041,28 @@ interface RunPtcProgramOptions {
    * to 0.
    */
   depth?: number;
+  /**
+   * ADR-0022 §3/reopen R-m12: this process's own background task id, when the run is inside a
+   * child spawned by `pi.dispatch({ background: true })`. The entrypoint reads it from
+   * `PI_PTC_TASK_ID` and threads it to the binding context so a nested spawn records
+   * `TaskRecord.parentTaskId`. Absent for a top-level session.
+   */
+  parentTaskId?: ULID;
   /** Identifier carried to the worker; generated when omitted. */
   runId?: string;
+  /**
+   * ADR-0022 R1: the session dir background children persist into, when the host has one.
+   * Threaded to the binding context so `pi.dispatch({ background: true })` can stamp the R1
+   * session flags; absent means the background spawn keeps the foreground no-session shape.
+   */
+  sessionDir?: string;
+  /**
+   * ADR-0022 §3/§9: session-level dispatch dependencies (TaskRegistry / OutputStorage /
+   * lifecycle / clock / logger). The dispatcher merges its per-run `DispatchSlotCounter`
+   * into this bag before handing it to the `pi.dispatch` binding, so background tasks count
+   * against this run's `dispatchConcurrency` for their whole lifetime.
+   */
+  dispatchDeps?: DispatchDeps;
   /**
    * Optional worker pool (ADR-0017). Absent = spawn a fresh worker and terminate it
    * at run end (the original cold-start path). Present = the dispatcher acquires a
@@ -642,7 +1163,15 @@ export declare class TurnPools {
 }
 //#endregion
 //#region src/index.d.ts
-export default function ptcSubagents(pi: ExtensionAPI): void;
+/**
+ * Optional seams for the extension factory. Production calls `ptcSubagents(pi)`; tests may inject
+ * a pre-built background runtime (with a mock child lifecycle) so no real `pi` process is spawned.
+ */
+export interface PtcSubagentsOptions {
+  /** Use this session-scoped background runtime instead of constructing one. */
+  backgroundRuntime?: BackgroundTaskRuntime;
+}
+export default function ptcSubagents(pi: ExtensionAPI, options?: PtcSubagentsOptions): void;
 //#endregion
 export type { Binding, BindingContext, BindingTable, CreateBuiltinBindingsOptions, DefaultModeConfig, ModeBlockReason, ModeEntryDecision, ModeEntryInput, ModeHideStrategy, PersistedModeState, PtcConfig, PtcErrorKind, PtcErrorShape, PtcImage, PtcJsonValue, PtcModeState, PtcRunOutcome, PtcSurface, RunPtcProgramOptions, TurnPoolsOptions, WorkerPoolOptions, WorkerPoolStats, WorkerPoolWorkerOptions };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,32 +1,43 @@
-import{a as e,i as t,n,o as r,r as i,s as a,t as o}from"./protocol-CfOgxz3u.js";import{DEFAULT_MAX_BYTES as s,DEFAULT_MAX_LINES as c,createBashTool as l,createEditTool as u,createFindTool as d,createGrepTool as f,createLsTool as p,createReadTool as m,createWriteTool as h,defineTool as g,formatSize as _,formatSkillsForPrompt as v,getAgentDir as y,truncateTail as b}from"@earendil-works/pi-coding-agent";import{Type as x}from"typebox";import{validateToolArguments as S}from"@earendil-works/pi-ai";import{spawn as ee}from"node:child_process";import*as C from"node:fs";import{existsSync as w,readFileSync as T,writeFileSync as E}from"node:fs";import*as D from"node:os";import{tmpdir as te}from"node:os";import*as O from"node:path";import{dirname as k,join as A,resolve as ne}from"node:path";import{randomUUID as j}from"node:crypto";import{MessageChannel as re,Worker as M}from"node:worker_threads";import N from"node:diagnostics_channel";import{fileURLToPath as P,pathToFileURL as ie}from"node:url";import{truncateToWidth as ae,visibleWidth as F}from"@earendil-works/pi-tui";function oe(e,t,n){let r=[`<pi-ptc-context depth="`+t+`" max-depth="`+n+`">`,`You are a PTC run at depth `+t+` (root is depth 0). You may write PTC programs and you may`,`call pi.dispatch(...) to spawn further children, but each level costs a fresh pi subprocess.`,`The remaining depth budget is `+n+` - `+t+`. Beyond it, pi.dispatch rejects with`,`{ status: "rejected", errorMessage: "dispatch depth limit reached" }.`,`</pi-ptc-context>`].join(`
+import{a as e,i as t,n,o as r,r as i,s as a,t as o}from"./protocol-CfOgxz3u.js";import{DEFAULT_MAX_BYTES as s,DEFAULT_MAX_LINES as c,createBashTool as l,createEditTool as u,createFindTool as d,createGrepTool as f,createLsTool as p,createReadTool as m,createWriteTool as h,defineTool as g,formatSize as _,formatSkillsForPrompt as v,getAgentDir as y,truncateTail as b}from"@earendil-works/pi-coding-agent";import{Type as x}from"typebox";import{validateToolArguments as S}from"@earendil-works/pi-ai";import*as C from"node:fs";import{existsSync as w,readFileSync as T,writeFileSync as ee}from"node:fs";import*as E from"node:os";import{tmpdir as te}from"node:os";import*as D from"node:path";import{dirname as O,join as k,resolve as A}from"node:path";import{spawn as ne}from"node:child_process";import{randomBytes as re,randomUUID as j}from"node:crypto";import{ok as M}from"node:assert/strict";import{MessageChannel as ie,Worker as N}from"node:worker_threads";import P from"node:diagnostics_channel";import{fileURLToPath as ae,pathToFileURL as F}from"node:url";import{truncateToWidth as I,visibleWidth as L}from"@earendil-works/pi-tui";import{appendFile as oe,mkdir as se,readFile as R,readdir as ce,rename as le,unlink as ue,writeFile as de}from"node:fs/promises";const fe=`0123456789ABCDEFGHJKMNPQRSTVWXYZ`;function pe(e){let t=``,n=Math.max(0,Math.floor(e));for(let e=0;e<10;e++)t=(fe[n%32]??`0`)+t,n=Math.floor(n/32);return t}function me(e){let t=``,n=0,r=0;for(let i=0;i<e.length&&t.length<16;i++)for(n=n<<8|(e[i]??0),r+=8;r>=5&&t.length<16;)r-=5,t+=fe[n>>>r&31];return t.padEnd(16,`0`)}function he(e){let t=new Uint8Array(e);for(let e=t.length-1;e>=0;e--){if((t[e]??0)<255)return t[e]=(t[e]??0)+1,t;t[e]=0}return t}function ge(e){let t=e.randomBytes??(e=>new Uint8Array(re(e))),n=-1,r=/* @__PURE__ */ new Uint8Array(10);return{next(){let i=Math.max(0,Math.floor(e.now())),a=i>n?i:n,o=a===n?he(r):t(10);return n=a,r=o,pe(a)+me(o)}}}const _e=ge({now:()=>Date.now()});function ve(){return _e.next()}function ye(e){let t=e.trim();if(t.length===0)return null;try{return JSON.parse(t)}catch{return null}}function be(e,t){if(e.pid===void 0)return!1;try{return e.kill(t),!0}catch{return!1}}function xe(e,t){if(e.eventWaiters.length>0){let n=e.eventWaiters.shift();n&&n(t);return}e.events.push(t)}function Se(e,t){if(e.exited)return;e.exited=!0,e.exitValue=t;for(let n of e.exitWaiters)n(t);e.exitWaiters=[];let n=e.eventWaiters;e.eventWaiters=[];for(let e of n)e(null);for(let t of e.stderrWaiters)t(e.stderr);e.stderrWaiters=[]}function Ce(e,t){let n=t.sessionDir===void 0?[...e]:e.filter(e=>e!==`--no-session`);return t.sessionDir!==void 0&&(n.push(`--session-dir`,t.sessionDir),t.sessionId!==void 0&&n.push(`--session-id`,t.sessionId),t.sessionName!==void 0&&n.push(`--name`,t.sessionName)),n}const we={warn:e=>{console.warn(`[pi-ptc.lifecycle] `+e)}};function Te(e){return e.length<=200?e:e.slice(0,200)+`…`}var Ee=class{#e;constructor(e={}){this.#e=e.logger??we}spawn(e,t){if(e.length===0)throw TypeError(`RealChildProcessLifecycle.spawn: argv must include the command`);let n=Ce(e,t),r=n[0],i=n.slice(1),a=ne(r,i,{cwd:t.cwd,shell:!1,stdio:[`ignore`,`pipe`,`pipe`],env:t.env}),o={proc:a,events:[],eventWaiters:[],exited:!1,exitValue:null,stderrWaiters:[],exitWaiters:[],stderr:``,lineBuffer:``},s={id:ve(),opaque:o},c=a.stdout;c&&c.on(`data`,e=>{o.lineBuffer+=e.toString(`utf-8`);let t=o.lineBuffer.indexOf(`
+`);for(;t>=0;){let e=o.lineBuffer.slice(0,t);o.lineBuffer=o.lineBuffer.slice(t+1);let n=ye(e);n?xe(o,n):e.trim().length>0&&this.#t(s,e),t=o.lineBuffer.indexOf(`
+`)}});let l=a.stderr;return l&&l.on(`data`,e=>{o.stderr+=e.toString(`utf-8`)}),a.on(`close`,(e,t)=>{let n=o.lineBuffer.trim();if(n.length>0){let e=ye(n);e?xe(o,e):this.#t(s,n),o.lineBuffer=``}Se(o,{code:e,signal:t})}),a.on(`error`,e=>{o.stderr+=`[spawn-error] `+e.message+`
+`,o.exited||Se(o,{code:null,signal:null})}),s}kill(e,t){let n=e.opaque;be(n.proc,t)}events(e){let t=e.opaque;return{async*[Symbol.asyncIterator](){for(;;){if(t.events.length>0){let e=t.events.shift();e!==void 0&&(yield e);continue}if(t.exited)return;let e=await new Promise(e=>{t.eventWaiters.push(e)});if(e===null)return;yield e}}}}exit(e){let t=e.opaque;return t.exited&&t.exitValue?Promise.resolve(t.exitValue):new Promise(e=>{t.exitWaiters.push(e)})}stderr(e){let t=e.opaque;return t.exited?Promise.resolve(t.stderr):new Promise(e=>{t.stderrWaiters.push(e)})}#t(e,t){this.#e.warn(`child ${e.id}: dropped a non-JSON stdout line (${t.length} chars): `+Te(t))}};const z=Object.freeze({timeoutMs:12e4,maxTimeoutMs:6e5,maxOutputBytes:67108864,maxMessageBytes:134217728,maxPendingCalls:128,maxParallelSubCalls:10,dispatchConcurrency:8,maxDispatchDepth:3,maxItemsPerCall:4096,graceMs:3e3,maxOldGenerationSizeMb:512,maxYoungGenerationSizeMb:64,poolSize:4,poolAcquireTimeoutMs:3e4,drainGraceMs:5e3}),De=Object.freeze([`PATH`,`PATHEXT`,`SYSTEMROOT`,`WINDIR`,`TEMP`,`TMP`]);function Oe(e=process.env){let t={};for(let n of De){let r=e[n];typeof r==`string`&&r.length>0&&(t[n]=r)}return t}function ke(e={}){let t={...z};for(let n of Object.keys(z)){let r=e[n];if(r!==void 0){if(typeof r!=`number`||!Number.isFinite(r)||r<=0)throw TypeError(`invalid PTC config override for ${n}: ${String(r)}`);t[n]=r}}return t}function Ae(e,t=z){return e===void 0||!Number.isFinite(e)||e<=0?t.timeoutMs:Math.min(e,t.maxTimeoutMs)}const je={running:[`stopping`,`succeeded`,`failed`,`canceled`,`lost`],stopping:[`succeeded`,`failed`,`canceled`],succeeded:[],failed:[],canceled:[],lost:[]},Me=/* @__PURE__ */ new Set([`succeeded`,`failed`,`canceled`,`lost`]),Ne=/* @__PURE__ */ new Set([`running`,`stopping`]);function Pe(e){return e===`running`||e===`stopping`||e===`succeeded`||e===`failed`||e===`canceled`||e===`lost`}function Fe(e){return typeof e==`string`&&e.length>0}const Ie=/* @__PURE__ */ new Set([`session_ended_while_running`,`user_killed_via_esc`,`lost_on_session_restart`]);function Le(e){return typeof e==`string`&&Ie.has(e)}function Re(e,t){return e.ownerPid===t.pid&&e.ownerBootMs===t.bootMs}function ze(e){try{return process.kill(e,0),!0}catch(e){let t=e?.code;if(t===`ESRCH`)return!1;if(t===`EPERM`)return!0;throw e}}function Be(e,t){let n=`task:${e}`;return t===`running`||t===`stopping`?`${n}:${t}`:`${n}:->${t}`}var Ve=class{#e;#t;#n;#r;#i;#a;#o=/* @__PURE__ */ new Set;#s=Promise.resolve();constructor(e,t){this.#e=e,this.#t=t.clock,this.#n=t.logger,this.#r=t.owner,this.#i=t.isPidAlive??ze,this.#a=ge({now:()=>this.#t()})}async transition(e,t){let n=await this.#h(()=>this.#c(e,t)),r=n.events[n.events.length-1];return r!==void 0&&this.#g(n.record,r,t.logger),n}onTransition(e){this.#o.add(e);let t=!0;return()=>{t&&(t=!1,this.#o.delete(e))}}async#c(e,t){switch(e.kind){case`spawn`:return this.#l(e,t);case`transition`:return this.#u(e,t);case`stop`:return this.#d(e,t);case`reconcile-lost`:return this.#p(e,t);case`resolve-exit`:return this.#f(e,t)}throw Error(`transition: unknown command kind ${String(e.kind)}`)}async get(e){return Fe(e)?await this.#e.loadTask(e):null}async query(e){let t=e.limit??100;if(!Number.isInteger(t)||t<0)throw Error(`query: limit must be a non-negative integer, got ${String(e.limit)}`);let n=e.orderBy??`createdAt-desc`,r=e.label===void 0?void 0:{label:e.label},i=[];for await(let t of this.#e.listTasks(r))(e.status===void 0||e.status.includes(t.status))&&i.push(t);return i.sort((e,t)=>n===`createdAt-asc`?e.createdAt-t.createdAt:t.createdAt-e.createdAt),i.slice(0,t)}async reconcileLostTasks(){let e=[];for await(let t of this.#e.listTasks())Ne.has(t.status)&&this.#_(t)&&e.push(t);let t=[];for(let n of e){let e=await this.transition({kind:`reconcile-lost`,taskId:n.id,reason:`lost_on_session_restart`},{clock:this.#t,callerId:this.#S(n),logger:this.#n});t.push(e.record)}return this.#n?.info(`reconcileLostTasks: marked ${t.length} task(s) lost`),t}async#l(e,t){let n=Math.max(0,Math.floor(t.clock())),r=e.handle;if(r==null)throw Error(`spawn: handle is required`);if(r.status!==`running`)throw Error(`spawn: handle.status must be "running", got ${String(r.status)}`);let i=Fe(r.taskId),a=i?r.taskId:this.#a.next();if(await this.#e.loadTask(a)!==null)throw Error(`spawn: task ${a} already exists (duplicate spawn)`);let o={...e.record,id:a,label:e.record.label.length>0?e.record.label:r.label,status:`running`,createdAt:n,startedAt:n,finishedAt:void 0,durationMs:void 0,transitionAt:n,parentTaskId:e.parentTaskId??e.record.parentTaskId};this.#r!==void 0&&(o.ownerPid=this.#r.pid,o.ownerBootMs=this.#r.bootMs),i||(r.taskId=a);let s=t.callerId,c=this.#x(a,s,`running`,n,o);return await this.#e.saveSubscription({subscriberId:s,taskId:a,cursor:c.eventId,status:`active`,createdAt:n}),await this.#e.appendEvents(s,[c]),await this.#e.saveTask(o),(t.logger??this.#n)?.info(`spawn: task ${a} (${o.label}) running for subscriber ${s}`),{record:o,events:[c],cursor:c.eventId}}async#u(e,t){if(!Pe(e.to))throw Error(`transition: unknown target state ${String(e.to)}`);let n=await this.#y(e.taskId);if(this.#v(n,e.to),e.to===`lost`&&!Le(e.reason))throw Error(`transition: to "lost" requires a LostReason (session_ended_while_running | user_killed_via_esc | lost_on_session_restart)`+(e.reason===void 0?``:`, got ${String(e.reason)}`));return this.#m(n,e.to,t,{reason:e.reason,stopReason:e.stopReason,errorMessage:e.errorMessage,exitCode:e.exitCode,outputRef:e.outputRef,outputBytes:e.outputBytes,outputPreview:e.outputPreview})}async#d(e,t){let n=await this.#y(e.taskId);return n.status===`stopping`?{record:n,events:[],cursor:(await this.#e.loadSubscription(t.callerId,n.id))?.cursor??n.id,fromStatus:n.status}:(this.#v(n,`stopping`),this.#m(n,`stopping`,t,{stopReason:e.reason}))}async#f(e,t){let n=await this.#y(e.taskId);if(n.status!==`running`&&n.status!==`stopping`)throw Error(`resolve-exit: task ${n.id} is terminal (${n.status}); the single terminal writer refuses to overwrite it`);let r=n.status===`stopping`?`canceled`:e.exitCode===0?`succeeded`:`failed`;return this.#v(n,r),this.#m(n,r,t,{exitCode:e.exitCode,outputRef:e.outputRef,outputBytes:e.outputBytes,outputPreview:e.outputPreview})}async#p(e,t){let n=await this.#y(e.taskId);if(!Ne.has(n.status))throw Error(`reconcile-lost: task ${n.id} is terminal (${n.status}); only running/stopping tasks can be reconciled`);return this.#m(n,`lost`,t,{errorMessage:e.reason})}async#m(e,t,n,r){let i=Math.max(0,Math.floor(n.clock())),a={...e,status:t,transitionAt:i};Me.has(t)&&(a.finishedAt=i,a.durationMs=i-e.startedAt),r.stopReason!==void 0&&(a.stopReason=r.stopReason),r.errorMessage!==void 0&&(a.errorMessage=r.errorMessage),r.exitCode!==void 0&&(a.exitCode=r.exitCode),r.outputRef!==void 0&&(a.outputRef=r.outputRef),r.outputBytes!==void 0&&(a.outputBytes=r.outputBytes),r.outputPreview!==void 0&&(a.outputPreview=r.outputPreview),r.reason!==void 0&&((t===`stopping`||t===`canceled`)&&a.stopReason===void 0&&(a.stopReason=r.reason),(t===`failed`||t===`lost`)&&a.errorMessage===void 0&&(a.errorMessage=r.reason));let o=n.callerId,s=this.#x(e.id,o,t,i,a);return await this.#b(o,e.id,i,s.eventId),await this.#e.appendEvents(o,[s]),await this.#e.saveTask(a),(n.logger??this.#n)?.info(`transition: task ${e.id} ${e.status} -> ${t} (subscriber ${o})`),{record:a,events:[s],cursor:s.eventId,fromStatus:e.status}}async#h(e){let t=this.#s.then(e,e);return this.#s=t.then(()=>void 0,()=>void 0),await t}#g(e,t,n){for(let r of this.#o)try{r(e,t)}catch(t){let r=t instanceof Error?t.message:String(t),i=`transition observer threw for task ${e.id}: ${r}`,a=n??this.#n;a===void 0?console.warn(`[task-registry] `+i):a.warn(i)}}#_(e){return e.ownerPid===void 0||!this.#i(e.ownerPid)}#v(e,t){let n=je[e.status];if(!n.includes(t)){let r=n.length===0?`<terminal>`:n.join(`, `);throw Error(`illegal transition for task ${e.id}: ${e.status} -> ${t} (allowed from ${e.status}: ${r})`)}}async#y(e){if(!Fe(e))throw Error(`transition: taskId is required`);let t=await this.#e.loadTask(e);if(t===null)throw Error(`transition: unknown taskId ${e}`);return t}async#b(e,t,n,r){await this.#e.loadSubscription(e,t)===null&&(await this.#e.saveSubscription({subscriberId:e,taskId:t,cursor:r,status:`active`,createdAt:n}),this.#n?.warn(`subscription: auto-created for subscriber ${e} on task ${t} at cursor ${r}`))}#x(e,t,n,r,i){let a=i.outputBytes,o=a!==void 0&&a<=2048?i.outputPreview:void 0;return{eventId:this.#a.next(),subscriptionId:t,taskId:e,type:Be(e,n),status:n,transitionAtMs:r,outputBytes:a,outputPreview:o}}#S(e){let t=e.spawnSource.callerId;return t.length>0?t:e.id}};function He(e,t){return new Ve(e,t)}function Ue(e,t){return e.eventId<t.eventId?-1:+(e.eventId>t.eventId)}function We(e){for(let t=1;t<e.length;t++)if(Ue(e[t-1],e[t])>0)return!1;return!0}var Ge=class e{#e;#t;#n;#r;constructor(){this.#e=/* @__PURE__ */ new Map,this.#t=/* @__PURE__ */ new Map,this.#n=/* @__PURE__ */ new Set,this.#r=/* @__PURE__ */ new Map}static#i(e,t){return`${e}-${t}`}#a(e){return this.#n.has(e)}async loadTask(e){let t=this.#e.get(e);return t===void 0?null:structuredClone(t)}async saveTask(e){M(e,`saveTask: record is required`),this.#e.set(e.id,structuredClone(e))}async deleteTask(e){if(!this.#e.has(e))throw Error(`deleteTask: unknown taskId ${e}`);this.#e.delete(e)}async*listTasks(e){for(let t of this.#e.values())(e?.status===void 0||t.status===e.status)&&(e?.label===void 0||t.label===e.label)&&(yield structuredClone(t))}async loadSubscription(t,n){let r=this.#t.get(e.#i(t,n));return r===void 0?null:structuredClone(r)}async saveSubscription(t){M(t,`saveSubscription: sub is required`);let n=e.#i(t.subscriberId,t.taskId);this.#t.set(n,structuredClone(t)),this.#n.add(t.subscriberId)}async appendEvents(e,t){if(!this.#a(e))throw Error(`appendEvents: unknown subscriptionId ${e}`);if(t.length===0)return;let n=this.#r.get(e)??[],r=We(t)?[...t]:[...t].sort(Ue),i=n.length===0?void 0:n[n.length-1]?.eventId,a=r[0]?.eventId;if(i===void 0||a!==void 0&&i<=a){for(let e of r)n.push(structuredClone(e));this.#r.set(e,n);return}let o=[...n,...r.map(e=>structuredClone(e))];o.sort(Ue),this.#r.set(e,o)}async*loadEvents(e,t){if(!this.#a(e))throw Error(`loadEvents: unknown subscriptionId ${e}`);let n=this.#r.get(e)??[],r=0;if(t!==void 0){let e=0,i=n.length;for(;e<i;){let r=e+i>>>1;(n[r]?.eventId??``)<=t?e=r+1:i=r}r=e}for(let e=r;e<n.length;e++)yield structuredClone(n[e])}};const B=new Ee;var Ke=class{limit;#e;#t=/* @__PURE__ */ new Set;constructor(e){if(!Number.isInteger(e)||e<0)throw TypeError(`DispatchSlotCounter: limit must be a non-negative integer, got ${String(e)}`);this.limit=e,this.#e=0}get active(){return this.#e}tryAcquire(e){return e!==void 0&&this.#t.has(e)||this.#e>=this.limit?!1:(e!==void 0&&this.#t.add(e),this.#e+=1,!0)}release(e){if(e!==void 0){if(!this.#t.delete(e))return;--this.#e;return}this.#e>this.#t.size&&--this.#e}};const qe=new Ke(z.dispatchConcurrency);let Je;function Ye(e,t){return e.taskRegistry===void 0?(Je??=new Ve(new Ge,{clock:t}),Je):e.taskRegistry}const Xe={info:()=>void 0,warn:e=>{console.warn(`[pi.dispatch] `+e)}};function Ze(e,t,n){let r=[`<pi-ptc-context depth="`+t+`" max-depth="`+n+`">`,`You are a PTC run at depth `+t+` (root is depth 0). You may write PTC programs and you may`,`call pi.dispatch(...) to spawn further children, but each level costs a fresh pi subprocess.`,`The remaining depth budget is `+n+` - `+t+`. Beyond it, pi.dispatch rejects with`,`{ status: "rejected", errorMessage: "dispatch depth limit reached" }.`,`</pi-ptc-context>`].join(`
 `);return e.length===0?r:e+`
 
-`+r}function se(){return{text:``,status:`rejected`,started:!1,agentName:`unknown`,durationMs:0,exitCode:-1,errorMessage:`dispatch depth limit reached`}}function ce(){return{text:``,status:`rejected`,started:!1,agentName:`unknown`,durationMs:0,exitCode:-1,errorMessage:`dispatch concurrency limit reached`}}function le(e){return e.aborted?{status:`rejected`,errorMessage:`dispatch cancelled`}:e.exitCode===0&&e.finalText.length>0?{status:`fulfilled`}:e.exitCode===0?{status:`rejected`,errorMessage:`dispatch produced no final text`}:{status:`rejected`}}function ue(e,t){if(e.pid===void 0)return!1;try{return e.kill(t),!0}catch{return!1}}function I(e,t){let n=e.match(RegExp(`^`+t+`:\\s*(.+)$`,`m`));if(!n)return;let r=(n[1]??``).trim();if(r.length>=2){let e=r[0],t=r[r.length-1];(e===`"`&&t===`"`||e===`'`&&t===`'`)&&(r=r.slice(1,-1))}return r.length===0?void 0:r}function de(e,t){let n=e.match(RegExp(`^`+t+`:\\s*(.+)$`,`m`));if(!n)return;let r=(n[1]??``).trim();r.startsWith(`[`)&&r.endsWith(`]`)&&(r=r.slice(1,-1));let i=r.split(`,`).map(e=>e.trim()).filter(e=>e.length>0);return i.length===0?void 0:i}function fe(e){let t=e.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);if(!t)return null;let n=t[1]??``,r=t[2]??``,i=I(n,`name`);if(!i)return null;let a=I(n,`description`)??``,o=I(n,`model`)??``,s=de(n,`tools`),c={name:i,systemPrompt:r.trim()};return a!==void 0&&(c.description=a),o!==void 0&&(c.model=o),s!==void 0&&(c.tools=s),c}function pe(e,t,n){let r=O.join(D.homedir(),`.pi`,`agent`,`agents`),i=O.join(t,`.pi`,`agents`),a=[];(n===`user`||n===`both`)&&a.push({path:O.join(r,e+`.md`),source:`user`}),(n===`project`||n===`both`)&&a.push({path:O.join(i,e+`.md`),source:`project`});for(let t of a){let n;try{n=C.readFileSync(t.path,`utf-8`)}catch{continue}let r=fe(n);if(r&&r.name===e){let e={name:r.name,source:t.source,systemPrompt:r.systemPrompt};return r.model!==void 0&&(e.model=r.model),r.tools!==void 0&&(e.tools=r.tools),e}}return null}function me(e,t,n){let r=[`--mode`,`json`,`-p`,`--no-session`],i=e.model??t.model;i&&r.push(`--model`,i);let a=e.thinkingLevel??`off`;return r.push(`--thinking`,a),t.tools&&t.tools.length>0&&r.push(`--tools`,t.tools.join(`,`)),r.push(`--append-system-prompt`,n),r.push(`Task: `+e.task),r}function he(e){let t=e.trim();if(t.length===0)return null;try{return JSON.parse(t)}catch{return null}}async function ge(e,t){let n=await C.promises.mkdtemp(O.join(D.tmpdir(),`pi-dispatch-`)),r=e.replace(/[^\w.-]+/g,`_`),i=O.join(n,`prompt-`+r+`.md`);return await C.promises.writeFile(i,t,{encoding:`utf-8`,mode:384}),{dir:n,filePath:i}}function _e(e){try{C.unlinkSync(e.filePath)}catch{}try{C.rmdirSync(e.dir)}catch{}}async function ve(e,t){let n=t.depth+1;if(n>t.maxDispatchDepth)return se();let r=e.cwd??t.cwd,i=e.agentScope??`user`,a=Date.now(),o=pe(e.agent,r,i);if(!o)return{text:``,status:`rejected`,started:!1,agentName:e.agent,durationMs:Date.now()-a,exitCode:1,errorMessage:`unknown agent: `+e.agent+` (agentScope=`+i+`, cwd=`+r+`)`};let s=oe(o.systemPrompt,n,t.maxDispatchDepth),c=await ge(o.name,s),l=me(e,o,c.filePath);return await new Promise(e=>{let i=``,s=``,u=``,d,f=-1,p=!1,m,h,g=!1,_=(n,r,i=!0)=>{if(p)return;p=!0,m&&clearTimeout(m),t.signal&&t.signal.removeEventListener(`abort`,v),_e(c);let l={text:u,status:n,started:i,agentName:o.name,durationMs:Date.now()-a,exitCode:f};d&&(l.usage=d),s.length>0&&(l.stderr=s),r&&(l.errorMessage=r),e(l)},v=()=>{!h||h.killed||p||(g=!0,ue(h,`SIGTERM`),m=setTimeout(()=>{h&&!h.killed&&ue(h,`SIGKILL`)},5e3))};try{h=ee(`pi`,l,{cwd:r,shell:!1,stdio:[`ignore`,`pipe`,`pipe`],env:{...process.env,PI_PTC_DEPTH:String(n)}})}catch(e){_(`rejected`,`failed to spawn pi: `+(e instanceof Error?e.message:String(e)),!1);return}t.signal&&(t.signal.aborted?v():t.signal.addEventListener(`abort`,v,{once:!0}));let y=h.stdout;if(!y)return;y.on(`data`,e=>{i+=e.toString(`utf-8`);let t=i.indexOf(`
-`);for(;t>=0;){let e=i.slice(0,t);i=i.slice(t+1);let n=he(e);if(!n){t=i.indexOf(`
-`);continue}if(n.type===`message_end`&&n.message&&n.message.role===`assistant`){let e=n.message;if(e.usage){let t=d??{input:0,output:0,cacheRead:0,cacheWrite:0,cost:0,turns:0};t.input+=e.usage.input??0,t.output+=e.usage.output??0,t.cacheRead+=e.usage.cacheRead??0,t.cacheWrite+=e.usage.cacheWrite??0,t.cost+=e.usage.cost?.total??0,t.turns+=1,d=t}if(Array.isArray(e.content))for(let t of e.content)t&&t.type===`text`&&typeof t.text==`string`&&(u=t.text)}t=i.indexOf(`
-`)}});let b=h.stderr;b&&(b.on(`data`,e=>{s+=e.toString(`utf-8`)}),h.on(`close`,e=>{f=e??-1;let{status:t,errorMessage:n}=le({exitCode:f,finalText:u,aborted:g});_(t,n)}),h.on(`error`,e=>{s+=`[spawn-error] `+e.message+`
-`,_(`rejected`,`failed to spawn pi: `+e.message,!1)}))})}const L=[`read`,`bash`,`edit`,`write`,`grep`,`find`,`ls`],ye=`pi.dispatch`,be=L,xe={read:m,bash:l,edit:u,write:h,grep:f,find:d,ls:p};function Se(e){let t=e.names??be,n=e.includeDispatch??e.names===void 0,r=/* @__PURE__ */ new Map;for(let n of t){let t=xe[n];if(!t)throw TypeError(`unknown PTC binding "${n}"; known bindings: ${L.join(`, `)}`);let i=t(e.cwd);r.set(n,{name:n,execute:async(e,t)=>{let n=`ptc:${t.callId}`,r={type:`toolCall`,id:n,name:i.name,arguments:e},a=S(i,r),o=await i.execute(n,a,t.signal,void 0);return{content:o.content,details:o.details===void 0?null:o.details}}})}return n&&r.set(ye,{name:ye,execute:async(t,n)=>ve(t,{signal:n.signal,callId:n.callId,cwd:e.cwd,depth:n.depth,maxDispatchDepth:n.maxDispatchDepth})}),r}const R=Object.freeze({timeoutMs:12e4,maxTimeoutMs:6e5,maxOutputBytes:67108864,maxMessageBytes:134217728,maxPendingCalls:128,maxParallelSubCalls:10,dispatchConcurrency:8,maxDispatchDepth:3,maxItemsPerCall:4096,graceMs:3e3,maxOldGenerationSizeMb:512,maxYoungGenerationSizeMb:64,poolSize:4,poolAcquireTimeoutMs:3e4,drainGraceMs:5e3}),Ce=Object.freeze([`PATH`,`PATHEXT`,`SYSTEMROOT`,`WINDIR`,`TEMP`,`TMP`]);function we(e=process.env){let t={};for(let n of Ce){let r=e[n];typeof r==`string`&&r.length>0&&(t[n]=r)}return t}function Te(e={}){let t={...R};for(let n of Object.keys(R)){let r=e[n];if(r!==void 0){if(typeof r!=`number`||!Number.isFinite(r)||r<=0)throw TypeError(`invalid PTC config override for ${n}: ${String(r)}`);t[n]=r}}return t}function Ee(e,t=R){return e===void 0||!Number.isFinite(e)||e<=0?t.timeoutMs:Math.min(e,t.maxTimeoutMs)}function De(){let e=/* @__PURE__ */ new Map;return{recordStart(t,n,r){if(e.has(t))throw Error(`duplicate sub-call callId ${t}`);e.set(t,{callId:t,name:n,args:r,status:`running`,startMs:Date.now()})},recordEnd(t,n,r){let i=e.get(t);if(i===void 0)throw Error(`recordEnd on unknown callId ${t}`);return i.status=n,i.endMs=Date.now(),i.durationMs=i.endMs-i.startMs,n===`rejected`&&(i.durationMs=0),r?.errorMessage!==void 0&&(i.errorMessage=r.errorMessage),r?.resultSummary!==void 0&&(i.resultSummary=r.resultSummary),i},snapshot(){return[...e.values()].map(e=>({...e}))}}}function Oe(e){return{name:`ptc-${e.surface}`,env:e.env,workerData:e.runId===void 0?{env:e.env}:{runId:e.runId,env:e.env},resourceLimits:{maxOldGenerationSizeMb:e.limits.maxOldGenerationSizeMb,maxYoungGenerationSizeMb:e.limits.maxYoungGenerationSizeMb}}}const z={acquireLatency:N.channel(`ptc:pool:acquire-latency`),resetTime:N.channel(`ptc:worker:reset-time`),imageBytes:N.channel(`ptc:image:hoist-bytes`)};function B(e,t){e.publish(t)}var ke=class{#e;#t;#n;#r;#i;#a=[];#o=/* @__PURE__ */ new Set;#s=[];#c=/* @__PURE__ */ new WeakMap;#l=0;#u=0;#d=!1;constructor(e){if(typeof e.buildWorkerUrl!=`function`)throw TypeError(`WorkerPool: buildWorkerUrl must be a function`);if(e.size!==void 0&&(typeof e.size!=`number`||!Number.isFinite(e.size)||e.size<=0))throw TypeError(`WorkerPool: size must be a positive finite number, received ${String(e.size)}`);if(e.acquireTimeoutMs!==void 0&&(typeof e.acquireTimeoutMs!=`number`||!Number.isFinite(e.acquireTimeoutMs)||e.acquireTimeoutMs<=0))throw TypeError(`WorkerPool: acquireTimeoutMs must be a positive finite number, received ${String(e.acquireTimeoutMs)}`);if(e.drainGraceMs!==void 0&&(typeof e.drainGraceMs!=`number`||!Number.isFinite(e.drainGraceMs)||e.drainGraceMs<=0))throw TypeError(`WorkerPool: drainGraceMs must be a positive finite number, received ${String(e.drainGraceMs)}`);this.#e=e.buildWorkerUrl,this.#t=e.size??4,this.#n=e.acquireTimeoutMs??3e4,this.#r=e.drainGraceMs??5e3,this.#i=e.workerOptions}async acquire(){if(this.#d)throw Error(`pool has been drained and can no longer serve workers`);this.#l+=1;let e=Date.now(),t=this.#a.shift();for(;t!==void 0&&!this.#p(t);)t=this.#a.shift();if(t!==void 0)return this.#o.add(t),t.ref(),B(z.acquireLatency,{poolSize:this.#t,waiters:this.#s.length,durationMs:Date.now()-e}),t;if(this.#o.size<this.#t){let t=this.#f();return this.#o.add(t),B(z.acquireLatency,{poolSize:this.#t,waiters:this.#s.length,durationMs:Date.now()-e}),t}return this.#u+=1,await new Promise((t,n)=>{let r=setTimeout(()=>{let e=this.#s.findIndex(e=>e.timer===r);e>=0&&this.#s.splice(e,1),n(/* @__PURE__ */ Error(`pool acquire timed out after ${this.#n} ms`))},this.#n);this.#s.push({resolve:t,reject:n,timer:r,startedAt:e})})}release(e){if(!this.#o.delete(e)||!this.#p(e))return;this.#c.set(e,Date.now());let t=this.#s.shift();if(t){clearTimeout(t.timer),this.#o.add(e),B(z.acquireLatency,{poolSize:this.#t,waiters:this.#s.length,durationMs:Date.now()-t.startedAt}),t.resolve(e);return}this.#a.push(e),e.unref()}lastSettledAt(e){return this.#c.get(e)}async drain(){for(;this.#s.length>0;){let e=this.#s.shift();if(!e)break;clearTimeout(e.timer),e.reject(/* @__PURE__ */ Error(`pool drained before acquire could be satisfied`))}let e=Date.now()+this.#r;for(;this.#o.size>0&&Date.now()<e;)await new Promise(e=>setTimeout(e,5));let t=[...this.#a,...this.#o];this.#a.length=0,this.#o.clear(),await Promise.all(t.map(e=>e.terminate().catch(()=>void 0))),this.#d=!0}stats(){return{resident:this.#o.size+this.#a.length,inFlight:this.#o.size,waiters:this.#s.length,totalAcquires:this.#l,poolExhaustions:this.#u}}#f(){let e=new M(this.#e(),this.#i);return e.once(`exit`,()=>{let t=this.#a.indexOf(e);if(t>=0){this.#a.splice(t,1);return}this.#o.delete(e)}),e}#p(e){return e.threadId!==-1}};function Ae(e){B(z.imageBytes,{byteLength:e})}function je(e){B(z.resetTime,{durationMs:e})}function Me(){let e=k(P(import.meta.url)),t=[ne(e,`worker.js`),ne(e,`worker-entry.ts`)];for(let e of t)if(w(e))return ie(e);throw Error(`worker entry not found; tried: ${t.join(`, `)}`)}function Ne(e){if(typeof e!=`object`||!e)return;let t=e;if(t.status!==`rejected`)return;let n=typeof t.errorMessage==`string`?t.errorMessage:t.started===!1?`dispatch refused`:`dispatch failed`;return{kind:t.started===!1?`refused`:`failed`,message:n}}function V(e){return e instanceof Error?e.message:String(e)}function Pe(e){if(typeof e!=`object`||!e)return;let t=e.content;if(Array.isArray(t)&&t.length>0){let e=t[0];if(typeof e==`object`&&e){let t=e.text;if(typeof t==`string`&&t.length>0){let e=t.indexOf(`
-`);return e===-1?t:t.slice(0,e)}}}}function Fe(e){return e instanceof ArrayBuffer||ArrayBuffer.isView(e)}function Ie(e,t){let n=/* @__PURE__ */ new WeakSet,r=e=>{if(e!=null){if(e instanceof ArrayBuffer){t(e);return}if(ArrayBuffer.isView(e)){t(e);return}if(typeof e==`object`&&!n.has(e)){if(n.add(e),Array.isArray(e)){for(let t of e)r(t);return}for(let t of Object.keys(e))r(e[t])}}};r(e)}function Le(e){try{let t=Buffer.byteLength(JSON.stringify(e,(e,t)=>Fe(t)?null:t)??``,`utf8`),n=0;return Ie(e,e=>{n+=e.byteLength}),t+n}catch{return 1/0}}async function Re(e){let i=Te(e.config),s=we(),c=e.runId??j(),l=Ee(e.timeoutMs,i),u=[],d=[],f=[];if(e.signal?.aborted)return{logs:u,narrations:d,phases:f,error:{kind:n.abort,message:`run cancelled before start`}};let p;try{p=e.pool?await e.pool.acquire():new M(Me(),Oe({surface:e.surface,env:s,limits:i,runId:c}))}catch(e){return{logs:u,narrations:d,phases:f,error:{kind:n.workerExit,message:`pool acquire failed: ${V(e)}`}}}return await new Promise(s=>{let m=new re,h=m.port1,g=m.port2,_=new AbortController,v=!1,y=De(),b=()=>{v||e.onSubCallChange?.(()=>y.snapshot())},x={recordStart(e,t,n){y.recordStart(e,t,n),b()},recordEnd(e,t,n){let r=y.recordEnd(e,t,n);return b(),r},snapshot:()=>y.snapshot()},S,ee=!1,C=0,w=0,T=0,E=0,D=[],te=e.depth??0,O,k,A=[],ne=e=>{let t=[],n=e?.content;if(!Array.isArray(n))return t;for(let e of n){if(typeof e!=`object`||!e)continue;let n=e;if(n.type!==`image`)continue;let r;typeof n.data==`string`&&n.data.length>0?r=n.data:n.bytes instanceof ArrayBuffer&&n.bytes.byteLength>0&&(r=Buffer.from(n.bytes).toString(`base64`)),r!==void 0&&t.push({data:r,mimeType:typeof n.mimeType==`string`?n.mimeType:`application/octet-stream`})}return t},j=e=>e===`timeout`?`run timed out after ${l} ms`:`run cancelled`,M=e=>e===`timeout`?n.timeout:n.abort,N=t=>{if(v)return;v=!0,O&&clearTimeout(O),k&&clearTimeout(k),e.signal?.removeEventListener(`abort`,pe),_.abort(),h.close(),e.pool?e.pool.release(p):p.terminate();let n=x.snapshot();s(n.length>0?{...t,subCalls:n}:t)},P=(e,t,n)=>{N({logs:u,narrations:d,phases:f,error:n===void 0?{kind:e,message:t}:{kind:e,message:t,stack:n}})},ie=e=>{if(!v){if(!r(e)){P(n.protocol,`internal error: malformed host frame`);return}h.postMessage(e)}},ae=()=>{let t={kind:o.init,runId:c,surface:e.surface,code:e.code,bindings:[...e.bindings.keys()],bindingCandidates:[...L],maxItemsPerCall:i.maxItemsPerCall,maxPendingCalls:i.maxPendingCalls,...e.args===void 0?{}:{args:e.args}};if(!r(t)){P(n.protocol,`internal error: malformed init frame`);return}let a=Le(t);if(a>i.maxMessageBytes){P(n.protocol,`init frame of ${a} bytes exceeds maxMessageBytes (${i.maxMessageBytes})`);return}ie(t)},F=(e,t)=>(w+=e,w<=i.maxOutputBytes||(P(n.outputLimit,`${t} exceeded the output budget: logs + result reached ${w} bytes (maxOutputBytes=${i.maxOutputBytes}); ${u.length} log line(s) retained`),!1)),oe=async()=>{if(E<i.maxParallelSubCalls){E+=1;return}await new Promise(e=>{D.push(e)})},se=()=>{let e=D.shift();if(e){e();return}--E},le=e=>{if(x.recordStart(e.callId,e.tool,e.args),C+=1,C>i.maxPendingCalls){x.recordEnd(e.callId,`error`,{errorMessage:`more than maxPendingCalls (${i.maxPendingCalls}) binding calls in flight`}),P(n.protocol,`more than maxPendingCalls (${i.maxPendingCalls}) binding calls in flight`);return}ue(e).finally(()=>{--C})},ue=async t=>{let r=e.bindings.get(t.tool);if(!r){x.recordEnd(t.callId,`error`,{errorMessage:`no binding named "${t.tool}" in this run; available bindings: `+([...e.bindings.keys()].join(`, `)||`(none)`)}),I({kind:o.callResult,callId:t.callId,tool:t.tool,ok:!1,message:`no binding named "${t.tool}" in this run; available bindings: `+([...e.bindings.keys()].join(`, `)||`(none)`)});return}let a=t.tool===ye;if(a){if(T>=i.dispatchConcurrency){x.recordEnd(t.callId,`rejected`,{errorMessage:`dispatch concurrency limit reached`}),I({kind:o.callResult,callId:t.callId,tool:t.tool,ok:!0,value:ce()});return}T+=1}else if(await oe(),v){x.recordEnd(t.callId,`cancelled`,{errorMessage:`run settled before binding started`}),se();return}try{let e=await r.execute(t.args,{signal:_.signal,callId:t.callId,depth:te,maxDispatchDepth:i.maxDispatchDepth}),s=ne(e),c={kind:o.callResult,callId:t.callId,tool:t.tool,ok:!0,value:e},l=Le(c);if(l>i.maxMessageBytes){x.recordEnd(t.callId,`error`,{errorMessage:`callResult frame of ${l} bytes exceeds maxMessageBytes (${i.maxMessageBytes})`}),P(n.protocol,`callResult frame of ${l} bytes exceeds maxMessageBytes (${i.maxMessageBytes})`);return}if(I(c))for(let e of s)A.push(e),Ae(Buffer.byteLength(e.data,`base64`));if(_.signal.aborted)x.recordEnd(t.callId,`cancelled`,{errorMessage:`binding aborted by run cancellation`});else{let n=a?Ne(e):void 0;n===void 0?x.recordEnd(t.callId,`ok`,{resultSummary:Pe(e)}):x.recordEnd(t.callId,n.kind===`refused`?`rejected`:`error`,{errorMessage:n.message})}}catch(e){_.signal.aborted?x.recordEnd(t.callId,`cancelled`,{errorMessage:V(e)}):x.recordEnd(t.callId,`error`,{errorMessage:V(e)}),I({kind:o.callResult,callId:t.callId,tool:t.tool,ok:!1,message:V(e)})}finally{a?--T:se()}},I=e=>{if(v)return!1;try{return h.postMessage(e),!0}catch(t){try{h.postMessage({kind:o.callResult,callId:e.callId,tool:e.tool,ok:!1,message:`binding result could not be transferred: ${V(t)}`})}catch{P(n.protocol,`binding result is not transferable`)}return!1}},de=e=>S?{logs:u,narrations:d,phases:f,error:{kind:M(S),message:j(S)}}:e,fe=r=>{if(v)return;if(!a(r)){P(n.protocol,`malformed worker frame`);return}let o=r.kind===t.ready?0:Le(r);if(!Number.isFinite(o)){P(n.protocol,`worker frame could not be serialized for accounting`);return}if(o>i.maxMessageBytes){P(n.protocol,`control frame of ${o} bytes exceeds maxMessageBytes (${i.maxMessageBytes})`);return}switch(r.kind){case t.ready:if(e.pool){let t=e.pool.lastSettledAt(p);t!==void 0&&je(Date.now()-t)}if(!ee&&(ee=!0,S)){me(S);return}ae();return;case t.call:le(r);return;case t.log:F(o,`console output`)&&u.push(r.text);return;case t.narration:F(o,`workflow narration`)&&d.push(r.message);return;case t.phase:F(o,`workflow phase`)&&f.push(r.title);return;case t.result:{if(!F(o,`completion value`))return;let e={logs:u,narrations:d,phases:f,...A.length>0?{images:A}:{}};N(de(r.value===void 0?e:{...e,value:r.value}));return}case t.error:N(de({logs:u,narrations:d,phases:f,error:r.error}));return;default:P(n.protocol,`unknown worker frame`)}};function pe(){he(`abort`)}let me=e=>{k&&clearTimeout(k),k=setTimeout(()=>{P(M(e),j(e))},i.graceMs)};function he(e){if(!v){if(S){P(M(S),j(S));return}S=e,_.abort(),ie({kind:o.cancel,reason:e}),me(e)}}p.on(`error`,e=>{P(n.workerExit,`worker failed: ${V(e)}`)}),p.on(`exit`,e=>{P(n.workerExit,`worker exited with code ${e} before the run completed`)}),h.on(`message`,fe),h.on(`messageerror`,()=>{P(n.protocol,`worker sent a frame that could not be deserialized`)}),e.signal?.addEventListener(`abort`,pe,{once:!0}),O=setTimeout(()=>{he(`timeout`)},l);let ge={kind:o.connect,port:g};r(ge)?p.postMessage(ge,[g]):P(n.protocol,`internal error: malformed connect frame`)})}const ze=200,Be=new RegExp([`(?:\\u001B\\][\\s\\S]*?(?:\\u0007|\\u001B\\u005C|\\u009C))`,`[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]`].join(`|`),`g`);function Ve(e){return!e.includes(`\x1B`)&&!e.includes(`›`)?e:e.replace(Be,``)}function H(e){let t=Ve(e).replace(/\r/g,``);if(t.length===0)return t;let n=``;for(let e of t){let t=e.codePointAt(0);if(t!==void 0){if(t===10||t===9){n+=e;continue}t<=31||t>=65529&&t<=65531||(n+=e)}}return n}const He=/^[A-Za-z_$][A-Za-z0-9_$]*$/;function U(e){return He.test(e)?e:JSON.stringify(e)}function Ue(e){if(e===null)return`null`;if(typeof e==`number`||typeof e==`boolean`)return String(e);if(typeof e==`string`){let t=H(e);return t.includes(`
-`)?void 0:JSON.stringify(t)}if(Array.isArray(e)){let t=[];for(let n of e){let e=Ue(n);if(e===void 0)return;t.push(e)}return`[${t.join(`, `)}]`}let t=Object.keys(e);if(t.length===0)return`{}`;let n=[];for(let r of t){let t=Ue(e[r]??null);if(t===void 0)return;n.push(`${U(r)}: ${t}`)}return`{${n.join(`, `)}}`}function We(e){let t=Ue(e);if(t!==void 0)return t.length<=100?t:void 0}function Ge(e){return e===null?`null`:typeof e==`string`?H(e):String(e)}function Ke(e,t){if(typeof e!=`object`||!e)return[`${t}${Ge(e)}`];if(Array.isArray(e)){if(e.length===0)return[`${t}[]`];let n=[`${t}[`];for(let r of e){let e=We(r);if(e!==void 0){n.push(`${t}  ${e}`);continue}n.push(...qe(r,t+`  `))}return n.push(`${t}]`),n}let n=Object.keys(e);if(n.length===0)return[`${t}{}`];let r=[`${t}{`],i=t+`  `;for(let t of n){let n=e[t]??null,a=We(n);if(a!==void 0){r.push(`${i}${U(t)}: ${a}`);continue}if(typeof n==`string`){r.push(`${i}${U(t)}:`);for(let e of H(n).split(`
-`))r.push(e.length===0?``:`${i}  ${e}`);continue}let o=Ke(n,i);r.push(`${i}${U(t)}: ${(o[0]??``).trimStart()}`.trimEnd(),...o.slice(1))}return r.push(`${t}}`),r}function qe(e,t){return typeof e==`string`?H(e).split(`
-`):typeof e!=`object`||!e?[String(e)]:Ke(e,t)}function Je(e){return e.split(`
+`+r}function Qe(){return{text:``,status:`rejected`,started:!1,agentName:`unknown`,durationMs:0,exitCode:-1,errorMessage:`dispatch depth limit reached`}}const $e=`dispatch concurrency limit reached`;function et(){return{text:``,status:`rejected`,started:!1,agentName:`unknown`,durationMs:0,exitCode:-1,errorMessage:$e}}function tt(e,t,n={}){e.kill(t,`SIGTERM`);let r=setTimeout(()=>{n.isDone?.()!==!0&&e.kill(t,`SIGKILL`)},5e3);return n.unref===!0&&r.unref(),()=>clearTimeout(r)}function nt(){return{...Qe(),errorMessage:`dispatch depth limit reached; next_step: call ptc_task_list to inspect the in-flight background tasks`}}function rt(){return{...et(),errorMessage:`dispatch concurrency limit reached; next_step: call ptc_task_list to inspect running tasks and ptc_task_stop to free a slot`}}function it(e){return e.aborted?{status:`rejected`,errorMessage:`dispatch cancelled`}:e.exitCode===0&&e.finalText.length>0?{status:`fulfilled`}:e.exitCode===0?{status:`rejected`,errorMessage:`dispatch produced no final text`}:{status:`rejected`}}function at(e,t){let n=e.match(RegExp(`^`+t+`:\\s*(.+)$`,`m`));if(!n)return;let r=(n[1]??``).trim();if(r.length>=2){let e=r[0],t=r[r.length-1];(e===`"`&&t===`"`||e===`'`&&t===`'`)&&(r=r.slice(1,-1))}return r.length===0?void 0:r}function ot(e,t){let n=e.match(RegExp(`^`+t+`:\\s*(.+)$`,`m`));if(!n)return;let r=(n[1]??``).trim();r.startsWith(`[`)&&r.endsWith(`]`)&&(r=r.slice(1,-1));let i=r.split(`,`).map(e=>e.trim()).filter(e=>e.length>0);return i.length===0?void 0:i}function st(e){let t=e.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);if(!t)return null;let n=t[1]??``,r=t[2]??``,i=at(n,`name`);if(!i)return null;let a=at(n,`description`)??``,o=at(n,`model`)??``,s=ot(n,`tools`),c={name:i,systemPrompt:r.trim()};return a!==void 0&&(c.description=a),o!==void 0&&(c.model=o),s!==void 0&&(c.tools=s),c}function ct(e,t,n,r){let{userDir:i,projectDir:a}=lt({cwd:t,agentScope:n,homeDir:r?.homeDir}),o=[];(n===`user`||n===`both`)&&o.push({path:D.join(i,e+`.md`),source:`user`}),(n===`project`||n===`both`)&&o.push({path:D.join(a,e+`.md`),source:`project`});for(let t of o){let n;try{n=C.readFileSync(t.path,`utf-8`)}catch{continue}let r=st(n);if(r&&r.name===e){let e={name:r.name,source:t.source,systemPrompt:r.systemPrompt};return r.model!==void 0&&(e.model=r.model),r.tools!==void 0&&(e.tools=r.tools),e}}return null}function lt(e){let t=e.homeDir??E.homedir();return{userDir:D.join(t,`.pi`,`agent`,`agents`),projectDir:D.join(e.cwd,`.pi`,`agents`),userRoot:t,projectRoot:e.cwd}}function ut(e){let t=e?.code;return typeof t==`string`?t:String(e)}function dt(e){try{return!C.statSync(e).isDirectory()}catch{try{return C.lstatSync(e),!0}catch{return!1}}}function ft(e,t){let n=D.resolve(e),r=D.resolve(t),i=e=>D.dirname(e),a=n,o=!1;for(let e=0;e<=8;e+=1){try{if(C.statSync(a).isDirectory()){o=!0;break}}catch{}if(a===r)break;let e=i(a);if(e===a)break;a=e}if(o){for(let e=n;e!==a&&e!==i(e);e=i(e))if(pt(e))return!0;return!1}return a===r&&pt(r)}function pt(e){try{return C.lstatSync(e).isSymbolicLink()}catch{return!1}}function mt(e,t,n){let r=ut(n);return r!==`ENOENT`&&r!==`ENOTDIR`||dt(e)?!1:!ft(e,t)}function ht(e){let{userDir:t,projectDir:n,userRoot:r,projectRoot:i}=lt(e),a=[];(e.agentScope===`user`||e.agentScope===`both`)&&a.push({dir:t,boundary:r}),(e.agentScope===`project`||e.agentScope===`both`)&&a.push({dir:n,boundary:i});let o=/* @__PURE__ */ new Set;for(let{dir:e,boundary:t}of a){let n;try{n=C.readdirSync(e)}catch(n){if(!mt(e,t,n)){let t=ut(n);console.warn(`pi.dispatch: cannot read agent directory ${e} (${t}); the agents registered there are not listed`)}continue}for(let t of n){if(!t.endsWith(`.md`))continue;let n=t.slice(0,-3),r=D.join(e,t),i;try{i=C.readFileSync(r,`utf-8`)}catch(e){let t=e instanceof Error?e.message:String(e);console.warn(`pi.dispatch: cannot read agent file ${r}: ${t}; falling back to the filename`),o.add(n);continue}let a=st(i)?.name??n;a.length>0&&o.add(a)}}return[...o].sort()}function gt(e){let{userDir:t,projectDir:n}=lt(e),r=ht(e);return`registered agents: ${r.length>0?`[`+r.join(`, `)+`]`:`(none)`} — agents load from ${t}/<name>.md (user scope) or ${n}/<name>.md (project scope); register one as an agent markdown file: frontmatter header (\`---\\nname: <agent-name>\\n---\`) followed by the system prompt body`}function _t(e){return{text:``,status:`rejected`,started:!1,agentName:``,durationMs:0,exitCode:1,errorMessage:`agent is required (there is no default agent) — `+gt(e)}}function vt(e){return typeof e!=`string`||e.trim().length===0}function yt(e,t,n,r=0){return{text:``,status:`rejected`,started:!1,agentName:e,durationMs:r,exitCode:1,errorMessage:`unknown agent: `+e+` (agentScope=`+t+`, cwd=`+n+`). `+gt({cwd:n,agentScope:t})}}function bt(e,t,n){let r=[`--mode`,`json`,`-p`,`--no-session`],i=e.model??t.model;i&&r.push(`--model`,i);let a=e.thinkingLevel??`off`;return r.push(`--thinking`,a),t.tools&&t.tools.length>0&&r.push(`--tools`,t.tools.join(`,`)),r.push(`--append-system-prompt`,n),r.push(`Task: `+e.task),r}async function xt(e,t){let n=await C.promises.mkdtemp(D.join(E.tmpdir(),`pi-dispatch-`)),r=e.replace(/[^\w.-]+/g,`_`),i=D.join(n,`prompt-`+r+`.md`);return await C.promises.writeFile(i,t,{encoding:`utf-8`,mode:384}),{dir:n,filePath:i}}function St(e){try{C.unlinkSync(e.filePath)}catch{}try{C.rmdirSync(e.dir)}catch{}}function Ct(e){if(e.type!==`message_end`||e.message?.role!==`assistant`)return;let t=e.message.content;if(!Array.isArray(t))return;let n;for(let e of t)e&&e.type===`text`&&typeof e.text==`string`&&(n=e.text);return n}async function wt(e,t,n){let r=t.depth+1;if(r>t.maxDispatchDepth)return nt();if(vt(e.agent))return _t({cwd:e.cwd??t.cwd,agentScope:e.agentScope??`user`});let i=ve(),a=n.slots??qe;if(!a.tryAcquire(i))return rt();let o=n.clock??(()=>Date.now()),s=n.logger??Xe,c=e.cwd??t.cwd,l=e.agentScope??`user`,u=n.lifecycle??B,d=t.callerId??`dispatch:`+String(t.callId),f=Ye(n,o),p=n.outputStorage,m,h;try{let n=ct(e.agent,c,l);if(!n)return a.release(i),yt(e.agent,l,c);let g=e.label??e.task.slice(0,64),_=Ze(n.systemPrompt,r,t.maxDispatchDepth),v=await xt(n.name,_);h=v;let y=bt(e,n,v.filePath),b={cwd:c,env:{...process.env,PI_PTC_DEPTH:String(r),PI_PTC_TASK_ID:i},promptFile:v.filePath};t.sessionDir!==void 0&&(b.sessionDir=t.sessionDir,b.sessionId=i,b.sessionName=`bgdispatch:`+i),m=u.spawn([`pi`,...y],b);let x=m,S={kind:`ptc-program`,callerId:d};await f.transition({kind:`spawn`,handle:{taskId:i,label:g,status:`running`},record:{label:g,agentName:n.name,depth:r,startedAt:Math.max(0,Math.floor(o())),finishedAt:void 0,durationMs:void 0,outputRef:void 0,outputBytes:void 0,outputPreview:void 0,stopReason:void 0,errorMessage:void 0,exitCode:void 0,spawnSource:S,parentTaskId:t.parentTaskId}},{clock:o,callerId:d,logger:s});let C=!1,w,T=f.onTransition((e,t)=>{e.id===i&&t.status===`stopping`&&(C||w!==void 0||(w=tt(u,x,{isDone:()=>C,unref:!0})))});return(async()=>{let e=``;try{for await(let t of u.events(x)){let n=Ct(t);n!==void 0&&(e=n)}C=!0,w?.();let t=(await u.exit(x)).code??-1,n=Buffer.byteLength(e,`utf8`),r=n<=2048?e:void 0,a;if(p!==void 0)try{await p.writeOutput(i,e),a=p.outputRef(i)}catch(e){let t=e instanceof Error?e.message:String(e);s.warn(`background dispatch output persistence for task `+i+` failed: `+t)}await f.transition({kind:`resolve-exit`,taskId:i,exitCode:t,outputRef:a,outputBytes:n,outputPreview:r},{clock:o,callerId:d,logger:s})}catch(t){let n=t instanceof Error?t.message:String(t);s.warn(`background dispatch pump for task `+i+` failed after `+String(e.length)+` chars of buffered output: `+n)}finally{T(),w?.(),St(v),a.release(i)}})(),{taskId:i,label:g,status:`running`}}catch(t){let n=t instanceof Error?t.message:String(t);return m!==void 0&&tt(u,m,{unref:!0}),h!==void 0&&St(h),a.release(i),s.warn(`background dispatch failed for agent `+e.agent+`: `+n),{text:``,status:`rejected`,started:m!==void 0,agentName:e.agent,durationMs:0,exitCode:-1,errorMessage:`background dispatch failed: `+n}}}async function Tt(e,t,n={}){if(e.background===!0)return await wt(e,t,n);let r=t.depth+1;if(r>t.maxDispatchDepth)return Qe();let i=e.cwd??t.cwd,a=e.agentScope??`user`,o=Date.now();if(vt(e.agent))return _t({cwd:i,agentScope:a});let s=ct(e.agent,i,a);if(!s)return yt(e.agent,a,i,Date.now()-o);let c=Ze(s.systemPrompt,r,t.maxDispatchDepth),l=await xt(s.name,c),u=bt(e,s,l.filePath);return await new Promise(e=>{let n=``,a,c=-1,d=``,f=!1,p,m,h=!1,g=(r,i,u=!0)=>{if(f)return;f=!0,p?.(),t.signal&&t.signal.removeEventListener(`abort`,_),St(l);let m={text:n,status:r,started:u,agentName:s.name,durationMs:Date.now()-o,exitCode:c};a&&(m.usage=a),d.length>0&&(m.stderr=d),i&&(m.errorMessage=i),e(m)},_=()=>{m&&!f&&(h=!0,p=tt(B,m,{isDone:()=>f}))};try{m=B.spawn([`pi`,...u],{cwd:i,env:{...process.env,PI_PTC_DEPTH:String(r)},promptFile:l.filePath})}catch(e){g(`rejected`,`failed to spawn pi: `+(e instanceof Error?e.message:String(e)),!1);return}t.signal&&(t.signal.aborted?_():t.signal.addEventListener(`abort`,_,{once:!0})),(async()=>{if(!m)return;let e=m;try{for await(let t of B.events(e))if(t.type===`message_end`&&t.message&&t.message.role===`assistant`){let e=t.message;if(e.usage){let t=a??{input:0,output:0,cacheRead:0,cacheWrite:0,cost:0,turns:0};t.input+=e.usage.input??0,t.output+=e.usage.output??0,t.cacheRead+=e.usage.cacheRead??0,t.cacheWrite+=e.usage.cacheWrite??0,t.cost+=e.usage.cost?.total??0,t.turns+=1,a=t}if(Array.isArray(e.content))for(let t of e.content)t&&t.type===`text`&&typeof t.text==`string`&&(n=t.text)}let t=await B.exit(e);c=t.code??-1,d=await B.stderr(e);let r=d.match(/^\[spawn-error\] (.+)$/m);if(r&&t.code===null&&t.signal===null){g(`rejected`,`failed to spawn pi: `+r[1],!1);return}let{status:i,errorMessage:o}=it({exitCode:c,finalText:n,aborted:h});g(i,o)}catch(e){let t=e instanceof Error?e.message:String(e);g(`rejected`,`dispatch internal error: `+t)}})()})}const V=[`read`,`bash`,`edit`,`write`,`grep`,`find`,`ls`],H=`pi.dispatch`,Et=V,Dt={read:m,bash:l,edit:u,write:h,grep:f,find:d,ls:p},Ot={name:H,description:`Dispatch a task to a registered pi agent as a child subprocess (foreground await or background task).`,parameters:x.Object({agent:x.String({minLength:1}),task:x.String({minLength:1}),cwd:x.Optional(x.String()),agentScope:x.Optional(x.Union([x.Literal(`user`),x.Literal(`project`),x.Literal(`both`)])),model:x.Optional(x.String()),thinkingLevel:x.Optional(x.String()),background:x.Optional(x.Boolean()),label:x.Optional(x.String())})};function kt(e){let t=e.names??Et,n=e.includeDispatch??e.names===void 0,r=/* @__PURE__ */ new Map;for(let n of t){let t=Dt[n];if(!t)throw TypeError(`unknown PTC binding "${n}"; known bindings: ${V.join(`, `)}`);let i=t(e.cwd);r.set(n,{name:n,execute:async(e,t)=>{let n=`ptc:${t.callId}`,r={type:`toolCall`,id:n,name:i.name,arguments:e},a=S(i,r),o=await i.execute(n,a,t.signal,void 0);return{content:o.content,details:o.details===void 0?null:o.details}}})}return n&&r.set(H,{name:H,execute:async(t,n)=>{let r={type:`toolCall`,id:`ptc:${n.callId}`,name:H,arguments:t},i;try{i=S(Ot,r)}catch(n){let r=typeof t==`object`&&t&&!Array.isArray(t)?t:void 0,i=r?.agent,a=r?.agentScope;return vt(i)?_t({cwd:e.cwd,agentScope:a===`user`||a===`project`||a===`both`?a:`user`}):{text:``,status:`rejected`,started:!1,agentName:i,durationMs:0,exitCode:1,errorMessage:n instanceof Error?n.message:String(n)}}return Tt(i,{signal:n.signal,callId:n.callId,cwd:e.cwd,depth:n.depth,maxDispatchDepth:n.maxDispatchDepth,...n.callerId===void 0?{}:{callerId:n.callerId},...n.sessionDir===void 0?{}:{sessionDir:n.sessionDir},...n.parentTaskId===void 0?{}:{parentTaskId:n.parentTaskId}},n.dispatchDeps)}}),r}function At(){let e=/* @__PURE__ */ new Map;return{recordStart(t,n,r){if(e.has(t))throw Error(`duplicate sub-call callId ${t}`);e.set(t,{callId:t,name:n,args:r,status:`running`,startMs:Date.now()})},recordEnd(t,n,r){let i=e.get(t);if(i===void 0)throw Error(`recordEnd on unknown callId ${t}`);return i.status=n,i.endMs=Date.now(),i.durationMs=i.endMs-i.startMs,n===`rejected`&&(i.durationMs=0),r?.errorMessage!==void 0&&(i.errorMessage=r.errorMessage),r?.resultSummary!==void 0&&(i.resultSummary=r.resultSummary),i},snapshot(){return[...e.values()].map(e=>({...e}))}}}function jt(e){return{name:`ptc-${e.surface}`,env:e.env,workerData:e.runId===void 0?{env:e.env}:{runId:e.runId,env:e.env},resourceLimits:{maxOldGenerationSizeMb:e.limits.maxOldGenerationSizeMb,maxYoungGenerationSizeMb:e.limits.maxYoungGenerationSizeMb}}}const U={acquireLatency:P.channel(`ptc:pool:acquire-latency`),resetTime:P.channel(`ptc:worker:reset-time`),imageBytes:P.channel(`ptc:image:hoist-bytes`)};function W(e,t){e.publish(t)}var Mt=class{#e;#t;#n;#r;#i;#a=[];#o=/* @__PURE__ */ new Set;#s=[];#c=/* @__PURE__ */ new WeakMap;#l=0;#u=0;#d=!1;constructor(e){if(typeof e.buildWorkerUrl!=`function`)throw TypeError(`WorkerPool: buildWorkerUrl must be a function`);if(e.size!==void 0&&(typeof e.size!=`number`||!Number.isFinite(e.size)||e.size<=0))throw TypeError(`WorkerPool: size must be a positive finite number, received ${String(e.size)}`);if(e.acquireTimeoutMs!==void 0&&(typeof e.acquireTimeoutMs!=`number`||!Number.isFinite(e.acquireTimeoutMs)||e.acquireTimeoutMs<=0))throw TypeError(`WorkerPool: acquireTimeoutMs must be a positive finite number, received ${String(e.acquireTimeoutMs)}`);if(e.drainGraceMs!==void 0&&(typeof e.drainGraceMs!=`number`||!Number.isFinite(e.drainGraceMs)||e.drainGraceMs<=0))throw TypeError(`WorkerPool: drainGraceMs must be a positive finite number, received ${String(e.drainGraceMs)}`);this.#e=e.buildWorkerUrl,this.#t=e.size??4,this.#n=e.acquireTimeoutMs??3e4,this.#r=e.drainGraceMs??5e3,this.#i=e.workerOptions}async acquire(){if(this.#d)throw Error(`pool has been drained and can no longer serve workers`);this.#l+=1;let e=Date.now(),t=this.#a.shift();for(;t!==void 0&&!this.#p(t);)t=this.#a.shift();if(t!==void 0)return this.#o.add(t),t.ref(),W(U.acquireLatency,{poolSize:this.#t,waiters:this.#s.length,durationMs:Date.now()-e}),t;if(this.#o.size<this.#t){let t=this.#f();return this.#o.add(t),W(U.acquireLatency,{poolSize:this.#t,waiters:this.#s.length,durationMs:Date.now()-e}),t}return this.#u+=1,await new Promise((t,n)=>{let r=setTimeout(()=>{let e=this.#s.findIndex(e=>e.timer===r);e>=0&&this.#s.splice(e,1),n(/* @__PURE__ */ Error(`pool acquire timed out after ${this.#n} ms`))},this.#n);this.#s.push({resolve:t,reject:n,timer:r,startedAt:e})})}release(e){if(!this.#o.delete(e)||!this.#p(e))return;this.#c.set(e,Date.now());let t=this.#s.shift();if(t){clearTimeout(t.timer),this.#o.add(e),W(U.acquireLatency,{poolSize:this.#t,waiters:this.#s.length,durationMs:Date.now()-t.startedAt}),t.resolve(e);return}this.#a.push(e),e.unref()}lastSettledAt(e){return this.#c.get(e)}async drain(){for(;this.#s.length>0;){let e=this.#s.shift();if(!e)break;clearTimeout(e.timer),e.reject(/* @__PURE__ */ Error(`pool drained before acquire could be satisfied`))}let e=Date.now()+this.#r;for(;this.#o.size>0&&Date.now()<e;)await new Promise(e=>setTimeout(e,5));let t=[...this.#a,...this.#o];this.#a.length=0,this.#o.clear(),await Promise.all(t.map(e=>e.terminate().catch(()=>void 0))),this.#d=!0}stats(){return{resident:this.#o.size+this.#a.length,inFlight:this.#o.size,waiters:this.#s.length,totalAcquires:this.#l,poolExhaustions:this.#u}}#f(){let e=new N(this.#e(),this.#i);return e.once(`exit`,()=>{let t=this.#a.indexOf(e);if(t>=0){this.#a.splice(t,1);return}this.#o.delete(e)}),e}#p(e){return e.threadId!==-1}};function Nt(e){W(U.imageBytes,{byteLength:e})}function Pt(e){W(U.resetTime,{durationMs:e})}function Ft(){let e=O(ae(import.meta.url)),t=[A(e,`worker.js`),A(e,`worker-entry.ts`)];for(let e of t)if(w(e))return F(e);throw Error(`worker entry not found; tried: ${t.join(`, `)}`)}function It(e){if(typeof e!=`object`||!e)return;let t=e;if(t.status!==`rejected`)return;let n=typeof t.errorMessage==`string`?t.errorMessage:t.started===!1?`dispatch refused`:`dispatch failed`;return{kind:t.started===!1?`refused`:`failed`,message:n}}function Lt(e){return typeof e==`object`&&!!e&&e.background===!0}function G(e){return e instanceof Error?e.message:String(e)}function Rt(e){if(typeof e!=`object`||!e)return;let t=e.content;if(Array.isArray(t)&&t.length>0){let e=t[0];if(typeof e==`object`&&e){let t=e.text;if(typeof t==`string`&&t.length>0){let e=t.indexOf(`
+`);return e===-1?t:t.slice(0,e)}}}}function zt(e){return e instanceof ArrayBuffer||ArrayBuffer.isView(e)}function Bt(e,t){let n=/* @__PURE__ */ new WeakSet,r=e=>{if(e!=null){if(e instanceof ArrayBuffer){t(e);return}if(ArrayBuffer.isView(e)){t(e);return}if(typeof e==`object`&&!n.has(e)){if(n.add(e),Array.isArray(e)){for(let t of e)r(t);return}for(let t of Object.keys(e))r(e[t])}}};r(e)}function Vt(e){try{let t=Buffer.byteLength(JSON.stringify(e,(e,t)=>zt(t)?null:t)??``,`utf8`),n=0;return Bt(e,e=>{n+=e.byteLength}),t+n}catch{return 1/0}}async function Ht(e){let i=ke(e.config),s=Oe(),c=e.runId??j(),l=Ae(e.timeoutMs,i),u=[],d=[],f=[];if(e.signal?.aborted)return{logs:u,narrations:d,phases:f,error:{kind:n.abort,message:`run cancelled before start`}};let p;try{p=e.pool?await e.pool.acquire():new N(Ft(),jt({surface:e.surface,env:s,limits:i,runId:c}))}catch(e){return{logs:u,narrations:d,phases:f,error:{kind:n.workerExit,message:`pool acquire failed: ${G(e)}`}}}return await new Promise(s=>{let m=new ie,h=m.port1,g=m.port2,_=new AbortController,v=!1,y=At(),b=()=>{v||e.onSubCallChange?.(()=>y.snapshot())},x={recordStart(e,t,n){y.recordStart(e,t,n),b()},recordEnd(e,t,n){let r=y.recordEnd(e,t,n);return b(),r},snapshot:()=>y.snapshot()},S,C=!1,w=0,T=0,ee=new Ke(i.dispatchConcurrency),E=0,te=[],D=e.depth??0,O,k,A=[],ne=e=>{let t=[],n=e?.content;if(!Array.isArray(n))return t;for(let e of n){if(typeof e!=`object`||!e)continue;let n=e;if(n.type!==`image`)continue;let r;typeof n.data==`string`&&n.data.length>0?r=n.data:n.bytes instanceof ArrayBuffer&&n.bytes.byteLength>0&&(r=Buffer.from(n.bytes).toString(`base64`)),r!==void 0&&t.push({data:r,mimeType:typeof n.mimeType==`string`?n.mimeType:`application/octet-stream`})}return t},re=e=>e===`timeout`?`run timed out after ${l} ms`:`run cancelled`,j=e=>e===`timeout`?n.timeout:n.abort,M=t=>{if(v)return;v=!0,O&&clearTimeout(O),k&&clearTimeout(k),e.signal?.removeEventListener(`abort`,ue),_.abort(),h.close(),e.pool?e.pool.release(p):p.terminate();let n=x.snapshot();s(n.length>0?{...t,subCalls:n}:t)},N=(e,t,n)=>{M({logs:u,narrations:d,phases:f,error:n===void 0?{kind:e,message:t}:{kind:e,message:t,stack:n}})},P=e=>{if(!v){if(!r(e)){N(n.protocol,`internal error: malformed host frame`);return}h.postMessage(e)}},ae=()=>{let t={kind:o.init,runId:c,surface:e.surface,code:e.code,bindings:[...e.bindings.keys()],bindingCandidates:[...V],maxItemsPerCall:i.maxItemsPerCall,maxPendingCalls:i.maxPendingCalls,...e.args===void 0?{}:{args:e.args}};if(!r(t)){N(n.protocol,`internal error: malformed init frame`);return}let a=Vt(t);if(a>i.maxMessageBytes){N(n.protocol,`init frame of ${a} bytes exceeds maxMessageBytes (${i.maxMessageBytes})`);return}P(t)},F=(e,t)=>(T+=e,T<=i.maxOutputBytes||(N(n.outputLimit,`${t} exceeded the output budget: logs + result reached ${T} bytes (maxOutputBytes=${i.maxOutputBytes}); ${u.length} log line(s) retained`),!1)),I=async()=>{if(E<i.maxParallelSubCalls){E+=1;return}await new Promise(e=>{te.push(e)})},L=()=>{let e=te.shift();if(e){e();return}--E},oe=e=>{if(x.recordStart(e.callId,e.tool,e.args),w+=1,w>i.maxPendingCalls){x.recordEnd(e.callId,`error`,{errorMessage:`more than maxPendingCalls (${i.maxPendingCalls}) binding calls in flight`}),N(n.protocol,`more than maxPendingCalls (${i.maxPendingCalls}) binding calls in flight`);return}se(e).finally(()=>{--w})},se=async t=>{let r=e.bindings.get(t.tool);if(!r){x.recordEnd(t.callId,`error`,{errorMessage:`no binding named "${t.tool}" in this run; available bindings: `+([...e.bindings.keys()].join(`, `)||`(none)`)}),R({kind:o.callResult,callId:t.callId,tool:t.tool,ok:!1,message:`no binding named "${t.tool}" in this run; available bindings: `+([...e.bindings.keys()].join(`, `)||`(none)`)});return}let a=t.tool===H,s=a&&Lt(t.args);if(a){if(!s&&!ee.tryAcquire()){x.recordEnd(t.callId,`rejected`,{errorMessage:$e}),R({kind:o.callResult,callId:t.callId,tool:t.tool,ok:!0,value:et()});return}}else if(await I(),v){x.recordEnd(t.callId,`cancelled`,{errorMessage:`run settled before binding started`}),L();return}try{let s=await r.execute(t.args,{signal:_.signal,callId:t.callId,depth:D,maxDispatchDepth:i.maxDispatchDepth,callerId:c,...e.parentTaskId===void 0?{}:{parentTaskId:e.parentTaskId},...e.sessionDir===void 0?{}:{sessionDir:e.sessionDir},dispatchDeps:{...e.dispatchDeps,slots:e.dispatchDeps?.slots??ee}}),l=ne(s),u={kind:o.callResult,callId:t.callId,tool:t.tool,ok:!0,value:s},d=Vt(u);if(d>i.maxMessageBytes){x.recordEnd(t.callId,`error`,{errorMessage:`callResult frame of ${d} bytes exceeds maxMessageBytes (${i.maxMessageBytes})`}),N(n.protocol,`callResult frame of ${d} bytes exceeds maxMessageBytes (${i.maxMessageBytes})`);return}if(R(u))for(let e of l)A.push(e),Nt(Buffer.byteLength(e.data,`base64`));if(_.signal.aborted)x.recordEnd(t.callId,`cancelled`,{errorMessage:`binding aborted by run cancellation`});else{let e=a?It(s):void 0;e===void 0?x.recordEnd(t.callId,`ok`,{resultSummary:Rt(s)}):x.recordEnd(t.callId,e.kind===`refused`?`rejected`:`error`,{errorMessage:e.message})}}catch(e){_.signal.aborted?x.recordEnd(t.callId,`cancelled`,{errorMessage:G(e)}):x.recordEnd(t.callId,`error`,{errorMessage:G(e)}),R({kind:o.callResult,callId:t.callId,tool:t.tool,ok:!1,message:G(e)})}finally{a?s||ee.release():L()}},R=e=>{if(v)return!1;try{return h.postMessage(e),!0}catch(t){try{h.postMessage({kind:o.callResult,callId:e.callId,tool:e.tool,ok:!1,message:`binding result could not be transferred: ${G(t)}`})}catch{N(n.protocol,`binding result is not transferable`)}return!1}},ce=e=>S?{logs:u,narrations:d,phases:f,error:{kind:j(S),message:re(S)}}:e,le=r=>{if(v)return;if(!a(r)){N(n.protocol,`malformed worker frame`);return}let o=r.kind===t.ready?0:Vt(r);if(!Number.isFinite(o)){N(n.protocol,`worker frame could not be serialized for accounting`);return}if(o>i.maxMessageBytes){N(n.protocol,`control frame of ${o} bytes exceeds maxMessageBytes (${i.maxMessageBytes})`);return}switch(r.kind){case t.ready:if(e.pool){let t=e.pool.lastSettledAt(p);t!==void 0&&Pt(Date.now()-t)}if(!C&&(C=!0,S)){de(S);return}ae();return;case t.call:oe(r);return;case t.log:F(o,`console output`)&&u.push(r.text);return;case t.narration:F(o,`workflow narration`)&&d.push(r.message);return;case t.phase:F(o,`workflow phase`)&&f.push(r.title);return;case t.result:{if(!F(o,`completion value`))return;let e={logs:u,narrations:d,phases:f,...A.length>0?{images:A}:{}};M(ce(r.value===void 0?e:{...e,value:r.value}));return}case t.error:M(ce({logs:u,narrations:d,phases:f,error:r.error}));return;default:N(n.protocol,`unknown worker frame`)}};function ue(){fe(`abort`)}let de=e=>{k&&clearTimeout(k),k=setTimeout(()=>{N(j(e),re(e))},i.graceMs)};function fe(e){if(!v){if(S){N(j(S),re(S));return}S=e,_.abort(),P({kind:o.cancel,reason:e}),de(e)}}p.on(`error`,e=>{N(n.workerExit,`worker failed: ${G(e)}`)}),p.on(`exit`,e=>{N(n.workerExit,`worker exited with code ${e} before the run completed`)}),h.on(`message`,le),h.on(`messageerror`,()=>{N(n.protocol,`worker sent a frame that could not be deserialized`)}),e.signal?.addEventListener(`abort`,ue,{once:!0}),O=setTimeout(()=>{fe(`timeout`)},l);let pe={kind:o.connect,port:g};r(pe)?p.postMessage(pe,[g]):N(n.protocol,`internal error: malformed connect frame`)})}const Ut=`pi-ptc-output-`;function Wt(e,t=Ut){let n=k(te(),`${t}${j()}.txt`);return ee(n,e,`utf8`),n}function Gt(e,t){let n=e.totalLines-e.outputLines+1,r=e.totalLines;return e.lastLinePartial?`[Showing last ${_(e.outputBytes)} of line ${r}. Full output: ${t}]`:e.truncatedBy===`lines`?`[Showing lines ${n}-${r} of ${e.totalLines}. Full output: ${t}]`:`[Showing lines ${n}-${r} of ${e.totalLines} (${_(s)} limit). Full output: ${t}]`}function Kt(e,t=Ut,n={}){let r=b(e,{maxLines:c,maxBytes:s});if(!r.truncated)return{text:e,truncated:!1};let i=Wt(n.fullText??e,t);return{text:`${r.content}\n\n${Gt(r,i)}`,truncated:!0,fullPath:i}}const qt=200,Jt=new RegExp([`(?:\\u001B\\][\\s\\S]*?(?:\\u0007|\\u001B\\u005C|\\u009C))`,`[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]`].join(`|`),`g`);function Yt(e){return!e.includes(`\x1B`)&&!e.includes(`›`)?e:e.replace(Jt,``)}function K(e){let t=Yt(e).replace(/\r/g,``);if(t.length===0)return t;let n=``;for(let e of t){let t=e.codePointAt(0);if(t!==void 0){if(t===10||t===9){n+=e;continue}t<=31||t>=65529&&t<=65531||(n+=e)}}return n}const Xt=/^[A-Za-z_$][A-Za-z0-9_$]*$/;function Zt(e){return Xt.test(e)?e:JSON.stringify(e)}function Qt(e){if(e===null)return`null`;if(typeof e==`number`||typeof e==`boolean`)return String(e);if(typeof e==`string`){let t=K(e);return t.includes(`
+`)?void 0:JSON.stringify(t)}if(Array.isArray(e)){let t=[];for(let n of e){let e=Qt(n);if(e===void 0)return;t.push(e)}return`[${t.join(`, `)}]`}let t=Object.keys(e);if(t.length===0)return`{}`;let n=[];for(let r of t){let t=Qt(e[r]??null);if(t===void 0)return;n.push(`${Zt(r)}: ${t}`)}return`{${n.join(`, `)}}`}function $t(e){let t=Qt(e);if(t!==void 0)return t.length<=100?t:void 0}function en(e){return e===null?`null`:typeof e==`string`?K(e):String(e)}function tn(e,t){if(typeof e!=`object`||!e)return[`${t}${en(e)}`];if(Array.isArray(e)){if(e.length===0)return[`${t}[]`];let n=[`${t}[`];for(let r of e){let e=$t(r);if(e!==void 0){n.push(`${t}  ${e}`);continue}n.push(...nn(r,t+`  `))}return n.push(`${t}]`),n}let n=Object.keys(e);if(n.length===0)return[`${t}{}`];let r=[`${t}{`],i=t+`  `;for(let t of n){let n=e[t]??null,a=$t(n);if(a!==void 0){r.push(`${i}${Zt(t)}: ${a}`);continue}if(typeof n==`string`){r.push(`${i}${Zt(t)}:`);for(let e of K(n).split(`
+`))r.push(e.length===0?``:`${i}  ${e}`);continue}let o=tn(n,i);r.push(`${i}${Zt(t)}: ${(o[0]??``).trimStart()}`.trimEnd(),...o.slice(1))}return r.push(`${t}}`),r}function nn(e,t){return typeof e==`string`?K(e).split(`
+`):typeof e!=`object`||!e?[String(e)]:tn(e,t)}function rn(e){return e.split(`
 `).map(e=>e.length>200?`${e.slice(0,199)}…`:e).join(`
-`)}function Ye(e){if(typeof e==`string`)return Je(H(e));if(typeof e!=`object`||!e)return String(e);let t=We(e);return Je((t===void 0?qe(e,``):[t]).join(`
-`))}function Xe(e=process.env){let t=e.PI_PTC_DEPTH;return t===void 0||!/^\d+$/.test(t)?0:Number.parseInt(t,10)}function W(e){if(e===void 0)return L;let t=new Set(e);return L.filter(e=>t.has(e))}const Ze=["Image-bearing tool results inside a program (a `tools.read` on a PNG, say) are attached to you after the run — never return image data as the completion value.",`Use ptc_run_code when a task needs several tool calls whose intermediate output you do not need to see — gather it inside the program and return only the final value.`,`Use ptc_workflow instead of ptc_run_code when the work has named phases and the user benefits from seeing progress narration.`],Qe={run_code:`ptc_run_code`,workflow:`ptc_workflow`};function $e(e){let t=e?.cwd;return typeof t==`string`&&t.length>0?t:process.cwd()}function et(e){let{surface:t,startedAt:n,onUpdate:r}=e;if(r===void 0)return{update:()=>{},cancel:()=>{}};let i=0,a,o,s=()=>{if(o===void 0)return;let e=o;o=void 0,i=Date.now(),r({content:[],details:{surface:t,logs:[],narrations:[],phases:[],warnings:[],durationMs:Date.now()-n,imageCount:0,subCalls:e()}})};return{update(e){o=e;let t=100-(Date.now()-i);if(t<=0){a!==void 0&&(clearTimeout(a),a=void 0),s();return}a??=setTimeout(()=>{a=void 0,s()},t)},cancel(){a!==void 0&&(clearTimeout(a),a=void 0),o=void 0}}}function tt(e){return[...e.phases.map(e=>`[phase] ${H(e)}`),...e.narrations.map(e=>`[log] ${H(e)}`),...e.logs.map(e=>H(e))]}function nt(e){let t=e.error;if(t===void 0)return/* @__PURE__ */ Error(`internal error: a successful PTC run was rendered as a failure`);let n=tt(e),r=n.length===0?``:`\nCaptured output:\n${n.join(`
-`)}`,i=Error(H(`code run failed (${t.kind}): ${t.message}${r}`));return i.name=`CodeRunFailedError`,i}function rt(e){let t=A(te(),`pi-ptc-output-${j()}.txt`);return E(t,e,`utf8`),t}function it(e,t){let n=e.totalLines-e.outputLines+1,r=e.totalLines;return e.lastLinePartial?`[Showing last ${_(e.outputBytes)} of line ${r}. Full output: ${t}]`:e.truncatedBy===`lines`?`[Showing lines ${n}-${r} of ${e.totalLines}. Full output: ${t}]`:`[Showing lines ${n}-${r} of ${e.totalLines} (${_(s)} limit). Full output: ${t}]`}function at(e){let{outcome:t,surface:n}=e,r=[...e.warnings??[]],i=t.images??[],a=[];t.phases.length>0&&a.push(`Phases: ${t.phases.map(e=>H(e)).join(` → `)}`),t.narrations.length>0&&a.push(t.narrations.map(e=>H(e)).join(`
-`)),t.logs.length>0&&a.push(t.logs.map(e=>H(e)).join(`
-`)),t.value!==void 0&&a.push(Ye(t.value));for(let e of r)a.push(`Warning: ${H(e)}`);let o=a.length>0?a.join(`
-`):`(${Qe[n]} completed with no output)`,l=b(o,{maxLines:c,maxBytes:s}),u,d=l.content;return l.truncated&&(u=rt(o),d+=`\n\n${it(l,u)}`),{content:[{type:`text`,text:d},...i.map(e=>({type:`image`,data:e.data,mimeType:e.mimeType}))],details:{surface:n,logs:[...t.logs],narrations:[...t.narrations],phases:[...t.phases],warnings:r,...t.value===void 0?{}:{result:t.value},durationMs:e.durationMs,imageCount:i.length,...u===void 0?{}:{fullOutputPath:u},...t.subCalls===void 0?{}:{subCalls:t.subCalls}}}}const ot=/^(.*?)(└─ |├─ |   )(?:PTC(?: workflow)?)([ ].*)$/;function st(e){return e.replace(/\x1b\[[0-9;]*m|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b\[\?[0-9;]*[a-zA-Z]/g,``)}function ct(e,t){if(e.charCodeAt(t)!==27)return t;let n=e.charCodeAt(t+1);if(n===93){let n=t+2;for(;n<e.length;){let t=e.charCodeAt(n);if(t===7)return n+1;if(t===27&&e.charCodeAt(n+1)===92)return n+2;n+=1}return n}if(n===91){let n=t+2;for(;n<e.length;){let t=e.charCodeAt(n);if(t>=64&&t<=126)return n+1;n+=1}return n}return t+2}function lt(e,t){let n=0,r=0;for(;r<t&&n<e.length;)e.charCodeAt(n)===27?n=ct(e,n):(n+=1,r+=1);return n}function ut(e,t){let n=t.intervalMs??150,{state:r}=t;t.isPartial?(r.startedAt??=Date.now(),r.interval??=setInterval(()=>t.requestInvalidate(),n)):(r.interval!==void 0&&(clearInterval(r.interval),r.interval=void 0),r.startedAt=void 0);let i=e.render.bind(e),a=e;return a.render=e=>{let a=i(e);return r.startedAt===void 0?a:dt(a,Math.floor((Date.now()-r.startedAt)/n),t.theme)},a.dispose=()=>{r.interval!==void 0&&(clearInterval(r.interval),r.interval=void 0)},e}function dt(e,t,n){return e.map(e=>{let r=st(e),i=ot.exec(r);if(i===null)return e;let a=(i[3]??``).slice(1);if(a.length===0)return e;let o=t%(a.length+1),s=i[0].length-a.length,c=lt(e,s),l=lt(e,s+a.length),u=o>=a.length?n.fg(`dim`,a):`${o>0?n.fg(`dim`,a.slice(0,o)):``}${n.fg(`accent`,a.slice(o,o+1))}${n.fg(`dim`,a.slice(o+1))}`;return`${e.slice(0,c)}${u}${e.slice(l)}`})}const ft={run_code:`PTC`,workflow:`PTC workflow`};var G=class{items;constructor(e){this.items=e}invalidate(){}render(e){let t=Math.max(1,Math.floor(e));return this.items.map(e=>pt(e,t))}};function pt(e,t){let{left:n,right:r}=e;if(r===void 0)return ae(n,t,`…`);let i=F(r);if(i>=t)return ae(r,t,`…`);let a=ae(n,Math.max(0,t-i-1),`…`),o=Math.max(1,t-i-F(a));return a+` `.repeat(o)+r}function K(e,t){return e.length>t?`${e.slice(0,t-1)}…`:e}function mt(e){return K((H(e).split(`
-`).find(e=>e.trim().length>0)??``).trim(),120)}function ht(e){return e<1e3?`${e}ms`:`${(e/1e3).toFixed(2).replace(/\.?0+$/,``)}s`}function q(e,t){return`${e} ${t}${e===1?``:`s`}`}function gt(e){for(let t of e.split(`
-`)){let e=t.trim();if(e.length!==0&&!e.startsWith(`//`)&&!e.startsWith(`/*`)&&!e.startsWith(`*`))return K(e.replace(/\s*\/\/.*$/,``),120)}}function _t(e){if(e===void 0)return;if(typeof e==`string`){let t=H(e).split(`
-`),n=t.find(e=>e.trim().length>0)?.trim()??``,r=t.length>1?` (+${t.length-1} lines)`:``;return n.length===0&&r.length===0?`""`:K(n,60)+r}if(typeof e!=`object`||!e)return String(e);let t=Ye(e);if(!t.includes(`
-`)&&t.length<=60)return t;if(Array.isArray(e))return`Array(${e.length})`;let n=Object.keys(e);return n.length===0?`{}`:`{${n.slice(0,4).join(`, `)}${n.length>4?`, +${n.length-4}`:``}}`}function vt(e,t){if(e===void 0)return;let n=[],r=e.logs.length+e.narrations.length;if(r>0&&n.push(t.fg(`dim`,q(r,`output line`))),e.imageCount>0&&n.push(t.fg(`toolOutput`,q(e.imageCount,`image`))),e.surface===`workflow`&&e.phases.length>0&&n.push(t.fg(`dim`,q(e.phases.length,`phase`))),e.warnings.length>0&&n.push(t.fg(`warning`,q(e.warnings.length,`warning`))),e.fullOutputPath!==void 0&&n.push(t.fg(`warning`,`truncated`)),e.durationMs>0&&n.push(t.fg(`dim`,ht(e.durationMs))),n.length!==0)return`${t.fg(`dim`,`•`)} ${n.join(t.fg(`dim`,` · `))}`}function yt(e){if(e!==void 0)return{surface:e.surface??`run_code`,logs:e.logs??[],narrations:e.narrations??[],phases:e.phases??[],warnings:e.warnings??[],durationMs:e.durationMs??0,imageCount:e.imageCount??0,...e.result===void 0?{}:{result:e.result},...e.fullOutputPath===void 0?{}:{fullOutputPath:e.fullOutputPath},...e.subCalls===void 0?{}:{subCalls:e.subCalls}}}function bt(e,t,n){let r=`   `+(t?`└─ `:`├─ `),i=`   `+(t?`   `:`│  `),a=` `.repeat(8),o=[],s=e.lines[0]??``;o.push({left:`${r}${e.label.padEnd(8)}${n.fg(`dim`,s)}`});for(let t=1;t<e.lines.length;t++)o.push({left:`${i}${a}${n.fg(`dim`,e.lines[t]??``)}`});return e.more!==void 0&&e.more>0&&o.push({left:`${i}${a}…+${e.more} more lines`}),o}function xt(e){return typeof e!=`object`||!e?!1:Array.isArray(e)?e.length>0:Object.keys(e).length>0}const St=/^[A-Za-z_$][A-Za-z0-9_$]*$/;function Ct(e){return St.test(e)?e:JSON.stringify(e)}function J(e,t){if(e===null)return`null`;if(typeof e==`boolean`||typeof e==`number`)return String(e);if(typeof e==`string`){let n=H(e);if(n.length===0)return`""`;if(n.includes(`
-`)){let e=K(n.replace(/\n/g,` `),Math.max(2,t-5));return JSON.stringify(e)+`…`}return n.length+2<=t?JSON.stringify(n):JSON.stringify(K(n,Math.max(2,t-5)))+`…`}return`?`}function wt(e){return typeof e!=`object`||!e}function Tt(e,t){if(t<8)return;if(Array.isArray(e)){if(e.length===0)return`[]`;if(e.length>5||!e.every(wt))return;let n=`[`+e.map(e=>J(e,Math.max(2,Math.floor(t/4)))).join(`, `)+`]`;return n.length<=t?n:void 0}if(typeof e!=`object`||!e)return;let n=Object.keys(e);if(n.length===0)return`{}`;if(n.length>5||!Object.values(e).every(wt))return;let r=`{`+n.map(n=>{let r=e[n]??null;return Ct(n)+`: `+J(r,Math.max(2,Math.floor(t/4)))}).join(`, `)+`}`;return r.length<=t?r:void 0}function Y(e,t,n,r,i,a,o,s,c){let l=n+(r?`└─ `:`├─ `),u=n+(r?`   `:`│  `);if(s>=i){c.push(X(l+t+`…`,o));return}if(Array.isArray(e)&&e.length===0){c.push(X(l+t+`[]`,o));return}if(!Array.isArray(e)&&typeof e==`object`&&e&&Object.keys(e).length===0){c.push(X(l+t+`{}`,o));return}if(typeof e!=`object`||!e){let n=Math.max(0,o-F(l)-t.length);c.push(X(l+t+J(e,n),o));return}let d=Tt(e,Math.max(0,o-F(l)-t.length));if(d!==void 0){c.push(X(l+t+d,o));return}let f=Array.isArray(e),p=f?e.length:Object.keys(e).length,m;m=f?`Array(`+p+`)`:p>a?`{`+a+` of `+p+`}`:`{`+p+` keys}`,c.push(X(l+t+m,o));let h=Math.min(a,p);if(f)for(let t=0;t<h;t+=1){let n=t===h-1&&p<=h;Y(e[t]??null,`[`+t+`] `,u,n,i,a,o,s+1,c)}else{let t=Object.keys(e);for(let n=0;n<h;n+=1){let r=n===h-1&&p<=h,l=t[n];Y(e[l]??null,Ct(l)+`: `,u,r,i,a,o,s+1,c)}}if(p>h){let e=f?`items`:`keys`;c.push(X(u+`└─ …+`+(p-h)+` more `+e,o))}}function X(e,t){if(F(e)<=t)return e;let n=e.match(/^([\s│├└─]*)/),r=n&&n[1]?n[1]:``,i=F(r),a=Math.max(0,t-i-1),o=``,s=0;for(let t of e.slice(r.length)){let e=F(t);if(s+e>a)break;o+=t,s+=e}return r+o+`…`}function Et(e,t={}){let n=t.maxDepth??4,r=t.maxChildren??6,i=t.maxLineChars??120,a=t.moreAfter===!0;if(!xt(e))return typeof e==`object`&&e?[Array.isArray(e)?`[]`:`{}`]:[J(e,i)];let o=[];if(Array.isArray(e)){let t=e.length,s=Math.min(r,t);for(let c=0;c<s;c+=1){let l=!a&&c===s-1&&t<=s;Y(e[c]??null,`[`+c+`] `,``,l,n,r,i,0,o)}return t>s&&o.push((a?`├─ `:`└─ `)+`…+`+(t-s)+` more items`),o}let s=Object.keys(e),c=s.length,l=Math.min(r,c);for(let t=0;t<l;t+=1){let u=!a&&t===l-1&&c<=l,d=s[t];Y(e[d]??null,Ct(d)+`: `,``,u,n,r,i,0,o)}return c>l&&o.push((a?`├─ `:`└─ `)+`…+`+(c-l)+` more keys`),o}function Dt(e,t,n=`run_code`,r={}){let i=(typeof e.description==`string`&&e.description.trim().length>0?e.description.trim():e.meta?.name)??``,a=gt(e.code??e.script??``),o=i.length>0?i:a??`(no description)`;return ut(new G([{left:`└─ ${`${t.fg(`toolTitle`,t.bold(ft[n]))} ${t.fg(`accent`,o)}`}`}]),{intervalMs:150,isPartial:r.isPartial??!1,theme:t,requestInvalidate:r.requestInvalidate??Ot,state:r.state??{}})}function Ot(){}function kt(e){let t=e.content?.find(e=>e.type===`text`&&(e.text??``).length>0);return mt(t?.text??``)||`failed`}function At(e,t){if(e===`pi.dispatch`&&typeof t==`object`&&t&&`agent`in t)return`→ ${String(t.agent)}`;if(typeof t==`object`&&t){let n=t,r=e=>typeof n[e]==`string`?n[e]:void 0,i=e===`read`?r(`path`):e===`bash`?r(`command`):e===`grep`||e===`find`?r(`pattern`):e===`ls`||e===`edit`||e===`write`?r(`path`):void 0;if(typeof i==`string`)return i}try{let e=JSON.stringify(t).replace(/\n/g,` `);return e.length>40?`${e.slice(0,39)}…`:e}catch{return String(t).slice(0,40)}}const jt={running:{text:()=>`running`,themeSlot:`muted`},ok:{text:e=>e.durationMs===void 0?`ok`:`ok ${ht(e.durationMs)}`,themeSlot:`accent`},error:{text:e=>`failed: ${e.errorMessage??`error`}`,themeSlot:`error`},cancelled:{text:()=>`cancelled`,themeSlot:`muted`},rejected:{text:e=>`rejected: ${e.errorMessage??`concurrency`}`,themeSlot:`warning`}};function Mt(e,t){if(e.length===0)return[];let n=e.slice(0,32),r=e.length>32?e.length-32:0,i=[];return n.forEach((e,a)=>{let o=a===n.length-1&&r===0?`└─ `:`├─ `,s=e.name.length>=8?`${e.name} `:e.name.padEnd(8),c=At(e.name,e.args),l=jt[e.status];i.push({left:`   ${o}${t.fg(`toolTitle`,s)}${t.fg(l.themeSlot,l.text(e))}${t.fg(`dim`,` `+c)}`})}),r>0&&i.push({left:`   └─ …+${r} more calls`}),i}function Nt(e,t,n,r=!1,i=!1){let a=vt(e.details,n),o=e=>a===void 0?e:{...e,right:a};if(t)return[o({left:`   ${n.fg(`error`,`failed: ${kt(e)}`)}`})];if(i&&e.details?.result===void 0)return[];let s=e.details?.result;if(s===void 0)return[o({left:`   ${n.fg(`muted`,`done`)}`})];if(xt(s))return Et(s,{maxDepth:4,maxChildren:6,maxLineChars:120,moreAfter:r}).map((e,t)=>{let n={left:`   ${e}`};return t===0&&a!==void 0?{...n,right:a}:n});let c=_t(s);return c===void 0?[o({left:`   ${n.fg(`muted`,`done`)}`})]:[o({left:`   ${n.fg(`dim`,`→ ${c}`)}`})]}function Pt(e,t,n,r={}){let i=yt(e.details),a=[...Nt({...e,details:i},t,n,!1,r.isPartial===!0)];return i?.subCalls!==void 0&&a.push(...Mt(i.subCalls,n)),new G(a)}function Ft(e,t,n,r,i={}){let a=yt(e.details);if(n){let t=[...Nt({...e,details:a},!0,r)];a?.subCalls!==void 0&&t.push(...Mt(a.subCalls,r));let n=H(e.content?.find(e=>e.type===`text`)?.text??kt(e));for(let e of n.split(`
-`).slice(0,12))t.push({left:`   ${r.fg(`error`,e)}`});return new G(t)}let o=[],s=t.code??t.script??``;if(s.length>0){let e=s.split(`
-`).map(e=>K(e,120)),t=e.slice(0,3);o.push({label:`code`,lines:t,...e.length>t.length?{more:e.length-t.length}:{}})}if(a!==void 0&&a.surface===`workflow`&&a.phases.length>0){let e=a.phases.slice(0,8),t=a.phases.length>e.length?` …`:``;o.push({label:`phases`,lines:[`${e.join(` → `)}${t}`]})}if(a!==void 0&&a.narrations.length>0){let e=a.narrations.slice(0,12);o.push({label:`log`,lines:e.map(e=>H(e)),...a.narrations.length>e.length?{more:a.narrations.length-e.length}:{}})}if(a!==void 0&&a.logs.length>0){let e=a.logs.slice(0,12);o.push({label:`out`,lines:e.map(e=>H(e)),...a.logs.length>e.length?{more:a.logs.length-e.length}:{}})}if(a!==void 0&&a.warnings.length>0){let e=a.warnings.slice(0,4);o.push({label:`warn`,lines:e.map(e=>H(e)),...a.warnings.length>e.length?{more:a.warnings.length-e.length}:{}})}if(a!==void 0&&a.imageCount>0){let e=a.imageCount===1?`1 image attached`:`${a.imageCount} images attached`;o.push({label:`image`,lines:[e]})}let c=a?.subCalls,l=c!==void 0&&c.length>0||o.length>0,u=Nt({...e,details:a},!1,r,l,i.isPartial===!0);c!==void 0&&u.push(...Mt(c,r));for(let e=0;e<o.length;e+=1){let t=e===o.length-1;u.push(...bt(o[e]??{label:``,lines:[]},t,r))}return new G(u)}function It(e){return{renderCall(t,n,r){return Dt(t,n,e,{...r?.invalidate===void 0?{}:{requestInvalidate:r.invalidate},...r?.isPartial===void 0?{}:{isPartial:r.isPartial},...r?.state===void 0?{}:{state:r.state}})},renderResult(e,t,n,r){let i=t.isPartial===!0;return t.expanded===!0?Ft(e,r?.args??{},r?.isError===!0,n,{isPartial:i}):Pt(e,r?.isError===!0,n,{isPartial:i})}}}const Lt=["Run a TypeScript program that composes pi's tools in one shot. Required arguments: `code` —","the body of an async function (top-level `return` and `await` work; type annotations are","advisory, the code runs type-stripped) — and `description`, a 5-10 word summary of what the",`program does.`,``,"Inside the program, call this session's enabled built-in tools as `tools.<name>(args)` — e.g.",'`await tools.read({ path: "src/index.ts" })` or `await tools.bash({ command: "npm test" })`.',"The bound names mirror the session's active tools (a default session has `read`, `bash`, `edit`,","`write`); calling a name that is not bound rejects with an error the program can catch, and","independent calls may overlap under `Promise.all`.",``,"Only the program's return value and its `console.log` output come back. This surface has no","helpers: `log` / `phase` / `parallel` / `pipeline` exist only in `ptc_workflow`.",``,"Image-bearing tool results inside the program (a `tools.read` on a PNG, say) are attached to you",`after the run, so never return image data as the completion value — that only spends your context`,`on base64.`].join(`
-`),Rt=x.Object({code:x.String({description:`The program: the body of an async TypeScript function.`}),description:x.String({description:`Clear, concise description of what this program does in active voice, 5-10 words (shown in the UI).`}),timeoutMs:x.Optional(x.Number({description:`Elapsed deadline in milliseconds for the whole run, including tool calls. Omit it (or pass 0) for the default of ${R.timeoutMs/1e3} s; anything above ${R.maxTimeoutMs/1e3} s is capped.`}))});function zt(e={}){return g({name:`ptc_run_code`,label:`PTC Run Code`,description:Lt,promptSnippet:`Run a TypeScript program that composes pi's tools in one shot (tools.<name>(args)); only its return value and console.log come back`,promptGuidelines:[...Ze],parameters:Rt,async execute(t,n,r,i,a){let o=$e(a),s=W(e.getBindingSourceNames?.()),c=Date.now(),l=e.getPool?.(),u=et({surface:`run_code`,startedAt:c,onUpdate:i}),d;try{d=await Re({code:n.code,surface:`run_code`,cwd:o,bindings:Se({cwd:o,names:s,includeDispatch:!0}),...e.depth===void 0?{}:{depth:e.depth},...n.timeoutMs===void 0?{}:{timeoutMs:n.timeoutMs},...r===void 0?{}:{signal:r},...e.config===void 0?{}:{config:e.config},...l===void 0?{}:{pool:l},onSubCallChange:e=>u.update(e)})}finally{u.cancel()}if(d.error!==void 0)throw nt(d);return at({outcome:d,surface:`run_code`,durationMs:Date.now()-c})},...It(`run_code`)})}const Bt=[`Run a structured TypeScript workflow: a named plan that reports phases and narration as it`,"goes. `script` is the body of an async function, `meta` names it (`{ name, description, phases? }`,","where `phases` is the ordered plan), and optional `args` is plain-JSON input bound to the","program's `args` global.",``,"Helpers inside the script: `log(message)` narrates progress; `phase(title)` frames the workflow","(titles outside `meta.phases` are reported as warnings); `parallel(thunks)` runs thunks","concurrently, a failed item becoming `null`; `pipeline(items, ...stages)` chains stages per item","with the same per-item `null` on failure. There is no `agent()` helper.",``,"Tools are reachable as `tools.<name>(args)` exactly as in `ptc_run_code`, and the bound names",`mirror the session's enabled tools. What comes back is the script's return value, its`,"`log`/`phase` narration and its `console.log` output.",``,`Image-bearing tool results inside the script are attached to you after the run — never return`,`image data as the script's value.`].join(`
-`),Vt=x.Object({meta:x.Object({name:x.String({description:`Short workflow name, shown in the UI.`}),description:x.String({description:`What this workflow does, in active voice.`}),phases:x.Optional(x.Array(x.Object({name:x.String({description:`Phase title, matched against phase(title) calls.`})}),{description:`Ordered plan of the workflow's phases. phase() titles outside this list are reported as warnings.`}))},{description:`Workflow metadata: what this run is and which phases it declares.`}),script:x.String({description:`The program: the body of an async TypeScript function.`}),args:x.Optional(x.Record(x.String(),x.Unknown(),{description:"Plain-JSON input bound to the program's `args` global. No functions, symbols, undefined values or cycles."}))});function Ht(t){if(t!==void 0){if(typeof t!=`object`||!t||Array.isArray(t))throw TypeError(`ptc_workflow args must be a plain JSON object, received ${e(t)}`);for(let e of Object.keys(t)){let n=Ut(t[e],`args.${e}`,/* @__PURE__ */ new Set);if(n!==void 0)throw TypeError(`ptc_workflow args must be plain JSON: ${n}`)}}}function Ut(t,n,r){if(t===null||typeof t==`string`||typeof t==`boolean`)return;if(t===void 0)return`${n} is undefined`;if(typeof t==`number`)return Number.isFinite(t)?void 0:`${n} is ${String(t)}, which is not representable as JSON`;if(typeof t!=`object`)return`${n} is ${e(t)}`;let i=t;if(r.has(i))return`${n} is a circular reference`;r.add(i);try{if(Array.isArray(i)){for(let e=0;e<i.length;e+=1){let t=Ut(i[e],`${n}[${e}]`,r);if(t!==void 0)return t}return}let e=Object.getPrototypeOf(i);if(e!==Object.prototype&&e!==null){let e=i.constructor?.name;return`${n} is a ${typeof e==`string`&&e.length>0?e:`non-plain object`}, not plain JSON`}for(let e of Object.keys(i)){let t=Ut(i[e],`${n}.${e}`,r);if(t!==void 0)return t}return}finally{r.delete(i)}}function Wt(e,t){if(t===void 0||t.length===0)return[];let n=new Set(t),r=/* @__PURE__ */ new Set,i=[];for(let t of e.phases)n.has(t)||r.has(t)||(r.add(t),i.push(`phase "${t}" is not listed in meta.phases (declared: ${[...n].join(`, `)})`));return i}function Gt(e={}){return g({name:`ptc_workflow`,label:`PTC Workflow`,description:Bt,promptSnippet:`Run a structured TypeScript workflow with named phases, narration (log/phase) and structured concurrency (parallel/pipeline)`,promptGuidelines:[...Ze],parameters:Vt,async execute(t,n,r,i,a){Ht(n.args);let o=$e(a),s=W(e.getBindingSourceNames?.()),c=Date.now(),l=e.getPool?.(),u=et({surface:`workflow`,startedAt:c,onUpdate:i}),d;try{d=await Re({code:n.script,surface:`workflow`,cwd:o,bindings:Se({cwd:o,names:s,includeDispatch:!0}),...n.args===void 0?{}:{args:n.args},...e.depth===void 0?{}:{depth:e.depth},...r===void 0?{}:{signal:r},...e.config===void 0?{}:{config:e.config},...l===void 0?{}:{pool:l},onSubCallChange:e=>u.update(e)})}finally{u.cancel()}if(d.error!==void 0)throw nt(d);let f=n.meta.phases?.map(e=>e.name);return at({outcome:d,surface:`workflow`,warnings:Wt(d,f),durationMs:Date.now()-c})},...It(`workflow`)})}var Kt=class{#e;#t=/* @__PURE__ */ new Map;constructor(e={}){this.#e=Te(e.config)}get(e){let t=this.#t.get(e);if(t!==void 0)return t;let n=we(),r=new ke({buildWorkerUrl:Me,size:this.#e.poolSize,acquireTimeoutMs:this.#e.poolAcquireTimeoutMs,drainGraceMs:this.#e.drainGraceMs,workerOptions:Oe({surface:e,env:n,limits:this.#e})});return this.#t.set(e,r),r}async drain(){let e=[...this.#t.values()];this.#t.clear(),await Promise.all(e.map(e=>e.drain()))}};const Z=[`ptc_run_code`,`ptc_workflow`],qt=[`read`,`bash`,`edit`,`write`],Q=`ptc-mode`,Jt=`ptc-mode`,Yt=`ptc.json`,Xt=`builtins-only`;function Zt(){return{enabled:!1,base:void 0,ourLoadout:void 0}}function Qt(e){let t=A(e,Yt),n;try{n=T(t,`utf8`)}catch{return{defaultMode:!0,source:`default`}}let r;try{r=JSON.parse(n)}catch(e){return{defaultMode:!0,source:`invalid`,error:`${t} is not valid JSON (${e instanceof Error?e.message:String(e)})`}}if(typeof r!=`object`||!r||Array.isArray(r))return{defaultMode:!0,source:`invalid`,error:`${t} must contain a JSON object`};let i=r.defaultMode;return i===void 0?{defaultMode:!0,source:`default`}:typeof i==`boolean`?{defaultMode:i,source:`file`}:{defaultMode:!0,source:`invalid`,error:`${t}: "defaultMode" must be a boolean, received ${typeof i}`}}function $t(e){return[...new Set(e)]}function en(e,t){if(e.length!==t.length)return!1;let n=[...e].sort(),r=[...t].sort();return n.every((e,t)=>e===r[t])}function tn(e,t){let n=e=>Z.includes(e);if(t===`all-but-ptc`)return $t(e.filter(n));let r=new Set(L);return $t(e.filter(e=>n(e)||!r.has(e)))}function nn(e){let{mode:t,defaultMode:n,active:r,manual:i}=e;return t===`tui`?!n&&!i?{enter:!1,reason:`config-off`}:Z.some(e=>r.includes(e))?!i&&qt.filter(e=>!r.includes(e)).length>0?{enter:!1,reason:`restricted-session`}:{enter:!0,base:$t(r),loadout:tn(r,e.hide??`builtins-only`)}:{enter:!1,reason:`tools-unavailable`}:{enter:!1,reason:`not-tui`}}function rn(e,t){return e.enabled&&e.base!==void 0?e.base:t}function an(e,t){return!e.enabled||e.ourLoadout===void 0?!1:!en(e.ourLoadout,t)}function on(e,t){let n=t.length>0&&t.every(e=>Z.includes(e));return e?.enabled===!0&&n&&e.base!==void 0?{base:e.base,restoreFirst:!0}:{base:t,restoreFirst:!1}}function sn(e,t){let n=t===`all-but-ptc`?`Every built-in tool is hidden from you, and so are other extensions' tools.`:`The built-in tools (read, bash, edit, write, grep, find, ls) are hidden from you.`,r=e.map(e=>`tools.${e}(args)`),i=e.slice(0,2).map(e=>e===`read`?`await tools.read({ path: "src/index.ts" })`:e===`bash`?`await tools.bash({ command: "pnpm test" })`:`await tools.${e}({ /* … */ })`).join(`
-`);return[`[PTC MODE ACTIVE]`,`This session runs in PTC mode. `+n,``,`Work by writing one TypeScript program per task and running it:`,`  - ptc_run_code for a plain program (its return value and console.log come back to you)`,`  - ptc_workflow when the task has named phases and you want narration (log / phase /`,`    parallel / pipeline are available there)`,``,`The program body is an async function. Available inside it: ${r.join(`, `)}.`,i.length>0?`Examples:\n${i}`:``,``,`Batch a task's steps into ONE program instead of issuing many tool calls — gathering`,`intermediate output yourself and returning only what matters is the point of this mode.`,`Image-bearing tool results inside a program are attached to you after the run — never return`,`base64 image data as your program's value.`,`If the PTC surfaces cannot express what you need, say so and the user can run /ptc off.`].filter(e=>e.length>0).join(`
-`)}const cn=[`read`,`bash`],ln=`Use the read tool to load a skill's file when the task matches its description.`,un=`Use tools.read({ path }) inside a ptc_run_code program to load a skill's file when the task matches its description.`;function dn(e){return!cn.some(t=>e.includes(t))}function fn(e,t=v){let n=t([...e],`read`).trim();return n.length===0?``:n.includes(ln)?n.replace(ln,un):`${un}\n\n${n}`}const $=Xt;function pn(e,t){return[`PTC mode on — ${t===`all-but-ptc`?`all other tools`:`built-in tools (now reachable only as tools.<name> inside a program)`} hidden.`,`Bindings available inside a program: ${W(e).join(`, `)||`(none)`}.`,`Run /ptc off to restore the normal tool set.`].join(`
-`)}function mn(e){let t=Zt(),n=!1,r=new Kt,i=()=>rn(t,e.getActiveTools()),a=Xe();e.registerTool(zt({getBindingSourceNames:i,getPool:()=>r.get(`run_code`),depth:a})),e.registerTool(Gt({getBindingSourceNames:i,getPool:()=>r.get(`workflow`),depth:a})),e.on(`turn_end`,async()=>{let e=r;r=new Kt,await e.drain()});let o=e=>{e.ui.setStatus(Jt,t.enabled?e.ui.theme.fg(`accent`,`PTC`):void 0)},s=(r,i,a,s)=>{t.enabled=!0,t.base=r,t.ourLoadout=i,e.setActiveTools([...i]),n=!0,e.appendEntry(Q,{enabled:!0,base:[...r]}),o(a),a.ui.notify(s,`info`)},c=(r,i)=>{let a=t.base;t.enabled=!1,t.base=void 0,t.ourLoadout=void 0,n=!1,a!==void 0&&e.setActiveTools([...a]),e.appendEntry(i.customType,{enabled:!1}),o(r),i.announce&&r.ui.notify(`PTC mode off — built-in tools are directly callable again.`,`info`)},l=e=>{let t=e.sessionManager.getEntries();for(let e=t.length-1;e>=0;--e){let n=t[e];if(n?.type!==`custom`||n.customType!==`ptc-mode`)continue;let r=n.data,i=Array.isArray(r?.base)?r.base.filter(e=>typeof e==`string`):void 0;return{enabled:r?.enabled===!0,...i===void 0?{}:{base:i}}}};e.registerCommand(`ptc`,{description:`Show or toggle PTC mode (built-in tools reachable only from inside a PTC program)`,handler:async(n,r)=>{let i=n.trim().toLowerCase();if(i===`off`){if(!t.enabled){r.ui.notify(`PTC mode is already off.`,`info`);return}c(r,{announce:!0,customType:Q});return}if(i!==`on`){r.ui.notify(t.enabled?`PTC mode is ON — run /ptc off to restore built-in tools.\nBindings: ${W(t.base).join(`, `)||`(none)`}`:`PTC mode is OFF — run /ptc on to enter it.`,`info`);return}if(t.enabled){r.ui.notify(`PTC mode is already on.`,`info`);return}let a=nn({mode:r.mode,defaultMode:!0,active:e.getActiveTools(),manual:!0,hide:$});if(!a.enter){r.ui.notify(a.reason===`tools-unavailable`?`Cannot enter PTC mode: ptc_run_code / ptc_workflow are not active in this session.`:`Cannot enter PTC mode in this run mode.`,`warning`);return}s(a.base,a.loadout,r,pn(a.base,$))}}),e.on(`session_start`,async(t,n)=>{let r=Qt(y());r.error!==void 0&&n.ui.notify(`pi-ptc-subagents: ${r.error}`,`warning`);let i=l(n),{base:a,restoreFirst:c}=on(i,e.getActiveTools());c&&e.setActiveTools([...a]);let u=nn({mode:n.mode,defaultMode:r.defaultMode,active:a,manual:!1,hide:$}),d=i?.enabled??u.enter;if(u.enter&&d){s(a,u.loadout,n,pn(a,$));return}o(n),!u.enter&&u.reason!==`not-tui`&&i===void 0&&u.reason===`restricted-session`&&n.ui.notify(`PTC mode skipped: this session was launched with an explicit tool restriction.`,`info`)});let u=!1,d=(e,n)=>{if(e===void 0)return;if(!t.enabled||!n){u&&=(delete e.sections.skills,!1);return}let r=fn(e.skills);r.length!==0&&(e.sections.skills=r,u=!0)};e.on(`before_agent_start`,async(r,i)=>{let a=r.systemPromptOptions;if(d(a,dn(e.getActiveTools())),t.enabled){if(an(t,e.getActiveTools())){c(i,{announce:!1,customType:Q}),d(a,dn(e.getActiveTools())),i.ui.notify(`PTC mode off — another extension changed the active tool set.`,`warning`);return}if(n)return n=!1,{message:{customType:`ptc-mode-briefing`,content:sn(W(t.base),$),display:!1}}}})}export{L as BUILTIN_BINDING_NAMES,be as DEFAULT_BINDING_NAMES,R as DEFAULT_CONFIG,Xt as DEFAULT_HIDE_STRATEGY,o as HOST_FRAME_KIND,ze as MAX_LINE_CHARS,qt as MODE_REQUIRED_TOOL_NAMES,n as PTC_ERROR_KIND,i as PTC_LOG_LEVEL,Yt as PTC_MODE_CONFIG_FILE,Q as PTC_MODE_ENTRY_TYPE,Jt as PTC_MODE_STATUS_KEY,Z as PTC_MODE_TOOL_NAMES,un as PTC_SKILL_LOAD_INSTRUCTION,cn as SKILL_READING_TOOL_NAMES,Kt as TurnPools,Ce as WORKER_ENV_ALLOW_LIST,t as WORKER_FRAME_KIND,ke as WorkerPool,rn as bindingSource,sn as buildModeInstruction,fn as buildPtcSkillsSection,Se as createBuiltinBindings,we as createWorkerEnv,nn as decideModeEntry,mn as default,an as detectExternalLoadoutChange,Ee as effectiveTimeoutMs,Zt as initialModeState,tn as modeLoadout,Qt as readDefaultModeConfig,Ye as renderModelValue,on as resolveBaseOnStart,Te as resolveConfig,Re as runPtcProgram,en as sameToolSet,H as sanitizeText,dn as skillsSectionDropped,Ve as stripAnsi};
+`)}function an(e){if(typeof e==`string`)return rn(K(e));if(typeof e!=`object`||!e)return String(e);let t=$t(e);return rn((t===void 0?nn(e,``):[t]).join(`
+`))}function on(e=process.env){let t=e.PI_PTC_DEPTH;return t===void 0||!/^\d+$/.test(t)?0:Number.parseInt(t,10)}function sn(e=process.env){let t=e.PI_PTC_TASK_ID;if(t!==void 0&&/^[0-9A-HJKMNP-TV-Z]{26}$/.test(t))return t}function q(e){if(e===void 0)return V;let t=new Set(e);return V.filter(e=>t.has(e))}const cn=["Image-bearing tool results inside a program (a `tools.read` on a PNG, say) are attached to you after the run — never return image data as the completion value.",`Use ptc_run_code when a task needs several tool calls whose intermediate output you do not need to see — gather it inside the program and return only the final value.`,`Use ptc_workflow instead of ptc_run_code when the work has named phases and the user benefits from seeing progress narration.`],ln={run_code:`ptc_run_code`,workflow:`ptc_workflow`};function un(e){let t=e?.cwd;return typeof t==`string`&&t.length>0?t:process.cwd()}function dn(e){let{surface:t,startedAt:n,onUpdate:r}=e;if(r===void 0)return{update:()=>{},cancel:()=>{}};let i=0,a,o,s=()=>{if(o===void 0)return;let e=o;o=void 0,i=Date.now(),r({content:[],details:{surface:t,logs:[],narrations:[],phases:[],warnings:[],durationMs:Date.now()-n,imageCount:0,subCalls:e()}})};return{update(e){o=e;let t=100-(Date.now()-i);if(t<=0){a!==void 0&&(clearTimeout(a),a=void 0),s();return}a??=setTimeout(()=>{a=void 0,s()},t)},cancel(){a!==void 0&&(clearTimeout(a),a=void 0),o=void 0}}}function fn(e){return[...e.phases.map(e=>`[phase] ${K(e)}`),...e.narrations.map(e=>`[log] ${K(e)}`),...e.logs.map(e=>K(e))]}function pn(e){let t=e.error;if(t===void 0)return/* @__PURE__ */ Error(`internal error: a successful PTC run was rendered as a failure`);let n=fn(e),r=n.length===0?``:`\nCaptured output:\n${n.join(`
+`)}`,i=Error(K(`code run failed (${t.kind}): ${t.message}${r}`));return i.name=`CodeRunFailedError`,i}function mn(e){let{outcome:t,surface:n}=e,r=[...e.warnings??[]],i=t.images??[],a=[];t.phases.length>0&&a.push(`Phases: ${t.phases.map(e=>K(e)).join(` → `)}`),t.narrations.length>0&&a.push(t.narrations.map(e=>K(e)).join(`
+`)),t.logs.length>0&&a.push(t.logs.map(e=>K(e)).join(`
+`)),t.value!==void 0&&a.push(an(t.value));for(let e of r)a.push(`Warning: ${K(e)}`);let o=Kt(a.length>0?a.join(`
+`):`(${ln[n]} completed with no output)`),s=o.text,c=o.truncated?o.fullPath:void 0;return{content:[{type:`text`,text:s},...i.map(e=>({type:`image`,data:e.data,mimeType:e.mimeType}))],details:{surface:n,logs:[...t.logs],narrations:[...t.narrations],phases:[...t.phases],warnings:r,...t.value===void 0?{}:{result:t.value},durationMs:e.durationMs,imageCount:i.length,...c===void 0?{}:{fullOutputPath:c},...t.subCalls===void 0?{}:{subCalls:t.subCalls}}}}const hn=/^(.*?)(└─ |├─ |   )(?:PTC(?: workflow)?)([ ].*)$/;function gn(e){return e.replace(/\x1b\[[0-9;]*m|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b\[\?[0-9;]*[a-zA-Z]/g,``)}function _n(e,t){if(e.charCodeAt(t)!==27)return t;let n=e.charCodeAt(t+1);if(n===93){let n=t+2;for(;n<e.length;){let t=e.charCodeAt(n);if(t===7)return n+1;if(t===27&&e.charCodeAt(n+1)===92)return n+2;n+=1}return n}if(n===91){let n=t+2;for(;n<e.length;){let t=e.charCodeAt(n);if(t>=64&&t<=126)return n+1;n+=1}return n}return t+2}function vn(e,t){let n=0,r=0;for(;r<t&&n<e.length;)e.charCodeAt(n)===27?n=_n(e,n):(n+=1,r+=1);return n}function yn(e,t){let n=t.intervalMs??150,{state:r}=t;t.isPartial?(r.startedAt??=Date.now(),r.interval??=setInterval(()=>t.requestInvalidate(),n)):(r.interval!==void 0&&(clearInterval(r.interval),r.interval=void 0),r.startedAt=void 0);let i=e.render.bind(e),a=e;return a.render=e=>{let a=i(e);return r.startedAt===void 0?a:bn(a,Math.floor((Date.now()-r.startedAt)/n),t.theme)},a.dispose=()=>{r.interval!==void 0&&(clearInterval(r.interval),r.interval=void 0)},e}function bn(e,t,n){return e.map(e=>{let r=gn(e),i=hn.exec(r);if(i===null)return e;let a=(i[3]??``).slice(1);if(a.length===0)return e;let o=t%(a.length+1),s=i[0].length-a.length,c=vn(e,s),l=vn(e,s+a.length),u=o>=a.length?n.fg(`dim`,a):`${o>0?n.fg(`dim`,a.slice(0,o)):``}${n.fg(`accent`,a.slice(o,o+1))}${n.fg(`dim`,a.slice(o+1))}`;return`${e.slice(0,c)}${u}${e.slice(l)}`})}const xn={run_code:`PTC`,workflow:`PTC workflow`};var Sn=class{items;constructor(e){this.items=e}invalidate(){}render(e){let t=Math.max(1,Math.floor(e));return this.items.map(e=>Cn(e,t))}};function Cn(e,t){let{left:n,right:r}=e;if(r===void 0)return I(n,t,`…`);let i=L(r);if(i>=t)return I(r,t,`…`);let a=I(n,Math.max(0,t-i-1),`…`),o=Math.max(1,t-i-L(a));return a+` `.repeat(o)+r}function J(e,t){return e.length>t?`${e.slice(0,t-1)}…`:e}function wn(e){return J((K(e).split(`
+`).find(e=>e.trim().length>0)??``).trim(),120)}function Tn(e){return e<1e3?`${e}ms`:`${(e/1e3).toFixed(2).replace(/\.?0+$/,``)}s`}function En(e,t){return`${e} ${t}${e===1?``:`s`}`}function Dn(e){for(let t of e.split(`
+`)){let e=t.trim();if(e.length!==0&&!e.startsWith(`//`)&&!e.startsWith(`/*`)&&!e.startsWith(`*`))return J(e.replace(/\s*\/\/.*$/,``),120)}}function On(e){if(e===void 0)return;if(typeof e==`string`){let t=K(e).split(`
+`),n=t.find(e=>e.trim().length>0)?.trim()??``,r=t.length>1?` (+${t.length-1} lines)`:``;return n.length===0&&r.length===0?`""`:J(n,60)+r}if(typeof e!=`object`||!e)return String(e);let t=an(e);if(!t.includes(`
+`)&&t.length<=60)return t;if(Array.isArray(e))return`Array(${e.length})`;let n=Object.keys(e);return n.length===0?`{}`:`{${n.slice(0,4).join(`, `)}${n.length>4?`, +${n.length-4}`:``}}`}function kn(e,t){if(e===void 0)return;let n=[],r=e.logs.length+e.narrations.length;if(r>0&&n.push(t.fg(`dim`,En(r,`output line`))),e.imageCount>0&&n.push(t.fg(`toolOutput`,En(e.imageCount,`image`))),e.surface===`workflow`&&e.phases.length>0&&n.push(t.fg(`dim`,En(e.phases.length,`phase`))),e.warnings.length>0&&n.push(t.fg(`warning`,En(e.warnings.length,`warning`))),e.fullOutputPath!==void 0&&n.push(t.fg(`warning`,`truncated`)),e.durationMs>0&&n.push(t.fg(`dim`,Tn(e.durationMs))),n.length!==0)return`${t.fg(`dim`,`•`)} ${n.join(t.fg(`dim`,` · `))}`}function An(e){if(e!==void 0)return{surface:e.surface??`run_code`,logs:e.logs??[],narrations:e.narrations??[],phases:e.phases??[],warnings:e.warnings??[],durationMs:e.durationMs??0,imageCount:e.imageCount??0,...e.result===void 0?{}:{result:e.result},...e.fullOutputPath===void 0?{}:{fullOutputPath:e.fullOutputPath},...e.subCalls===void 0?{}:{subCalls:e.subCalls}}}function jn(e,t,n){let r=`   `+(t?`└─ `:`├─ `),i=`   `+(t?`   `:`│  `),a=` `.repeat(8),o=[],s=e.lines[0]??``;o.push({left:`${r}${e.label.padEnd(8)}${n.fg(`dim`,s)}`});for(let t=1;t<e.lines.length;t++)o.push({left:`${i}${a}${n.fg(`dim`,e.lines[t]??``)}`});return e.more!==void 0&&e.more>0&&o.push({left:`${i}${a}…+${e.more} more lines`}),o}function Mn(e){return typeof e!=`object`||!e?!1:Array.isArray(e)?e.length>0:Object.keys(e).length>0}const Nn=/^[A-Za-z_$][A-Za-z0-9_$]*$/;function Pn(e){return Nn.test(e)?e:JSON.stringify(e)}function Fn(e,t){if(e===null)return`null`;if(typeof e==`boolean`||typeof e==`number`)return String(e);if(typeof e==`string`){let n=K(e);if(n.length===0)return`""`;if(n.includes(`
+`)){let e=J(n.replace(/\n/g,` `),Math.max(2,t-5));return JSON.stringify(e)+`…`}return n.length+2<=t?JSON.stringify(n):JSON.stringify(J(n,Math.max(2,t-5)))+`…`}return`?`}function In(e){return typeof e!=`object`||!e}function Ln(e,t){if(t<8)return;if(Array.isArray(e)){if(e.length===0)return`[]`;if(e.length>5||!e.every(In))return;let n=`[`+e.map(e=>Fn(e,Math.max(2,Math.floor(t/4)))).join(`, `)+`]`;return n.length<=t?n:void 0}if(typeof e!=`object`||!e)return;let n=Object.keys(e);if(n.length===0)return`{}`;if(n.length>5||!Object.values(e).every(In))return;let r=`{`+n.map(n=>{let r=e[n]??null;return Pn(n)+`: `+Fn(r,Math.max(2,Math.floor(t/4)))}).join(`, `)+`}`;return r.length<=t?r:void 0}function Rn(e,t,n,r,i,a,o,s,c){let l=n+(r?`└─ `:`├─ `),u=n+(r?`   `:`│  `);if(s>=i){c.push(Y(l+t+`…`,o));return}if(Array.isArray(e)&&e.length===0){c.push(Y(l+t+`[]`,o));return}if(!Array.isArray(e)&&typeof e==`object`&&e&&Object.keys(e).length===0){c.push(Y(l+t+`{}`,o));return}if(typeof e!=`object`||!e){let n=Math.max(0,o-L(l)-t.length);c.push(Y(l+t+Fn(e,n),o));return}let d=Ln(e,Math.max(0,o-L(l)-t.length));if(d!==void 0){c.push(Y(l+t+d,o));return}let f=Array.isArray(e),p=f?e.length:Object.keys(e).length,m;m=f?`Array(`+p+`)`:p>a?`{`+a+` of `+p+`}`:`{`+p+` keys}`,c.push(Y(l+t+m,o));let h=Math.min(a,p);if(f)for(let t=0;t<h;t+=1){let n=t===h-1&&p<=h;Rn(e[t]??null,`[`+t+`] `,u,n,i,a,o,s+1,c)}else{let t=Object.keys(e);for(let n=0;n<h;n+=1){let r=n===h-1&&p<=h,l=t[n];Rn(e[l]??null,Pn(l)+`: `,u,r,i,a,o,s+1,c)}}if(p>h){let e=f?`items`:`keys`;c.push(Y(u+`└─ …+`+(p-h)+` more `+e,o))}}function Y(e,t){if(L(e)<=t)return e;let n=e.match(/^([\s│├└─]*)/),r=n&&n[1]?n[1]:``,i=L(r),a=Math.max(0,t-i-1),o=``,s=0;for(let t of e.slice(r.length)){let e=L(t);if(s+e>a)break;o+=t,s+=e}return r+o+`…`}function zn(e,t={}){let n=t.maxDepth??4,r=t.maxChildren??6,i=t.maxLineChars??120,a=t.moreAfter===!0;if(!Mn(e))return typeof e==`object`&&e?[Array.isArray(e)?`[]`:`{}`]:[Fn(e,i)];let o=[];if(Array.isArray(e)){let t=e.length,s=Math.min(r,t);for(let c=0;c<s;c+=1){let l=!a&&c===s-1&&t<=s;Rn(e[c]??null,`[`+c+`] `,``,l,n,r,i,0,o)}return t>s&&o.push((a?`├─ `:`└─ `)+`…+`+(t-s)+` more items`),o}let s=Object.keys(e),c=s.length,l=Math.min(r,c);for(let t=0;t<l;t+=1){let u=!a&&t===l-1&&c<=l,d=s[t];Rn(e[d]??null,Pn(d)+`: `,``,u,n,r,i,0,o)}return c>l&&o.push((a?`├─ `:`└─ `)+`…+`+(c-l)+` more keys`),o}function Bn(e,t,n=`run_code`,r={}){let i=(typeof e.description==`string`&&e.description.trim().length>0?e.description.trim():e.meta?.name)??``,a=Dn(e.code??e.script??``),o=i.length>0?i:a??`(no description)`;return yn(new Sn([{left:`└─ ${`${t.fg(`toolTitle`,t.bold(xn[n]))} ${t.fg(`accent`,o)}`}`}]),{intervalMs:150,isPartial:r.isPartial??!1,theme:t,requestInvalidate:r.requestInvalidate??Vn,state:r.state??{}})}function Vn(){}function Hn(e){let t=e.content?.find(e=>e.type===`text`&&(e.text??``).length>0);return wn(t?.text??``)||`failed`}function Un(e,t){if(e===`pi.dispatch`&&typeof t==`object`&&t&&`agent`in t)return`→ ${String(t.agent)}`;if(typeof t==`object`&&t){let n=t,r=e=>typeof n[e]==`string`?n[e]:void 0,i=e===`read`?r(`path`):e===`bash`?r(`command`):e===`grep`||e===`find`?r(`pattern`):e===`ls`||e===`edit`||e===`write`?r(`path`):void 0;if(typeof i==`string`)return i}try{let e=JSON.stringify(t).replace(/\n/g,` `);return e.length>40?`${e.slice(0,39)}…`:e}catch{return String(t).slice(0,40)}}const Wn={running:{text:()=>`running`,themeSlot:`muted`},ok:{text:e=>e.durationMs===void 0?`ok`:`ok ${Tn(e.durationMs)}`,themeSlot:`accent`},error:{text:e=>`failed: ${e.errorMessage??`error`}`,themeSlot:`error`},cancelled:{text:()=>`cancelled`,themeSlot:`muted`},rejected:{text:e=>`rejected: ${e.errorMessage??`concurrency`}`,themeSlot:`warning`}};function Gn(e,t){if(e.length===0)return[];let n=e.slice(0,32),r=e.length>32?e.length-32:0,i=[];return n.forEach((e,a)=>{let o=a===n.length-1&&r===0?`└─ `:`├─ `,s=e.name.length>=8?`${e.name} `:e.name.padEnd(8),c=Un(e.name,e.args),l=Wn[e.status];i.push({left:`   ${o}${t.fg(`toolTitle`,s)}${t.fg(l.themeSlot,l.text(e))}${t.fg(`dim`,` `+c)}`})}),r>0&&i.push({left:`   └─ …+${r} more calls`}),i}function Kn(e,t,n,r=!1,i=!1){let a=kn(e.details,n),o=e=>a===void 0?e:{...e,right:a};if(t)return[o({left:`   ${n.fg(`error`,`failed: ${Hn(e)}`)}`})];if(i&&e.details?.result===void 0)return[];let s=e.details?.result;if(s===void 0)return[o({left:`   ${n.fg(`muted`,`done`)}`})];if(Mn(s))return zn(s,{maxDepth:4,maxChildren:6,maxLineChars:120,moreAfter:r}).map((e,t)=>{let n={left:`   ${e}`};return t===0&&a!==void 0?{...n,right:a}:n});let c=On(s);return c===void 0?[o({left:`   ${n.fg(`muted`,`done`)}`})]:[o({left:`   ${n.fg(`dim`,`→ ${c}`)}`})]}function qn(e,t,n,r={}){let i=An(e.details),a=[...Kn({...e,details:i},t,n,!1,r.isPartial===!0)];return i?.subCalls!==void 0&&a.push(...Gn(i.subCalls,n)),new Sn(a)}function Jn(e,t,n,r,i={}){let a=An(e.details);if(n){let t=[...Kn({...e,details:a},!0,r)];a?.subCalls!==void 0&&t.push(...Gn(a.subCalls,r));let n=K(e.content?.find(e=>e.type===`text`)?.text??Hn(e));for(let e of n.split(`
+`).slice(0,12))t.push({left:`   ${r.fg(`error`,e)}`});return new Sn(t)}let o=[],s=t.code??t.script??``;if(s.length>0){let e=s.split(`
+`).map(e=>J(e,120)),t=e.slice(0,3);o.push({label:`code`,lines:t,...e.length>t.length?{more:e.length-t.length}:{}})}if(a!==void 0&&a.surface===`workflow`&&a.phases.length>0){let e=a.phases.slice(0,8),t=a.phases.length>e.length?` …`:``;o.push({label:`phases`,lines:[`${e.join(` → `)}${t}`]})}if(a!==void 0&&a.narrations.length>0){let e=a.narrations.slice(0,12);o.push({label:`log`,lines:e.map(e=>K(e)),...a.narrations.length>e.length?{more:a.narrations.length-e.length}:{}})}if(a!==void 0&&a.logs.length>0){let e=a.logs.slice(0,12);o.push({label:`out`,lines:e.map(e=>K(e)),...a.logs.length>e.length?{more:a.logs.length-e.length}:{}})}if(a!==void 0&&a.warnings.length>0){let e=a.warnings.slice(0,4);o.push({label:`warn`,lines:e.map(e=>K(e)),...a.warnings.length>e.length?{more:a.warnings.length-e.length}:{}})}if(a!==void 0&&a.imageCount>0){let e=a.imageCount===1?`1 image attached`:`${a.imageCount} images attached`;o.push({label:`image`,lines:[e]})}let c=a?.subCalls,l=c!==void 0&&c.length>0||o.length>0,u=Kn({...e,details:a},!1,r,l,i.isPartial===!0);c!==void 0&&u.push(...Gn(c,r));for(let e=0;e<o.length;e+=1){let t=e===o.length-1;u.push(...jn(o[e]??{label:``,lines:[]},t,r))}return new Sn(u)}function Yn(e){return{renderCall(t,n,r){return Bn(t,n,e,{...r?.invalidate===void 0?{}:{requestInvalidate:r.invalidate},...r?.isPartial===void 0?{}:{isPartial:r.isPartial},...r?.state===void 0?{}:{state:r.state}})},renderResult(e,t,n,r){let i=t.isPartial===!0;return t.expanded===!0?Jn(e,r?.args??{},r?.isError===!0,n,{isPartial:i}):qn(e,r?.isError===!0,n,{isPartial:i})}}}const Xn=["Run a TypeScript program that composes pi's tools in one shot. Required arguments: `code` —","the body of an async function (top-level `return` and `await` work; type annotations are","advisory, the code runs type-stripped) — and `description`, a 5-10 word summary of what the",`program does.`,``,"Inside the program, call this session's enabled built-in tools as `tools.<name>(args)` — e.g.",'`await tools.read({ path: "src/index.ts" })` or `await tools.bash({ command: "npm test" })`.',"The bound names mirror the session's active tools (a default session has `read`, `bash`, `edit`,","`write`); calling a name that is not bound rejects with an error the program can catch, and","independent calls may overlap under `Promise.all`.",``,"The parallel binding `pi.dispatch` is always available, registered under its literal dot name —",'call it with string indexing, e.g. `await tools["pi.dispatch"]({ agent: "reviewer", task: "..." })`;',"`tools.pi.dispatch` does not exist. It fans work out to child pi agents, and independent","foreground dispatches compose under `Promise.all` exactly like the built-in calls. The run's","actual bound names (this run, not a static list) are on the `ptcBindings` global, so the program",`never has to guess what is bound.`,``,"Only the program's return value and its `console.log` output come back. This surface has no","helpers: `log` / `phase` / `parallel` / `pipeline` exist only in `ptc_workflow`.",``,"Image-bearing tool results inside the program (a `tools.read` on a PNG, say) are attached to you",`after the run, so never return image data as the completion value — that only spends your context`,`on base64.`].join(`
+`),Zn=x.Object({code:x.String({description:`The program: the body of an async TypeScript function.`}),description:x.String({description:`Clear, concise description of what this program does in active voice, 5-10 words (shown in the UI).`}),timeoutMs:x.Optional(x.Number({description:`Elapsed deadline in milliseconds for the whole run, including tool calls. Omit it (or pass 0) for the default of ${z.timeoutMs/1e3} s; anything above ${z.maxTimeoutMs/1e3} s is capped. The deadline bounds the whole run: if it expires, in-flight foreground dispatches spawned by the program are terminated with it.`}))});function Qn(e={}){return g({name:`ptc_run_code`,label:`PTC Run Code`,description:Xn,promptSnippet:`Run a TypeScript program that composes pi's tools in one shot (tools.<name>(args)); only its return value and console.log come back`,promptGuidelines:[...cn],parameters:Zn,async execute(t,n,r,i,a){let o=un(a),s=q(e.getBindingSourceNames?.()),c=Date.now(),l=e.getPool?.(),u=a.sessionManager?.getSessionDir?.(),d=e.getDispatchDeps?.(),f=dn({surface:`run_code`,startedAt:c,onUpdate:i}),p;try{p=await Ht({code:n.code,surface:`run_code`,cwd:o,bindings:kt({cwd:o,names:s,includeDispatch:!0}),...u===void 0?{}:{sessionDir:u},...d===void 0?{}:{dispatchDeps:d},...e.depth===void 0?{}:{depth:e.depth},...e.parentTaskId===void 0?{}:{parentTaskId:e.parentTaskId},...n.timeoutMs===void 0?{}:{timeoutMs:n.timeoutMs},...r===void 0?{}:{signal:r},...e.config===void 0?{}:{config:e.config},...l===void 0?{}:{pool:l},onSubCallChange:e=>f.update(e)})}finally{f.cancel()}if(p.error!==void 0)throw pn(p);return mn({outcome:p,surface:`run_code`,durationMs:Date.now()-c})},...Yn(`run_code`)})}const $n=[`Run a structured TypeScript workflow: a named plan that reports phases and narration as it`,"goes. `script` is the body of an async function, `meta` names it (`{ name, description, phases? }`,","where `phases` is the ordered plan), and optional `args` is plain-JSON input bound to the","program's `args` global.",``,"Helpers inside the script: `log(message)` narrates progress; `phase(title)` frames the workflow","(titles outside `meta.phases` are reported as warnings); `parallel(thunks)` runs thunks","concurrently, a failed item becoming `null`; `pipeline(items, ...stages)` chains stages per item","with the same per-item `null` on failure. There is no `agent()` helper.",``,"Tools are reachable as `tools.<name>(args)` exactly as in `ptc_run_code`, and the bound names","mirror the session's enabled tools. The parallel binding `pi.dispatch` is always available under",'its literal dot name — call it with string indexing: `await tools["pi.dispatch"]({ agent, task })`;',"the run's actual bound names are on the `ptcBindings` global. What comes back is the script's","return value, its `log`/`phase` narration and its `console.log` output.",``,`Image-bearing tool results inside the script are attached to you after the run — never return`,`image data as the script's value.`].join(`
+`),er=x.Object({meta:x.Object({name:x.String({description:`Short workflow name, shown in the UI.`}),description:x.String({description:`What this workflow does, in active voice.`}),phases:x.Optional(x.Array(x.Object({name:x.String({description:`Phase title, matched against phase(title) calls.`})}),{description:`Ordered plan of the workflow's phases. phase() titles outside this list are reported as warnings.`}))},{description:`Workflow metadata: what this run is and which phases it declares.`}),script:x.String({description:`The program: the body of an async TypeScript function.`}),args:x.Optional(x.Record(x.String(),x.Unknown(),{description:"Plain-JSON input bound to the program's `args` global. No functions, symbols, undefined values or cycles."}))});function tr(t){if(t!==void 0){if(typeof t!=`object`||!t||Array.isArray(t))throw TypeError(`ptc_workflow args must be a plain JSON object, received ${e(t)}`);for(let e of Object.keys(t)){let n=nr(t[e],`args.${e}`,/* @__PURE__ */ new Set);if(n!==void 0)throw TypeError(`ptc_workflow args must be plain JSON: ${n}`)}}}function nr(t,n,r){if(t===null||typeof t==`string`||typeof t==`boolean`)return;if(t===void 0)return`${n} is undefined`;if(typeof t==`number`)return Number.isFinite(t)?void 0:`${n} is ${String(t)}, which is not representable as JSON`;if(typeof t!=`object`)return`${n} is ${e(t)}`;let i=t;if(r.has(i))return`${n} is a circular reference`;r.add(i);try{if(Array.isArray(i)){for(let e=0;e<i.length;e+=1){let t=nr(i[e],`${n}[${e}]`,r);if(t!==void 0)return t}return}let e=Object.getPrototypeOf(i);if(e!==Object.prototype&&e!==null){let e=i.constructor?.name;return`${n} is a ${typeof e==`string`&&e.length>0?e:`non-plain object`}, not plain JSON`}for(let e of Object.keys(i)){let t=nr(i[e],`${n}.${e}`,r);if(t!==void 0)return t}return}finally{r.delete(i)}}function rr(e,t){if(t===void 0||t.length===0)return[];let n=new Set(t),r=/* @__PURE__ */ new Set,i=[];for(let t of e.phases)n.has(t)||r.has(t)||(r.add(t),i.push(`phase "${t}" is not listed in meta.phases (declared: ${[...n].join(`, `)})`));return i}function ir(e={}){return g({name:`ptc_workflow`,label:`PTC Workflow`,description:$n,promptSnippet:`Run a structured TypeScript workflow with named phases, narration (log/phase) and structured concurrency (parallel/pipeline)`,promptGuidelines:[...cn],parameters:er,async execute(t,n,r,i,a){tr(n.args);let o=un(a),s=q(e.getBindingSourceNames?.()),c=Date.now(),l=e.getPool?.(),u=a.sessionManager?.getSessionDir?.(),d=e.getDispatchDeps?.(),f=dn({surface:`workflow`,startedAt:c,onUpdate:i}),p;try{p=await Ht({code:n.script,surface:`workflow`,cwd:o,bindings:kt({cwd:o,names:s,includeDispatch:!0}),...u===void 0?{}:{sessionDir:u},...d===void 0?{}:{dispatchDeps:d},...n.args===void 0?{}:{args:n.args},...e.depth===void 0?{}:{depth:e.depth},...e.parentTaskId===void 0?{}:{parentTaskId:e.parentTaskId},...r===void 0?{}:{signal:r},...e.config===void 0?{}:{config:e.config},...l===void 0?{}:{pool:l},onSubCallChange:e=>f.update(e)})}finally{f.cancel()}if(p.error!==void 0)throw pn(p);let m=n.meta.phases?.map(e=>e.name);return mn({outcome:p,surface:`workflow`,warnings:rr(p,m),durationMs:Date.now()-c})},...Yn(`workflow`)})}var ar=class{#e;constructor(e){this.#e=new Map(e??[])}async readOutput(e){let t=this.#e.get(e);return t===void 0?null:t}async writeOutput(e,t){this.#e.set(e,t)}outputRef(e){return`memory:tasks/${e}/output.log`}};function or(e){return typeof e==`object`&&!!e&&e.code===`ENOENT`}var sr=class{#e;constructor(e){if(e.length===0)throw TypeError(`FileOutputStorage: baseDir is required`);this.#e=e}async readOutput(e){try{return await R(this.#t(e),`utf8`)}catch(e){if(or(e))return null;throw e}}async writeOutput(e,t){let n=k(this.#e,`tasks`,e);await se(n,{recursive:!0}),await de(k(n,`output.log`),t,`utf8`)}outputRef(e){return this.#t(e)}#t(e){return k(this.#e,`tasks`,e,`output.log`)}};function cr(e,t){return Kt(e,`pi-ptc-task-output-`,t===void 0?{}:{fullText:t})}const lr={running:`accent`,stopping:`warning`,succeeded:`success`,failed:`error`,lost:`dim`,canceled:`muted`},ur={running:`●`,stopping:`◐`,succeeded:`✓`,failed:`✗`,lost:`◌`,canceled:`⊘`};var X=class{items;constructor(e){this.items=e}invalidate(){}render(e){let t=Math.max(1,Math.floor(e));return this.items.map(e=>dr(e,t))}};function dr(e,t){let{left:n,right:r}=e;if(r===void 0)return I(n,t,`…`);let i=L(r);if(i>=t)return I(r,t,`…`);let a=I(n,Math.max(0,t-i-1),`…`),o=Math.max(1,t-i-L(a));return a+` `.repeat(o)+r}function fr(e,t){return e.length>t?`${e.slice(0,t-1)}…`:e}function pr(e){return fr((K(e).split(`
+`).find(e=>e.trim().length>0)??``).trim(),120)}function mr(e){return typeof e==`object`&&e?e:{}}function hr(e){return e===`running`||e===`stopping`}function gr(e){let t=Math.max(0,Math.floor(e));if(t<1e3)return`${t}ms`;let n=Math.floor(t/1e3);if(n<60)return`${n}s`;let r=Math.floor(n/60),i=n%60;return r<60?`${r}m${i}s`:`${Math.floor(r/60)}h${String(r%60).padStart(2,`0`)}m`}function _r(e,t){if(hr(e.status))return gr(t-e.createdAt);if(e.durationMs!==void 0)return gr(e.durationMs);if(e.finishedAt!==void 0)return gr(e.finishedAt-e.createdAt)}function vr(e,t){let{state:n}=t;t.isLive?n.interval??=setInterval(()=>t.requestInvalidate(),1e3):n.interval!==void 0&&(clearInterval(n.interval),n.interval=void 0);let r=e;return r.dispose=()=>{n.interval!==void 0&&(clearInterval(n.interval),n.interval=void 0)},e}function yr(){}function br(e,t,n){return new X([{left:`└─ ${n.fg(`toolTitle`,n.bold(e))}${t.length>0?` ${t}`:``}`}])}function xr(e,t,n){let r=mr(t);switch(e){case`task-list`:{let e=Array.isArray(r.status)?r.status:void 0,t=e!==void 0&&e.length>0?e.join(`,`):`all`,i=typeof r.limit==`number`?` · limit=${r.limit}`:``;return br(`PTC task list`,n.fg(`dim`,`status=${t}${i}`),n)}case`task-output`:{let e=typeof r.taskId==`string`&&r.taskId.length>0?r.taskId:void 0,t=typeof r.sinceBytes==`number`?` · since=${r.sinceBytes}B`:``;return br(`PTC task output`,e===void 0?n.fg(`muted`,`(unknown task)`):`${n.fg(`accent`,e)}${n.fg(`dim`,t)}`,n)}case`task-stop`:{let e=typeof r.taskId==`string`&&r.taskId.length>0?r.taskId:void 0,t=typeof r.reason==`string`&&r.reason.length>0?` · reason=${K(r.reason)}`:``;return br(`PTC task stop`,e===void 0?n.fg(`muted`,`(unknown task)`):`${n.fg(`accent`,e)}${n.fg(`dim`,t)}`,n)}}}function Sr(e,t,n,r){let i=lr[e.status]??`muted`,a=n.fg(i,ur[e.status]??`?`),o=fr(K(e.label),48),s=[`${a} ${n.fg(`text`,o)}`,n.fg(`dim`,K(e.agentName))],c=_r(e,r);return c!==void 0&&s.push(n.fg(`dim`,c)),e.outputBytes!==void 0&&s.push(n.fg(`dim`,`${e.outputBytes}B`)),{left:`   ${t?`└─ `:`├─ `}${s.join(n.fg(`dim`,` · `))}`}}function Cr(e,t){let n=mr(e),r=Array.isArray(n.tasks)?n.tasks:[];if(r.length===0)return vr(new X([{left:`   ${t.theme.fg(`muted`,`(no background tasks)`)}`}]),{isLive:!1,state:t.state,requestInvalidate:t.requestInvalidate});let i=r.some(e=>hr(e.status)),a=r.slice(0,32),o=r.length-a.length,s=a.map((e,n)=>Sr(e,n===a.length-1&&o===0,t.theme,t.now));return o>0&&s.push({left:`   └─ ${t.theme.fg(`dim`,`…+${o} more tasks`)}`}),vr(new X(s),{isLive:t.partial&&i,state:t.state,requestInvalidate:t.requestInvalidate})}function wr(e,t,n){let r=[];if(e!==void 0&&r.push(n.fg(`dim`,`${e}B`)),t&&r.push(n.fg(`warning`,`truncated`)),r.length!==0)return`${n.fg(`dim`,`•`)} ${r.join(n.fg(`dim`,` · `))}`}function Tr(e,t){return`   ${t.fg(`dim`,`full output: `)}${t.fg(`accent`,e)}`}function Er(e,t){let n=mr(e),r=typeof n.output==`string`?n.output:``,i=typeof n.outputBytes==`number`?n.outputBytes:void 0,a=n.outputTruncated===!0,o=typeof n.outputFullPath==`string`&&n.outputFullPath.length>0?n.outputFullPath:void 0,s=wr(i,a,t.theme),c=[];if(r.length>0){let e=K(r).split(`
+`),n=e.slice(0,6);n.forEach((e,n)=>{let r=t.theme.fg(`toolOutput`,fr(e,160));c.push(n===0&&s!==void 0?{left:`   ${r}`,right:s}:{left:`   ${r}`})}),e.length>n.length&&c.push({left:`   ${t.theme.fg(`dim`,`…+${e.length-n.length} more lines`)}`}),a&&o!==void 0&&c.push({left:Tr(o,t.theme)})}else o===void 0?c.push({left:`   ${t.theme.fg(`muted`,`(no output yet)`)}`,...s===void 0?{}:{right:s}}):c.push({left:Tr(o,t.theme),...s===void 0?{}:{right:s}});return new X(c)}function Dr(e,t){let n=mr(e),r=n.task;if(typeof r!=`object`||!r)return new X([{left:`   ${t.theme.fg(`muted`,`(no task)`)}`}]);let i=lr[r.status]??`muted`,a=t.theme.fg(i,ur[r.status]??`?`),o=typeof n.fromStatus==`string`?n.fromStatus:void 0,s=o===void 0?r.status===`stopping`?`running → stopping`:`→ ${String(r.status)}`:`${o} → ${r.status}`,c=[`${a} ${t.theme.fg(`text`,K(r.id))}`,t.theme.fg(i,s)];return typeof r.stopReason==`string`&&r.stopReason.length>0&&c.push(t.theme.fg(`dim`,`reason=${K(r.stopReason)}`)),new X([{left:`   ${c.join(` `)}`}])}function Or(e,t){let n=e.content?.find(e=>e.type===`text`&&(e.text??``).length>0),r=pr(n?.text??``)||`failed`;return new X([{left:`   ${t.fg(`error`,`failed: ${r}`)}`}])}function kr(e,t,n){switch(e){case`task-list`:return Cr(t.details,n);case`task-output`:return Er(t.details,n);case`task-stop`:return Dr(t.details,n)}}function Ar(e){return{renderCall(t,n){return xr(e,t,n)},renderResult(t,n,r,i){return i?.isError===!0?Or(t,r):kr(e,t,{theme:r,partial:n?.isPartial===!0||i?.isPartial===!0,requestInvalidate:i?.invalidate??yr,state:i?.state??{},now:Date.now()})}}}const jr=[`Use ptc_task_list to see the background tasks this session dispatched and their live status.`,`Use ptc_task_output to read a task's captured output (it is tail-truncated; the footer names the full-output file).`,`Use ptc_task_stop to ask a running task to stop; the dispatcher delivers the actual signal, so the task transitions through stopping to canceled.`,`These background-task tools stay callable when PTC mode is off — /ptc off only blocks new dispatches.`],Mr=x.Union([x.Literal(`running`),x.Literal(`stopping`),x.Literal(`succeeded`),x.Literal(`failed`),x.Literal(`canceled`),x.Literal(`lost`)]),Nr=x.Object({status:x.Optional(x.Array(Mr,{description:`Only return tasks in these states. Omit for all six states (running, stopping, succeeded, failed, canceled, lost).`})),limit:x.Optional(x.Number({description:`Maximum number of tasks to return, newest first. Defaults to 100.`}))});function Pr(e){let t=[e.id,e.status,`${e.agentName} depth=${e.depth}`,K(e.label)];return e.outputBytes!==void 0&&t.push(`${e.outputBytes}B`),e.errorMessage!==void 0&&t.push(`error=${K(e.errorMessage)}`),t.join(`  `)}function Fr(e){return g({name:`ptc_task_list`,label:`PTC Task List`,description:[`List the background tasks this session has dispatched (from pi.dispatch({ background: true })).`,`Returns each task's id, status, agent, depth, label and output size, newest first.`,`Filter with status (e.g. ["running"]); limit caps the row count (default 100).`].join(`
+`),promptSnippet:`List background tasks and their live status (id, status, agent, label, output size)`,promptGuidelines:[...jr],parameters:Nr,async execute(t,n){let r=await e.query({...n.status===void 0?{}:{status:n.status},limit:n.limit??100,orderBy:`createdAt-desc`});return{content:[{type:`text`,text:r.length===0?`(no background tasks)`:r.map(e=>Pr(e)).join(`
+`)}],details:{tasks:r,count:r.length}}},...Ar(`task-list`)})}async function Ir(e,t,n){let r=await e.get(t);if(r===null)throw Error(`${n}: unknown taskId ${t}`);return r}const Lr=x.Object({taskId:x.String({description:`The background task's id (as returned by ptc_task_list or the dispatch handle).`}),sinceBytes:x.Optional(x.Number({description:`Skip this many bytes of the stored output before returning it. Use for paging larger logs; defaults to 0.`}))});function Rr(e,t){return g({name:`ptc_task_output`,label:`PTC Task Output`,description:[`Read a background task's captured output.`,`The text is tail-truncated to pi's ADR-0015 limits (50 KB / 2000 lines); when anything is cut, outputFullPath names a file with the complete output.`,`Pass sinceBytes to skip a prefix of the stored output when paging.`].join(`
+`),promptSnippet:`Read a background task's output (tail-truncated, with the full-output file path)`,promptGuidelines:[...jr],parameters:Lr,async execute(n,r){let i=r.taskId,a=await Ir(e,i,`ptc_task_output`),o=await t.readOutput(i)??``,s=Buffer.byteLength(o,`utf8`),c=r.sinceBytes??0;if(!Number.isInteger(c)||c<0)throw Error(`ptc_task_output: sinceBytes must be a non-negative integer, got ${String(r.sinceBytes)}`);if(c>s)throw Error(`ptc_task_output: sinceBytes ${c} exceeds the ${s}-byte output of task ${i}`);let l=Buffer.from(o,`utf8`);if(c<s&&((l[c]??0)&192)==128)throw Error(`ptc_task_output: sinceBytes ${c} splits a UTF-8 character in task ${i}; use a byte offset on a character boundary`);let u=cr(c===0?o:l.subarray(c).toString(`utf8`),o),d=s<=2048?o:void 0,f={taskId:i,output:u.text,outputBytes:s,...d===void 0?{}:{outputPreview:d},outputTruncated:u.truncated,...u.fullPath===void 0?{}:{outputFullPath:u.fullPath}};return{content:[{type:`text`,text:f.output.length>0?f.output:`(no output yet; task ${i} is ${a.status})`}],details:f}},...Ar(`task-output`)})}const zr=x.Object({taskId:x.String({description:`The running task's id (as returned by ptc_task_list or the dispatch handle).`}),reason:x.Optional(x.String({description:`Why the task is being stopped; recorded as the task's stopReason. Defaults to "model stop".`}))});function Br(e,t,n={}){if(t==null)throw TypeError(`createPtcTaskStopTool: lifecycle is required`);let r=n.clock??(()=>Date.now());return g({name:`ptc_task_stop`,label:`PTC Task Stop`,description:[`Ask a running background task to stop.`,`The task moves to "stopping"; the dispatcher sends the signal and records the terminal "canceled" state when the child exits.`,`The call is idempotent when the task is already stopping, and errors when the task is already terminal.`].join(`
+`),promptSnippet:`Ask a background task to stop (dispatcher delivers the signal)`,promptGuidelines:[...jr],parameters:zr,async execute(t,n){let i=n.taskId,a=await Ir(e,i,`ptc_task_stop`),o=a.spawnSource.callerId.length>0?a.spawnSource.callerId:`ptc_task_stop`,{record:s,fromStatus:c}=await e.transition({kind:`stop`,taskId:i,reason:n.reason??`model stop`},{clock:r,callerId:o}),l=s.stopReason===void 0?``:`  reason=${K(s.stopReason)}`;return{content:[{type:`text`,text:`${s.id}  ${s.status}${l}`}],details:{task:s,fromStatus:c??a.status}}},...Ar(`task-stop`)})}var Vr=class{#e;#t=/* @__PURE__ */ new Map;constructor(e={}){this.#e=ke(e.config)}get(e){let t=this.#t.get(e);if(t!==void 0)return t;let n=Oe(),r=new Mt({buildWorkerUrl:Ft,size:this.#e.poolSize,acquireTimeoutMs:this.#e.poolAcquireTimeoutMs,drainGraceMs:this.#e.drainGraceMs,workerOptions:jt({surface:e,env:n,limits:this.#e})});return this.#t.set(e,r),r}async drain(){let e=[...this.#t.values()];this.#t.clear(),await Promise.all(e.map(e=>e.drain()))}};const Hr={warn:e=>{console.warn(`[pi-ptc.notifications] `+e)}};var Ur=class{#e;#t;#n;#r;#i;constructor(e,t={}){this.#e=e,this.#t=t.now??Date.now,this.#n=t.logger??Hr,this.#r=[],this.#i=/* @__PURE__ */ new Map}async subscribe(e,t,n){let r=await this.#e.loadSubscription(e,t);if(r!==null)return r;let i={subscriberId:e,taskId:t,cursor:n??`00000000000000000000`,status:`active`,createdAt:this.#t()};return await this.#e.saveSubscription(i),i}async drainPending(e,t){let n=await this.#o(e,t,`drainPending`);return this.#s(n)}async acknowledgeEvents(e,t,n){await this.#a(e,t,async()=>{let r=await this.#o(e,t,`acknowledgeEvents`);n<=r.cursor||await this.#e.saveSubscription({...r,cursor:n})})}#a(e,t,n){let r=`${e}-${t}`,i=(this.#i.get(r)??Promise.resolve()).then(n),a=i.then(()=>void 0,()=>void 0);return this.#i.set(r,a),a.then(()=>{this.#i.get(r)===a&&this.#i.delete(r)}),i}onIdleWake(e){this.#r.push(e)}async pendingCount(e,t){let n=await this.#o(e,t,`pendingCount`);return(await this.#s(n)).length}async notifyIdle(e,t){let n=await this.drainPending(e,t);if(n.length===0)return n;let r=this.#r.slice();for(let i of r)try{i(e,n)}catch(n){let r=n instanceof Error?n.message:String(n);this.#n.warn(`notifyIdle: idle-wake handler for subscriber ${e} / task ${t} threw: ${r}`)}return n}async#o(e,t,n){let r=await this.#e.loadSubscription(e,t);if(r===null)throw Error(`${n}: unknown subscription for subscriber ${e} / task ${t}`);return r}async#s(e){let t=[];for await(let n of this.#e.loadEvents(e.subscriberId,e.cursor===`00000000000000000000`?void 0:e.cursor))n.taskId===e.taskId&&t.push(n);return t}};const Wr={mkdir:(e,t)=>se(e,t),readFile:(e,t)=>R(e,t),writeFile:(e,t,n)=>de(e,t,n),appendFile:(e,t,n)=>oe(e,t,n),rename:(e,t)=>le(e,t),unlink:e=>ue(e),readdir:e=>ce(e)};function Gr(e){return typeof e==`object`&&!!e&&e.code===`ENOENT`}function Kr(e){return e instanceof Error?e.message:String(e)}function qr(e,t){return e.eventId<t.eventId?-1:+(e.eventId>t.eventId)}var Jr=class{#e;#t;constructor(e,t={}){if(e.length===0)throw TypeError(`FileTaskStorage: baseDir is required`);this.#e=e,this.#t=t.fs??Wr}async loadTask(e){return await this.#r(this.#f(e))}async saveTask(e){M(e,`saveTask: record is required`),await this.#o(this.#f(e.id),e)}async deleteTask(e){let t=this.#f(e);if(!await this.#c(t))throw Error(`deleteTask: unknown taskId `+e);await this.#t.unlink(t)}async*listTasks(e){let t=this.#l();for(let n of(await this.#s(t)).sort()){if(!n.endsWith(`.json`))continue;let r=await this.#r(k(t,n));r!==null&&(e?.status===void 0||r.status===e.status)&&(e?.label===void 0||r.label===e.label)&&(yield r)}}async loadSubscription(e,t){return await this.#r(this.#p(e,t))}async saveSubscription(e){M(e,`saveSubscription: sub is required`),await this.#o(this.#p(e.subscriberId,e.taskId),e)}async appendEvents(e,t){if(t.length===0){if((await this.#n(e)).length===0)throw Error(`appendEvents: unknown subscriptionId `+e);return}let n=/* @__PURE__ */ new Map;for(let e of t){let t=n.get(e.taskId);t===void 0?n.set(e.taskId,[e]):t.push(e)}let r;for(let t of n.keys())if(await this.loadSubscription(e,t)===null){r=t;break}if(r!==void 0)throw(await this.#n(e)).length===0?Error(`appendEvents: unknown subscriptionId `+e):Error(`appendEvents: no subscription for subscriber `+e+` on task `+r);await this.#t.mkdir(this.#d(),{recursive:!0});for(let[t,r]of n){let n=(r.every((e,t)=>t===0||qr(r[t-1],e)<=0)?r:[...r].sort(qr)).map(e=>JSON.stringify(e)).join(`
+`)+`
+`;await this.#t.appendFile(this.#m(e,t),n,{encoding:`utf8`})}}async*loadEvents(e,t){let n=await this.#n(e);if(n.length===0)throw Error(`loadEvents: unknown subscriptionId `+e);let r=[];for(let t of n)r.push(...await this.#a(this.#m(e,t.taskId)));r.sort(qr);for(let e of r)t!==void 0&&e.eventId<=t||(yield e)}async#n(e){let t=this.#u(),n=[];for(let r of await this.#s(t)){if(!r.endsWith(`.json`))continue;let i=await this.#r(k(t,r));i!==null&&i.subscriberId===e&&n.push(i)}return n}async#r(e){let t;try{t=await this.#t.readFile(e,{encoding:`utf8`})}catch(e){if(Gr(e))return null;throw e}return this.#i(e,t)}#i(e,t){let n;try{n=JSON.parse(t)}catch(t){throw Error(`FileTaskStorage: corrupt JSON in `+e+`: `+Kr(t))}if(typeof n!=`object`||!n||Array.isArray(n))throw Error(`FileTaskStorage: corrupt JSON in `+e+`: expected a JSON object`);return n}async#a(e){let t;try{t=await this.#t.readFile(e,{encoding:`utf8`})}catch(e){if(Gr(e))return[];throw e}let n=[];for(let r of t.split(`
+`)){let t=r.trim();if(t.length===0)continue;let i;try{i=JSON.parse(t)}catch(t){throw Error(`FileTaskStorage: corrupt event JSON in `+e+`: `+Kr(t))}if(typeof i!=`object`||!i||Array.isArray(i))throw Error(`FileTaskStorage: corrupt event JSON in `+e+`: expected a JSON object`);n.push(i)}return n}async#o(e,t){await this.#t.mkdir(O(e),{recursive:!0});let n=e+`.tmp-`+j();await this.#t.writeFile(n,JSON.stringify(t,null,2),{encoding:`utf8`}),await this.#t.rename(n,e)}async#s(e){try{return await this.#t.readdir(e)}catch(e){if(Gr(e))return[];throw e}}async#c(e){try{return await this.#t.readFile(e,{encoding:`utf8`}),!0}catch(e){if(Gr(e))return!1;throw e}}#l(){return k(this.#e,`tasks`)}#u(){return k(this.#e,`subscriptions`)}#d(){return k(this.#e,`events`)}#f(e){return k(this.#l(),e+`.json`)}#p(e,t){return k(this.#u(),e+`-`+t+`.json`)}#m(e,t){return k(this.#d(),e+`-`+t+`.jsonl`)}};function Yr(e,t){return new Jr(e,t)}const Xr=/* @__PURE__ */ new Set([`succeeded`,`failed`,`canceled`,`lost`]),Zr=/* @__PURE__ */ new Set([`running`,`stopping`]),Qr=2**53-1,$r={info:()=>void 0,warn:e=>{console.warn(`[pi-ptc.background] `+e)}};function Z(e){return e instanceof Error?e.message:String(e)}function ei(e){return e===void 0||e.length===0?`<in-memory>`:e}function ti(e){let t=e.spawnSource.callerId;return t.length>0?t:e.id}var ni=class{#e;#t=/* @__PURE__ */ new Map;constructor(e){this.#e=e}setCurrent(e){this.#e=e}async transition(e,t){let n=e.kind===`spawn`?this.#e:this.#t.get(e.taskId)??this.#e,r=await n.transition(e,t);return e.kind===`spawn`&&this.#t.set(r.record.id,n),r}query(e){return this.#e.query(e)}get(e){return this.#e.get(e)}onTransition(e){return this.#e.onTransition(e)}reconcileLostTasks(){return this.#e.reconcileLostTasks()}},ri=class{#e;constructor(e){this.#e=e}setCurrent(e){this.#e=e}readOutput(e){return this.#e.readOutput(e)}writeOutput(e,t){return this.#e.writeOutput(e,t)}outputRef(e){return this.#e.outputRef(e)}},ii=class{#e;#t=[];constructor(e){this.#e=e}setCurrent(e){this.#e=e;for(let t of this.#t)e.onIdleWake(t)}current(){return this.#e}subscribe(e,t,n){return this.#e.subscribe(e,t,n)}drainPending(e,t){return this.#e.drainPending(e,t)}acknowledgeEvents(e,t,n){return this.#e.acknowledgeEvents(e,t,n)}onIdleWake(e){this.#t.push(e),this.#e.onIdleWake(e)}pendingCount(e,t){return this.#e.pendingCount(e,t)}notifyIdle(e,t){return this.#e.notifyIdle(e,t)}},ai=class{#e;#t=/* @__PURE__ */ new Set;#n=/* @__PURE__ */ new Map;constructor(e){this.#e=e}isLive(e){return this.#t.has(e)}trackReapCancel(e,t){this.#n.set(e,t)}spawn(e,t){let n=this.#e.spawn(e,t);return this.#t.add(n),n}kill(e,t){this.#e.kill(e,t)}events(e){return this.#e.events(e)}async exit(e){try{return await this.#e.exit(e)}finally{this.#t.delete(e);let t=this.#n.get(e);t!==void 0&&(this.#n.delete(e),t())}}stderr(e){return this.#e.stderr(e)}liveHandles(){return[...this.#t]}},oi=class{registry;outputStorage;pipeline;slots;lifecycle;dispatchDeps;clock;#e;#t;#n;#r;#i;#a=!1;constructor(e){this.clock=e.clock??(()=>Date.now()),this.#e=e.logger??$r,this.#r=e.owner??{pid:process.pid,bootMs:this.clock()},this.#i=e.isPidAlive??ze,this.#t=e.createStorage??(e=>e===void 0||e.length===0?new Ge:Yr(e)),this.#n=e.createOutputStorage??(e=>e===void 0||e.length===0?new ar:new sr(e));let t=new Ge,n=He(t,{clock:this.clock,logger:this.#e,owner:this.#r,isPidAlive:this.#i}),r=new Ur(t,{now:this.clock,logger:this.#e});this.registry=new ni(n),this.outputStorage=new ri(new ar),this.pipeline=new ii(r),this.lifecycle=new ai((e.createLifecycle??(()=>new Ee({logger:this.#e})))()),this.slots=new Ke(e.concurrency??z.dispatchConcurrency),this.dispatchDeps={taskRegistry:this.registry,lifecycle:this.lifecycle,slots:this.slots,outputStorage:this.outputStorage,clock:this.clock,logger:this.#e},this.registry.onTransition(this.#o)}#o=(e,t)=>{this.#a||Xr.has(e.status)&&this.pipeline.notifyIdle(t.subscriptionId,e.id).catch(t=>{this.#e.warn(`terminal notification wake for task `+e.id+` failed: `+Z(t))})};async bindSession(e,t){let n,r;try{n=this.#t(e),r=this.#n(e)}catch(n){return this.#s(`background runtime: session storage for `+ei(e)+` is unavailable: `+Z(n),t),[]}let i=He(n,{clock:this.clock,logger:this.#e,owner:this.#r,isPidAlive:this.#i}),a=new Ur(n,{now:this.clock,logger:this.#e});this.registry.setCurrent(i),this.outputStorage.setCurrent(r),this.pipeline.setCurrent(a),this.#a=!1;try{return await i.reconcileLostTasks()}catch(e){return this.#s(`background runtime: startup reconcile failed; stale running tasks were not all marked lost (reconcile is not per-record tolerant yet): `+Z(e),t),[]}finally{this.registry.onTransition(this.#o)}}async drainNotifications(e){let t;try{t=await this.registry.query({limit:Qr})}catch(t){return this.#e.warn(`drainNotifications: could not list tasks for subscriber `+e+`: `+Z(t)),{items:[],acks:[]}}let n=[],r=[],i=this.pipeline.current();for(let a of t){if(a.spawnSource.callerId!==e)continue;let t;try{t=await i.drainPending(e,a.id)}catch(t){this.#e.warn(`drainNotifications: task `+a.id+` for subscriber `+e+`: `+Z(t));continue}for(let e of t)n.push({event:e,record:a});let o=t[t.length-1];o!==void 0&&r.push({subscriberId:e,taskId:a.id,cursor:o.eventId,sink:i})}return{items:n,acks:r}}async acknowledgeNotifications(e){for(let t of e)try{await t.sink.acknowledgeEvents(t.subscriberId,t.taskId,t.cursor)}catch(e){this.#e.warn(`acknowledgeNotifications: could not acknowledge task `+t.taskId+`: `+Z(e))}}async shutdown(e){if(this.#a)return[];this.#a=!0;let t;try{t=await this.registry.query({limit:Qr})}catch(e){this.#e.warn(`shutdown: could not list tasks: `+Z(e)),t=[]}let n=[];for(let r of t)if(Zr.has(r.status)&&Re(r,this.#r))try{let t=await this.registry.transition({kind:`reconcile-lost`,taskId:r.id,reason:e},{clock:this.clock,callerId:ti(r),logger:this.#e});n.push(t.record)}catch(e){this.#e.warn(`shutdown: could not mark task `+r.id+` lost: `+Z(e))}for(let e of this.lifecycle.liveHandles()){let t=tt(this.lifecycle,e,{isDone:()=>!this.lifecycle.isLive(e),unref:!0});this.lifecycle.trackReapCancel(e,t)}for(let e of n)this.slots.release(e.id);return n}#s(e,t){if(this.#e.warn(e),t!==void 0)try{t(e)}catch(e){this.#e.warn(`bindSession reporter threw: `+Z(e))}}};function si(e={}){return new oi(e)}const ci=/* @__PURE__ */ new Set([`succeeded`,`failed`,`lost`]);function li(e){return ci.has(e.status)}function ui(e,t){if(e.length===0)return``;let n=e.map(fi).join(`
+`);return`${`<bg-task-notifications batch-id="${Q(t.batchId)}" delivered-at-ms="${t.deliveredAtMs}">`}\n${n}\n</bg-task-notifications>`}function di(e,t=102400){let n=[],r=[],i=0,a=t-mi;for(let t of e){let e=pi(t);r.length>0&&i+1+e>a&&(n.push(r),r=[],i=0),r.length>0&&(i+=1),r.push(t),i+=e}return r.length>0&&n.push(r),n}function fi(e){let{event:t,record:n}=e,r=t.outputBytes??n.outputBytes,i=r??0,a=t.outputPreview??n.outputPreview,o=[`  <bg-task-notification`,`    id="${Q(t.type)}"`,`    task-id="${Q(t.taskId)}"`,`    subscription-id="${Q(t.subscriptionId)}"`,`    status="${Q(t.status)}"`,`    label="${Q(n.label)}"`,`    agent-name="${Q(n.agentName)}"`,`    depth="${n.depth}"`,`    duration-ms="${n.durationMs??0}"`,`    transition-at-ms="${t.transitionAtMs}">`,`    <output-bytes>${i}</output-bytes>`];return n.outputRef!==void 0&&o.push(`    <output-ref>${Q(n.outputRef)}</output-ref>`),r!==void 0&&r<=2048&&a!==void 0&&o.push(`    <output-preview>${Q(a)}</output-preview>`),o.push(`  </bg-task-notification>`),o.join(`
+`)}function Q(e){return e.replaceAll(`&`,`&amp;`).replaceAll(`<`,`&lt;`).replaceAll(`"`,`&quot;`).replaceAll(`	`,`&#9;`).replaceAll(`
+`,`&#10;`).replaceAll(`\r`,`&#13;`)}function pi(e){return Buffer.byteLength(fi(e),`utf8`)}const mi=Buffer.byteLength(`<bg-task-notifications batch-id="${`0`.repeat(26)}" delivered-at-ms="${`9`.repeat(13)}">\n\n</bg-task-notifications>`,`utf8`),hi=[`ptc_run_code`,`ptc_workflow`],gi=[`read`,`bash`,`edit`,`write`],_i=`ptc-mode`,vi=`ptc-mode`,yi=`ptc.json`,bi=`builtins-only`;function xi(){return{enabled:!1,base:void 0,ourLoadout:void 0}}function Si(e){let t=k(e,yi),n;try{n=T(t,`utf8`)}catch{return{defaultMode:!0,source:`default`}}let r;try{r=JSON.parse(n)}catch(e){return{defaultMode:!0,source:`invalid`,error:`${t} is not valid JSON (${e instanceof Error?e.message:String(e)})`}}if(typeof r!=`object`||!r||Array.isArray(r))return{defaultMode:!0,source:`invalid`,error:`${t} must contain a JSON object`};let i=r.defaultMode;return i===void 0?{defaultMode:!0,source:`default`}:typeof i==`boolean`?{defaultMode:i,source:`file`}:{defaultMode:!0,source:`invalid`,error:`${t}: "defaultMode" must be a boolean, received ${typeof i}`}}function Ci(e){return[...new Set(e)]}function wi(e,t){if(e.length!==t.length)return!1;let n=[...e].sort(),r=[...t].sort();return n.every((e,t)=>e===r[t])}function Ti(e,t){let n=e=>hi.includes(e);if(t===`all-but-ptc`)return Ci(e.filter(n));let r=new Set(V);return Ci(e.filter(e=>n(e)||!r.has(e)))}function Ei(e){let{mode:t,defaultMode:n,active:r,manual:i}=e;return t===`tui`?!n&&!i?{enter:!1,reason:`config-off`}:hi.some(e=>r.includes(e))?!i&&gi.filter(e=>!r.includes(e)).length>0?{enter:!1,reason:`restricted-session`}:{enter:!0,base:Ci(r),loadout:Ti(r,e.hide??`builtins-only`)}:{enter:!1,reason:`tools-unavailable`}:{enter:!1,reason:`not-tui`}}function Di(e,t){return e.enabled&&e.base!==void 0?e.base:t}function Oi(e,t){return!e.enabled||e.ourLoadout===void 0?!1:!wi(e.ourLoadout,t)}function ki(e,t){let n=t.length>0&&t.every(e=>hi.includes(e));return e?.enabled===!0&&n&&e.base!==void 0?{base:e.base,restoreFirst:!0}:{base:t,restoreFirst:!1}}function Ai(e,t){let n=t===`all-but-ptc`?`Every built-in tool is hidden from you, and so are other extensions' tools.`:`The built-in tools (read, bash, edit, write, grep, find, ls) are hidden from you.`,r=e.map(e=>`tools.${e}(args)`),i=e.slice(0,2).map(e=>e===`read`?`await tools.read({ path: "src/index.ts" })`:e===`bash`?`await tools.bash({ command: "pnpm test" })`:`await tools.${e}({ /* … */ })`).join(`
+`);return[`[PTC MODE ACTIVE]`,`This session runs in PTC mode. `+n,``,`Work by writing one TypeScript program per task and running it:`,`  - ptc_run_code for a plain program (its return value and console.log come back to you)`,`  - ptc_workflow when the task has named phases and you want narration (log / phase /`,`    parallel / pipeline are available there)`,``,`The program body is an async function. Available inside it: ${r.join(`, `)}, plus the`,'parallel binding `tools["pi.dispatch"](args)` — always bound, and its dot name needs string',"indexing (`tools.pi.dispatch` does not exist). The run's actual bound names are on the","`ptcBindings` global, so a program never has to guess what is bound this run.",i.length>0?`Examples:\n${i}`:``,``,`Batch a task's steps into ONE program instead of issuing many tool calls — gathering`,`intermediate output yourself and returning only what matters is the point of this mode.`,`Image-bearing tool results inside a program are attached to you after the run — never return`,`base64 image data as your program's value.`,`If the PTC surfaces cannot express what you need, say so and the user can run /ptc off.`].filter(e=>e.length>0).join(`
+`)}const ji=[`read`,`bash`],Mi=`Use the read tool to load a skill's file when the task matches its description.`,Ni=`Use tools.read({ path }) inside a ptc_run_code program to load a skill's file when the task matches its description.`;function Pi(e){return!ji.some(t=>e.includes(t))}function Fi(e,t=v){let n=t([...e],`read`).trim();return n.length===0?``:n.includes(Mi)?n.replace(Mi,Ni):`${Ni}\n\n${n}`}const $=bi;function Ii(e,t){return[`PTC mode on — ${t===`all-but-ptc`?`all other tools`:`built-in tools (now reachable only as tools.<name> inside a program)`} hidden.`,`Bindings available inside a program: ${q(e).join(`, `)||`(none)`}.`,`Run /ptc off to restore the normal tool set.`].join(`
+`)}function Li(e,t={}){let n=xi(),r=!1,i=new Vr,a=()=>Di(n,e.getActiveTools()),o=on(),s=sn(),c=t.backgroundRuntime??si(),l=!1,u=e=>{console.warn(`[pi-ptc.background] `+e)},d=t=>{if(t.length!==0){if(l){e.sendMessage({customType:`bg-task-notification`,content:t,display:!1},{deliverAs:`steer`});return}e.sendUserMessage(t)}},f=async e=>{let{items:t,acks:n}=await c.drainNotifications(e),r=t.filter(e=>li(e.record));for(let e of di(r))d(ui(e,{batchId:ve(),deliveredAtMs:c.clock()}));await c.acknowledgeNotifications(n)},p=async()=>{let e=await c.registry.query({limit:2**53-1}),t=/* @__PURE__ */ new Set;for(let n of e){let e=n.spawnSource.callerId;e.length>0&&t.add(e)}return[...t]},m=async()=>{for(let e of await p())await f(e)},h=async e=>{let t=/* @__PURE__ */ new Set;for(let n of e){let e=n.spawnSource.callerId;e.length>0&&t.add(e)}for(let e of t)await f(e)};c.pipeline.onIdleWake(e=>{f(e).catch(e=>{u(`notification delivery failed: `+(e instanceof Error?e.message:String(e)))})}),e.registerTool(Qn({getBindingSourceNames:a,getPool:()=>i.get(`run_code`),depth:o,...s===void 0?{}:{parentTaskId:s},getDispatchDeps:()=>c.dispatchDeps})),e.registerTool(ir({getBindingSourceNames:a,getPool:()=>i.get(`workflow`),depth:o,...s===void 0?{}:{parentTaskId:s},getDispatchDeps:()=>c.dispatchDeps})),e.registerTool(Fr(c.registry)),e.registerTool(Rr(c.registry,c.outputStorage)),e.registerTool(Br(c.registry,c.lifecycle,{clock:c.clock})),e.on(`turn_start`,async()=>{l=!0}),e.on(`agent_settled`,async()=>{l=!1;try{await m()}catch(e){u(`agent_settled delivery failed: `+(e instanceof Error?e.message:String(e)))}}),e.on(`turn_end`,async()=>{let e=i;i=new Vr,await e.drain()});let g=e=>{e.ui.setStatus(vi,n.enabled?e.ui.theme.fg(`accent`,`PTC`):void 0)},_=(t,i,a,o)=>{n.enabled=!0,n.base=t,n.ourLoadout=i,e.setActiveTools([...i]),r=!0,e.appendEntry(_i,{enabled:!0,base:[...t]}),g(a),a.ui.notify(o,`info`)},v=(t,i)=>{let a=n.base;n.enabled=!1,n.base=void 0,n.ourLoadout=void 0,r=!1,a!==void 0&&e.setActiveTools([...a]),e.appendEntry(i.customType,{enabled:!1}),g(t),i.announce&&t.ui.notify(`PTC mode off — built-in tools are directly callable again.`,`info`)},b=e=>{let t=e.sessionManager.getEntries();for(let e=t.length-1;e>=0;--e){let n=t[e];if(n?.type!==`custom`||n.customType!==`ptc-mode`)continue;let r=n.data,i=Array.isArray(r?.base)?r.base.filter(e=>typeof e==`string`):void 0;return{enabled:r?.enabled===!0,...i===void 0?{}:{base:i}}}};e.registerCommand(`ptc`,{description:`Show or toggle PTC mode (built-in tools reachable only from inside a PTC program)`,handler:async(t,r)=>{let i=t.trim().toLowerCase();if(i===`off`){if(!n.enabled){r.ui.notify(`PTC mode is already off.`,`info`);return}v(r,{announce:!0,customType:_i});return}if(i!==`on`){r.ui.notify(n.enabled?`PTC mode is ON — run /ptc off to restore built-in tools.\nBindings: ${q(n.base).join(`, `)||`(none)`}`:`PTC mode is OFF — run /ptc on to enter it.`,`info`);return}if(n.enabled){r.ui.notify(`PTC mode is already on.`,`info`);return}let a=Ei({mode:r.mode,defaultMode:!0,active:e.getActiveTools(),manual:!0,hide:$});if(!a.enter){r.ui.notify(a.reason===`tools-unavailable`?`Cannot enter PTC mode: ptc_run_code / ptc_workflow are not active in this session.`:`Cannot enter PTC mode in this run mode.`,`warning`);return}_(a.base,a.loadout,r,Ii(a.base,$))}}),e.on(`session_start`,async(t,n)=>{l=!1;let r=await c.bindSession(n.sessionManager?.getSessionDir?.(),e=>n.ui.notify(e,`warning`));try{await h(r)}catch(e){u(`startup reconcile delivery failed: `+(e instanceof Error?e.message:String(e)))}let i=Si(y());i.error!==void 0&&n.ui.notify(`pi-ptc-subagents: ${i.error}`,`warning`);let a=b(n),{base:o,restoreFirst:s}=ki(a,e.getActiveTools());s&&e.setActiveTools([...o]);let d=Ei({mode:n.mode,defaultMode:i.defaultMode,active:o,manual:!1,hide:$}),f=a?.enabled??d.enter;if(d.enter&&f){_(o,d.loadout,n,Ii(o,$));return}g(n),!d.enter&&d.reason!==`not-tui`&&a===void 0&&d.reason===`restricted-session`&&n.ui.notify(`PTC mode skipped: this session was launched with an explicit tool restriction.`,`info`)}),e.on(`session_shutdown`,async()=>{l=!1;try{await c.shutdown(`session_ended_while_running`)}catch(e){u(`session shutdown failed: `+(e instanceof Error?e.message:String(e)))}});let x=!1,S=(e,t)=>{if(e===void 0)return;if(!n.enabled||!t){x&&=(delete e.sections.skills,!1);return}let r=Fi(e.skills);r.length!==0&&(e.sections.skills=r,x=!0)};e.on(`before_agent_start`,async(t,i)=>{let a=t.systemPromptOptions;if(S(a,Pi(e.getActiveTools())),n.enabled){if(Oi(n,e.getActiveTools())){v(i,{announce:!1,customType:_i}),S(a,Pi(e.getActiveTools())),i.ui.notify(`PTC mode off — another extension changed the active tool set.`,`warning`);return}if(r)return r=!1,{message:{customType:`ptc-mode-briefing`,content:Ai(q(n.base),$),display:!1}}}})}export{V as BUILTIN_BINDING_NAMES,Et as DEFAULT_BINDING_NAMES,z as DEFAULT_CONFIG,bi as DEFAULT_HIDE_STRATEGY,o as HOST_FRAME_KIND,qt as MAX_LINE_CHARS,gi as MODE_REQUIRED_TOOL_NAMES,n as PTC_ERROR_KIND,i as PTC_LOG_LEVEL,yi as PTC_MODE_CONFIG_FILE,_i as PTC_MODE_ENTRY_TYPE,vi as PTC_MODE_STATUS_KEY,hi as PTC_MODE_TOOL_NAMES,Ni as PTC_SKILL_LOAD_INSTRUCTION,ji as SKILL_READING_TOOL_NAMES,Vr as TurnPools,De as WORKER_ENV_ALLOW_LIST,t as WORKER_FRAME_KIND,Mt as WorkerPool,Di as bindingSource,Ai as buildModeInstruction,Fi as buildPtcSkillsSection,kt as createBuiltinBindings,Oe as createWorkerEnv,Ei as decideModeEntry,Li as default,Oi as detectExternalLoadoutChange,Ae as effectiveTimeoutMs,xi as initialModeState,Ti as modeLoadout,Si as readDefaultModeConfig,an as renderModelValue,ki as resolveBaseOnStart,ke as resolveConfig,Ht as runPtcProgram,wi as sameToolSet,K as sanitizeText,Pi as skillsSectionDropped,Yt as stripAnsi};
 //# sourceMappingURL=index.js.map

package/dist/worker.js

@@ -1,4 +1,4 @@
 import{a as e,c as t}from"./protocol-CfOgxz3u.js";import{stripTypeScriptTypes as n}from"node:module";import{parentPort as r,workerData as i}from"node:worker_threads";import{inspect as a}from"node:util";function o(t){let n=t.protocol.hostFrame,r=t.protocol.workerFrame,i=t.protocol.logLevel,a=t.protocol.errorKind,o=`__ptcProgram`,s=`CREATED`,c=0,l,u,d=1,f=0,p=1/0,m=[],h=/* @__PURE__ */ new Map,g,_=()=>globalThis;class v extends Error{toolName;constructor(e,t){super(t),this.name=`ToolCallError`,this.toolName=e}}let y=e=>e instanceof Error?e.message:String(e),b=e=>{if(!(e instanceof Error)||typeof e.stack!=`string`)return;let t=e.stack.split(`
 `),n=[t[0]??``];for(let e of t.slice(1))if(n.push(e),n.length>=6)break;return n.join(`
-`)},x=(e,t=l)=>{if(!t)return!1;try{return t.postMessage(e),!0}catch{return!1}},S=(e,t,n)=>{x({kind:r.log,level:e,text:t},n)},C=(e,t,n,i)=>{x(n===void 0?{kind:r.error,error:{kind:e,message:t}}:{kind:r.error,error:{kind:e,message:t,stack:n}},i)},w=e=>{let t=/* @__PURE__ */ Error(e===`timeout`?`PTC run timed out`:`PTC run was cancelled`);return t.name=`AbortError`,t},T=()=>{let e=/* @__PURE__ */ Error(`the PTC control channel closed before the call completed`);return e.name=`AbortError`,e},E=async()=>{if(f<p){f+=1;return}await new Promise((e,t)=>{m.push({resolve:e,reject:t})})},D=()=>{let e=m.shift();if(e){e.resolve();return}--f},O=e=>{for(;m.length>0;){let t=m.shift();t&&t.reject(e)}},k=e=>{O(e);for(let[t,n]of h)h.delete(t),n.reject(e)},A=()=>{let e=t.workerData;if(typeof e!=`object`||!e)return;let n=e.env;if(typeof n!=`object`||!n||Array.isArray(n))return;let r=n;for(let e of Object.keys(process.env))e in r||delete process.env[e];for(let e of Object.keys(r)){let t=r[e];typeof t==`string`&&(process.env[e]=t)}},j=t=>{let n=/* @__PURE__ */ new Set,r=(t,i)=>{if(t===null)return{ok:!0,value:null};if(typeof t==`string`||typeof t==`boolean`)return{ok:!0,value:t};if(t===void 0)return{ok:!0,value:void 0};if(typeof t==`number`)return Number.isFinite(t)?{ok:!0,value:t}:{ok:!1,reason:`${i} is ${String(t)}, which is not representable as JSON`};if(typeof t!=`object`)return{ok:!1,reason:`${i} is ${e(t)}; results must be lossless JSON`};if(Array.isArray(t)){if(n.has(t))return{ok:!1,reason:`${i} is a circular reference`};n.add(t);let e=[];for(let n=0;n<t.length;n+=1){let a=r(t[n],`${i}[${n}]`);if(!a.ok)return a;e.push(a.value===void 0?null:a.value)}return n.delete(t),{ok:!0,value:e}}let a=Object.getPrototypeOf(t);if(a!==Object.prototype&&a!==null){let e=t.constructor;return{ok:!1,reason:`${i} is a ${e&&typeof e.name==`string`&&e.name.length>0?e.name:`an object`}; results must be plain JSON objects`}}if(n.has(t))return{ok:!1,reason:`${i} is a circular reference`};n.add(t);let o={};for(let e of Object.keys(t)){let n=r(t[e],`${i}.${e}`);if(!n.ok)return n;n.value!==void 0&&(o[e]=n.value)}return n.delete(t),{ok:!0,value:o}};return r(t,`result`)},M=e=>e.map(e=>typeof e==`string`?e:t.inspect(e,{depth:4,breakLength:1/0,colors:!1})).join(` `),N=e=>{let t=t=>(...n)=>{S(t,M(n),e)};_().console={log:t(i.log),info:t(i.info),warn:t(i.warn),error:t(i.error),debug:t(i.debug)}},P=()=>{typeof process.removeAllListeners==`function`&&typeof process.on==`function`&&(process.removeAllListeners(`warning`),process.on(`warning`,e=>{let t=typeof e==`object`&&e?e:void 0,n=t&&typeof t.name==`string`?t.name:`Warning`;if(n===`ExperimentalWarning`)return;let r=t&&typeof t.message==`string`?t.message:String(e);S(i.warn,`${n}: ${r}`)}))},F=e=>{let n=`async function ${o}() {\n${e}\n}`,r=n;try{r=t.stripTypes(n,{mode:`strip`})}catch{r=n}return Function(`${r}\nreturn ${o}();`)},I=async(e,t,n)=>{try{let t;try{t=F(e)}catch(e){C(a.exception,`program failed to compile: ${y(e)}`,b(e),n);return}try{let e=await t(),i=j(e);if(!i.ok){C(a.invalidOutput,i.reason,void 0,n);return}x(i.value===void 0?{kind:r.result}:{kind:r.result,value:i.value},n)}catch(e){C(u??a.exception,y(e),b(e),n)}}finally{await W(t,n)}},L=(e,t)=>async n=>{if(u)throw w(u);await E();try{if(u)throw w(u);let i=d;d+=1;let a=new Promise((e,t)=>{h.set(i,{resolve:e,reject:t})});if(!x({kind:r.call,callId:i,tool:e,args:n},t))throw h.delete(i),new v(e,`${e}() could not be called: the arguments are not transferable or the run has ended`);return await a}finally{D()}},R=e=>{let t=e.callId;if(typeof t!=`number`)return;let n=h.get(t);if(n){if(h.delete(t),e.ok===!0){n.resolve(e.value);return}n.reject(new v(typeof e.tool==`string`?e.tool:`unknown`,typeof e.message==`string`?e.message:`binding call failed`))}},z=e=>{u=e,k(w(e))},B=(e,t)=>{u=void 0;let n=w(e);C(e,n.message,void 0,t)},V=(e,t,n)=>{if(t>n)throw RangeError(`${e}() received ${t} items, exceeding maxItemsPerCall (${n})`)},H=(t,n,i)=>{let a=_();a.args=t===void 0?null:t,a.log=t=>{if(typeof t!=`string`)throw TypeError(`log(message) expects a string, received ${e(t)}`);x({kind:r.narration,message:t},i)},a.phase=t=>{if(typeof t!=`string`)throw TypeError(`phase(title) expects a string, received ${e(t)}`);x({kind:r.phase,title:t},i)},a.parallel=async t=>{if(!Array.isArray(t))throw TypeError(`parallel(thunks) expects an array of functions, received ${e(t)}`);V(`parallel`,t.length,n);for(let n=0;n<t.length;n+=1)if(typeof t[n]!=`function`)throw TypeError(`parallel(thunks) expects functions; item ${n} is ${e(t[n])}`);return await Promise.all(t.map(async e=>{try{return await e()}catch{return null}}))},a.pipeline=async(t,...r)=>{if(!Array.isArray(t))throw TypeError(`pipeline(items, ...stages) expects an array of items, received ${e(t)}`);if(V(`pipeline`,t.length,n),r.length===0)throw TypeError(`pipeline(items, ...stages) requires at least one stage function`);for(let t=0;t<r.length;t+=1)if(typeof r[t]!=`function`)throw TypeError(`pipeline(items, ...stages) expects stage functions; stage ${t} is ${e(r[t])}`);let i=r;return await Promise.all(t.map(async(e,t)=>{try{let n=e;for(let r of i)n=await r(n,e,t);return n}catch{return null}}))}},U=()=>{if(!g)return;let e=_();for(let t of Object.keys(e))g.has(t)||delete e[t];for(let[t,n]of g){let r=Object.getOwnPropertyDescriptor(e,t);if(r===void 0||r.writable!==!1)try{e[t]=n}catch{}}},W=async(e,t)=>{s===`RUNNING`&&e===c&&(k(T()),f=0,u=void 0,d=1,h.clear(),U(),A(),s=`READY`,x({kind:r.ready},t))},G=(e,t,n)=>{U(),u=void 0,f=0,h.clear(),A(),N(n),p=typeof e.maxPendingCalls==`number`&&Number.isFinite(e.maxPendingCalls)&&e.maxPendingCalls>0?e.maxPendingCalls:1/0;let r={},i=Array.isArray(e.bindings)?e.bindings.filter(e=>typeof e==`string`):[];for(let e of i)r[e]=L(e,n);let a=i.join(`, `)||`(none)`,o=Array.isArray(e.bindingCandidates)?e.bindingCandidates:[];for(let e of o)typeof e!=`string`||r[e]||(r[e]=async()=>{throw new v(e,`no binding named "${e}" in this run; available bindings: ${a}`)});if(_().tools=r,e.surface===`workflow`){let t=typeof e.maxItemsPerCall==`number`?e.maxItemsPerCall:0;H(e.args,t,n)}I(typeof e.code==`string`?e.code:``,t,n)},K=(e,t)=>{if(typeof e!=`object`||!e||Array.isArray(e))return;let r=e;if(r.kind===n.init){if(s!==`READY`)return;c+=1;let e=c;s=`RUNNING`,G(r,e,t);return}if(r.kind===n.callResult){R(r);return}if(r.kind===n.cancel){let e=r.reason===`timeout`?`timeout`:`abort`;if(s===`READY`){B(e,t);return}z(e)}};s=`BOOTING`,t.parentPort.on(`message`,e=>{if(typeof e!=`object`||!e)return;let t=e;if(t.kind!==n.connect)return;let i=t.port;if(typeof i!=`object`||!i||typeof i.on!=`function`)return;let a=i;l=a,a.on(`message`,e=>{K(e,a)}),a.on(`close`,()=>{l===a&&k(T())}),P();let o=g===void 0;if(o&&(g=new Map(Object.entries(_()))),s=`READY`,u!==void 0){if(o){B(u,a);return}u=void 0}x({kind:r.ready},a)})}o({parentPort:r,workerData:i,inspect:a,stripTypes:n,protocol:t()});export{};
+`)},x=(e,t=l)=>{if(!t)return!1;try{return t.postMessage(e),!0}catch{return!1}},S=(e,t,n)=>{x({kind:r.log,level:e,text:t},n)},C=(e,t,n,i)=>{x(n===void 0?{kind:r.error,error:{kind:e,message:t}}:{kind:r.error,error:{kind:e,message:t,stack:n}},i)},w=e=>{let t=/* @__PURE__ */ Error(e===`timeout`?`PTC run timed out`:`PTC run was cancelled`);return t.name=`AbortError`,t},T=()=>{let e=/* @__PURE__ */ Error(`the PTC control channel closed before the call completed`);return e.name=`AbortError`,e},E=async()=>{if(f<p){f+=1;return}await new Promise((e,t)=>{m.push({resolve:e,reject:t})})},D=()=>{let e=m.shift();if(e){e.resolve();return}--f},O=e=>{for(;m.length>0;){let t=m.shift();t&&t.reject(e)}},k=e=>{O(e);for(let[t,n]of h)h.delete(t),n.reject(e)},A=()=>{let e=t.workerData;if(typeof e!=`object`||!e)return;let n=e.env;if(typeof n!=`object`||!n||Array.isArray(n))return;let r=n;for(let e of Object.keys(process.env))e in r||delete process.env[e];for(let e of Object.keys(r)){let t=r[e];typeof t==`string`&&(process.env[e]=t)}},j=t=>{let n=/* @__PURE__ */ new Set,r=(t,i)=>{if(t===null)return{ok:!0,value:null};if(typeof t==`string`||typeof t==`boolean`)return{ok:!0,value:t};if(t===void 0)return{ok:!0,value:void 0};if(typeof t==`number`)return Number.isFinite(t)?{ok:!0,value:t}:{ok:!1,reason:`${i} is ${String(t)}, which is not representable as JSON`};if(typeof t!=`object`)return{ok:!1,reason:`${i} is ${e(t)}; results must be lossless JSON`};if(Array.isArray(t)){if(n.has(t))return{ok:!1,reason:`${i} is a circular reference`};n.add(t);let e=[];for(let n=0;n<t.length;n+=1){let a=r(t[n],`${i}[${n}]`);if(!a.ok)return a;e.push(a.value===void 0?null:a.value)}return n.delete(t),{ok:!0,value:e}}let a=Object.getPrototypeOf(t);if(a!==Object.prototype&&a!==null){let e=t.constructor;return{ok:!1,reason:`${i} is a ${e&&typeof e.name==`string`&&e.name.length>0?e.name:`an object`}; results must be plain JSON objects`}}if(n.has(t))return{ok:!1,reason:`${i} is a circular reference`};n.add(t);let o={};for(let e of Object.keys(t)){let n=r(t[e],`${i}.${e}`);if(!n.ok)return n;n.value!==void 0&&(o[e]=n.value)}return n.delete(t),{ok:!0,value:o}};return r(t,`result`)},M=e=>e.map(e=>typeof e==`string`?e:t.inspect(e,{depth:4,breakLength:1/0,colors:!1})).join(` `),N=e=>{let t=t=>(...n)=>{S(t,M(n),e)};_().console={log:t(i.log),info:t(i.info),warn:t(i.warn),error:t(i.error),debug:t(i.debug)}},P=()=>{typeof process.removeAllListeners==`function`&&typeof process.on==`function`&&(process.removeAllListeners(`warning`),process.on(`warning`,e=>{let t=typeof e==`object`&&e?e:void 0,n=t&&typeof t.name==`string`?t.name:`Warning`;if(n===`ExperimentalWarning`)return;let r=t&&typeof t.message==`string`?t.message:String(e);S(i.warn,`${n}: ${r}`)}))},F=e=>{let n=`async function ${o}() {\n${e}\n}`,r=n;try{r=t.stripTypes(n,{mode:`strip`})}catch{r=n}return Function(`${r}\nreturn ${o}();`)},I=async(e,t,n)=>{try{let t;try{t=F(e)}catch(e){C(a.exception,`program failed to compile: ${y(e)}`,b(e),n);return}try{let e=await t(),i=j(e);if(!i.ok){C(a.invalidOutput,i.reason,void 0,n);return}x(i.value===void 0?{kind:r.result}:{kind:r.result,value:i.value},n)}catch(e){C(u??a.exception,y(e),b(e),n)}}finally{await W(t,n)}},L=(e,t)=>async n=>{if(u)throw w(u);await E();try{if(u)throw w(u);let i=d;d+=1;let a=new Promise((e,t)=>{h.set(i,{resolve:e,reject:t})});if(!x({kind:r.call,callId:i,tool:e,args:n},t))throw h.delete(i),new v(e,`${e}() could not be called: the arguments are not transferable or the run has ended`);return await a}finally{D()}},R=e=>{let t=e.callId;if(typeof t!=`number`)return;let n=h.get(t);if(n){if(h.delete(t),e.ok===!0){n.resolve(e.value);return}n.reject(new v(typeof e.tool==`string`?e.tool:`unknown`,typeof e.message==`string`?e.message:`binding call failed`))}},z=e=>{u=e,k(w(e))},B=(e,t)=>{u=void 0;let n=w(e);C(e,n.message,void 0,t)},V=(e,t,n)=>{if(t>n)throw RangeError(`${e}() received ${t} items, exceeding maxItemsPerCall (${n})`)},H=(t,n,i)=>{let a=_();a.args=t===void 0?null:t,a.log=t=>{if(typeof t!=`string`)throw TypeError(`log(message) expects a string, received ${e(t)}`);x({kind:r.narration,message:t},i)},a.phase=t=>{if(typeof t!=`string`)throw TypeError(`phase(title) expects a string, received ${e(t)}`);x({kind:r.phase,title:t},i)},a.parallel=async t=>{if(!Array.isArray(t))throw TypeError(`parallel(thunks) expects an array of functions, received ${e(t)}`);V(`parallel`,t.length,n);for(let n=0;n<t.length;n+=1)if(typeof t[n]!=`function`)throw TypeError(`parallel(thunks) expects functions; item ${n} is ${e(t[n])}`);return await Promise.all(t.map(async e=>{try{return await e()}catch{return null}}))},a.pipeline=async(t,...r)=>{if(!Array.isArray(t))throw TypeError(`pipeline(items, ...stages) expects an array of items, received ${e(t)}`);if(V(`pipeline`,t.length,n),r.length===0)throw TypeError(`pipeline(items, ...stages) requires at least one stage function`);for(let t=0;t<r.length;t+=1)if(typeof r[t]!=`function`)throw TypeError(`pipeline(items, ...stages) expects stage functions; stage ${t} is ${e(r[t])}`);let i=r;return await Promise.all(t.map(async(e,t)=>{try{let n=e;for(let r of i)n=await r(n,e,t);return n}catch{return null}}))}},U=()=>{if(!g)return;let e=_();for(let t of Object.keys(e))g.has(t)||delete e[t];for(let[t,n]of g){let r=Object.getOwnPropertyDescriptor(e,t);if(r===void 0||r.writable!==!1)try{e[t]=n}catch{}}},W=async(e,t)=>{s===`RUNNING`&&e===c&&(k(T()),f=0,u=void 0,d=1,h.clear(),U(),A(),s=`READY`,x({kind:r.ready},t))},G=(e,t,n)=>{U(),u=void 0,f=0,h.clear(),A(),N(n),p=typeof e.maxPendingCalls==`number`&&Number.isFinite(e.maxPendingCalls)&&e.maxPendingCalls>0?e.maxPendingCalls:1/0;let r={},i=Array.isArray(e.bindings)?e.bindings.filter(e=>typeof e==`string`):[];for(let e of i)r[e]=L(e,n);let a=i.join(`, `)||`(none)`,o=Array.isArray(e.bindingCandidates)?e.bindingCandidates:[];for(let e of o)typeof e!=`string`||r[e]||(r[e]=async()=>{throw new v(e,`no binding named "${e}" in this run; available bindings: ${a}`)});if(_().tools=r,_().ptcBindings=Object.freeze([...i]),e.surface===`workflow`){let t=typeof e.maxItemsPerCall==`number`?e.maxItemsPerCall:0;H(e.args,t,n)}I(typeof e.code==`string`?e.code:``,t,n)},K=(e,t)=>{if(typeof e!=`object`||!e||Array.isArray(e))return;let r=e;if(r.kind===n.init){if(s!==`READY`)return;c+=1;let e=c;s=`RUNNING`,G(r,e,t);return}if(r.kind===n.callResult){R(r);return}if(r.kind===n.cancel){let e=r.reason===`timeout`?`timeout`:`abort`;if(s===`READY`){B(e,t);return}z(e)}};s=`BOOTING`,t.parentPort.on(`message`,e=>{if(typeof e!=`object`||!e)return;let t=e;if(t.kind!==n.connect)return;let i=t.port;if(typeof i!=`object`||!i||typeof i.on!=`function`)return;let a=i;l=a,a.on(`message`,e=>{K(e,a)}),a.on(`close`,()=>{l===a&&k(T())}),P();let o=g===void 0;if(o&&(g=new Map(Object.entries(_()))),s=`READY`,u!==void 0){if(o){B(u,a);return}u=void 0}x({kind:r.ready},a)})}o({parentPort:r,workerData:i,inspect:a,stripTypes:n,protocol:t()});export{};
 //# sourceMappingURL=worker.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ptc-subagents",
-  "version": "0.1.3",
+  "version": "1.1.0",
   "description": "DSH PTC mode (ptc_run_code + ptc_workflow) for pi",
   "keywords": [
     "pi",