@wrongstack/core 0.1.10 → 0.2.0

package/dist/{events-BMNaEFZl.d.ts → events-B6Q03pTu.d.ts}

@@ -1,4 +1,4 @@
-import { U as Usage, a0 as Context, y as ToolProgressEvent, u as Tool } from './context-BmM2xGUZ.js';
+import { U as Usage, a0 as Context, y as ToolProgressEvent, u as Tool } from './context-u0bryklF.js';
 
 /**
  * EventBus — observe-only typed event bus.
@@ -173,6 +173,78 @@ interface EventMap {
         load: number;
         fatal: boolean;
     };
+    /**
+     * Subagent lifecycle events. Emitted by `MultiAgentHost` so the TUI can
+     * surface what's happening in the fleet without needing director-mode
+     * (which renders the live FleetPanel). These complement the FleetBus
+     * (director-only) by giving the TUI a uniform feed for both `/spawn`
+     * and director-orchestrated work.
+     */
+    'subagent.spawned': {
+        subagentId: string;
+        taskId: string;
+        name?: string;
+        provider?: string;
+        model?: string;
+        description?: string;
+        /**
+         * Absolute path to the per-subagent JSONL transcript on disk, when
+         * one was created. Undefined when the subagent shares the parent
+         * session writer (in-memory or single-file configurations).
+         * Surfaced so the TUI (FleetPanel) and `/fleet log` can show the
+         * user *where* to look without computing it from the run id.
+         */
+        transcriptPath?: string;
+    };
+    'subagent.task_started': {
+        subagentId: string;
+        taskId: string;
+        description?: string;
+    };
+    /**
+     * Per-tool-call event re-emitted from a subagent's own EventBus
+     * onto the host EventBus, so the TUI / non-director surfaces can
+     * render "AGENT#1 ● bash 250ms" without having to subscribe to
+     * the director-only FleetBus. Fired AFTER the tool completes
+     * (paired with `tool.executed`). Includes the subagent id so
+     * multiple parallel subagents are distinguishable.
+     */
+    'subagent.tool_executed': {
+        subagentId: string;
+        taskId?: string;
+        name: string;
+        durationMs: number;
+        ok: boolean;
+        input?: unknown;
+        outputBytes?: number;
+    };
+    'subagent.task_completed': {
+        subagentId: string;
+        taskId: string;
+        status: 'success' | 'failed' | 'timeout' | 'stopped';
+        iterations: number;
+        toolCalls: number;
+        durationMs: number;
+        /**
+         * Structured failure envelope when `status !== 'success'`. Carries
+         * `kind` (one of `SubagentErrorKind`), `message`, `retryable`, and
+         * optional `backoffMs`. UIs branch on `kind` to render the right
+         * chip (rate_limit vs auth vs tool_failed). The type is imported
+         * lazily as a structural object to avoid a coordination → kernel
+         * cycle in the dependency graph.
+         */
+        error?: {
+            kind: string;
+            message: string;
+            retryable: boolean;
+            backoffMs?: number;
+            cause?: {
+                name: string;
+                message: string;
+                stack?: string;
+            };
+        };
+    };
     'mcp.server.connected': {
         name: string;
         toolCount: number;

package/dist/execution/index.d.ts

@@ -1,17 +1,17 @@
-export { C as CompactorOptions, D as DefaultErrorHandler, a as DefaultRetryPolicy, H as HybridCompactor, T as ToolExecutor } from '../tool-executor-CpuJPYm9.js';
-import { g as Provider, a0 as Context } from '../context-BmM2xGUZ.js';
-import { C as Compactor, a as CompactReport } from '../compactor-B4mQZXf2.js';
-import { M as MessageSelector } from '../selector-BbJqiEP4.js';
-import { E as EventBus } from '../events-BMNaEFZl.js';
-import { a as MiddlewareHandler } from '../renderer-rk_1Swwc.js';
-import { A as Agent, R as RunResult } from '../plugin-DJk6LL8B.js';
-import { D as DoneCondition } from '../multi-agent-fmkRHtof.js';
-import { a as SkillLoader, b as SkillManifest, S as SkillEntry } from '../skill-DhfSizKv.js';
+export { C as CompactorOptions, D as DefaultErrorHandler, a as DefaultRetryPolicy, H as HybridCompactor, T as ToolExecutor } from '../tool-executor-CYdZdtno.js';
+import { g as Provider, a0 as Context } from '../context-u0bryklF.js';
+import { C as Compactor, a as CompactReport } from '../compactor-DSl2FK7a.js';
+import { M as MessageSelector } from '../selector-BRqzvugb.js';
+import { E as EventBus } from '../events-B6Q03pTu.js';
+import { a as MiddlewareHandler } from '../renderer-0A2ZEtca.js';
+import { A as Agent, R as RunResult } from '../plugin-CoYYZKdn.js';
+import { D as DoneCondition } from '../multi-agent-BDfkxL5C.js';
+import { a as SkillLoader, b as SkillManifest, S as SkillEntry } from '../skill-Bx8jxznf.js';
 import { a as WstackPaths } from '../wstack-paths-BGu2INTm.js';
 import '../models-registry-Y2xbog0E.js';
 import '../observability-BhnVLBLS.js';
-import '../secret-scrubber-CicHLN4G.js';
-import '../config-BU9f_5yH.js';
+import '../secret-scrubber-3TLUkiCV.js';
+import '../config-DXrqb41m.js';
 import '../logger-BMQgxvdy.js';
 
 interface SkillLoaderOptions {

package/dist/index.d.ts

@@ -1,51 +1,51 @@
-import { C as Container } from './renderer-rk_1Swwc.js';
-export { B as BindOptions, D as Decorator, F as Factory, M as Middleware, a as MiddlewareHandler, N as NextFn, P as Pipeline, b as PipelineOptions, R as Renderer, T as Token } from './renderer-rk_1Swwc.js';
-import { E as EventBus, a as EventName, L as Listener } from './events-BMNaEFZl.js';
-export { b as EventLogger, c as EventMap } from './events-BMNaEFZl.js';
+import { C as Container } from './renderer-0A2ZEtca.js';
+export { B as BindOptions, D as Decorator, F as Factory, M as Middleware, a as MiddlewareHandler, N as NextFn, P as Pipeline, b as PipelineOptions, R as Renderer, T as Token } from './renderer-0A2ZEtca.js';
+import { E as EventBus, a as EventName, L as Listener } from './events-B6Q03pTu.js';
+export { b as EventLogger, c as EventMap } from './events-B6Q03pTu.js';
 export { RunController, RunControllerOptions, TOKENS } from './kernel/index.js';
-import { b as ContentBlock, T as TextBlock, a0 as Context } from './context-BmM2xGUZ.js';
-export { A as AgentError, C as Capabilities, a as ConfigError, a3 as ContextInit, a4 as ConversationState, E as ErrorCode, c as ErrorSeverity, d as ErrorSubsystem, I as ImageBlock, J as JSONSchema, M as Message, e as MessageRole, P as Permission, f as PluginError, g as Provider, h as ProviderError, i as ProviderErrorBody, a5 as ReadonlyConversationState, R as Request, j as Response, k as ResumedSession, a6 as RunEnv, a7 as RunOptions, S as SessionData, l as SessionError, m as SessionEvent, n as SessionMetadata, o as SessionStore, p as SessionSummary, q as SessionWriter, a8 as StateChange, a9 as StateChangeHandler, r as StopReason, s as StreamEvent, t as ThinkingBlock, aa as TodoItem, a1 as TokenCounter, u as Tool, v as ToolCallContext, w as ToolError, x as ToolFinalEvent, y as ToolProgressEvent, z as ToolResultBlock, B as ToolStreamEvent, D as ToolUseBlock, U as Usage, W as WrongStackError, F as asBlocks, G as asText, ab as extractRunEnv, H as isAgentError, K as isConfigError, L as isImageBlock, N as isPluginError, O as isSessionError, Q as isTextBlock, V as isThinkingBlock, X as isToolError, Y as isToolResultBlock, Z as isToolUseBlock, _ as isWrongStackError, $ as toWrongStackError, ac as wrapAsState } from './context-BmM2xGUZ.js';
-import { C as Config } from './config-BU9f_5yH.js';
-export { a as ConfigLoader, b as ConfigStore, c as ContextConfig, F as FeaturesConfig, L as LogConfig, M as MCPServerConfig, P as PluginConfig, d as ProviderApiKey, e as ProviderConfig, T as ToolsConfig } from './config-BU9f_5yH.js';
-export { P as PermissionDecision, a as PermissionPolicy, T as TrustPolicy } from './secret-scrubber-CicHLN4G.js';
-import { e as AttachmentStore, d as AttachmentRef, A as AddAttachmentInput } from './session-reader-Drq8RvJu.js';
-export { a as Attachment, b as AttachmentKind, c as AttachmentMeta, D as DefaultSessionReader } from './session-reader-Drq8RvJu.js';
-export { D as DefaultSecretScrubber, a as DefaultSecretVault, S as SecretVaultOptions, d as decryptConfigSecrets, e as encryptConfigSecrets, m as migratePlaintextSecrets, r as rewriteConfigEncrypted } from './secret-scrubber-DF88luOe.js';
+import { b as ContentBlock, T as TextBlock, a0 as Context } from './context-u0bryklF.js';
+export { A as AgentError, C as Capabilities, a as ConfigError, a3 as ContextInit, a4 as ConversationState, E as ErrorCode, c as ErrorSeverity, d as ErrorSubsystem, I as ImageBlock, J as JSONSchema, M as Message, e as MessageRole, P as Permission, f as PluginError, g as Provider, h as ProviderError, i as ProviderErrorBody, a5 as ReadonlyConversationState, R as Request, j as Response, k as ResumedSession, a6 as RunEnv, a7 as RunOptions, S as SessionData, l as SessionError, m as SessionEvent, n as SessionMetadata, o as SessionStore, p as SessionSummary, q as SessionWriter, a8 as StateChange, a9 as StateChangeHandler, r as StopReason, s as StreamEvent, t as ThinkingBlock, aa as TodoItem, a1 as TokenCounter, u as Tool, v as ToolCallContext, w as ToolError, x as ToolFinalEvent, y as ToolProgressEvent, z as ToolResultBlock, B as ToolStreamEvent, D as ToolUseBlock, U as Usage, W as WrongStackError, F as asBlocks, G as asText, ab as extractRunEnv, H as isAgentError, K as isConfigError, L as isImageBlock, N as isPluginError, O as isSessionError, Q as isTextBlock, V as isThinkingBlock, X as isToolError, Y as isToolResultBlock, Z as isToolUseBlock, _ as isWrongStackError, $ as toWrongStackError, ac as wrapAsState } from './context-u0bryklF.js';
+import { C as Config } from './config-DXrqb41m.js';
+export { a as ConfigLoader, b as ConfigStore, c as ContextConfig, F as FeaturesConfig, L as LogConfig, M as MCPServerConfig, P as PluginConfig, d as ProviderApiKey, e as ProviderConfig, T as ToolsConfig } from './config-DXrqb41m.js';
+export { P as PermissionDecision, a as PermissionPolicy, T as TrustPolicy } from './secret-scrubber-3TLUkiCV.js';
+import { e as AttachmentStore, d as AttachmentRef, A as AddAttachmentInput } from './session-reader-C3x96CDR.js';
+export { a as Attachment, b as AttachmentKind, c as AttachmentMeta, D as DefaultSessionReader } from './session-reader-C3x96CDR.js';
+export { D as DefaultSecretScrubber, a as DefaultSecretVault, S as SecretVaultOptions, d as decryptConfigSecrets, e as encryptConfigSecrets, m as migratePlaintextSecrets, r as rewriteConfigEncrypted } from './secret-scrubber-CwYliRWd.js';
 export { D as DefaultLogger, a as DefaultLoggerOptions } from './logger-BH6AE0W9.js';
-export { D as DefaultPathResolver, a as DefaultTokenCounter } from './path-resolver-DBjaoXFq.js';
+export { D as DefaultPathResolver, a as DefaultTokenCounter } from './path-resolver-Crkt8wTQ.js';
 import { b as MemoryStore } from './memory-CEXuo7sz.js';
 export { M as MemoryEntry, a as MemoryScope } from './memory-CEXuo7sz.js';
-export { C as CompactorOptions, b as DEFAULT_RECOVERY_STRATEGIES, D as DefaultErrorHandler, a as DefaultRetryPolicy, H as HybridCompactor, R as RecoveryStrategy, T as ToolExecutor, c as buildRecoveryStrategies } from './tool-executor-CpuJPYm9.js';
-import { a as SkillLoader } from './skill-DhfSizKv.js';
-export { S as SkillEntry, b as SkillManifest } from './skill-DhfSizKv.js';
-import { S as SystemPromptBuilder, M as ModelCapabilities, B as BuildContext } from './system-prompt-BC_8ypCG.js';
+export { C as CompactorOptions, b as DEFAULT_RECOVERY_STRATEGIES, D as DefaultErrorHandler, a as DefaultRetryPolicy, H as HybridCompactor, R as RecoveryStrategy, T as ToolExecutor, c as buildRecoveryStrategies } from './tool-executor-CYdZdtno.js';
+import { a as SkillLoader } from './skill-Bx8jxznf.js';
+export { S as SkillEntry, b as SkillManifest } from './skill-Bx8jxznf.js';
+import { S as SystemPromptBuilder, M as ModelCapabilities, B as BuildContext } from './system-prompt-CG9jU5-5.js';
 export { I as InputReader, P as PromptOption } from './input-reader-E-ffP2ee.js';
-import { S as SlashCommand, a as PluginAPI, d as PluginPipelines, T as ToolRegistryView, f as ProviderRegistryView, M as MCPRegistryView, g as SlashCommandRegistryView, k as ToolRegistry, l as ProviderRegistry, P as Plugin } from './plugin-DJk6LL8B.js';
-export { A as Agent, m as AgentInit, n as AgentInput, o as AgentPipelines, D as DEFAULT_MAX_ITERATIONS, b as PluginCapabilities, c as PluginDependency, p as ProviderFactory, R as RunResult, U as UserInputPayload, q as createDefaultPipelines } from './plugin-DJk6LL8B.js';
+import { S as SlashCommand, a as PluginAPI, d as PluginPipelines, T as ToolRegistryView, f as ProviderRegistryView, M as MCPRegistryView, g as SlashCommandRegistryView, k as ToolRegistry, l as ProviderRegistry, P as Plugin } from './plugin-CoYYZKdn.js';
+export { A as Agent, m as AgentInit, n as AgentInput, o as AgentPipelines, D as DEFAULT_MAX_ITERATIONS, b as PluginCapabilities, c as PluginDependency, p as ProviderFactory, R as RunResult, U as UserInputPayload, q as createDefaultPipelines } from './plugin-CoYYZKdn.js';
 export { D as DefaultModelsRegistry, a as DefaultModelsRegistryOptions, c as classifyFamily } from './models-registry-DqzwpBQy.js';
 import { c as ModeStore } from './mode-CV077NjV.js';
 export { D as DEFAULT_MODES, M as Mode, a as ModeConfig, b as ModeManifest } from './mode-CV077NjV.js';
-export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from './agent-bridge-6KPqsFx6.js';
-export { B as BudgetExceededError, a as BudgetKind, b as BudgetLimits, c as BudgetUsage, C as CoordinatorEvents, d as CoordinatorStatus, D as DoneCondition, M as MultiAgentConfig, e as MultiAgentCoordinator, f as SpawnResult, S as SubagentBudget, g as SubagentConfig, h as SubagentContext, i as SubagentRunContext, j as SubagentRunOutcome, k as SubagentRunner, T as TaskDelegation, l as TaskResult, m as TaskSpec } from './multi-agent-fmkRHtof.js';
+export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from './agent-bridge-DmBiCipY.js';
+export { B as BudgetExceededError, a as BudgetKind, b as BudgetLimits, c as BudgetUsage, C as CoordinatorEvents, d as CoordinatorStatus, D as DoneCondition, M as MultiAgentConfig, e as MultiAgentCoordinator, f as SpawnResult, S as SubagentBudget, g as SubagentConfig, h as SubagentContext, i as SubagentError, j as SubagentErrorKind, k as SubagentRunContext, l as SubagentRunOutcome, m as SubagentRunner, T as TaskDelegation, n as TaskResult, o as TaskSpec } from './multi-agent-BDfkxL5C.js';
 export { C as CriticalPathResult, D as DEFAULT_SPEC_TEMPLATE, S as SpecAnalysis, a as SpecApiEndpoint, b as SpecRequirement, c as SpecSection, d as SpecSectionType, e as SpecStatus, f as SpecTemplate, g as SpecValidationResult, h as Specification, T as TaskAssignment, i as TaskDependency, j as TaskEdge, k as TaskFilter, l as TaskGraph, m as TaskNode, n as TaskPriority, o as TaskProgress, p as TaskSort, q as TaskStatus, r as TaskType, s as computeTaskProgress, t as findCriticalPath, u as topologicalSort } from './task-graph-BITvWt4t.js';
 export { A as AggregateHealth, H as HealthCheck, a as HealthCheckResult, b as HealthRegistry, c as HealthStatus, M as MetricLabels, d as MetricSeries, e as MetricsSink, f as MetricsSnapshot, S as Span, T as Tracer } from './observability-BhnVLBLS.js';
 export { AtomicWriteOptions, BuildChildEnvOptions, NewlineStyle, SafeParseResult, ToolOutputSerializerOptions, UnifiedDiffOptions, ValidationError, ValidationResult, atomicWrite, buildChildEnv, color, compileGlob, createToolOutputSerializer, detectNewlineStyle, ensureDir, estimateTextTokens, estimateToolInputTokens, estimateToolResultTokens, formatTodosList, matchAny, matchGlob, normalizeToLf, safeParse, safeStringify, sanitizeJsonString, stripAnsi, toStyle, unifiedDiff, validateAgainstSchema } from './utils/index.js';
 export { W as WstackPathOptions, a as WstackPaths, p as projectHash, r as resolveWstackPaths } from './wstack-paths-BGu2INTm.js';
-export { AbandonedSession, AttachmentStoreOptions, ConfigLoaderOptions, ConfigMigration, ConfigMigrationError, ConfigSource, DEFAULT_CONFIG_MIGRATIONS, DefaultAttachmentStore, DefaultConfigLoader, DefaultConfigStore, DefaultMemoryStore, DefaultSessionStore, MemoryStoreOptions, MigrationContext, MigrationResult, PersistedQueueItem, QueueStore, RecoveryLock, RecoveryLockOptions, SessionAnalyzer, SessionStoreOptions, runConfigMigrations } from './storage/index.js';
-export { DefaultPermissionPolicy, PermissionPolicyOptions } from './security/index.js';
+export { AbandonedSession, AttachmentStoreOptions, ConfigLoaderOptions, ConfigMigration, ConfigMigrationError, ConfigSource, DEFAULT_CONFIG_MIGRATIONS, DefaultAttachmentStore, DefaultConfigLoader, DefaultConfigStore, DefaultMemoryStore, DefaultSessionStore, DirectorStateCheckpoint, DirectorStateSnapshot, DirectorSubagentState, DirectorTaskState, MemoryStoreOptions, MigrationContext, MigrationResult, PersistedQueueItem, PlanFile, PlanItem, QueueStore, RecoveryLock, RecoveryLockOptions, SessionAnalyzer, SessionStoreOptions, TodosCheckpointFile, addPlanItem, attachPlanCheckpoint, attachTodosCheckpoint, clearPlan, emptyPlan, formatPlan, loadDirectorState, loadPlan, loadTodosCheckpoint, removePlanItem, runConfigMigrations, savePlan, saveTodosCheckpoint, setPlanItemStatus } from './storage/index.js';
+export { AutoApprovePermissionPolicy, DefaultPermissionPolicy, PermissionPolicyOptions } from './security/index.js';
 export { AutoCompactionMiddleware, AutonomousRunner, AutonomousRunnerOptions, DefaultSkillLoader, DoneCheckResult, DoneConditionChecker, IntelligentCompactor, IntelligentCompactorOptions, SelectiveCompactor, SelectiveCompactorOptions, SkillLoaderOptions } from './execution/index.js';
-export { ALL_FLEET_AGENTS, AUDIT_LOG_AGENT, AgentFactory, AgentFactoryResult, AgentRunnerOptions, BUG_HUNTER_AGENT, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_SUBAGENT_BASELINE, DefaultMultiAgentCoordinator, Director, DirectorBudgetError, DirectorPromptParts, DirectorSessionFactory, DirectorSessionFactoryOptions, FLEET_ROSTER, FleetBus, FleetEvent, FleetHandler, FleetUsage, FleetUsageAggregator, MultiAgentCoordinatorOptions, REFACTOR_PLANNER_AGENT, SECURITY_SCANNER_AGENT, SubagentPromptParts, SubagentUsageSnapshot, composeDirectorPrompt, composeSubagentPrompt, makeAgentSubagentRunner, makeDirectorSessionFactory, rosterSummaryFromConfigs } from './coordination/index.js';
+export { ALL_FLEET_AGENTS, AUDIT_LOG_AGENT, AgentFactory, AgentFactoryResult, AgentRunnerOptions, BUG_HUNTER_AGENT, CreateDelegateToolOptions, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_SUBAGENT_BASELINE, DefaultMultiAgentCoordinator, DelegateHost, Director, DirectorBudgetError, DirectorPromptParts, DirectorSessionFactory, DirectorSessionFactoryOptions, FLEET_ROSTER, FleetBus, FleetEvent, FleetHandler, FleetUsage, FleetUsageAggregator, MultiAgentCoordinatorOptions, REFACTOR_PLANNER_AGENT, SECURITY_SCANNER_AGENT, SubagentPromptParts, SubagentUsageSnapshot, composeDirectorPrompt, composeSubagentPrompt, createDelegateTool, makeAgentSubagentRunner, makeDirectorSessionFactory, rosterSummaryFromConfigs } from './coordination/index.js';
 export { DefaultModeStore, LLMSelector, LLMSelectorOptions, ModeLoaderOptions, loadProjectModes, loadUserModes } from './models/index.js';
 export { DefaultTaskStore, GeneratedTask, SpecDrivenDev, SpecDrivenDevOptions, SpecParser, TaskFlow, TaskFlowEventMap, TaskFlowEventName, TaskFlowExecutionContext, TaskFlowOptions, TaskFlowPhase, TaskGenerator, TaskGeneratorOptions, TaskStore, TaskTracker, TaskTrackerOptions, TaskTransition } from './sdd/index.js';
 export { DefaultHealthRegistry, InMemoryMetricsSink, MetricsServerHandle, MetricsServerOptions, NoopMetricsSink, NoopTracer, OTelTracer, OtlpMetricsExporterHandle, OtlpMetricsExporterOptions, OtlpTraceExporterHandle, OtlpTraceExporterOptions, PROMETHEUS_CONTENT_TYPE, buildOtlpMetricsRequest, buildOtlpTracesRequest, renderPrometheus, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, wireMetricsToEvents } from './observability/index.js';
-export { C as ContextManagerAction, a as ContextManagerInput, b as ContextManagerResult, c as ContextManagerToolOptions, d as allServers, e as awsServer, f as blockServer, g as braveSearchServer, h as context7Server, i as contextManagerTool, j as createContextManagerTool, k as everArtServer, l as filesystemServer, m as githubServer, n as googleMapsServer, s as sentinelServer, o as slackServer } from './mcp-servers-Dzgg4x1w.js';
+export { C as ContextManagerAction, a as ContextManagerInput, b as ContextManagerResult, c as ContextManagerToolOptions, d as allServers, e as awsServer, f as blockServer, g as braveSearchServer, h as context7Server, i as contextManagerTool, j as createContextManagerTool, k as everArtServer, l as filesystemServer, m as githubServer, n as googleMapsServer, s as sentinelServer, o as slackServer } from './mcp-servers-BA1Ofmfj.js';
 import { L as Logger } from './logger-BMQgxvdy.js';
 export { a as LogLevel } from './logger-BMQgxvdy.js';
 export { a as ModelsDevPayload, c as ModelsDevProvider, M as ModelsRegistry, b as ResolvedModel, R as ResolvedProvider, W as WireFamily } from './models-registry-Y2xbog0E.js';
 export { S as SecretVault } from './secret-vault-DoISxaKO.js';
-import './compactor-B4mQZXf2.js';
+import './compactor-DSl2FK7a.js';
 import './path-resolver-CPRj4bFY.js';
-import './selector-BbJqiEP4.js';
+import './selector-BRqzvugb.js';
 import 'node:events';
 
 interface InputBuilderOptions {
@@ -124,6 +124,20 @@ interface DefaultSystemPromptBuilderOptions {
     /** Pre-resolved model capabilities — enables adaptive context thresholds. */
     modelCapabilities?: ModelCapabilities;
     todayIso?: string;
+    /**
+     * Path to the session's plan JSON, or a getter that returns it. When
+     * set, the builder reads the file on every `build()` call and injects
+     * an "Active plan" block listing open items, so the LLM is anchored to
+     * the strategic roadmap every turn — not just at resume. The block is
+     * tagged `ephemeral` so a plan edit on turn N doesn't invalidate the
+     * provider's prefix cache for earlier turns.
+     *
+     * The function form lets callers bind the builder before the session
+     * id is known (e.g. DI containers that resolve the builder lazily) —
+     * the getter is called at build-time, after the session has been
+     * created.
+     */
+    planPath?: string | (() => string | undefined);
 }
 declare class DefaultSystemPromptBuilder implements SystemPromptBuilder {
     private readonly opts;
@@ -138,6 +152,14 @@ declare class DefaultSystemPromptBuilder implements SystemPromptBuilder {
     private skillCache?;
     constructor(opts?: DefaultSystemPromptBuilderOptions);
     build(ctx: BuildContext): Promise<TextBlock[]>;
+    /**
+     * Reads `<sessionId>.plan.json` (when configured) and produces a short
+     * "Active plan" block listing open items so the model is anchored to
+     * the strategic roadmap every turn. Reads on every `build()` so a
+     * plan edit (via `/plan` or the `plan` tool) reflects on the next
+     * turn without restarting the session.
+     */
+    private buildActivePlan;
     private buildToolUsage;
     private buildEnvironment;
     private buildMemoryAndSkills;
@@ -173,6 +195,7 @@ declare class SlashCommandRegistry {
     dispatch(line: string, ctx: Context): Promise<{
         exit?: boolean;
         message?: string;
+        runText?: string;
     } | null>;
 }
 
@@ -219,7 +242,17 @@ declare class DefaultPluginAPI implements PluginAPI {
  * 0.1.9: additive — `DirectorBudgetError` plus `FLEET_ROSTER` and the
  * pre-built fleet agent configs (Audit Log, Bug Hunter, Refactor Planner,
  * Security Scanner) now exported from `@wrongstack/core`.
- * Plugins pinning `apiVersion: "^0.1"` continue to load unchanged.
+ * 0.1.10: additive — extended-thinking stream events, core subpath
+ * exports, tool output size chips on `tool.executed`. Plugin contract
+ * unchanged otherwise; 0.1.x range still loads cleanly.
+ *
+ * Note: the package shipped as 0.2.0, but the *plugin contract* didn't
+ * change in a breaking way — `SubagentError`, `subagent.tool_executed`,
+ * `transcriptPath`, `planTool`, `delegate`, `runText`, and Director
+ * sessionWriter are all additive to the surface. We deliberately keep
+ * the kernel API at 0.1.10 so plugins pinning `apiVersion: "^0.1"`
+ * keep loading. Bump to 1.0 when we stabilize and want the freedom to
+ * remove deprecated surfaces.
  */
 declare const KERNEL_API_VERSION = "0.1.10";
 interface LoadPluginsOptions {