@wrongstack/core 0.275.0 → 0.276.2

package/dist/{models-registry-CrkcxQ-g.d.ts → models-registry-8XOdxWQu.d.ts}

@@ -1,4 +1,4 @@
-import { M as ModelsRegistry, a as ModelsDevPayload, R as ResolvedProvider, b as ResolvedModel, W as WireFamily } from './config-BzFRKkg7.js';
+import { M as ModelsRegistry, a as ModelsDevPayload, R as ResolvedProvider, b as ResolvedModel, W as WireFamily } from './config-Bf5mj-ad.js';
 
 interface DefaultModelsRegistryOptions {
     cacheFile: string;
@@ -42,6 +42,14 @@ declare class DefaultModelsRegistry implements ModelsRegistry {
     private payload?;
     /** Memoised overlay payload (in-memory / fetched / file). */
     private overlayPayload?;
+    /**
+     * Extra providers injected at runtime via `mergeOverlay()` — e.g. an
+     * openai-compatible server (omniroute, LiteLLM, …) auto-discovered from its
+     * `/v1/models` endpoint at boot. Applied LAST (on top of base + curated
+     * overlay) and re-applied across `refresh()` so the discovered catalog
+     * survives a models.dev refetch.
+     */
+    private extraOverlay?;
     private fetchedAt?;
     private readonly cacheFile;
     private readonly url;
@@ -58,6 +66,13 @@ declare class DefaultModelsRegistry implements ModelsRegistry {
     load(opts?: {
         force?: boolean | undefined;
     }): Promise<ModelsDevPayload>;
+    /**
+     * Merge an additional provider payload on top of the resolved catalog. Used
+     * for runtime-discovered openai-compatible providers. Remembered so it is
+     * re-applied across `refresh()`. A no-op for an empty payload.
+     */
+    mergeOverlay(payload: ModelsDevPayload): void;
+    private withExtraOverlay;
     /**
      * Load the models.dev base payload: fresh cache → network → stale cache.
      * On total failure, degrade to `{}` (so a non-empty overlay still drives

package/dist/{multi-agent-coordinator-Dc_HuG9p.d.ts → multi-agent-coordinator-CiRtKVTk.d.ts}

@@ -1,4 +1,4 @@
-import { S as SubagentConfig, M as MultiAgentCoordinator, c as MultiAgentConfig, d as SubagentRunner, F as FleetBus, e as SpawnResult, T as TaskSpec, a as BridgeMessage, A as AgentBridge, C as CoordinatorStatus, f as TaskResult } from './agent-subagent-runner-CArSFKFl.js';
+import { S as SubagentConfig, M as MultiAgentCoordinator, c as MultiAgentConfig, d as SubagentRunner, e as BudgetSessionIdSource, F as FleetBus, f as SpawnResult, T as TaskSpec, a as BridgeMessage, A as AgentBridge, C as CoordinatorStatus, g as TaskResult } from './agent-subagent-runner-CEuw4ATz.js';
 import { EventEmitter } from 'node:events';
 
 /**
@@ -170,11 +170,17 @@ interface MultiAgentCoordinatorOptions {
      * own bridge) and enforces timeout + concurrency.
      */
     runner?: SubagentRunner | undefined;
+    /**
+     * Session id for EventBus/FleetBus emissions produced by this coordinator.
+     * Accepts a getter so a long-lived coordinator follows session resume/new.
+     */
+    sessionId?: BudgetSessionIdSource | undefined;
 }
 declare class DefaultMultiAgentCoordinator extends EventEmitter implements MultiAgentCoordinator {
     readonly coordinatorId: string;
     readonly config: MultiAgentConfig;
     private runner?;
+    private readonly sessionId;
     private fleetBus?;
     private readonly subagents;
     /**
@@ -204,6 +210,7 @@ declare class DefaultMultiAgentCoordinator extends EventEmitter implements Multi
      */
     private readonly terminating;
     constructor(config: MultiAgentConfig, options?: MultiAgentCoordinatorOptions);
+    private currentSessionId;
     /**
      * Replace the runner after construction. Used when the runner depends
      * on infrastructure (e.g. FleetBus) that isn't available until after

package/dist/{null-fleet-bus-BMZwMin7.d.ts → null-fleet-bus-d9G-bVy9.d.ts}

@@ -1,12 +1,12 @@
-import { A as AgentPhase, b as AgentDefinition, a as DefaultMultiAgentCoordinator, D as DispatchClassifier } from './multi-agent-coordinator-Dc_HuG9p.js';
-import { F as FleetBus, i as FleetUsage, S as SubagentConfig, j as FleetUsageAggregator, f as TaskResult, C as CoordinatorStatus, T as TaskSpec, c as MultiAgentConfig, d as SubagentRunner } from './agent-subagent-runner-CArSFKFl.js';
-import { b as SessionWriter, T as Tool, k as SessionStore } from './context-BrLe8pJy.js';
-import { B as BrainArbiter, E as EventBus } from './brain-DCkB5_e7.js';
+import { A as AgentPhase, b as AgentDefinition, a as DefaultMultiAgentCoordinator, D as DispatchClassifier } from './multi-agent-coordinator-CiRtKVTk.js';
+import { F as FleetBus, j as FleetUsage, S as SubagentConfig, k as FleetUsageAggregator, g as TaskResult, C as CoordinatorStatus, T as TaskSpec, c as MultiAgentConfig, d as SubagentRunner } from './agent-subagent-runner-CEuw4ATz.js';
+import { b as SessionWriter, T as Tool, k as SessionStore } from './context-CLnUMW5g.js';
+import { B as BrainArbiter, E as EventBus } from './brain-BLOyN5ZP.js';
 import { EventEmitter } from 'node:events';
 import { L as Logger } from './logger-B63L5bTg.js';
 import { D as DirectorStateSnapshot } from './director-state-BfeCUbmk.js';
-import { d as ModelMatrixEntry } from './config-BzFRKkg7.js';
-import { I as InMemoryAgentBridge } from './agent-bridge-D9JkPvJ0.js';
+import { d as ModelMatrixEntry } from './config-Bf5mj-ad.js';
+import { I as InMemoryAgentBridge } from './agent-bridge-D7A-eu3C.js';
 
 /**
  * Alert levels the Director can emit when a collab session needs attention.
@@ -901,6 +901,12 @@ interface DirectorOptions {
      * writer the host Agent uses so all events land in a single JSONL.
      */
     sessionWriter?: SessionWriter | undefined;
+    /**
+     * Session id for live fleet/coordinator events. Defaults to
+     * `sessionWriter.id` when a writer is available; accepts a getter so
+     * embedding surfaces can follow session swaps.
+     */
+    sessionId?: string | (() => string | undefined) | undefined;
     /**
      * Debounce window for periodic manifest writes triggered by spawn/
      * assign/complete events. Default: 2000ms. Pass 0 to disable periodic
@@ -946,7 +952,7 @@ interface DirectorOptions {
     /**
      * Sessions root directory for per-subagent JSONL transcripts.
      * When set, the director can read subagent transcripts directly for
-     * `fleet_session` tool — no bridge round-trip needed. Path convention:
+     * `fleet` tool (action: session) — no bridge round-trip needed. Path convention:
      * `<sessionsRoot>/<directorRunId>/<subagentId>.jsonl`.
      */
     sessionsRoot?: string | undefined;
@@ -1041,6 +1047,7 @@ declare class Director implements ICoordinator {
      */
     getLeaderContextPressure(): number;
     private resolveMaxContext;
+    private currentSessionId;
     /** Optional Brain arbiter for director-level policy decisions. */
     private readonly brain?;
     /**
@@ -1100,6 +1107,7 @@ declare class Director implements ICoordinator {
     private readonly stateCheckpoint;
     /** Optional session writer for emitting task_* / agent_* lifecycle events. */
     private readonly sessionWriter;
+    private readonly sessionIdSource;
     /** Debounce timer for periodic manifest writes. */
     private manifestTimer;
     private readonly manifestDebounceMs;
@@ -1107,7 +1115,7 @@ declare class Director implements ICoordinator {
     private readonly maxFleetCostUsd;
     /** Max auto-extensions per subagent per budget kind before denying. */
     private readonly maxBudgetExtensions;
-    /** Sessions root for direct subagent JSONL reads (fleet_session tool). */
+    /** Sessions root for direct subagent JSONL reads (fleet tool, action: session). */
     private readonly sessionsRoot?;
     /** Director run id for JSONL path resolution. */
     private readonly directorRunId;
@@ -1468,21 +1476,17 @@ declare function makeAskTool(director: Director): Tool;
 declare function makeAskResultTool(director: Director): Tool;
 declare function makeRollUpTool(director: Director): Tool;
 declare function makeTerminateTool(director: Director): Tool;
-declare function makeFleetStatusTool(director: Director): Tool;
-declare function makeFleetUsageTool(director: Director): Tool;
+declare function makeTerminateAllTool(director: Director): Tool;
 /**
- * Read a subagent's JSONL transcript and return the last assistant text,
- * stop reason, and tool-use count. The director can call this on a
- * running or timed-out subagent to see what it actually produced without
- * having to wait for natural completion.
- */
-declare function makeFleetSessionTool(director: Director): Tool;
-/**
- * Health snapshot per subagent — budget pressure (how close to limits),
- * last activity timestamp, and current status. Lets the director make
- * smarter routing decisions without having to call fleet_usage + fleet_status separately.
+ * Unified fleet observation tool — consolidates the former fleet_status,
+ * fleet_usage, fleet_session, and fleet_health tools under a single `action`
+ * parameter (status, usage, health, session).
+ *
+ * These four are all read-only fleet queries; merging them into one tool
+ * reduces tool-schema token overhead (4 × ~150 tokens → 1 × ~250 tokens)
+ * and eliminates model confusion when choosing between similar tools.
  */
-declare function makeFleetHealthTool(director: Director): Tool;
+declare function makeFleetTool(director: Director): Tool;
 /**
  * Collaborative debugging session: BugHunter, RefactorPlanner, and Critic
  * run in parallel on the same target files, with findings flowing through
@@ -1900,4 +1904,4 @@ declare function attachAutoExtend(events: EventBus, policy?: AutoExtendPolicy):
  */
 declare const NULL_FLEET_BUS: FleetBus;
 
-export { getAgentDefinition as $, ACP_AGENTS as A, BUG_HUNTER_AGENT as B, type CollabBudgetConfig as C, DEFAULT_DIRECTOR_PREAMBLE as D, FLEET_ROSTER_WITHACP as E, FLEET_ROSTER as F, FleetCostCapError as G, FleetManager as H, type FleetManagerOptions as I, type FleetRosterBudget as J, FleetSpawnBudgetError as K, type ICoordinator as L, type IFleetManager as M, LargeAnswerStore as N, NULL_FLEET_BUS as O, type RefactorPhase as P, type RefactorPlan as Q, REFACTOR_PLANNER_AGENT as R, SECURITY_SCANNER_AGENT as S, type SharedFileEntry as T, type SharedFileSnapshot as U, type SubagentPromptParts as V, applyRosterBudget as W, attachAutoExtend as X, composeDirectorPrompt as Y, composeSubagentPrompt as Z, createDelegateTool as _, AGENTS_BY_PHASE as a, makeAskResultTool as a0, makeAskTool as a1, makeAssignTool as a2, makeAwaitTasksTool as a3, makeCollabDebugTool as a4, makeDirectorSessionFactory as a5, makeFleetEmitTool as a6, makeFleetHealthTool as a7, makeFleetSessionTool as a8, makeFleetStatusTool as a9, makeFleetUsageTool as aa, makeRollUpTool as ab, makeSpawnTool as ac, makeTerminateTool as ad, makeWorkCompleteTool as ae, rosterSummaryFromConfigs as af, AGENT_CATALOG as b, ALL_AGENT_DEFINITIONS as c, ALL_FLEET_AGENTS as d, AUDIT_LOG_AGENT as e, type AutoExtendCeiling as f, type AutoExtendPolicy as g, type BugFinding as h, type CollabBudgetOverrides as i, type CollabBudgetWarningPayload as j, type CollabDebugReport as k, CollabSession as l, type CollabSessionOptions as m, type CreateDelegateToolOptions as n, type CriticConcern as o, type CriticEvaluation as p, DEFAULT_SUBAGENT_BASELINE as q, type DelegateHost as r, Director as s, type DirectorAlert as t, DirectorAlertLevel as u, type DirectorCancelCollabPayload as v, type DirectorPromptParts as w, type DirectorSessionFactory as x, type DirectorSessionFactoryOptions as y, FLEET_ROSTER_BUDGETS as z };
+export { getAgentDefinition as $, ACP_AGENTS as A, BUG_HUNTER_AGENT as B, type CollabBudgetConfig as C, DEFAULT_DIRECTOR_PREAMBLE as D, FLEET_ROSTER_WITHACP as E, FLEET_ROSTER as F, FleetCostCapError as G, FleetManager as H, type FleetManagerOptions as I, type FleetRosterBudget as J, FleetSpawnBudgetError as K, type ICoordinator as L, type IFleetManager as M, LargeAnswerStore as N, NULL_FLEET_BUS as O, type RefactorPhase as P, type RefactorPlan as Q, REFACTOR_PLANNER_AGENT as R, SECURITY_SCANNER_AGENT as S, type SharedFileEntry as T, type SharedFileSnapshot as U, type SubagentPromptParts as V, applyRosterBudget as W, attachAutoExtend as X, composeDirectorPrompt as Y, composeSubagentPrompt as Z, createDelegateTool as _, AGENTS_BY_PHASE as a, makeAskResultTool as a0, makeAskTool as a1, makeAssignTool as a2, makeAwaitTasksTool as a3, makeCollabDebugTool as a4, makeDirectorSessionFactory as a5, makeFleetEmitTool as a6, makeFleetTool as a7, makeRollUpTool as a8, makeSpawnTool as a9, makeTerminateAllTool as aa, makeTerminateTool as ab, makeWorkCompleteTool as ac, rosterSummaryFromConfigs as ad, AGENT_CATALOG as b, ALL_AGENT_DEFINITIONS as c, ALL_FLEET_AGENTS as d, AUDIT_LOG_AGENT as e, type AutoExtendCeiling as f, type AutoExtendPolicy as g, type BugFinding as h, type CollabBudgetOverrides as i, type CollabBudgetWarningPayload as j, type CollabDebugReport as k, CollabSession as l, type CollabSessionOptions as m, type CreateDelegateToolOptions as n, type CriticConcern as o, type CriticEvaluation as p, DEFAULT_SUBAGENT_BASELINE as q, type DelegateHost as r, Director as s, type DirectorAlert as t, DirectorAlertLevel as u, type DirectorCancelCollabPayload as v, type DirectorPromptParts as w, type DirectorSessionFactory as x, type DirectorSessionFactoryOptions as y, FLEET_ROSTER_BUDGETS as z };

package/dist/observability/index.d.ts

@@ -1,6 +1,6 @@
 import { M as MetricsSink, d as MetricLabels, f as MetricsSnapshot, H as HealthRegistry, a as HealthCheck, A as AggregateHealth, T as Tracer, S as Span } from '../observability-D-HZN_mF.js';
-import { E as EventBus } from '../brain-DCkB5_e7.js';
-import '../context-BrLe8pJy.js';
+import { E as EventBus } from '../brain-BLOyN5ZP.js';
+import '../context-CLnUMW5g.js';
 
 /**
  * In-memory metrics sink. Suitable for embedded use, tests, and /metrics

package/dist/{path-resolver-uVK4BatM.d.ts → path-resolver-BhIb6mtd.d.ts}

@@ -1,6 +1,6 @@
-import { E as EventBus } from './brain-DCkB5_e7.js';
-import { M as ModelsRegistry, b as ResolvedModel } from './config-BzFRKkg7.js';
-import { e as TokenCounter, U as Usage, f as CacheStats } from './context-BrLe8pJy.js';
+import { E as EventBus } from './brain-BLOyN5ZP.js';
+import { M as ModelsRegistry, b as ResolvedModel } from './config-Bf5mj-ad.js';
+import { e as TokenCounter, U as Usage, f as CacheStats } from './context-CLnUMW5g.js';
 import { P as PathResolver } from './path-resolver-CPRj4bFY.js';
 
 /**
@@ -18,6 +18,7 @@ declare class DefaultTokenCounter implements TokenCounter {
     private readonly registry?;
     private readonly providerId?;
     private readonly events?;
+    private sessionId?;
     private priceCache;
     /** Most recently accounted request's tokens. Used for per-request context pressure. */
     private lastInput;
@@ -26,7 +27,9 @@ declare class DefaultTokenCounter implements TokenCounter {
         registry?: ModelsRegistry | undefined;
         providerId?: string | undefined;
         events?: EventBus | undefined;
+        sessionId?: string | (() => string | undefined) | undefined;
     });
+    setSessionId(sessionId: string | (() => string | undefined) | undefined): void;
     account(usage: Usage, model?: string): void;
     /** Synchronous variant for code paths that have already resolved the model. */
     accountWithModel(usage: Usage, resolved: ResolvedModel): void;
@@ -35,6 +38,7 @@ declare class DefaultTokenCounter implements TokenCounter {
         input: number;
         cacheRead: number;
     };
+    setCurrentRequestTokens(input: number, cacheRead?: number): void;
     estimateCost(): {
         input: number;
         output: number;
@@ -45,6 +49,7 @@ declare class DefaultTokenCounter implements TokenCounter {
     /** Invalidate cached prices so the next account() call fetches fresh data. */
     invalidateCache(): void;
     private emitAccounted;
+    private currentSessionId;
     reset(): void;
     private applyPrice;
 }

package/dist/{permission-CJR1qfOi.d.ts → permission-BCbQDR2s.d.ts}

@@ -1,4 +1,4 @@
-import { T as Tool, C as Context, h as Permission } from './context-BrLe8pJy.js';
+import { T as Tool, C as Context, h as Permission } from './context-CLnUMW5g.js';
 
 interface SecretScrubber {
     scrub(text: string): string;

package/dist/{permission-policy-DLVKKk4w.d.ts → permission-policy-C0ikndX_.d.ts}

@@ -1,6 +1,6 @@
-import { T as Tool, C as Context } from './context-BrLe8pJy.js';
+import { T as Tool, C as Context } from './context-CLnUMW5g.js';
 import { I as InputReader } from './input-reader-E-ffP2ee.js';
-import { P as PermissionPolicy, a as PermissionDecision } from './permission-CJR1qfOi.js';
+import { P as PermissionPolicy, a as PermissionDecision } from './permission-BCbQDR2s.js';
 
 interface PermissionPolicyOptions {
     trustFile: string;
@@ -122,22 +122,6 @@ declare class DefaultPermissionPolicy implements PermissionPolicy {
     }): void;
     private findNamespaceEntry;
 }
-/**
- * Auto-approving PermissionPolicy used for subagents. Subagents run
- * non-interactively under a director — they cannot answer permission
- * prompts, so a non-YOLO policy on the leader would silently hang the
- * delegated run on the first sensitive tool call. The user already
- * authorized the delegation when they invoked the leader; subagents
- * inherit that authorization automatically.
- *
- * Tool defaults of `permission: 'deny'` are still honored (this is a
- * subagent capability override, not a deny-bypass).
- *
- * 2026-06+: Primary decision is now based on declared `Tool.capabilities`
- * (capability allowlist / denylist model). The legacy name-based DENY set
- * is kept only for backward compatibility with tools that have not yet
- * declared capabilities.
- */
 /**
  * Auto-approving PermissionPolicy used for subagents. Subagents run
  * non-interactively under a director — they cannot answer permission

package/dist/{pipeline-BYR-Vdau.d.ts → pipeline-Dl6XbfE7.d.ts}

@@ -1,6 +1,6 @@
-import { T as Tool, q as TextBlock, i as ContentBlock } from './context-BrLe8pJy.js';
-import { a as MailboxAgentStatus } from './mailbox-types-_7gaY0Rl.js';
-import { H as HookEvent, f as HookMatcher, I as InProcessHook, S as ShellHook, g as HookEntry, T as ToolResultRenderMode } from './config-BzFRKkg7.js';
+import { T as Tool, r as TextBlock, i as ContentBlock } from './context-CLnUMW5g.js';
+import { a as MailboxAgentStatus } from './mailbox-types-DTl7bRH3.js';
+import { H as HookEvent, f as HookMatcher, I as InProcessHook, S as ShellHook, g as HookEntry, T as ToolResultRenderMode } from './config-Bf5mj-ad.js';
 
 /** Model capabilities relevant to prompt composition. */
 interface ModelCapabilities {
@@ -208,9 +208,13 @@ type MiddlewareHandler<T> = (value: T, next: NextFn<T>) => Promise<T>;
  * Pipeline's error boundary to log the offender without aborting the run.
  *
  * Return `'rethrow'` to propagate the error (default for core middleware),
- * or `'swallow'` to skip past the crashing middleware and continue with the
- * value the previous one produced. Plugin middleware should usually be
- * swallowed so one bad plugin can't kill an agent run.
+ * or `'swallow'` to abort descent into the crashing middleware: its caller's
+ * `await next()` resolves with the value that was about to flow into the
+ * crashed middleware. The crashed middleware AND every middleware after it in
+ * the chain are skipped (they never run); UPSTREAM middleware, already paused
+ * at their own `await next()`, resume their post-`next()` work normally. It
+ * does NOT continue at the next sibling middleware. Plugin middleware should
+ * usually be swallowed so one bad plugin can't kill an agent run.
  */
 type PipelineErrorPolicy = 'rethrow' | 'swallow';
 interface PipelineErrorEvent {

package/dist/{provider-model-resolve-iREK_1lG.d.ts → provider-model-resolve-B70epO19.d.ts}

@@ -1,7 +1,7 @@
-import { P as Provider, M as Message } from './context-BrLe8pJy.js';
-import { M as MessageSelector, S as SelectorResult } from './selector-qjpee9BF.js';
+import { P as Provider, M as Message } from './context-CLnUMW5g.js';
+import { M as MessageSelector, S as SelectorResult } from './selector-BCkWgdwy.js';
 import { M as ModeStore, a as ModeConfig, b as Mode } from './mode-CZlO9iU1.js';
-import { e as ModelsDevModel, R as ResolvedProvider } from './config-BzFRKkg7.js';
+import { e as ModelsDevModel, R as ResolvedProvider } from './config-Bf5mj-ad.js';
 
 /**
  * Offline **floor** for the ChatGPT "Sign in with ChatGPT" (`openai-codex`)

package/dist/{provider-runner-i7SQXZuC.d.ts → provider-runner-DZ808MSM.d.ts}

@@ -1,8 +1,8 @@
-import { E as EventBus } from './brain-DCkB5_e7.js';
+import { E as EventBus } from './brain-BLOyN5ZP.js';
 import { L as Logger } from './logger-B63L5bTg.js';
 import { T as Tracer } from './observability-D-HZN_mF.js';
-import { P as Provider, c as Request, C as Context, d as Response } from './context-BrLe8pJy.js';
-import { R as RetryPolicy } from './retry-policy-BmY5ooh3.js';
+import { P as Provider, c as Request, C as Context, d as Response } from './context-CLnUMW5g.js';
+import { R as RetryPolicy } from './retry-policy-Dt3_z8Aj.js';
 
 /**
  * Options passed to a ProviderRunner when calling the provider.

package/dist/{retry-policy-BmY5ooh3.d.ts → retry-policy-Dt3_z8Aj.d.ts}

@@ -1,4 +1,4 @@
-import { C as Context, d as Response, g as ProviderError } from './context-BrLe8pJy.js';
+import { C as Context, d as Response, g as ProviderError } from './context-CLnUMW5g.js';
 
 type RecoveryDecision = {
     /**

package/dist/sdd/index.d.ts

@@ -1,17 +1,17 @@
 import { h as Specification, e as SpecStatus, S as SpecAnalysis, g as SpecValidationResult, f as SpecTemplate, b as SpecRequirement } from '../spec-TBi3Jr6T.js';
 import { d as TaskGraph, e as TaskNode, i as TaskFilter, j as TaskSort, c as TaskProgress, T as TaskType, a as TaskPriority } from '../task-graph-u1q9Jkyk.js';
-import { E as EventBus, B as BrainArbiter } from '../brain-DCkB5_e7.js';
-import { g as Agent, h as AgentFactory, f as TaskResult, D as DoneCondition } from '../agent-subagent-runner-CArSFKFl.js';
-import { W as WorktreeManager } from '../worktree-manager-A1Efnvs0.js';
-import '../context-BrLe8pJy.js';
-import '../index-CtlizLTK.js';
+import { E as EventBus, B as BrainArbiter } from '../brain-BLOyN5ZP.js';
+import { h as Agent, i as AgentFactory, g as TaskResult, D as DoneCondition } from '../agent-subagent-runner-CEuw4ATz.js';
+import { W as WorktreeManager } from '../worktree-manager-DBdl_5rs.js';
+import '../context-CLnUMW5g.js';
+import '../index-Cn0NOshr.js';
 import '../logger-B63L5bTg.js';
-import '../pipeline-BYR-Vdau.js';
-import '../mailbox-types-_7gaY0Rl.js';
-import '../config-BzFRKkg7.js';
+import '../pipeline-Dl6XbfE7.js';
+import '../mailbox-types-DTl7bRH3.js';
+import '../config-Bf5mj-ad.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-CJR1qfOi.js';
-import '../retry-policy-BmY5ooh3.js';
+import '../permission-BCbQDR2s.js';
+import '../retry-policy-Dt3_z8Aj.js';
 
 interface TaskStore {
     saveGraph(graph: TaskGraph): Promise<void>;
@@ -641,6 +641,8 @@ interface SddParallelRunOptions {
     onProgress?: ((progress: SddProgress) => void) | undefined;
     /** Shared EventBus — when set, the run emits `sdd.*` live-board events. */
     events?: EventBus | undefined;
+    /** Parent session id for every emitted `sdd.*` event. */
+    sessionId?: string | (() => string | undefined) | undefined;
     /** Stable id correlating all events of this run (default: random). */
     runId?: string | undefined;
     /**
@@ -717,6 +719,7 @@ declare class SddParallelRun {
     private retryMap;
     readonly runId: string;
     private readonly events?;
+    private readonly sessionIdSource;
     private readonly maxTotalWaves;
     private readonly maxWallClockMs?;
     private readonly maxRecoveryRounds;
@@ -750,6 +753,7 @@ declare class SddParallelRun {
     constructor(opts: SddParallelRunOptions);
     /** Type-safe emit on the optional EventBus (no-op when unwired). */
     private emit;
+    private currentSessionId;
     private paused;
     /** Trigger stop — causes run() to abort after the current wave. */
     stop(): void;
@@ -1005,6 +1009,8 @@ interface SddBoardProjectorOptions {
     graph: TaskGraph;
     tracker: TaskTracker;
     events: EventBus;
+    /** Parent session id for emitted `sdd.board.snapshot` events. */
+    sessionId?: string | (() => string | undefined) | undefined;
     /** Persist snapshots + JSONL events (optional — omit for in-memory only). */
     store?: SddBoardStore | undefined;
     specId?: string | undefined;
@@ -1060,6 +1066,7 @@ declare class SddBoardProjector {
     private build;
     private markDirty;
     private flush;
+    private currentSessionId;
 }
 
 interface SpecStoreOptions {
@@ -1740,6 +1747,8 @@ interface StartSddRunOptions {
     agent: Agent;
     projectRoot: string;
     events: EventBus;
+    /** Parent session id for all SDD EventBus emissions. */
+    sessionId?: string | (() => string | undefined) | undefined;
     /** Per-task agent factory. Omit to run every task on the leader agent. */
     subagentFactory?: AgentFactory | undefined;
     /** Board snapshot/event persistence (also drained for cross-process control). */