@pellux/goodvibes-sdk 0.37.1 → 0.38.0

package/dist/platform/state/knowledge-injection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-injection.d.ts","sourceRoot":"","sources":["../../../src/platform/state/knowledge-injection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;CACnD;AAED,KAAK,6BAA6B,GAC9B,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,CAAC,GAC5F,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC;AAEzG,KAAK,uBAAuB,GAAG;IAC7B,MAAM,IAAI,SAAS,YAAY,EAAE,CAAC;IAClC,cAAc,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,0BAA0B,EAAE,CAAC;CAChH,CAAC;AA4FF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAI,GACR,kBAAkB,EAAE,CAgDtB;AAgBD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,SAAS,6BAA6B,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBjH"}
+{"version":3,"file":"knowledge-injection.d.ts","sourceRoot":"","sources":["../../../src/platform/state/knowledge-injection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;CACnD;AAED,KAAK,6BAA6B,GAC9B,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,CAAC,GAC5F,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC;AAEzG,KAAK,uBAAuB,GAAG;IAC7B,MAAM,IAAI,SAAS,YAAY,EAAE,CAAC;IAClC,cAAc,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,0BAA0B,EAAE,CAAC;CAChH,CAAC;AA4FF;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAI,GACR,wBAAwB,EAAE,CA+C5B;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAI,GACR,kBAAkB,EAAE,CAItB;AAgBD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,SAAS,6BAA6B,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBjH"}

package/dist/platform/state/knowledge-injection.js

@@ -69,7 +69,17 @@ function scoreKnowledge(record, taskTokens, scopeTokens) {
     }
     return score;
 }
-export function selectKnowledgeForTask(registry, task, writeScope = [], limit = 3) {
+/**
+ * Full ranking pipeline, unsliced: scores every registry record that clears
+ * the confidence>=55 gate against `task`/`writeScope`, folds in semantic
+ * similarity when the registry supports it, and returns every candidate with
+ * score>0 sorted best-first. `limit` only widens the semantic-search
+ * candidate pool (`Math.max(limit*4,12)`, mirroring the historical
+ * behavior) — it does NOT slice the returned array. Callers that want the
+ * spawn-time top-N behavior should slice the result themselves; see
+ * `selectKnowledgeForTask` below.
+ */
+export function selectKnowledgeForTaskScored(registry, task, writeScope = [], limit = 3) {
     const taskTokens = tokenize(task);
     const scopeTokens = writeScope.flatMap((entry) => tokenize(entry));
     const semanticResults = registry.searchSemantic?.({
@@ -85,7 +95,7 @@ export function selectKnowledgeForTask(registry, task, writeScope = [], limit =
     for (const entry of semanticResults) {
         recordsById.set(entry.record.id, entry.record);
     }
-    const records = [...recordsById.values()]
+    return [...recordsById.values()]
         .filter((record) => record.confidence >= 55)
         .map((record) => {
         const semantic = semanticById.get(record.id);
@@ -96,26 +106,31 @@ export function selectKnowledgeForTask(registry, task, writeScope = [], limit =
     })
         .filter((entry) => entry.score > 0)
         .sort((a, b) => b.score - a.score || b.record.updatedAt - a.record.updatedAt)
-        .map((entry) => entry.record);
-    return records
-        .slice(0, limit)
-        .map((record) => ({
-        id: record.id,
-        cls: record.cls,
-        summary: record.summary,
-        reason: determineReason(record, taskTokens, scopeTokens, semanticById.get(record.id)?.similarity),
-        confidence: record.confidence,
-        reviewState: record.reviewState,
-        trustTier: inferKnowledgeInjectionTrustTier(record.reviewState),
-        useAs: 'reference-material',
-        retention: 'task-only',
-        provenance: {
-            source: 'project-memory',
-            links: record.provenance,
+        .map(({ record, score }) => ({
+        score,
+        injection: {
+            id: record.id,
+            cls: record.cls,
+            summary: record.summary,
+            reason: determineReason(record, taskTokens, scopeTokens, semanticById.get(record.id)?.similarity),
+            confidence: record.confidence,
+            reviewState: record.reviewState,
+            trustTier: inferKnowledgeInjectionTrustTier(record.reviewState),
+            useAs: 'reference-material',
+            retention: 'task-only',
+            provenance: {
+                source: 'project-memory',
+                links: record.provenance,
+            },
+            ingestMode: determineIngestMode(record, taskTokens, scopeTokens, semanticById.get(record.id)?.similarity),
         },
-        ingestMode: determineIngestMode(record, taskTokens, scopeTokens, semanticById.get(record.id)?.similarity),
     }));
 }
+export function selectKnowledgeForTask(registry, task, writeScope = [], limit = 3) {
+    return selectKnowledgeForTaskScored(registry, task, writeScope, limit)
+        .map((entry) => entry.injection)
+        .slice(0, limit);
+}
 function normalizeKnowledgeInjectionPromptInput(injection) {
     return {
         ...injection,

package/dist/platform/state/memory-vector-store.d.ts

@@ -1,18 +1,6 @@
 import type { MemoryClass, MemoryRecord, MemoryReviewState, MemoryScope } from './memory-store.js';
 import { MemoryEmbeddingProviderRegistry } from './memory-embeddings.js';
-/**
- * Resolves the path to the sqlite-vec native extension.
- *
- * When running inside a Bun bundled executable (import.meta.url path contains
- * "$bunfs"), the npm package's import.meta.resolve() cannot find the extension
- * because the virtual filesystem does not contain node_modules. In that case,
- * the extension must be co-located with the binary under
- * `<execDir>/lib/sqlite-vec-<os>-<arch>/vec0.<suffix>`.
- *
- * In development (bun run / node), the package's own getLoadablePath() is used
- * via the re-exported `load()` function.
- */
-export declare function resolveSqliteVecPath(): string;
+export { resolveSqliteVecPath } from './sqlite-vec-loader.js';
 export declare const MEMORY_VECTOR_DIMS = 384;
 export { embedMemoryText } from './memory-embeddings.js';
 export interface MemoryVectorSearchFilter {

package/dist/platform/state/memory-vector-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-vector-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-vector-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-vector-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-vector-store.ts"],"names":[],"mappings":"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"}

package/dist/platform/state/memory-vector-store.js

@@ -1,47 +1,15 @@
 import { createHash } from 'node:crypto';
-import { dirname, join } from 'node:path';
+import { dirname } from 'node:path';
 import { mkdirSync } from 'node:fs';
 import { Database } from 'bun:sqlite';
-import { load as loadSqliteVec } from 'sqlite-vec';
 import { MemoryEmbeddingProviderRegistry, embedMemoryText, normalizeMemoryEmbeddingVector, } from './memory-embeddings.js';
+import { loadSqliteVecExtension } from './sqlite-vec-loader.js';
 import { logger } from '../utils/logger.js';
 import { summarizeError } from '../utils/error-display.js';
-/**
- * Resolves the path to the sqlite-vec native extension.
- *
- * When running inside a Bun bundled executable (import.meta.url path contains
- * "$bunfs"), the npm package's import.meta.resolve() cannot find the extension
- * because the virtual filesystem does not contain node_modules. In that case,
- * the extension must be co-located with the binary under
- * `<execDir>/lib/sqlite-vec-<os>-<arch>/vec0.<suffix>`.
- *
- * In development (bun run / node), the package's own getLoadablePath() is used
- * via the re-exported `load()` function.
- */
-export function resolveSqliteVecPath() {
-    const isBundled = import.meta.url.includes('$bunfs');
-    if (isBundled) {
-        const os = process.platform === 'win32' ? 'windows' : process.platform;
-        const arch = process.arch;
-        const suffix = process.platform === 'win32' ? 'dll' : process.platform === 'darwin' ? 'dylib' : 'so';
-        return join(dirname(process.execPath), 'lib', `sqlite-vec-${os}-${arch}`, `vec0.${suffix}`);
-    }
-    // In dev mode, delegate to sqlite-vec's own resolver.
-    return '';
-}
-/**
- * Loads the sqlite-vec extension into a Bun SQLite database.
- * Handles both bundled-binary and development execution contexts.
- */
-function loadSqliteVecExtension(db) {
-    const bundledPath = resolveSqliteVecPath();
-    if (bundledPath) {
-        db.loadExtension(bundledPath);
-    }
-    else {
-        loadSqliteVec(db);
-    }
-}
+// Lifted to sqlite-vec-loader.ts (Wave-5 W5.3) so code-index-store.ts can load
+// the exact same native extension the exact same way. Re-exported here so
+// existing callers that import resolveSqliteVecPath from this module keep working.
+export { resolveSqliteVecPath } from './sqlite-vec-loader.js';
 // Keep this in sync with DEFAULT_MEMORY_EMBEDDING_DIMS in memory-embeddings.ts.
 // Duplicating the literal here avoids an initialization cycle when state/index.ts
 // re-exports both modules during targeted test imports.

package/dist/platform/state/sqlite-vec-loader.d.ts

@@ -0,0 +1,25 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import type { Database } from 'bun:sqlite';
+/**
+ * Resolves the path to the sqlite-vec native extension.
+ *
+ * When running inside a Bun bundled executable (import.meta.url path contains
+ * "$bunfs"), the npm package's import.meta.resolve() cannot find the extension
+ * because the virtual filesystem does not contain node_modules. In that case,
+ * the extension must be co-located with the binary under
+ * `<execDir>/lib/sqlite-vec-<os>-<arch>/vec0.<suffix>`.
+ *
+ * In development (bun run / node), the package's own getLoadablePath() is used
+ * via the re-exported `load()` function.
+ *
+ * Shared by memory-vector-store.ts (MemoryStore's vector index) and
+ * code-index-store.ts (the repo source-tree code index, Wave-5 W5.3) so both
+ * indexes load the exact same native extension the exact same way.
+ */
+export declare function resolveSqliteVecPath(): string;
+/**
+ * Loads the sqlite-vec extension into a Bun SQLite database.
+ * Handles both bundled-binary and development execution contexts.
+ */
+export declare function loadSqliteVecExtension(db: Database): void;
+//# sourceMappingURL=sqlite-vec-loader.d.ts.map

package/dist/platform/state/sqlite-vec-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-vec-loader.d.ts","sourceRoot":"","sources":["../../../src/platform/state/sqlite-vec-loader.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAGrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAOzD"}

package/dist/platform/state/sqlite-vec-loader.js

@@ -0,0 +1,43 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import { dirname, join } from 'node:path';
+import { load as loadSqliteVec } from 'sqlite-vec';
+/**
+ * Resolves the path to the sqlite-vec native extension.
+ *
+ * When running inside a Bun bundled executable (import.meta.url path contains
+ * "$bunfs"), the npm package's import.meta.resolve() cannot find the extension
+ * because the virtual filesystem does not contain node_modules. In that case,
+ * the extension must be co-located with the binary under
+ * `<execDir>/lib/sqlite-vec-<os>-<arch>/vec0.<suffix>`.
+ *
+ * In development (bun run / node), the package's own getLoadablePath() is used
+ * via the re-exported `load()` function.
+ *
+ * Shared by memory-vector-store.ts (MemoryStore's vector index) and
+ * code-index-store.ts (the repo source-tree code index, Wave-5 W5.3) so both
+ * indexes load the exact same native extension the exact same way.
+ */
+export function resolveSqliteVecPath() {
+    const isBundled = import.meta.url.includes('$bunfs');
+    if (isBundled) {
+        const os = process.platform === 'win32' ? 'windows' : process.platform;
+        const arch = process.arch;
+        const suffix = process.platform === 'win32' ? 'dll' : process.platform === 'darwin' ? 'dylib' : 'so';
+        return join(dirname(process.execPath), 'lib', `sqlite-vec-${os}-${arch}`, `vec0.${suffix}`);
+    }
+    // In dev mode, delegate to sqlite-vec's own resolver.
+    return '';
+}
+/**
+ * Loads the sqlite-vec extension into a Bun SQLite database.
+ * Handles both bundled-binary and development execution contexts.
+ */
+export function loadSqliteVecExtension(db) {
+    const bundledPath = resolveSqliteVecPath();
+    if (bundledPath) {
+        db.loadExtension(bundledPath);
+    }
+    else {
+        loadSqliteVec(db);
+    }
+}

package/dist/platform/tools/agent/manager.d.ts

@@ -2,10 +2,12 @@ import { ArchetypeLoader } from '../../agents/archetypes.js';
 import { AgentMessageBus } from '../../agents/message-bus.js';
 import { WrfcController } from '../../agents/wrfc-controller.js';
 import type { ConfigManager } from '../../config/manager.js';
+import type { ConversationMessageSnapshot } from '../../core/conversation.js';
 import type { RuntimeEventBus } from '../../runtime/events/index.js';
 import type { ExecutionIntent } from '../../runtime/execution-intents.js';
 import type { AgentInput } from './schema.js';
 import type { WrfcAgentRole } from '../../agents/wrfc-types.js';
+import type { TurnInjectionRecord } from '../../agents/turn-knowledge-injection.js';
 export type AgentExecutor = {
     runAgent(record: AgentRecord): Promise<void>;
 };
@@ -15,7 +17,25 @@ export interface AgentManagerDependencies {
     readonly wrfcController?: Pick<WrfcController, 'createChain'> | null | undefined;
     readonly executor?: AgentExecutor | null | undefined;
     readonly configManager?: Pick<ConfigManager, 'get'> | undefined;
+    /**
+     * Bound on how many finished agents' final conversation snapshot are kept
+     * in the retention ring (see getConversationSnapshot). Defaults to
+     * DEFAULT_CONVERSATION_SNAPSHOT_RETENTION. Test-only knob in practice.
+     */
+    readonly conversationSnapshotRetention?: number | undefined;
 }
+/**
+ * Wave-3 tab attach point (Part C6): default bound on how many recently
+ * finished agents' final conversation snapshot AgentManager keeps around
+ * after their live source is released. Without a bound, a long-lived process
+ * that spawns many short-lived agents would retain every finished agent's
+ * full message history forever — this is the "leaking unbounded memory" the
+ * brief calls out. RUNNING agents are unaffected by this bound: their
+ * snapshot is read live from the still-open ConversationManager, whose size
+ * is already governed by the existing context-window compaction machinery
+ * (core/context-compaction.ts), not by this retention ring.
+ */
+export declare const DEFAULT_CONVERSATION_SNAPSHOT_RETENTION = 20;
 export declare const AGENT_TEMPLATES: Record<string, {
     description: string;
     defaultTools: string[];
@@ -33,6 +53,16 @@ export interface AgentRecord {
     context?: string | undefined;
     tools: string[];
     status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+    /**
+     * Set by cancel(id, kind) when status transitions to 'cancelled'. Distinguishes
+     * a graceful interrupt request from a hard kill for display purposes
+     * (Wave-3 verb formalization) without overloading `status`, which is
+     * consumed widely (ledger parse, orchestrator finalize, exportState/
+     * importState). Absent on records cancelled before this field existed, and
+     * on any record cancelled via the single-arg cancel(id) call — both default
+     * to 'kill' at the read site (fleet/adapters/agent.ts deriveAgentState).
+     */
+    terminationKind?: 'interrupt' | 'kill' | undefined;
     startedAt: number;
     completedAt?: number | undefined;
     progress?: string | undefined;
@@ -57,6 +87,15 @@ export interface AgentRecord {
     wrfcRouteReason?: string | undefined;
     wrfcSubtasks?: AgentInput['wrfcSubtasks'] | undefined;
     dangerously_disable_wrfc?: boolean | undefined;
+    /**
+     * Wave-4 orchestration engine tag (wo701): set by phase-runner.ts when it
+     * spawns an agent to run one WorkItem through one Phase. Mirrors
+     * wrfcId/wrfcSubtaskId — the fleet's agent adapter uses it to parent this
+     * agent node under its work-item ProcessNode (adapters/agent.ts
+     * resolveParentId), separate from the WRFC parenting track so the two
+     * systems' agents are never conflated.
+     */
+    workItemId?: string | undefined;
     cohort?: string | undefined;
     orchestrationGraphId?: string | undefined;
     orchestrationNodeId?: string | undefined;
@@ -80,6 +119,17 @@ export interface AgentRecord {
         confidence: number;
         reviewState: 'fresh' | 'reviewed' | 'stale' | 'contradicted';
     }>;
+    /**
+     * Wave-5 (wo801, W5.1) bounded ring of per-turn passive-injection honesty
+     * records — one entry per turn that actually ran retrieval (turns that
+     * reused the prior turn's cached block, or that ran with the feature
+     * flag/budget off, append nothing). See turn-knowledge-injection.ts for
+     * the record shape and recordTurnInjection for the ring-eviction policy.
+     * Deliberately a plain field (no new KnowledgeEvent contract member) —
+     * the same entries are also appended to the agent's session transcript
+     * via `session.appendMessage({type:'knowledge_injection', ...})`.
+     */
+    turnInjections?: TurnInjectionRecord[] | undefined;
 }
 export declare class AgentManager {
     private agents;
@@ -90,12 +140,89 @@ export declare class AgentManager {
     private wrfcController;
     private executor;
     private readonly configManager;
+    /**
+     * Live snapshot accessors for RUNNING agents (Wave-3 Part C6 bridge).
+     * Registered by the executor (orchestrator-runner.ts) right after it
+     * creates the agent's ConversationManager; the manager never stores
+     * messages itself while an agent is running — it just holds a callback.
+     */
+    private readonly conversationSources;
+    /**
+     * Wave-4 cooperative cancellation bridge (wo701): per-agent AbortSignal
+     * registered by an orchestration-engine work item for the duration of one
+     * phase run. AgentOrchestrator reads this via
+     * setCancellationSource/getCancellationSignal and threads it into
+     * toolRegistry.execute opts so opted-in tools (exec, fetch) can abort an
+     * in-flight child process/request immediately, instead of only at the next
+     * turn boundary's status poll. Purely additive — no caller is required to
+     * register anything, and an agent with no registered signal behaves
+     * exactly as before this change.
+     */
+    private readonly cancellationSignals;
+    /**
+     * Frozen final snapshots for agents whose live source was released (their
+     * run ended). Map insertion order doubles as the bounded ring's age order:
+     * oldest entry (first key) is evicted once conversationSnapshotRetention is
+     * exceeded. See getConversationSnapshot for the read-side contract.
+     */
+    private readonly frozenConversationSnapshots;
+    private readonly conversationSnapshotRetention;
     constructor(deps?: AgentManagerDependencies);
     setRuntimeBus(runtimeBus: RuntimeEventBus | null): void;
     private deriveEffectiveTools;
     spawn(input: AgentInput): AgentRecord;
     getStatus(id: string): AgentRecord | null;
-    cancel(id: string): boolean;
+    cancel(id: string, kind?: 'interrupt' | 'kill'): boolean;
+    /**
+     * Register the live conversation-snapshot source for a running agent
+     * (Wave-3 Part C6 bridge). Called by the executor (orchestrator-runner.ts)
+     * once its ConversationManager exists — `source` is invoked on demand by
+     * getConversationSnapshot(); the manager never copies or stores the
+     * messages itself while the agent is running.
+     */
+    registerConversationSource(agentId: string, source: () => ConversationMessageSnapshot[]): void;
+    /**
+     * Wave-4 cooperative cancellation bridge (wo701): register the AbortSignal
+     * an orchestration engine's cancellation registry created for a work
+     * item's current agent. Called by the engine right after
+     * AgentManager.spawn() so the signal is in place before the agent's first
+     * turn/tool call.
+     */
+    registerCancellationSignal(agentId: string, signal: AbortSignal): void;
+    /** Drop the registered signal once the run ends (success, failure, or cancel). Safe to call unconditionally. */
+    releaseCancellationSignal(agentId: string): void;
+    /** Read back the registered signal for AgentOrchestrator's per-tool-call opts. */
+    getCancellationSignal(agentId: string): AbortSignal | undefined;
+    /**
+     * Release the live source for an agent whose run has ended, freezing one
+     * final snapshot into the bounded retention ring (see
+     * DEFAULT_CONVERSATION_SNAPSHOT_RETENTION) so a transcript tab that was
+     * open at the moment of completion keeps showing content instead of going
+     * blank. Once evicted (oldest-first, beyond the retention bound),
+     * getConversationSnapshot falls back to an empty array — callers past that
+     * point are expected to degrade to the on-disk event ledger (Wave-3 TUI
+     * Part C6's documented fallback for completed/detached agents).
+     *
+     * Safe to call even when no source was ever registered for this agentId
+     * (e.g. a WRFC owner agent, which never runs its own turn loop).
+     */
+    releaseConversationSource(agentId: string): void;
+    /**
+     * The Wave-3 tab attach point: a full-fidelity conversation history for a
+     * fleet agent (ConversationMessageSnapshot[] — the same shape the main
+     * session surface renders via MessageLineCache/conversation.ts).
+     *
+     * - RUNNING agent with a registered source → the current live snapshot.
+     * - Agent whose run just ended → the frozen final snapshot, until evicted
+     *   from the bounded retention ring (oldest-first beyond
+     *   conversationSnapshotRetention completed agents).
+     * - Unknown agent, or one long since evicted → empty array. The disk
+     *   ledger (<agentId>.jsonl, written by AgentSession) is NOT a substitute
+     *   for this array — it is a truncated event log (tool args/results
+     *   sliced to 500 chars, no assistant message text), so callers past
+     *   eviction get a degraded activity view, never a fabricated replay.
+     */
+    getConversationSnapshot(agentId: string): ConversationMessageSnapshot[];
     listByGraph(graphId: string): AgentRecord[];
     cancelSubtree(rootAgentId: string): string[];
     cancelGraph(graphId: string): string[];

package/dist/platform/tools/agent/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/manager.ts"],"names":[],"mappings":"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"}

package/dist/platform/tools/agent/manager.js

@@ -8,6 +8,18 @@ import { logger } from '../../utils/logger.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { splitModelRegistryKey } from '../../providers/registry-helpers.js';
 import { isRootReviewRoleTask, resolveAuthoritativeWrfcScope, resolveImplementationToolContract, resolveNarrowedRootSpawnScope, } from './wrfc-batch-policy.js';
+/**
+ * Wave-3 tab attach point (Part C6): default bound on how many recently
+ * finished agents' final conversation snapshot AgentManager keeps around
+ * after their live source is released. Without a bound, a long-lived process
+ * that spawns many short-lived agents would retain every finished agent's
+ * full message history forever — this is the "leaking unbounded memory" the
+ * brief calls out. RUNNING agents are unaffected by this bound: their
+ * snapshot is read live from the still-open ConversationManager, whose size
+ * is already governed by the existing context-window compaction machinery
+ * (core/context-compaction.ts), not by this retention ring.
+ */
+export const DEFAULT_CONVERSATION_SNAPSHOT_RETENTION = 20;
 export const AGENT_TEMPLATES = {
     orchestrator: {
         description: 'WRFC coordination and decomposition agent',
@@ -65,12 +77,40 @@ export class AgentManager {
     wrfcController;
     executor;
     configManager;
+    /**
+     * Live snapshot accessors for RUNNING agents (Wave-3 Part C6 bridge).
+     * Registered by the executor (orchestrator-runner.ts) right after it
+     * creates the agent's ConversationManager; the manager never stores
+     * messages itself while an agent is running — it just holds a callback.
+     */
+    conversationSources = new Map();
+    /**
+     * Wave-4 cooperative cancellation bridge (wo701): per-agent AbortSignal
+     * registered by an orchestration-engine work item for the duration of one
+     * phase run. AgentOrchestrator reads this via
+     * setCancellationSource/getCancellationSignal and threads it into
+     * toolRegistry.execute opts so opted-in tools (exec, fetch) can abort an
+     * in-flight child process/request immediately, instead of only at the next
+     * turn boundary's status poll. Purely additive — no caller is required to
+     * register anything, and an agent with no registered signal behaves
+     * exactly as before this change.
+     */
+    cancellationSignals = new Map();
+    /**
+     * Frozen final snapshots for agents whose live source was released (their
+     * run ended). Map insertion order doubles as the bounded ring's age order:
+     * oldest entry (first key) is evicted once conversationSnapshotRetention is
+     * exceeded. See getConversationSnapshot for the read-side contract.
+     */
+    frozenConversationSnapshots = new Map();
+    conversationSnapshotRetention;
     constructor(deps = {}) {
         this.archetypeLoader = deps.archetypeLoader ?? new ArchetypeLoader();
         this.messageBus = deps.messageBus ?? new AgentMessageBus();
         this.wrfcController = deps.wrfcController ?? null;
         this.executor = deps.executor ?? null;
         this.configManager = deps.configManager ?? null;
+        this.conversationSnapshotRetention = deps.conversationSnapshotRetention ?? DEFAULT_CONVERSATION_SNAPSHOT_RETENTION;
     }
     setRuntimeBus(runtimeBus) {
         this.runtimeBus = runtimeBus;
@@ -446,12 +486,13 @@ export class AgentManager {
     getStatus(id) {
         return this.agents.get(id) ?? null;
     }
-    cancel(id) {
+    cancel(id, kind = 'kill') {
         const record = this.agents.get(id);
         if (!record)
             return false;
         if (record.status === 'pending' || record.status === 'running') {
             record.status = 'cancelled';
+            record.terminationKind = kind;
             record.completedAt = Date.now();
             if (this.runtimeBus) {
                 emitAgentCancelled(this.runtimeBus, {
@@ -480,6 +521,99 @@ export class AgentManager {
         this.agents.set(id, record);
         return true;
     }
+    /**
+     * Register the live conversation-snapshot source for a running agent
+     * (Wave-3 Part C6 bridge). Called by the executor (orchestrator-runner.ts)
+     * once its ConversationManager exists — `source` is invoked on demand by
+     * getConversationSnapshot(); the manager never copies or stores the
+     * messages itself while the agent is running.
+     */
+    registerConversationSource(agentId, source) {
+        this.conversationSources.set(agentId, source);
+    }
+    /**
+     * Wave-4 cooperative cancellation bridge (wo701): register the AbortSignal
+     * an orchestration engine's cancellation registry created for a work
+     * item's current agent. Called by the engine right after
+     * AgentManager.spawn() so the signal is in place before the agent's first
+     * turn/tool call.
+     */
+    registerCancellationSignal(agentId, signal) {
+        this.cancellationSignals.set(agentId, signal);
+    }
+    /** Drop the registered signal once the run ends (success, failure, or cancel). Safe to call unconditionally. */
+    releaseCancellationSignal(agentId) {
+        this.cancellationSignals.delete(agentId);
+    }
+    /** Read back the registered signal for AgentOrchestrator's per-tool-call opts. */
+    getCancellationSignal(agentId) {
+        return this.cancellationSignals.get(agentId);
+    }
+    /**
+     * Release the live source for an agent whose run has ended, freezing one
+     * final snapshot into the bounded retention ring (see
+     * DEFAULT_CONVERSATION_SNAPSHOT_RETENTION) so a transcript tab that was
+     * open at the moment of completion keeps showing content instead of going
+     * blank. Once evicted (oldest-first, beyond the retention bound),
+     * getConversationSnapshot falls back to an empty array — callers past that
+     * point are expected to degrade to the on-disk event ledger (Wave-3 TUI
+     * Part C6's documented fallback for completed/detached agents).
+     *
+     * Safe to call even when no source was ever registered for this agentId
+     * (e.g. a WRFC owner agent, which never runs its own turn loop).
+     */
+    releaseConversationSource(agentId) {
+        const source = this.conversationSources.get(agentId);
+        if (!source)
+            return;
+        this.conversationSources.delete(agentId);
+        let finalSnapshot;
+        try {
+            finalSnapshot = source();
+        }
+        catch (error) {
+            logger.warn('AgentManager: conversation source threw on release', { agentId, error: summarizeError(error) });
+            return;
+        }
+        // Re-insert at the end (freshest) even if already present, so the ring's
+        // insertion order tracks recency of completion, not first appearance.
+        this.frozenConversationSnapshots.delete(agentId);
+        this.frozenConversationSnapshots.set(agentId, finalSnapshot);
+        while (this.frozenConversationSnapshots.size > this.conversationSnapshotRetention) {
+            const oldestKey = this.frozenConversationSnapshots.keys().next().value;
+            if (oldestKey === undefined)
+                break;
+            this.frozenConversationSnapshots.delete(oldestKey);
+        }
+    }
+    /**
+     * The Wave-3 tab attach point: a full-fidelity conversation history for a
+     * fleet agent (ConversationMessageSnapshot[] — the same shape the main
+     * session surface renders via MessageLineCache/conversation.ts).
+     *
+     * - RUNNING agent with a registered source → the current live snapshot.
+     * - Agent whose run just ended → the frozen final snapshot, until evicted
+     *   from the bounded retention ring (oldest-first beyond
+     *   conversationSnapshotRetention completed agents).
+     * - Unknown agent, or one long since evicted → empty array. The disk
+     *   ledger (<agentId>.jsonl, written by AgentSession) is NOT a substitute
+     *   for this array — it is a truncated event log (tool args/results
+     *   sliced to 500 chars, no assistant message text), so callers past
+     *   eviction get a degraded activity view, never a fabricated replay.
+     */
+    getConversationSnapshot(agentId) {
+        const liveSource = this.conversationSources.get(agentId);
+        if (liveSource) {
+            try {
+                return liveSource();
+            }
+            catch (error) {
+                logger.warn('AgentManager: conversation source threw', { agentId, error: summarizeError(error) });
+                return [];
+            }
+        }
+        return this.frozenConversationSnapshots.get(agentId) ?? [];
+    }
     listByGraph(graphId) {
         return this.list().filter((agent) => agent.orchestrationGraphId === graphId);
     }
@@ -521,6 +655,8 @@ export class AgentManager {
     clear() {
         this.agents.clear();
         this.orchestrationGraphs.clear();
+        this.conversationSources.clear();
+        this.frozenConversationSnapshots.clear();
     }
     exportState() {
         return [...this.agents.values()].map((agent) => {

package/dist/platform/tools/exec/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/exec/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAqB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAA+B,iBAAiB,EAAiB,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAse/E;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,GAC3D,OAAO,CA2CT;AA8ID,wBAAgB,cAAc,CAC5B,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE;IACP,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACjF,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACnD,GACL,IAAI,CA6FN"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/exec/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAqB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAA+B,iBAAiB,EAAiB,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAyjB/E;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,GAC3D,OAAO,CA8CT;AAsJD,wBAAgB,cAAc,CAC5B,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE;IACP,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACjF,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACnD,GACL,IAAI,CA8FN"}