@pellux/goodvibes-sdk 0.37.1 → 0.38.0

package/dist/platform/orchestration/types.d.ts

@@ -0,0 +1,250 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Orchestration engine — the model (W4.1, wo701).
+ *
+ * A phase/work-item pipeline layered OVER (not replacing) WrfcController. The
+ * hard departure from WrfcController is pipeline semantics: an item advances
+ * to its next phase the instant its gate passes, claimed by WHATEVER capacity
+ * slot is free — there is no pairwise binding of one reviewer to one
+ * engineer's history (see wrfc-controller.ts startReview:883/startFix:1042,
+ * which bind chain.reviewerAgentId/chain.fixerAgentId to a single chain).
+ *
+ * Float ordinals on Phase are load-bearing: inserting a phase mid-run assigns
+ * an ordinal strictly between its neighbors, so existing phase ids — and
+ * therefore existing PhaseResult resume-cache keys (itemId,phaseId) — never
+ * shift or invalidate.
+ */
+import type { WrfcAgentRole, QualityGateResult } from '../agents/wrfc-types.js';
+import type { WrfcCommitScope } from '../agents/wrfc-config.js';
+import type { CompletionReport, ConstraintFinding } from '../agents/completion-report.js';
+/** A named agent role, OR an archetype name loaded via ArchetypeLoader. */
+export type PhaseRole = WrfcAgentRole | (string & {});
+export type PhaseKind = 'plan' | 'engineer' | 'review' | 'fix' | 'gate' | 'integrate' | 'custom';
+/** The gate policy a phase enforces before an item may advance past it. */
+export interface PhaseGateSpec {
+    readonly scope: WrfcCommitScope;
+    readonly gates: readonly string[];
+}
+/**
+ * One pipeline stage. `ordinal` is a float specifically so
+ * `engine.insertPhase()` can slot a new phase strictly between two existing
+ * ordinals without renumbering anything — renumbering would invalidate every
+ * PhaseResult cache key already keyed off the old (itemId,phaseId) pairs.
+ */
+export interface Phase {
+    readonly id: string;
+    readonly ordinal: number;
+    readonly role: PhaseRole;
+    readonly capacity: number;
+    readonly gate: PhaseGateSpec;
+    readonly kind: PhaseKind;
+    /** Epoch ms — set only for phases created via insertPhase() mid-run. */
+    readonly insertedAt?: number | undefined;
+}
+/** Caller-supplied shape for engine.insertPhase() / seeding. `id` is generated when omitted. */
+export interface PhaseSpec {
+    readonly id?: string | undefined;
+    readonly role: PhaseRole;
+    readonly capacity: number;
+    readonly gate: PhaseGateSpec;
+    readonly kind: PhaseKind;
+}
+export type WorkItemState = 'pending' | 'awaiting-capacity'
+/**
+ * Live only while a phase's agent is actually running. `importWorkstream`
+ * (engine.ts) reconciles any item persisted in this state back to
+ * 'pending' and clears `agentId` before the workstream is registered — a
+ * snapshot can only ever capture 'in-phase' as a crash artifact (the
+ * process died mid-run), never a resumable one, since no agent from a
+ * prior process is still alive to finish it. Without that reconciliation
+ * an imported 'in-phase' item counts as an OCCUPIED capacity slot forever
+ * (computeClaims, scheduler.ts) while never being in the re-claimable
+ * waiting set, permanently starving its workstream.
+ */
+ | 'in-phase' | 'passed' | 'failed'
+/**
+ * Recoverable, not terminal. computeClaims (scheduler.ts) includes
+ * 'blocked-budget' items in its waiting set, so the item is automatically
+ * reconsidered on the next tick(). Because usage only grows, in practice
+ * that next tick only unblocks the item once the ceiling itself rises (or
+ * is removed) via `engine.updateBudget()` — which calls tick() after
+ * updating `workstream.budget` so the reconsideration happens immediately
+ * rather than waiting on some unrelated sibling to complete. `blockedReason`
+ * carries the human-readable reason for as long as the item stays blocked
+ * (cleared the moment it reclaims a slot).
+ */
+ | 'blocked-budget';
+/** Token/cost usage rolled up across every agent this work-item has ever spawned. */
+export interface WorkItemUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    readonly reasoningTokens?: number | undefined;
+    readonly llmCallCount: number;
+    readonly turnCount: number;
+    readonly toolCallCount: number;
+    readonly costUsd: number | null;
+    readonly costState: 'priced' | 'unpriced' | 'estimated';
+}
+export declare function emptyWorkItemUsage(): WorkItemUsage;
+/**
+ * One unit of pipeline work. `visits` bounds re-review cycles the same way
+ * WrfcController.retryTransportFailure/evaluateConstraints cap fix attempts —
+ * keyed by phaseId so a dynamically-inserted 'fix' phase gets its own counter.
+ */
+export interface WorkItem {
+    readonly id: string;
+    title: string;
+    readonly task: string;
+    /** The phase this item is currently queued for or running in; null once terminal. */
+    currentPhaseId: string | null;
+    state: WorkItemState;
+    branch?: string | undefined;
+    /** The agent currently (or most recently) driving this item's active phase. */
+    agentId?: string | undefined;
+    /** Every agent ever spawned for this item, across all phases/retries — usage rollup roster. */
+    allAgentIds: string[];
+    /** phaseId -> number of times this item has been routed through that phase. */
+    readonly visits: Map<string, number>;
+    /** Deduped touched-path ledger for scoped commits, mirrors WrfcChain.touchedPaths. */
+    touchedPaths: string[];
+    usage: WorkItemUsage;
+    /** Separate from `visits` — a transport blip must never eat into the fix-cycle budget. */
+    transportRetryCount: number;
+    readonly createdAt: number;
+    completedAt?: number | undefined;
+    failureReason?: string | undefined;
+    /** Set only while state === 'blocked-budget'; cleared the instant the item reclaims a slot. See the 'blocked-budget' state doc for recovery semantics. */
+    blockedReason?: string | undefined;
+}
+export interface WorkItemSpec {
+    readonly id?: string | undefined;
+    readonly title: string;
+    readonly task: string;
+}
+export interface BudgetCeiling {
+    readonly maxTokens?: number | undefined;
+    readonly maxCostUsd?: number | undefined;
+}
+export interface Workstream {
+    readonly id: string;
+    title: string;
+    readonly schemaVersion: number;
+    phases: Phase[];
+    items: WorkItem[];
+    /**
+     * Mutable (not readonly) specifically so `engine.updateBudget()` can raise,
+     * lower, or clear (`undefined`) the ceiling on a live workstream. Every
+     * update calls tick() immediately afterward, so any item already sitting
+     * in 'blocked-budget' gets reconsidered right away rather than waiting on
+     * an unrelated sibling to complete first.
+     */
+    budget?: BudgetCeiling | undefined;
+    readonly createdAt: number;
+}
+/** Outcome of running a phase's configured gates for one item. */
+export interface GateOutcome {
+    readonly passed: boolean;
+    readonly results: readonly QualityGateResult[];
+    readonly constraintFindings?: readonly ConstraintFinding[] | undefined;
+    readonly unsatisfiedConstraintIds?: readonly string[] | undefined;
+}
+/**
+ * Recorded on a PhaseResult when a scoped commit (Wave 6, wo-F item 4)
+ * excluded one or more candidate paths because they were already dirty
+ * before this engine run launched and this phase never actually touched
+ * them (see dirty-guard.ts's excludeUntouchedLaunchResidue). `skipped: true`
+ * means every candidate was excluded and no commit was attempted at all.
+ */
+export interface CommitExclusion {
+    readonly excludedPaths: readonly string[];
+    readonly skipped: boolean;
+}
+/**
+ * The resume-cache unit, keyed (itemId,phaseId). On resume, every
+ * (itemId,phaseId) present in a snapshot's completedResults is hydrated
+ * without re-spawning — this is what makes prefix-replay possible.
+ */
+export interface PhaseResult {
+    readonly itemId: string;
+    readonly phaseId: string;
+    readonly agentId: string;
+    readonly report: CompletionReport;
+    readonly gate: GateOutcome;
+    readonly startedAt: number;
+    readonly completedAt: number;
+    readonly usage: WorkItemUsage;
+    /** Present only when a scoped commit excluded launch-dirty residue (see CommitExclusion). */
+    readonly commitExclusion?: CommitExclusion | undefined;
+}
+/** Snapshot shape written to .goodvibes/orchestration/<workstreamId>.json. */
+export interface WorkstreamSnapshot {
+    readonly schemaVersion: number;
+    readonly writtenAt: number;
+    readonly workstream: SerializedWorkstream;
+    readonly completedResults: readonly PhaseResult[];
+}
+/** JSON-safe mirror of Workstream (WorkItem.visits as an object, not a Map). */
+export interface SerializedWorkstream extends Omit<Workstream, 'items'> {
+    readonly items: readonly SerializedWorkItem[];
+}
+export interface SerializedWorkItem extends Omit<WorkItem, 'visits'> {
+    readonly visits: Record<string, number>;
+}
+export declare const CURRENT_WORKSTREAM_SCHEMA_VERSION = 1;
+/** Discriminated events the engine emits over its own lifecycle (persistence, budget, fleet). */
+export type OrchestrationEvent = {
+    readonly type: 'phase-inserted';
+    readonly workstreamId: string;
+    readonly phase: Phase;
+} | {
+    readonly type: 'item-advanced';
+    readonly workstreamId: string;
+    readonly itemId: string;
+    readonly fromPhaseId: string | null;
+    readonly toPhaseId: string | null;
+} | {
+    readonly type: 'item-blocked-budget';
+    readonly workstreamId: string;
+    readonly itemId: string;
+    readonly phaseId: string;
+    readonly reason: string;
+} | {
+    readonly type: 'item-cancelled';
+    readonly workstreamId: string;
+    readonly itemId: string;
+    readonly reason: string;
+} | {
+    readonly type: 'item-passed';
+    readonly workstreamId: string;
+    readonly itemId: string;
+} | {
+    readonly type: 'item-failed';
+    readonly workstreamId: string;
+    readonly itemId: string;
+    readonly reason: string;
+}
+/** Emitted once per item on `importWorkstream` for every item reconciled from a crash-artifact 'in-phase' snapshot back to 'pending' — see the 'in-phase' state doc. */
+ | {
+    readonly type: 'item-requeued';
+    readonly workstreamId: string;
+    readonly itemId: string;
+    readonly reason: string;
+} | {
+    readonly type: 'workstream-persisted';
+    readonly workstreamId: string;
+}
+/**
+ * Emitted once per engine instance (Wave 6, wo-F item 4), right after the
+ * launch-time dirty-tree snapshot resolves, ONLY when it is non-empty.
+ * Engine-wide, not workstream-scoped — `workstreamId` is absent (unlike
+ * every other variant above) because it fires before any workstream is
+ * necessarily even created. See dirty-guard.ts.
+ */
+ | {
+    readonly type: 'dirty-tree-at-launch';
+    readonly paths: readonly string[];
+};
+export type OrchestrationEventListener = (event: OrchestrationEvent) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/platform/orchestration/types.d.ts.map

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

package/dist/platform/orchestration/types.js

@@ -0,0 +1,15 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+export function emptyWorkItemUsage() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheReadTokens: 0,
+        cacheWriteTokens: 0,
+        llmCallCount: 0,
+        turnCount: 0,
+        toolCallCount: 0,
+        costUsd: null,
+        costState: 'unpriced',
+    };
+}
+export const CURRENT_WORKSTREAM_SCHEMA_VERSION = 1;

package/dist/platform/runtime/emitters/communication.d.ts

@@ -17,6 +17,17 @@ export declare function emitCommunicationSent(bus: RuntimeEventBus, ctx: Emitter
     parentAgentId?: string | undefined;
 }): void;
 export declare function emitCommunicationDelivered(bus: RuntimeEventBus, ctx: EmitterContext, data: BaseCommunication): void;
+/**
+ * The honest "consumed at boundary" signal — emitted once, at the drain
+ * site (orchestrator-runner.ts), the turn a queued message is actually
+ * injected into the target agent's conversation. Never repurpose
+ * `emitCommunicationDelivered` for this: it fires eagerly at send() time.
+ */
+export declare function emitCommunicationConsumed(bus: RuntimeEventBus, ctx: EmitterContext, data: {
+    messageId: string;
+    agentId: string;
+    turn: number;
+}): void;
 export declare function emitCommunicationBlocked(bus: RuntimeEventBus, ctx: EmitterContext, data: BaseCommunication & {
     reason: string;
     fromRole?: string | undefined;

package/dist/platform/runtime/emitters/communication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"communication.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/emitters/communication.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE9F,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,iBAAiB,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GACA,IAAI,CAEN;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAEN;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,iBAAiB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GACA,IAAI,CAEN"}
+{"version":3,"file":"communication.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/emitters/communication.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE9F,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,iBAAiB,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GACA,IAAI,CAEN;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD,IAAI,CAEN;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,iBAAiB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GACA,IAAI,CAEN"}

package/dist/platform/runtime/emitters/communication.js

@@ -8,6 +8,15 @@ export function emitCommunicationSent(bus, ctx, data) {
 export function emitCommunicationDelivered(bus, ctx, data) {
     bus.emit('communication', createEventEnvelope('COMMUNICATION_DELIVERED', { type: 'COMMUNICATION_DELIVERED', ...data }, ctx));
 }
+/**
+ * The honest "consumed at boundary" signal — emitted once, at the drain
+ * site (orchestrator-runner.ts), the turn a queued message is actually
+ * injected into the target agent's conversation. Never repurpose
+ * `emitCommunicationDelivered` for this: it fires eagerly at send() time.
+ */
+export function emitCommunicationConsumed(bus, ctx, data) {
+    bus.emit('communication', createEventEnvelope('COMMUNICATION_CONSUMED', { type: 'COMMUNICATION_CONSUMED', ...data }, ctx));
+}
 export function emitCommunicationBlocked(bus, ctx, data) {
     bus.emit('communication', createEventEnvelope('COMMUNICATION_BLOCKED', { type: 'COMMUNICATION_BLOCKED', ...data }, ctx));
 }

package/dist/platform/runtime/feature-flags/flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/feature-flags/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EAyctC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAE7D,CAAC"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/feature-flags/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EA4dtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAE7D,CAAC"}

package/dist/platform/runtime/feature-flags/flags.js

@@ -190,6 +190,23 @@ export const FEATURE_FLAGS = [
         tier: 9,
         runtimeToggleable: true,
     },
+    {
+        id: 'agent-passive-knowledge-injection',
+        name: 'Agent Passive Knowledge Injection',
+        description: 'Enables per-turn re-retrieval of project-memory knowledge against the EVOLVING main-'
+            + 'session conversation (steers, new sub-topics), not just the frozen spawn-time task. '
+            + 'Re-runs retrieval only when a new user/steer message arrived this turn, applies a '
+            + 'relevance floor to filter filler, and holds the injected block to a hard token '
+            + 'budget (min ~800 tokens or 3% of the model context window) with a visible per-turn '
+            + 'record (candidates considered, ids injected, ids dropped for budget, token cost, '
+            + 'embeddings backend) stored on AgentRecord.turnInjections and the session transcript. '
+            + 'Default-on is safe specifically because the block is hard-budgeted and every turn '
+            + 'is honestly recorded, never silently eating context. Disable or set the budget to 0 '
+            + 'to revert to spawn-time-only injection (base system prompt byte-identical).',
+        defaultState: 'enabled',
+        tier: 9,
+        runtimeToggleable: true,
+    },
     {
         id: 'output-schema-fingerprint',
         name: 'Output Schema Fingerprints',

package/dist/platform/runtime/fleet/adapters/agent.d.ts

@@ -0,0 +1,56 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import type { AgentRecord } from '../../../tools/agent/manager.js';
+import type { ProcessActivity, ProcessNode, ProcessState, ProcessUsage } from '../types.js';
+/** Chain node ids are namespaced to avoid colliding with agent/process ids. */
+export declare function chainNodeId(chainId: string): string;
+/** Subtask node ids are namespaced to avoid colliding with agent/process ids. */
+export declare function subtaskNodeId(subtaskId: string): string;
+/** Work-item node ids are namespaced to avoid colliding with agent/process ids (Wave 4, wo701). */
+export declare function workItemNodeId(workItemId: string): string;
+/**
+ * One activity side-table entry. Registry-owned; populated from the EXISTING
+ * runtime-bus 'agents' channel emitters (no new event contract).
+ */
+export interface AgentActivityEntry {
+    readonly state: Extract<ProcessState, 'thinking' | 'executing-tool' | 'streaming' | 'retrying' | 'queued' | 'done' | 'failed'>;
+    readonly activity?: ProcessActivity | undefined;
+    /** Epoch ms of the last observed bus event for this agent. */
+    readonly at: number;
+}
+/** Assembly context the agent adapter needs to derive state and edges. */
+export interface AgentAdapterContext {
+    readonly now: number;
+    readonly stalledThresholdMs: number;
+    /** Side-table entries keyed by agentId. Empty map when no runtimeBus was provided. */
+    readonly activity: ReadonlyMap<string, AgentActivityEntry>;
+    /** True when a runtimeBus feeds the side-table — gates the stalled derivation. */
+    readonly liveness: boolean;
+    /** Agent ids that have a pending shared approval (metadata.agentId match). */
+    readonly pendingApprovalAgentIds: ReadonlySet<string>;
+    /** Session ids that have a pending shared approval (sessionRef cross-match). */
+    readonly pendingApprovalSessionIds: ReadonlySet<string>;
+    /** agentId → bound sessionId (from the session broker, when available). */
+    readonly sessionIdByAgentId: ReadonlyMap<string, string>;
+    /** Raw WrfcChain ids present in this snapshot. */
+    readonly chainIds: ReadonlySet<string>;
+    /** Raw WrfcSubtask ids present in this snapshot. */
+    readonly subtaskIds: ReadonlySet<string>;
+    /** Raw orchestration-engine WorkItem ids present in this snapshot (Wave 4, wo701). */
+    readonly workItemIds: ReadonlySet<string>;
+    /** orchestrationNodeId → owning agentId, for parentNodeId edge resolution. */
+    readonly agentIdByOrchestrationNodeId: ReadonlyMap<string, string>;
+    /** All agent ids present in this snapshot. */
+    readonly agentIds: ReadonlySet<string>;
+    readonly priceUsage?: ((model: string | undefined, usage: ProcessUsage) => number | null) | undefined;
+    /**
+     * True when the registry was constructed with a `messageBus` dep — gates
+     * `steerable`. Without it, steering has no delivery mechanism, so every
+     * agent (even a live one) honestly reports steerable=false.
+     */
+    readonly messageBusPresent: boolean;
+}
+/** AgentRecord.usage + toolCallCount → ProcessUsage. */
+export declare function usageFromAgentRecord(record: AgentRecord): ProcessUsage | undefined;
+/** AgentRecord → ProcessNode. */
+export declare function adaptAgent(record: AgentRecord, ctx: AgentAdapterContext): ProcessNode;
+//# sourceMappingURL=agent.d.ts.map

package/dist/platform/runtime/fleet/adapters/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/fleet/adapters/agent.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC/H,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAChD,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3D,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtD,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,4BAA4B,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnE,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACtG;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAYlF;AA8ED,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,mBAAmB,GAAG,WAAW,CA6CrF"}

package/dist/platform/runtime/fleet/adapters/agent.js

@@ -0,0 +1,143 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/** Chain node ids are namespaced to avoid colliding with agent/process ids. */
+export function chainNodeId(chainId) {
+    return `chain:${chainId}`;
+}
+/** Subtask node ids are namespaced to avoid colliding with agent/process ids. */
+export function subtaskNodeId(subtaskId) {
+    return `subtask:${subtaskId}`;
+}
+/** Work-item node ids are namespaced to avoid colliding with agent/process ids (Wave 4, wo701). */
+export function workItemNodeId(workItemId) {
+    return `work-item:${workItemId}`;
+}
+/** AgentRecord.usage + toolCallCount → ProcessUsage. */
+export function usageFromAgentRecord(record) {
+    if (!record.usage)
+        return undefined;
+    return {
+        inputTokens: record.usage.inputTokens,
+        outputTokens: record.usage.outputTokens,
+        cacheReadTokens: record.usage.cacheReadTokens,
+        cacheWriteTokens: record.usage.cacheWriteTokens,
+        reasoningTokens: record.usage.reasoningTokens,
+        llmCallCount: record.usage.llmCallCount,
+        turnCount: record.usage.turnCount,
+        toolCallCount: record.toolCallCount,
+    };
+}
+/**
+ * parentId precedence (brief-mandated, Wave-4 stable):
+ * wrfcSubtaskId → `subtask:<id>` else wrfcId → `chain:<id>` else
+ * workItemId → `work-item:<id>` (Wave 4, wo701 — orchestration-engine phase
+ * agents, a separate track from WRFC so the two systems' agents are never
+ * conflated) else orchestrationNodeId/parentNodeId (resolved to the owning
+ * agent) else parentAgentId. Every step falls through when the referenced
+ * node is not present in this snapshot, so edges always resolve or the node
+ * is a root.
+ */
+function resolveParentId(record, ctx) {
+    if (record.wrfcSubtaskId && ctx.subtaskIds.has(record.wrfcSubtaskId)) {
+        return subtaskNodeId(record.wrfcSubtaskId);
+    }
+    if (record.wrfcId && ctx.chainIds.has(record.wrfcId)) {
+        return chainNodeId(record.wrfcId);
+    }
+    if (record.workItemId && ctx.workItemIds.has(record.workItemId)) {
+        return workItemNodeId(record.workItemId);
+    }
+    if (record.parentNodeId) {
+        const owner = ctx.agentIdByOrchestrationNodeId.get(record.parentNodeId);
+        if (owner && owner !== record.id && ctx.agentIds.has(owner))
+            return owner;
+    }
+    if (record.parentAgentId && ctx.agentIds.has(record.parentAgentId)) {
+        return record.parentAgentId;
+    }
+    return undefined;
+}
+function deriveAgentState(record, entry, sessionId, ctx) {
+    switch (record.status) {
+        case 'completed':
+            return 'done';
+        case 'failed':
+            return 'failed';
+        case 'cancelled':
+            // terminationKind distinguishes a graceful interrupt request from a hard
+            // kill for display purposes (Wave-3 verb formalization). Records
+            // persisted before this field existed have no terminationKind and
+            // default to 'killed' — the historical behavior.
+            return record.terminationKind === 'interrupt' ? 'interrupted' : 'killed';
+        case 'pending':
+            return 'queued';
+        case 'running':
+            break;
+    }
+    // running — fine-grained derivation.
+    if (ctx.pendingApprovalAgentIds.has(record.id) ||
+        (sessionId !== undefined && ctx.pendingApprovalSessionIds.has(sessionId))) {
+        return 'awaiting-approval';
+    }
+    // Stalled: only derivable when a bus feeds the side-table (headless runtimes
+    // degrade to the coarse state, never crash). Baseline is the last observed
+    // event, or startedAt when the agent predates the registry.
+    //
+    // executing-tool is exempt: AGENT_AWAITING_TOOL stamps activity.at once at
+    // tool start and no further 'agents' event fires until the tool returns, so
+    // a long-running tool call (build, test suite, bash) would otherwise be
+    // misread as silence and falsely flip a working agent to 'stalled'. Only
+    // thinking/streaming (and other non-tool) silence may stall.
+    if (ctx.liveness && entry?.state !== 'executing-tool') {
+        const lastActivityAt = entry?.at ?? record.startedAt;
+        if (ctx.now - lastActivityAt > ctx.stalledThresholdMs)
+            return 'stalled';
+    }
+    if (entry && entry.state !== 'done' && entry.state !== 'failed')
+        return entry.state;
+    return 'executing-tool';
+}
+/** AgentRecord → ProcessNode. */
+export function adaptAgent(record, ctx) {
+    const entry = ctx.activity.get(record.id);
+    const sessionId = ctx.sessionIdByAgentId.get(record.id);
+    const state = deriveAgentState(record, entry, sessionId, ctx);
+    const usage = usageFromAgentRecord(record);
+    const active = record.status === 'pending' || record.status === 'running';
+    let costUsd = null;
+    let costState = 'unpriced';
+    if (usage && ctx.priceUsage) {
+        let priced = null;
+        try {
+            priced = ctx.priceUsage(record.model, usage);
+        }
+        catch {
+            priced = null;
+        }
+        if (priced !== null) {
+            costUsd = priced;
+            costState = 'priced';
+        }
+    }
+    const label = record.wrfcRole ? `${record.template} (${record.wrfcRole})` : record.template;
+    const elapsedMs = Math.max(0, (record.completedAt ?? ctx.now) - record.startedAt);
+    return {
+        id: record.id,
+        kind: 'agent',
+        parentId: resolveParentId(record, ctx),
+        label,
+        task: record.task,
+        state,
+        startedAt: record.startedAt,
+        completedAt: record.completedAt,
+        elapsedMs,
+        usage,
+        model: record.model,
+        provider: record.provider,
+        costUsd,
+        costState,
+        currentActivity: entry?.activity,
+        capabilities: { interruptible: active, killable: active, pausable: false, resumable: false, steerable: active && ctx.messageBusPresent },
+        sessionRef: { sessionId, agentId: record.id },
+        raw: record,
+    };
+}

package/dist/platform/runtime/fleet/adapters/automation.d.ts

@@ -0,0 +1,30 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import type { AutomationJob } from '../../../automation/jobs.js';
+import type { ProcessNode } from '../types.js';
+/**
+ * Automation-job node ids are namespaced separately from workflow-tool
+ * ScheduleEntry ids (adapters/schedule.ts's scheduleNodeId) — same kind
+ * ('schedule'), completely different id space (AutomationJob.id vs
+ * ScheduleEntry.name), so the two can never collide even though a user
+ * could name a workflow-tool schedule and an automation job identically.
+ */
+export declare function automationJobNodeId(jobId: string): string;
+/** The `raw` shape for an automation-job-sourced 'schedule' node — the source marker registry.ts's control dispatch switches on to route kill/interrupt/resume to AutomationManager instead of ScheduleManager. */
+export interface AutomationJobRaw {
+    readonly source: 'automation-manager';
+    readonly job: AutomationJob;
+}
+/** Type guard for AutomationJobRaw, used by registry.ts to distinguish an automation-job 'schedule' node's `raw` from a workflow-tool ScheduleEntry's `raw` — both share the 'schedule' kind. */
+export declare function isAutomationJobRaw(raw: unknown): raw is AutomationJobRaw;
+/**
+ * AutomationJob → ProcessNode (Wave 6, wo-F item d4). Reuses the 'schedule'
+ * kind rather than inventing a new one — a job created via `/schedule` IS a
+ * schedule from the user's viewpoint, even though it lives in a completely
+ * separate subsystem (platform/automation) from the workflow-tool's
+ * ScheduleManager (platform/tools/workflow) that adapters/schedule.ts
+ * already covers. `raw.source: 'automation-manager'` (AutomationJobRaw)
+ * distinguishes the origin so registry.ts's kill/interrupt/resume dispatch
+ * can route to the right manager.
+ */
+export declare function adaptAutomationJob(job: AutomationJob): ProcessNode;
+//# sourceMappingURL=automation.d.ts.map

package/dist/platform/runtime/fleet/adapters/automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/fleet/adapters/automation.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,mNAAmN;AACnN,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;CAC7B;AAED,iMAAiM;AACjM,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CAExE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,CAelE"}

package/dist/platform/runtime/fleet/adapters/automation.js

@@ -0,0 +1,41 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Automation-job node ids are namespaced separately from workflow-tool
+ * ScheduleEntry ids (adapters/schedule.ts's scheduleNodeId) — same kind
+ * ('schedule'), completely different id space (AutomationJob.id vs
+ * ScheduleEntry.name), so the two can never collide even though a user
+ * could name a workflow-tool schedule and an automation job identically.
+ */
+export function automationJobNodeId(jobId) {
+    return `automation-job:${jobId}`;
+}
+/** Type guard for AutomationJobRaw, used by registry.ts to distinguish an automation-job 'schedule' node's `raw` from a workflow-tool ScheduleEntry's `raw` — both share the 'schedule' kind. */
+export function isAutomationJobRaw(raw) {
+    return raw !== null && typeof raw === 'object' && raw.source === 'automation-manager';
+}
+/**
+ * AutomationJob → ProcessNode (Wave 6, wo-F item d4). Reuses the 'schedule'
+ * kind rather than inventing a new one — a job created via `/schedule` IS a
+ * schedule from the user's viewpoint, even though it lives in a completely
+ * separate subsystem (platform/automation) from the workflow-tool's
+ * ScheduleManager (platform/tools/workflow) that adapters/schedule.ts
+ * already covers. `raw.source: 'automation-manager'` (AutomationJobRaw)
+ * distinguishes the origin so registry.ts's kill/interrupt/resume dispatch
+ * can route to the right manager.
+ */
+export function adaptAutomationJob(job) {
+    return {
+        id: automationJobNodeId(job.id),
+        kind: 'schedule',
+        parentId: undefined,
+        label: job.name,
+        task: job.execution.prompt,
+        state: job.enabled ? 'idle' : 'paused',
+        startedAt: job.lastRunAt,
+        elapsedMs: 0,
+        costUsd: null,
+        costState: 'unpriced',
+        capabilities: { interruptible: false, killable: true, pausable: job.enabled, resumable: !job.enabled, steerable: false },
+        raw: { source: 'automation-manager', job },
+    };
+}

package/dist/platform/runtime/fleet/adapters/background-process.d.ts

@@ -0,0 +1,12 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import type { BackgroundProcess } from '../../../tools/shared/process-manager.js';
+import type { ProcessNode } from '../types.js';
+/** Last non-empty stdout line — already tracked on the record, no new emission needed. */
+export declare function lastOutputLine(stdout: readonly string[]): string | undefined;
+/**
+ * BackgroundProcess → ProcessNode. Silent source (no bus emission): liveness
+ * rides the registry tick; currentActivity is the last stdout line the
+ * ProcessManager already buffers.
+ */
+export declare function adaptBackgroundProcess(record: BackgroundProcess, now: number): ProcessNode;
+//# sourceMappingURL=background-process.d.ts.map