@gotgenes/pi-subagents 12.1.0 → 13.1.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [13.1.0](https://github.com/gotgenes/pi-packages/compare/pi-subagents-v13.0.0...pi-subagents-v13.1.0) (2026-05-30)
+
+
+### Features
+
+* add createSubagentSession factory ([62c319d](https://github.com/gotgenes/pi-packages/commit/62c319d6703a6f58a829f372b609daea36170987))
+* add SubagentSession with turn-loop and disposal behavior ([69f8f4b](https://github.com/gotgenes/pi-packages/commit/69f8f4bf78431be990a9eb6fbe592e59cc313912))
+* dissolve the runner; Agent drives SubagentSession directly ([fbe71b0](https://github.com/gotgenes/pi-packages/commit/fbe71b02759551e60b4e22e96bb28299e444feb2))
+
+## [13.0.0](https://github.com/gotgenes/pi-packages/compare/pi-subagents-v12.1.0...pi-subagents-v13.0.0) (2026-05-30)
+
+
+### ⚠ BREAKING CHANGES
+
+* the `skills:` custom-agent frontmatter key and skill preloading are removed; children always load the parent's skills.
+* the `extensions:` custom-agent frontmatter key is removed; children always load the parent's extensions.
+* `SpawnOptions.isolated` and the `isolated:` custom-agent frontmatter key are removed. Children always load the parent's extensions.
+
+### Features
+
+* always inherit extensions; make the recursion guard unconditional ([#264](https://github.com/gotgenes/pi-packages/issues/264)) ([3cc682e](https://github.com/gotgenes/pi-packages/commit/3cc682ec401167f922a1f892f6260a10f9fa99f2))
+* always inherit skills; remove noSkills and the skill-preload path ([#264](https://github.com/gotgenes/pi-packages/issues/264)) ([93266ff](https://github.com/gotgenes/pi-packages/commit/93266ff4a204d154b357efac57912330fad240be))
+* remove isolated from the subagent spawn API and lifecycle ([#264](https://github.com/gotgenes/pi-packages/issues/264)) ([d08f340](https://github.com/gotgenes/pi-packages/commit/d08f34066ea472d850423e67349b7a623ca72f42))
+
 ## [12.1.0](https://github.com/gotgenes/pi-packages/compare/pi-subagents-v12.0.0...pi-subagents-v12.1.0) (2026-05-29)
 
 

package/dist/public.d.ts

@@ -25,7 +25,6 @@ interface AgentInvocation {
     modelName?: string;
     thinking?: ThinkingLevel;
     maxTurns?: number;
-    isolated?: boolean;
     inheritContext?: boolean;
     runInBackground?: boolean;
 }
@@ -46,7 +45,7 @@ interface AgentInvocation {
  * The child's working directory is supplied by a registered WorkspaceProvider
  * (the workspace seam); with no provider the child runs in the parent cwd.
  *
- * Phase-specific collaborators (execution, notification) are attached
+ * Phase-specific collaborators (subagentSession, notification) are attached
  * after construction as lifecycle information becomes available.
  */
 
@@ -125,7 +124,6 @@ interface SpawnOptions {
     model?: string;
     maxTurns?: number;
     thinkingLevel?: string;
-    isolated?: boolean;
     inheritContext?: boolean;
     foreground?: boolean;
     bypassQueue?: boolean;

package/docs/architecture/architecture.md

@@ -45,8 +45,6 @@ flowchart TB
         SessionConfig["assembleSessionConfig<br/>(pure assembler)"]
         Prompts["prompts<br/>(system prompt)"]
         Context["context<br/>(parent history)"]
-        SafeFs["safe-fs<br/>(symlink/name guards)"]
-        SkillLoader["skill-loader<br/>(preload skills)"]
         Env["env<br/>(git/platform)"]
         ModelResolver["model-resolver<br/>(fuzzy match)"]
     end
@@ -55,7 +53,8 @@ flowchart TB
         direction TB
         AgentManager["AgentManager<br/>(spawn, abort, collection)"]
         ConcurrencyQueue["ConcurrencyQueue<br/>(scheduling, drain)"]
-        AgentRunner["agent-runner<br/>(session, turns, results)"]
+        CreateSubagentSession["createSubagentSession<br/>(assembly factory)"]
+        SubagentSession["SubagentSession<br/>(turn loop, steer, dispose)"]
         Agent["Agent<br/>(status, behavior: abort/steer/run lifecycle)"]
         ParentSnapshot["ParentSnapshot<br/>(frozen parent state)"]
         Workspace["workspace<br/>(provider seam: child cwd + teardown)"]
@@ -87,14 +86,15 @@ flowchart TB
     end
 
     AgentTool --> AgentManager
-    AgentManager --> AgentRunner
-    AgentRunner --> SessionConfig
+    AgentManager --> Agent
+    Agent --> CreateSubagentSession & SubagentSession
+    CreateSubagentSession --> SubagentSession
+    CreateSubagentSession --> SessionConfig
     SessionConfig --> AgentTypeRegistry
-    SessionConfig --> Prompts & SkillLoader & Env
-    SkillLoader --> SafeFs
+    SessionConfig --> Prompts & Env
     AgentTypeRegistry --> DefaultAgents & CustomAgents
-    RecordObserver -.->|subscribes| AgentRunner
-    UIObserver -.->|subscribes| AgentRunner
+    RecordObserver -.->|subscribes| SubagentSession
+    UIObserver -.->|subscribes| SubagentSession
     Widget -.->|polls| AgentManager
 ```
 
@@ -111,7 +111,7 @@ classDiagram
         +error?: string
         +toolUses: number
         +lifetimeUsage: LifetimeUsage
-        +execution?: ExecutionState
+        +subagentSession?: SubagentSession
         +notification?: NotificationState
         +markRunning()
         +markCompleted()
@@ -124,13 +124,13 @@ classDiagram
         +resume(prompt, signal)
         +abort(): boolean
         +queueSteer(message)
-        +flushPendingSteers(session)
+        +flushPendingSteers()
         +completeRun(result)
         +failRun(err)
+        +disposeSession()
         +wireSignal(signal, onAbort)
         +attachObserver(unsub)
         +releaseListeners()
-        +setOnRunFinished(fn)
     }
 
     class AgentManager {
@@ -213,24 +213,31 @@ sequenceDiagram
     participant Tool as subagent tool
     participant Spawn as spawn-config
     participant Mgr as AgentManager
-    participant Runner as agent-runner
+    participant Ag as Agent
+    participant Factory as createSubagentSession
     participant Asm as assembleSessionConfig
+    participant Sub as SubagentSession
     participant Child as Child session
 
     LLM->>Tool: subagent(type, prompt, ...)
     Tool->>Spawn: resolveSpawnConfig(params)
     Spawn-->>Tool: ResolvedSpawnConfig
     Tool->>Mgr: spawn(snapshot, type, prompt, config)
-    Mgr->>Runner: runAgent(record, snapshot, options, io)
-    Runner->>Asm: assembleSessionConfig(type, ctx, opts, env, registry, io)
-    Asm-->>Runner: SessionConfig
-    Runner->>Child: create session + run turn loop
-    Child-->>Runner: result text
-    Runner-->>Mgr: update Agent
-    Note over Mgr: agent-observer subscribes to session events for stats
-    Note over Mgr: ui-observer subscribes for streaming state
+    Mgr->>Ag: run()
+    Ag->>Factory: createSubagentSession(params, deps)
+    Factory->>Asm: assembleSessionConfig(type, ctx, opts, env, registry, io)
+    Asm-->>Factory: SessionConfig
+    Factory->>Child: create session + bind extensions
+    Factory-->>Ag: SubagentSession (born complete)
+    Note over Ag: agent-observer + ui-observer subscribe to session events
+    Ag->>Sub: runTurnLoop(prompt, opts)
+    Sub->>Child: prompt + drive turn loop
+    Child-->>Sub: result text
+    Sub-->>Ag: TurnLoopResult
+    Ag-->>Mgr: update Agent
     Mgr-->>Tool: Agent
     Tool-->>LLM: formatted result
+    Note over Mgr: disposeSession() fires `disposed` at cleanup (resume-detectable)
 ```
 
 ## Module organization
@@ -260,19 +267,19 @@ src/
 │   ├── prompts.ts                  system prompt building
 │   ├── content-items.ts            shared message content parsing (tool-call names, assistant content)
 │   ├── context.ts                  parent conversation extraction
-│   ├── safe-fs.ts                  symlink rejection and safe file reads
-│   ├── skill-loader.ts             skill preloading
+│   ├── conversation.ts             render a session's messages as formatted text
 │   ├── env.ts                      git/platform detection
 │   ├── model-resolver.ts           fuzzy model name resolution
 │   └── session-dir.ts              session directory derivation
 │
 ├── lifecycle/                      agent execution and state tracking
 │   ├── agent-manager.ts            collection manager + observer wiring
-│   ├── agent-runner.ts             session creation, turn loop, tool filtering
+│   ├── create-subagent-session.ts  assembly factory: session creation, binding, tool filtering
+│   ├── subagent-session.ts         born-complete child session: turn loop, steer, dispose
+│   ├── turn-limits.ts              normalizeMaxTurns (turn-count policy)
 │   ├── agent.ts                    owns full execution lifecycle (run, abort, steer, workspace)
 │   ├── concurrency-queue.ts        background agent scheduling with configurable concurrency limit
 │   ├── parent-snapshot.ts          immutable spawn-time parent state
-│   ├── execution-state.ts          session/output phase state
 │   ├── child-lifecycle.ts          child-execution lifecycle event publisher
 │   ├── workspace.ts                workspace provider seam (generative extension surface)
 │   └── usage.ts                    token usage tracking
@@ -332,7 +339,7 @@ flowchart TD
     subgraph core["@gotgenes/pi-subagents"]
         direction TB
         exports["SubagentsService API<br/>publish / getSubagentsService<br/>SubagentRecord, SubagentStatus"]
-        engine["Tools: subagent, get_subagent_result,<br/>steer_subagent<br/>AgentManager, agent-runner"]
+        engine["Tools: subagent, get_subagent_result,<br/>steer_subagent<br/>AgentManager, createSubagentSession, SubagentSession"]
         ui_int["Internal UI: widget, viewer,<br/>/agents menu"]
     end
 
@@ -349,13 +356,14 @@ They declare this package as an optional peer dependency and use dynamic import
 - The three tools: `subagent` (née `Agent`), `get_subagent_result`, `steer_subagent`.
 - `AgentManager` — spawn, abort, resume, collection management, observer wiring.
 - `ConcurrencyQueue` — background agent scheduling with configurable concurrency limit.
-- `agent-runner` — session creation, turn loop, extension binding.
+- `createSubagentSession` — assembly factory: session creation and extension binding; returns a born-complete `SubagentSession`.
+- `SubagentSession` — the born-complete child session: drives the turn loop (`runTurnLoop`/`resumeTurnLoop`), steers, and disposes (firing `disposed` at true session disposal, so resume executions are registry-detected).
 - `child-lifecycle` — publishes the child-execution lifecycle (`spawning`, `session-created` before `bindExtensions()`, `completed`, `disposed`) on `pi.events`.
   Reactive consumers subscribe: `@gotgenes/pi-permission-system` registers each child session on `session-created` and unregisters it on `disposed`.
   This replaced the former outbound `permission-bridge` (#261, ADR 0002) — the core no longer looks up a named consumer.
 - `workspace` — the single generative seam (#262, ADR 0002): a registered `WorkspaceProvider` supplies a child's cwd plus bracketed `dispose()` at run-start.
   With no provider, children run in the parent cwd (default unchanged); the git worktree strategy lives behind this seam in `@gotgenes/pi-subagents-worktrees` (#263, the seam's first consumer).
-- `session-config` — pure configuration assembler (extracted from `agent-runner`).
+- `session-config` — pure configuration assembler (called by `createSubagentSession`).
 - `SubagentRuntime` — session-scoped state bag with methods.
 - `ParentSnapshot` — immutable snapshot of parent session state, captured once at spawn time.
 - `record-observer` — session-event observer that updates record statistics without callback threading.
@@ -415,7 +423,7 @@ Key types:
 
 - `SubagentsService` — `spawn`, `getRecord`, `listAgents`, `abort`, `steer`, `waitForAll`, `hasRunning`.
 - `SubagentRecord` — serializable agent snapshot (no live session objects).
-- `SpawnOptions` — `description`, `model`, `maxTurns`, `thinkingLevel`, `isolated`, `inheritContext`, `foreground`, `bypassQueue`.
+- `SpawnOptions` — `description`, `model`, `maxTurns`, `thinkingLevel`, `inheritContext`, `foreground`, `bypassQueue`.
 - `SUBAGENT_EVENTS` — channel constants for `pi.events` subscriptions.
 
 ### Accessor pattern
@@ -482,11 +490,11 @@ Latent extensibility is the deliverable; a vacant hook is not.
 ### Core responsibilities (keep)
 
 - **Agent definitions** — name, model, thinking, system prompt, tools list.
-- **Prompt composition** — system prompt assembly, skill preloading into prompt.
+- **Prompt composition** — system prompt assembly.
 - **Session lifecycle** — create child sessions, bind extensions, run conversation loop, track results.
 - **Concurrency management** — queue, abort, resume, max concurrency.
 - **Recursion guard** — remove pi-subagents' own three tools from child sessions (prevent infinite nesting).
-  With `isolated` removed, children always load the parent's resources, so the guard becomes unconditional rather than gated on `cfg.extensions`.
+  With `isolated` removed (#264), children always load the parent's resources, so the guard is unconditional rather than gated on `cfg.extensions`.
   This is the core defending its own invariant, keyed off its own tool names — not policy.
 - **Lifecycle events** — emit awaited, ordered events when child sessions spawn, are created, complete, and are disposed.
 - **Workspace provider seam** — accept a registered `WorkspaceProvider` and consult it for the child's cwd; default to the parent's cwd when none is registered.
@@ -499,7 +507,8 @@ Latent extensibility is the deliverable; a vacant hook is not.
 - **Worktree isolation** (`worktree.ts`, `worktree-isolation.ts`, `GitWorktreeManager`, the `isolation: "worktree"` spawn mode) — environment policy, not core.
   Git worktrees are one *strategy* for choosing the child's working directory; containers, throwaway tmpdirs, and remote sandboxes are others.
   Evicted to `@gotgenes/pi-subagents-worktrees` (#263), the first consumer of the workspace provider seam.
-- **Extension lifecycle control** (`extensions: false`, `isolated`, `noSkills`) — deny-at-use (the in-child permission layer blocking disallowed tool calls) covers what `isolated` pretended to do for tools.
+- **Extension lifecycle control** (`extensions: false`, `isolated`, `noSkills`) — removed in #264.
+  Deny-at-use (the in-child permission layer blocking disallowed tool calls) covers what `isolated` pretended to do for tools.
   Prevent-load (refusing to bind an extension because of load-time side effects, cost, or true sandboxing) is genuinely generative and is left as a *latent* (un-built) provider seam, added only if a real consumer needs it.
 
 ### Composition model
@@ -536,20 +545,21 @@ This is achieved across phases: Phase 14 (strip policy), Phase 16 (invert depend
 These interfaces carry hidden dependencies that obscure true coupling.
 Bags with 10+ fields are the highest priority for decomposition.
 
-| Interface                   | Fields                                                 | Consumers                                         | Severity  |
-| --------------------------- | ------------------------------------------------------ | ------------------------------------------------- | --------- |
-| `ResolvedSpawnConfig`       | 3 nested                                               | foreground-runner, background-spawner, agent-tool | ✓ done    |
-| `AgentSpawnConfig`          | 13 → 13 (ParentSessionInfo nested)                     | agent-manager (internal)                          | ✓ done    |
-| `RunOptions`                | 9 (`RunContext` nested)                                | agent-runner                                      | ✓ done    |
-| `SessionConfig`             | 8 (flat fields, ToolFilterConfig removed)              | agent-runner (output of assembler)                | ✓ done    |
-| `NotificationDetails`       | 10                                                     | notification                                      | Low (DTO) |
-| `ResourceLoaderOptions`     | 10                                                     | agent-runner (SDK bridge)                         | Low (SDK) |
-| `RunnerIO`                  | split → `EnvironmentIO` (3) + `SessionFactoryIO` (5+1) | agent-runner                                      | ✓ done    |
-| `CreateSessionOptions`      | 9                                                      | agent-runner (SDK bridge)                         | Low (SDK) |
-| `AgentToolDeps`             | 8                                                      | agent-tool                                        | ✓ done    |
-| `AgentMenuDeps`             | 8                                                      | agent-menu                                        | ✓ done    |
-| `ConversationViewerOptions` | 8                                                      | conversation-viewer                               | Low       |
-| `AgentInit`                 | 8                                                      | agent                                             | Low       |
+| Interface                     | Fields                                                       | Consumers                                         | Severity  |
+| ----------------------------- | ------------------------------------------------------------ | ------------------------------------------------- | --------- |
+| `ResolvedSpawnConfig`         | 3 nested                                                     | foreground-runner, background-spawner, agent-tool | ✓ done    |
+| `AgentSpawnConfig`            | 13 → 13 (ParentSessionInfo nested)                           | agent-manager (internal)                          | ✓ done    |
+| `CreateSubagentSessionParams` | 6 (snapshot, type, cwd, parentSession, model, thinkingLevel) | create-subagent-session                           | ✓ done    |
+| `TurnLoopOptions`             | 4 (maxTurns, defaultMaxTurns, graceTurns, signal)            | subagent-session                                  | ✓ done    |
+| `SessionConfig`               | 6 (flat fields; extensions/noSkills/extras removed in #264)  | session-config (output of assembler)              | ✓ done    |
+| `NotificationDetails`         | 10                                                           | notification                                      | Low (DTO) |
+| `ResourceLoaderOptions`       | 10                                                           | create-subagent-session (SDK bridge)              | Low (SDK) |
+| `SubagentSessionIO`           | split → `EnvironmentIO` (3) + `SessionFactoryIO` (5+1)       | create-subagent-session                           | ✓ done    |
+| `CreateSessionOptions`        | 9                                                            | create-subagent-session (SDK bridge)              | Low (SDK) |
+| `AgentToolDeps`               | 8                                                            | agent-tool                                        | ✓ done    |
+| `AgentMenuDeps`               | 8                                                            | agent-menu                                        | ✓ done    |
+| `ConversationViewerOptions`   | 8                                                            | conversation-viewer                               | Low       |
+| `AgentInit`                   | 8                                                            | agent                                             | Low       |
 
 ### Complexity hotspots
 
@@ -579,6 +589,22 @@ The prior clone group between `agent-runner.ts` and `message-formatters.ts` was
 The 20-line clone group between `agent-config-editor.ts` and `agent-creation-wizard.ts` was resolved in #217 — extracted into `ui/agent-file-writer.ts` (`writeAgentFile`).
 One 11-line internal clone group remains within `agent-config-editor.ts` (lines 135–145 / 173–183).
 
+### Session encapsulation debt (Law of Demeter) — [#277]
+
+Discovered while planning [#265].
+Consumers reach the raw SDK `AgentSession` through the `Agent.session` getter (`this.subagentSession?.session`) and operate on it directly, instead of telling the owning agent what they want.
+These are Law of Demeter / Tell-Don't-Ask reach-throughs; the fix is intent-revealing methods on the owning object (`Subagent` / `SubagentSession`, introduced by [#265]).
+
+| Reach-through                         | Sites                                               | Missing method                                   |
+| ------------------------------------- | --------------------------------------------------- | ------------------------------------------------ |
+| Steer (buffer-or-deliver, duplicated) | `service-adapter.ts` (~L93), `steer-tool.ts` (~L43) | `Subagent.steer(message)`                        |
+| Conversation viewing                  | `get-result-tool.ts:84`, `agent-menu.ts:255`        | `Subagent.getConversation()`                     |
+| Session-readiness guard               | `agent-tool.ts:111`, `agent-manager.ts:203`         | `Subagent.isSessionReady()`                      |
+| Session disposal                      | `agent-manager.ts:235,309`                          | `SubagentSession.dispose()` — resolved by [#265] |
+
+[#265] introduces `SubagentSession` and routes the run / resume / dispose path (and steering during a run) through it; the consumer-facing reach-throughs above are deferred to [#277].
+The steer buffer-or-deliver decision is duplicated across two call sites — two callers performing the same reach-through plus the same decision is the signal for the missing method.
+
 ### Proposed bag decompositions
 
 #### ResolvedSpawnConfig (15 fields → 3 value objects)
@@ -604,7 +630,6 @@ interface SpawnExecution {
   thinking: ThinkingLevel | undefined;
   inheritContext: boolean;
   runInBackground: boolean;
-  isolated: boolean;
   agentInvocation: AgentInvocation;
 }
 
@@ -648,7 +673,7 @@ export interface RunContext {
 }
 ```
 
-The remaining `RunOptions` fields (`model`, `maxTurns`, `signal`, `isolated`, `thinkingLevel`, `defaultMaxTurns`, `graceTurns`, `onSessionCreated`) are genuine execution parameters.
+The remaining `RunOptions` fields (`model`, `maxTurns`, `signal`, `thinkingLevel`, `defaultMaxTurns`, `graceTurns`, `onSessionCreated`) are genuine execution parameters.
 `RunOptions` now has 9 fields: 1 nested `context: RunContext` (2 per-call fields) plus 8 flat execution fields.
 
 #### SessionConfig (11 fields → extract ToolFilterConfig) — done ([#168][168])
@@ -781,19 +806,22 @@ Removed `worktree.ts`, `worktree-isolation.ts`, `GitWorktreeManager`, and the `i
   From the release carrying #272, all five workspace types are importable by name: `WorkspaceProvider`, `Workspace`, `WorkspacePrepareContext`, `WorkspaceDisposeOutcome`, and `WorkspaceDisposeResult`.
 - Outcome: git leaves the core; worktree users install one package, everyone else pays nothing.
 
-#### Step 4: Remove `isolated` / `extensions: false` / `noSkills` — [#264]
+#### Step 4: Remove `isolated` / `extensions: false` / `noSkills` — [#264] ✅ Delivered
 
-Children always load the parent's extensions and skills; the recursion guard becomes unconditional.
+Children always load the parent's extensions and skills; the recursion guard is now unconditional.
 Deny-at-use (the in-child permission layer) covers tool restriction; prevent-load is left as a latent provider seam (not shipped).
+The `skills` curation axis collapsed symmetrically with `extensions`: `AgentConfig.skills`, the skill-preload path (`skill-loader.ts`, `safe-fs.ts`, `preloadSkills`, `PromptExtras`), `SessionConfig.{extensions,noSkills,extras}`, and the `isolated:` / `extensions:` / `skills:` custom-agent frontmatter keys are all gone.
 
-- Depends on: Step 1 (deny-at-use over events).
-- Outcome: the `isolated`/`extensions`/`noSkills` axis is gone; one fewer conditional in the guard.
+- Depended on: Step 1 (deny-at-use over events).
+- Outcome: the `isolated`/`extensions`/`noSkills`/`skills` axis is gone; the guard is unconditional.
 
-#### Step 5: Born-complete child execution; dissolve the runner — [#265]
+#### Step 5: Born-complete child execution; dissolve the runner — [#265] ✅ Delivered
 
-With the cwd resolved through the provider seam (not relayed by `Agent`), child-session creation produces a born-complete execution (`{ session, outputFile?, dispose() }`).
-`Agent` owns session interaction directly (prompt, steer, abort, resume, turn limits, response collection); `runAgent` / `resumeAgent` / `ConcreteAgentRunner` / `RunOptions` / `RunResult` dissolve.
-Retain `getAgentConversation()` and `normalizeMaxTurns()`.
+`createSubagentSession()` is an assembly factory that returns a born-complete `SubagentSession` (session created, extensions bound, recursion guard applied).
+`SubagentSession` owns turn driving (`runTurnLoop`/`resumeTurnLoop`), steering, and disposal.
+`Agent.run()` is coordination, not assembly; `runAgent` / `resumeAgent` / `ConcreteAgentRunner` / `AgentRunner` / `RunOptions` / `RunResult` / `ExecutionState` dissolved.
+`getAgentConversation()` relocated to `session/conversation.ts`; `normalizeMaxTurns()` to `lifecycle/turn-limits.ts`.
+`disposed` now fires at true session disposal (cleanup), so resume executions are registry-detected (closing the gap deferred from #261).
 
 - Depends on: Steps 2–4.
 - Outcome: the "runner" concept is gone; `Agent.run()` is coordination, not assembly — the structural goal of the abandoned collaborator plan, reached cleanly.
@@ -889,7 +917,7 @@ If they land, upstream gains the peer-dep fix and the two RepOne patches.
 This fork continues independently regardless.
 
 Upstream fixes and ideas are cherry-picked when they align with this fork's scope.
-The upstream test suite is run periodically as a regression canary for the agent-runner core.
+The upstream test suite is run periodically as a regression canary for the session assembly core.
 
 [earendil-works/pi#4207]: https://github.com/earendil-works/pi/issues/4207
 [gotgenes/pi-packages]: https://github.com/gotgenes/pi-packages
@@ -919,3 +947,4 @@ The upstream test suite is run periodically as a regression canary for the agent
 [#263]: https://github.com/gotgenes/pi-packages/issues/263
 [#264]: https://github.com/gotgenes/pi-packages/issues/264
 [#265]: https://github.com/gotgenes/pi-packages/issues/265
+[#277]: https://github.com/gotgenes/pi-packages/issues/277