@ordewell/core 0.4.11 → 0.4.13

package/dist/index.d.ts

@@ -1,11 +1,13 @@
-import { h as RunnerId, c as PlanStatus, L as LegacyPlanState, a as DiscoveredModel, T as Task, d as ResearchProgress, R as ResearchLogEntry, C as ConversationMessage, n as TaskSnapshot, Q as QueuedMessage, A as ActiveTaskSession, g as ResearchToolType, v as Verdict, e as ResearchStep, b as PlanState } from './Task-cGrfYRXK.js';
-export { D as DiscoveredMode, M as Message, P as PlanModificationWarnings, f as ResearchStepOutcome, S as StreamEvent, i as StreamStepEvent, j as StreamThinkingEvent, k as TaskMode, l as TaskModelAssignment, m as TaskOutputSummary, o as TaskStatus, p as TaskType, q as TaskWithParent, r as ThinkingBlock, U as UserPromptEntry, s as UserStep, V as ValidationCheck, t as ValidationContext, u as ValidationResult, w as VerificationCheck, x as addTaskToPlan, y as createEmptyPlan, z as createTask, B as emptyWarnings, E as flattenTasks, F as flattenTasksWithParents, G as migrateLegacyPlan, H as migratePlanState, I as migrateTask, J as removeTaskFromPlan, K as renumberTasks, N as updateTaskInPlan, O as validateModifiedPlan, W as warningsText } from './Task-cGrfYRXK.js';
-import { n as IFileSystem, I as IApproval, R as ReadFileOpts, T as ToolOutcome, k as GrepOptions, j as GlobOptions, i as FindSymbolOptions, f as ApprovalRequest, m as IConfig, A as AiProvider, z as ProviderModelLists, c as ApprovalMode, q as ITerminalSession, p as ITerminalRunner, K as RunnerRegistry, s as OrchestratorOption, b as ApprovalKind, g as ApprovalSource, H as RunnerInvocation, o as IPluginStore, J as RunnerPluginManifest, E as ResolveContext } from './ITerminalRunner-DVwORcV9.js';
-export { a as AllProviderModels, d as ApprovalPolicy, e as ApprovalPolicyOptions, C as CatalogModel, D as DENY_ALL, h as DiscoveryCommand, F as FetchAllProviderModelsOptions, G as GREP_DEFAULT_HEAD_LIMIT, l as GrepOutputMode, M as ModelCatalog, r as ModelShortcut, O as ORCHESTRATOR_SHORTCUTS, P as PluginCloneFn, t as PluginEntry, u as PluginFeatures, v as PluginMode, w as PluginModelDiscovery, x as PluginRunnerDef, y as ProviderCredentialSource, B as ProviderModelsResult, S as SEARCH_EXCLUSIONS, L as collectProviderCredentials, N as enabledRunners, Q as fetchAllProviderModels, U as isReservedRunnerName, V as knownModelId, W as resolveModelShortcut, X as resolveProvider, Y as toOrchestratorOptions } from './ITerminalRunner-DVwORcV9.js';
+import { h as RunnerId, c as PlanStatus, L as LegacyPlanState, a as DiscoveredModel, T as Task, d as ResearchProgress, R as ResearchLogEntry, C as ConversationMessage, n as TaskSnapshot, Q as QueuedMessage, A as ActiveTaskSession, g as ResearchToolType, b as PlanState, v as Verdict } from './Task-cGrfYRXK.js';
+export { D as DiscoveredMode, M as Message, P as PlanModificationWarnings, e as ResearchStep, f as ResearchStepOutcome, S as StreamEvent, i as StreamStepEvent, j as StreamThinkingEvent, k as TaskMode, l as TaskModelAssignment, m as TaskOutputSummary, o as TaskStatus, p as TaskType, q as TaskWithParent, r as ThinkingBlock, U as UserPromptEntry, s as UserStep, V as ValidationCheck, t as ValidationContext, u as ValidationResult, w as VerificationCheck, x as addTaskToPlan, y as createEmptyPlan, z as createTask, B as emptyWarnings, E as flattenTasks, F as flattenTasksWithParents, G as migrateLegacyPlan, H as migratePlanState, I as migrateTask, J as removeTaskFromPlan, K as renumberTasks, N as updateTaskInPlan, O as validateModifiedPlan, W as warningsText } from './Task-cGrfYRXK.js';
+import { f as IFileSystem, R as ReadFileOpts, T as ToolOutcome, d as GrepOptions, c as GlobOptions, b as FindSymbolOptions, I as IConfig, A as AiProvider, r as ProviderModelLists, i as ITerminalSession, h as ITerminalRunner, w as RunnerRegistry, k as OrchestratorOption, u as RunnerInvocation, g as IPluginStore, v as RunnerPluginManifest, t as ResolveContext } from './ITerminalRunner-DqAs12sy.js';
+export { a as AllProviderModels, C as CatalogModel, D as DiscoveryCommand, F as FetchAllProviderModelsOptions, G as GREP_DEFAULT_HEAD_LIMIT, e as GrepOutputMode, M as ModelCatalog, j as ModelShortcut, O as ORCHESTRATOR_SHORTCUTS, P as PluginCloneFn, l as PluginEntry, m as PluginFeatures, n as PluginMode, o as PluginModelDiscovery, p as PluginRunnerDef, q as ProviderCredentialSource, s as ProviderModelsResult, S as SEARCH_EXCLUSIONS, x as collectProviderCredentials, y as enabledRunners, z as fetchAllProviderModels, B as isReservedRunnerName, E as knownModelId, H as resolveModelShortcut, J as resolveProvider, K as toOrchestratorOptions } from './ITerminalRunner-DqAs12sy.js';
+import { I as IApproval, d as ApprovalRequest, a as ApprovalMode } from './ApprovalPolicy-BVhGdECT.js';
+export { A as ApprovalKind, b as ApprovalPolicy, c as ApprovalPolicyOptions, e as ApprovalSource, D as DENY_ALL } from './ApprovalPolicy-BVhGdECT.js';
 import { R as RunnerModeInfo } from './ModeResolver-CzZd-i6T.js';
 export { M as ManifestLookup, b as buildModeGuide, f as filteredBuildModes, r as resolveDefaultMode, a as resolveTaskMode, c as runnerModesFrom } from './ModeResolver-CzZd-i6T.js';
-import { T as TaskOp } from './plan-utils-akoB6YCL.js';
-export { A as ApplyTaskOpsResult, a as TaskRef, b as applyTaskOps, c as canMergeTasks, d as canSetDependencies, e as canSplitTask, f as classifyOutcome, g as dependencyCandidates, h as dependentsOf, p as parseTaskOpsJson, s as summarizeToolCall, t as textHasTaskOps } from './plan-utils-akoB6YCL.js';
+import { T as TaskOp, c as SessionBroadcaster } from './plan-utils-BbC9KdK4.js';
+export { A as ApplyTaskOpsResult, C as CHECKPOINT_TRUNCATE_LENGTH, S as SerializedPlan, a as SerializedTask, b as SerializedTaskStatus, d as SessionMessage, e as TaskRef, f as applyTaskOps, g as canMergeTasks, h as canSetDependencies, i as canSplitTask, j as classifyOutcome, k as dependencyCandidates, l as dependentsOf, m as executionSummary, p as parseTaskOpsJson, s as serializePlan, n as serializeTask, o as serializeTaskStatus, q as summarizeToolCall, t as textHasTaskOps, r as truncateCheckpointSummary } from './plan-utils-BbC9KdK4.js';
 import { ChildProcess } from 'child_process';
 import { EventEmitter } from 'events';
 import { b as PlanParseError } from './parsing-D87zKtTe.js';
@@ -723,6 +725,65 @@ declare abstract class AbstractRunner<S extends ITerminalSession> implements ITe
     }): Promise<ITerminalSession>;
 }
 
+declare function stripAnsi(text: string): string;
+declare function posixShellQuote(s: string): string;
+/**
+ * Wrap a command for execution inside a POSIX login shell, which is what
+ * resolves runner binaries managed by nvm/volta/asdf.
+ *
+ * Deliberately POSIX-only. This used to take a `platform` and emit
+ * `powershell.exe -Command "'claude' '-p' '…'"` for Windows, which PowerShell
+ * cannot run at all: a quoted string in leading position is parsed in
+ * expression mode, so the invocation died with a parse error before the runner
+ * started — a task that failed instantly, every time, on that platform. Windows
+ * has no login-shell equivalent to emulate (its PATH comes from the registry
+ * and is already inherited), so {@link planShellLaunch} starts the runner
+ * directly there instead of routing it through a shell. Platform choice belongs
+ * to that function; this one only knows how to phrase the POSIX half.
+ */
+declare function buildShellInvocation(command: string, args: string[]): {
+    shellPath: string;
+    shellArgs: string[];
+};
+/** A terminal size in cells. */
+interface PtySize {
+    cols: number;
+    rows: number;
+}
+/**
+ * Options for {@link wrapWithPty}. `size` sets the PTY's window size before the
+ * wrapped command starts. `controlChannel` makes the wrapper listen on its fd 3
+ * for `"<cols> <rows>"` lines and resize the PTY live — the caller spawns the
+ * child with an extra pipe there and writes resize requests into it.
+ */
+interface PtyWrapOptions {
+    size?: PtySize;
+    controlChannel?: boolean;
+}
+/**
+ * Wrap a command in `script` to allocate the PTY some runners require when
+ * headless; `-e` propagates the child's exit code so verification still works.
+ *
+ * POSIX-only by nature — there is no `script` on Windows, which
+ * `HeadlessRunner`'s `hasScriptCmd` probe already discovers, so this is never
+ * reached there.
+ *
+ * `script` sizes its PTY off the terminal it is attached to; spawned off a pipe
+ * (every transport here) it allocates 0x0, which a runner TUI renders as
+ * garbage. `stty` fixes the size on the PTY slave before the command starts, so
+ * the TUI reads its true dimensions via ioctl.
+ *
+ * The control channel can only live on a *separate* fd from the agent's stdin,
+ * so the wrapper saves the PTY on fd 4 first: POSIX sends an asynchronous
+ * command's stdin to `/dev/null`, so the watcher's own stdin cannot be the PTY.
+ * A background job also inherits an fd 0 that is not the terminal; `stty` names
+ * fd 4 explicitly for that reason.
+ */
+declare function wrapWithPty(command: string, args: string[], opts?: PtyWrapOptions): {
+    command: string;
+    args: string[];
+};
+
 /**
  * cmd.exe's command-line buffer. A longer line is truncated rather than
  * rejected, which would corrupt a planner's system prompt or a task's prompt
@@ -857,7 +918,7 @@ declare function planShellLaunch(command: string, args: string[], deps?: LaunchD
 
 type SpawnFn = (command: string, args: string[], options: {
     env: NodeJS.ProcessEnv;
-    stdio: ['pipe', 'pipe', 'pipe'];
+    stdio: Array<'pipe' | 'ignore'>;
     cwd: string;
     /** Set by the Windows batch route, where `args` is already a quoted command line. */
     windowsVerbatimArguments?: boolean;
@@ -877,12 +938,17 @@ declare class HeadlessSession extends AbstractTerminalSession {
     private spawnImpl;
     private process;
     private outputBuffer;
+    private controlStream;
     constructor(id: string, taskId: string, spawnImpl: SpawnFn);
     get isStarted(): boolean;
-    start(launch: LaunchPlan, cwd: string, resolvedPath: string, env?: Record<string, string>): void;
+    start(launch: LaunchPlan, cwd: string, resolvedPath: string, env?: Record<string, string>, options?: {
+        controlChannel?: boolean;
+    }): void;
     kill(): void;
     getOutput(): string;
     write(text: string): void;
+    /** PTY resize requests from a surface that owns the terminal rendering the wrapper. */
+    writeControl(text: string): void;
 }
 type RunnerSpawnOptions = Parameters<ITerminalRunner['spawn']>[0];
 /** Everything needed to start one runner process, resolved before any child exists. */
@@ -909,7 +975,7 @@ declare class HeadlessRunner extends AbstractRunner<HeadlessSession> {
     constructor(deps?: HeadlessRunnerDeps);
     protected createSession(id: string, taskId: string): HeadlessSession;
     /** Everything up to, but not including, spawning — so a surface that owns its own child reaches the same decisions. */
-    protected prepareLaunch(opts: RunnerSpawnOptions): Promise<PreparedLaunch>;
+    protected prepareLaunch(opts: RunnerSpawnOptions, ptyOptions?: PtyWrapOptions): Promise<PreparedLaunch>;
     spawn(opts: RunnerSpawnOptions): Promise<ITerminalSession>;
 }
 
@@ -2259,138 +2325,6 @@ declare class SkillsService {
 }
 declare function createSkillsService(workspaceRoot?: string): SkillsService;
 
-type SerializedTaskStatus = {
-    id: string;
-    status: string;
-    verdict: {
-        outcome: 'pass' | 'fail';
-        reason: string;
-        checks: Verdict['checks'];
-    } | null;
-    /** Advisory silence timestamp from VerdictEngine — not part of task status semantics. */
-    idleSince?: string | null;
-};
-type SerializedTask = {
-    id: string;
-    order: number;
-    title: string;
-    type: string;
-    description: string;
-    dependencies: string[];
-    assignedRunner: RunnerId;
-    assignedModel: Task['assignedModel'] | null;
-    taskMode: string;
-    prompt: string | null;
-    subtasks: SerializedTask[];
-    userSteps: Task['userSteps'];
-    thinkingEffort: Task['thinkingEffort'];
-    autonomy: Task['autonomy'];
-    sliceType: Task['sliceType'];
-    userStoriesCovered: Task['userStoriesCovered'];
-};
-type SerializedPlan = {
-    tasks: SerializedTask[];
-    runners: RunnerId[];
-    generatedAt: string;
-    conversationHistory?: LegacyPlanState['conversationHistory'];
-    prdMarkdown?: string;
-    queuedMessages?: QueuedMessage[];
-};
-type SessionMessage = {
-    type: 'plan_generated';
-    plan: SerializedPlan;
-    goal: string;
-    runners: RunnerId[];
-} | {
-    type: 'planner_message';
-    content: string;
-    timestamp: string;
-} | {
-    type: 'status_update';
-    tasks: SerializedTaskStatus[];
-} | {
-    type: 'review_needed';
-    tasks: SerializedTask[];
-} | {
-    type: 'review_approved';
-} | {
-    type: 'checkpoint';
-    taskId: string;
-    taskTitle: string;
-    summary: string;
-} | {
-    type: 'execution_complete';
-    summary: {
-        total: number;
-        completed: number;
-        failed: number;
-    };
-} | {
-    type: 'execution_stopped';
-} | {
-    type: 'queue_ready';
-} | {
-    type: 'task_updated';
-    taskId: string;
-    changes: Record<string, unknown>;
-} | {
-    type: 'task_started';
-    taskId: string;
-    order: number;
-    title: string;
-    runner: RunnerId;
-    modelId?: string;
-} | {
-    type: 'task_output';
-    taskId: string;
-    text: string;
-} | {
-    type: 'plan_thinking';
-    text: string;
-} | {
-    type: 'research_step';
-    tool: string;
-    toolLabel?: string;
-    args: string;
-    subagentId?: string;
-    toolCallId?: string;
-} | {
-    type: 'plan_token';
-    token: string;
-} | {
-    type: 'research_step_done';
-    step: ResearchStep;
-    subagentId?: string;
-} | {
-    type: 'approval_request';
-    id: string;
-    kind: ApprovalKind;
-    subject: string;
-    scope: string;
-    detail?: string;
-} | {
-    type: 'approval_settled';
-    id: string;
-    granted: boolean;
-} | {
-    type: 'approval_decided';
-    kind: ApprovalKind;
-    subject: string;
-    scope: string;
-    detail?: string;
-    granted: boolean;
-    source: Exclude<ApprovalSource, 'asked'>;
-};
-type SessionBroadcaster = (msg: SessionMessage) => void;
-declare function serializeTask(t: Task): SerializedTask;
-declare function serializeTaskStatus(t: Task, idleSince?: string | null): SerializedTaskStatus;
-declare function serializePlan(plan: LegacyPlanState): SerializedPlan;
-declare function executionSummary(tasks: Task[]): {
-    total: number;
-    completed: number;
-    failed: number;
-};
-
 /**
  * A direct (non-planner) plan edit the session refused. Distinct from a plain
  * Error so a surface can tell "you asked for something invalid" from "something
@@ -3286,39 +3220,6 @@ declare class TmuxRunner extends AbstractRunner<TmuxSession> {
     }): Promise<ITerminalSession>;
 }
 
-declare function stripAnsi(text: string): string;
-declare function posixShellQuote(s: string): string;
-/**
- * Wrap a command for execution inside a POSIX login shell, which is what
- * resolves runner binaries managed by nvm/volta/asdf.
- *
- * Deliberately POSIX-only. This used to take a `platform` and emit
- * `powershell.exe -Command "'claude' '-p' '…'"` for Windows, which PowerShell
- * cannot run at all: a quoted string in leading position is parsed in
- * expression mode, so the invocation died with a parse error before the runner
- * started — a task that failed instantly, every time, on that platform. Windows
- * has no login-shell equivalent to emulate (its PATH comes from the registry
- * and is already inherited), so {@link planShellLaunch} starts the runner
- * directly there instead of routing it through a shell. Platform choice belongs
- * to that function; this one only knows how to phrase the POSIX half.
- */
-declare function buildShellInvocation(command: string, args: string[]): {
-    shellPath: string;
-    shellArgs: string[];
-};
-/**
- * Wrap a command in `script` to allocate the PTY some runners require when
- * headless; `-e` propagates the child's exit code so verification still works.
- *
- * POSIX-only by nature — there is no `script` on Windows, which
- * `HeadlessRunner`'s `hasScriptCmd` probe already discovers, so this is never
- * reached there.
- */
-declare function wrapWithPty(command: string, args: string[]): {
-    command: string;
-    args: string[];
-};
-
 /**
  * A workspace path that does not exist, or exists but is not a directory.
  * Checked at every surface that starts a planner or spawns an agent inside
@@ -3696,4 +3597,4 @@ declare class PlannerModelMemory {
     recall(provider: string, catalog: PlannerModelCandidate[]): PlannerModelRecall;
 }
 
-export { ALLOWED_PLUGIN_HOSTS, ALL_PROVIDERS, AUTO_COMMANDS, AbstractRunner, AbstractTerminalSession, ActiveTaskSession, type AgentAdapter, type AgentAdapterFactory, type AgentEvent, type AgentProcessDeps, type AgentStartOptions, AiProvider, ApprovalKind, ApprovalMode, ApprovalRequest, ApprovalSource, BUILTIN_SKILL_NAMES, BaseAiService, BaseConfig, BaseFileSystem, CLAUDE_CODE_MANIFEST, CLI_PROVIDERS, CMD_EXE_MAX_COMMAND_LINE, CORE_PLANNER_PROMPT, type CappedRows, type CheckpointListener, ClaudeCodeAdapter, CliAgentAiService, type CliAgentAiServiceDeps, CodexAdapter, type CommandClassification, CommandLineTooLongError, type CommandTier, type ComposeOptions, ConsoleLogger, ContextCollector, ConversationMessage, type ConversationRequest, type ConversationTurn, DAEMON_SUBPROTOCOL, DAEMON_TOKEN_SUBPROTOCOL_PREFIX, DiscoveredModel, EmbeddedNewlineError, type EnvAdmission, EnvConfig, type ExecFileFn, type ExecImpl, ExecutableNotFoundError, FindSymbolOptions, FsPluginStore, GIT_READONLY_SUBCOMMANDS, GeminiService, GlobOptions, type GrepInvocation, GrepOptions, type HasBinFn, HeadlessRunner, type HeadlessRunnerDeps, HeadlessSession, type IAiService, IApproval, IConfig, IFileSystem, type ILogger, type INotification, IPluginStore, ITerminalRunner, ITerminalSession, JSON_REPAIR_INSTRUCTION, type KillTreeDeps, type LaunchDeps, type LaunchPlan, LegacyPlanState, LineBuffer, type MappedTool, ModelResolver, type ModelResolverDeps, type ModifyPlanRequest, type NotificationAction, OPENCODE_MANIFEST, ORDEWELL_SETTABLE_ENV, OpenAiService, OpenCodeAdapter, type OrchestratorObserver, OrchestratorOption, PLUGIN_NAME_PATTERN, PROVIDER_CREDENTIAL_ENV, PROVIDER_DETECT_PRIORITY, PROVIDER_LABEL, PROVIDER_PRIORITY, PROVIDER_SHORT_LABEL, type PendingApproval, PendingApprovals, type PendingApprovalsOptions, PlanEditError, PlanParseError, type PlanRequest, PlanState, PlanStatus, PlanStore, Planner, type PlannerModelCandidate, type PlannerModelChoice, PlannerModelMemory, type PlannerModelRecall, type PlannerModelStore, type PlannerReplyClassification, type PlannerRuntimeToggles, type PluginSource, type PrdBlock, type PreparedLaunch, type PriorOutput, type ProbeFn, ProviderModelLists, type ProviderRegistration, QueuedMessage, REFUSED_COMMANDS, ReadFileOpts, type RepairLoopOpts, type RepairVerdict, type ResearchChat, ResearchLogEntry, ResearchProgress, type ResearchShell, type ResearchShellDeps, ResearchStep, ResearchToolType, type ResearchTurn, ResolveContext, type RunnerCatalog, RunnerId, RunnerInstallation, RunnerInvocation, type RunnerMode, RunnerModeInfo, RunnerPluginManifest, RunnerRegistry, type RunnerSpawnOptions, SETTINGS_ENV_ALLOWLIST, SETTINGS_ENV_REFUSED, STATE_DIR, STOPPED_TOOL_RESULT, SYMBOL_LANGUAGES, type SerializedPlan, type SerializedTask, type SerializedTaskStatus, Session, type SessionBroadcaster, type SessionData, type SessionDeps, type SessionMessage, type SessionMeta, type SessionPlanner, type SessionRuntimeSettings, SettingsService, type ShellDialect, type SkillInfo, type SkillMetadata, SkillsService, type SpawnSpec, StdioAgentAdapter, TASK_QUERY_ANSWER_OR_OPS, TASK_QUERY_FIELDS, TASK_QUERY_PROTOCOL, TASK_QUERY_REMINDER, TRUNCATED_PLAN_REPAIR_INSTRUCTION, Task, TaskOp, TaskOrchestrator, type TaskQuery, type TaskQueryCatalog, type TaskQueryField, TaskSnapshot, TmuxRunner, type TmuxRunnerDeps, type TokenCarriers, type ToolCall, ToolOutcome, type ToolResult, type UserSettings, Verdict, VerdictEngine, type VerdictListener, WINDOWS_MAX_COMMAND_LINE, type WorkspaceCheckDeps, WorkspaceNotAProjectError, WorkspaceNotFoundError, type WorkspaceProjectCheckDeps, admitSettingsEnv, applyHeadLimit, assertInstallablePluginUrl, assertPlainPluginName, assertWorkspaceExists, assertWorkspaceIsProject, augmentPromptWithPriorOutputs, augmentedPath, bearerHeaderValue, buildConversationSystemPrompt, buildFallbackGrepArgs, buildGlobArgs, buildGrepArgs, buildMergePrompt, buildModifyDuringExecutionPrompt, buildModifyPlanPrompt, buildPlanWithResults, buildResearchPrompt, buildResearchToolsPrompt, buildRunnerInvocation, buildShellInvocation, buildSplitPrompt, buildSubagentSystemPrompt, clampThinkingEffort, classifyCommand, classifyPlannerReply, classifyPluginSource, clearAugmentedPathCache, clearDaemonToken, clearResearchShellCache, clearState, clipboardCopyCommand, coerceAssignments, collectDirectDependencyOutputs, composeAugmentedPrompt, configuredProviders, createAiService, createSkillsService, daemonTokenPath, defaultLogger, definitionPattern, deleteSession, discoverGeminiModels, effectiveAllowlist, ensureDir, ensureStateDirIgnored, executionLogBlock, executionSummary, extractPrdBlock, extractPresentedToken, filterFallbackByAnchoredInclude, filterModelsForPrompt, formatSearchOutput, generatePlanWithRepair, getLatestSession, getProviderMeta, getSettingsPath, getStateDir, globalDataDir, grantScopeFor, hasTmux, includeGlobFor, isCliProvider, isExecutableResolved, isOpenAiProvider, isPlainPluginName, isValidManifest, killTree, languageForId, listSessions, loadSession, loadSessionPlanState, loadState, mapAgentTool, migrateOldConfigDir, mintDaemonToken, mintSessionId, modelContextBlock, modifyValidationFeedback, normalizeAgentArgs, normalizeGeminiModel, parseTaskQueryJson, pendingEditRulesBlock, planDirectLaunch, planShellLaunch, posixShellQuote, prefixModelId, providerForRunner, reEmitPlanPrompt, reEmitTaskOpsPrompt, reEmitTaskQueryPrompt, readDaemonToken, referencePattern, renderPlanMap, renderPriorOutputs, renderTaskQueryAnswer, repairLoop, researchShellWarning, researchToolsPath, resolveArgs, resolvePluginInstallDir, resolveProviderFromPrefix, resolveResearchShell, resolveSkillInvocation, resolveWithin, retargetTaskRunner, runnerAssignment, runnerForProvider, sanitizeSlug, savePrdMarkdown, saveSession, saveState, serializePlan, serializeTask, serializeTaskStatus, sessionRuntimeSettings, stateExists, stripAnsi, stripModelPrefix, summarizeOutput, taskOpsRejectedPrompt, taskQuerySignature, textHasTaskQuery, tmuxSessionName, tmuxSocketName, tmuxWindowName, tokenSubprotocols, tokensMatch, truncatedPlanReEmitPrompt, wellKnownBinDirs, windowsCommandLine, withPath, wrapWithPty };
+export { ALLOWED_PLUGIN_HOSTS, ALL_PROVIDERS, AUTO_COMMANDS, AbstractRunner, AbstractTerminalSession, ActiveTaskSession, type AgentAdapter, type AgentAdapterFactory, type AgentEvent, type AgentProcessDeps, type AgentStartOptions, AiProvider, ApprovalMode, ApprovalRequest, BUILTIN_SKILL_NAMES, BaseAiService, BaseConfig, BaseFileSystem, CLAUDE_CODE_MANIFEST, CLI_PROVIDERS, CMD_EXE_MAX_COMMAND_LINE, CORE_PLANNER_PROMPT, type CappedRows, type CheckpointListener, ClaudeCodeAdapter, CliAgentAiService, type CliAgentAiServiceDeps, CodexAdapter, type CommandClassification, CommandLineTooLongError, type CommandTier, type ComposeOptions, ConsoleLogger, ContextCollector, ConversationMessage, type ConversationRequest, type ConversationTurn, DAEMON_SUBPROTOCOL, DAEMON_TOKEN_SUBPROTOCOL_PREFIX, DiscoveredModel, EmbeddedNewlineError, type EnvAdmission, EnvConfig, type ExecFileFn, type ExecImpl, ExecutableNotFoundError, FindSymbolOptions, FsPluginStore, GIT_READONLY_SUBCOMMANDS, GeminiService, GlobOptions, type GrepInvocation, GrepOptions, type HasBinFn, HeadlessRunner, type HeadlessRunnerDeps, HeadlessSession, type IAiService, IApproval, IConfig, IFileSystem, type ILogger, type INotification, IPluginStore, ITerminalRunner, ITerminalSession, JSON_REPAIR_INSTRUCTION, type KillTreeDeps, type LaunchDeps, type LaunchPlan, LegacyPlanState, LineBuffer, type MappedTool, ModelResolver, type ModelResolverDeps, type ModifyPlanRequest, type NotificationAction, OPENCODE_MANIFEST, ORDEWELL_SETTABLE_ENV, OpenAiService, OpenCodeAdapter, type OrchestratorObserver, OrchestratorOption, PLUGIN_NAME_PATTERN, PROVIDER_CREDENTIAL_ENV, PROVIDER_DETECT_PRIORITY, PROVIDER_LABEL, PROVIDER_PRIORITY, PROVIDER_SHORT_LABEL, type PendingApproval, PendingApprovals, type PendingApprovalsOptions, PlanEditError, PlanParseError, type PlanRequest, PlanState, PlanStatus, PlanStore, Planner, type PlannerModelCandidate, type PlannerModelChoice, PlannerModelMemory, type PlannerModelRecall, type PlannerModelStore, type PlannerReplyClassification, type PlannerRuntimeToggles, type PluginSource, type PrdBlock, type PreparedLaunch, type PriorOutput, type ProbeFn, ProviderModelLists, type ProviderRegistration, type PtySize, type PtyWrapOptions, QueuedMessage, REFUSED_COMMANDS, ReadFileOpts, type RepairLoopOpts, type RepairVerdict, type ResearchChat, ResearchLogEntry, ResearchProgress, type ResearchShell, type ResearchShellDeps, ResearchToolType, type ResearchTurn, ResolveContext, type RunnerCatalog, RunnerId, RunnerInstallation, RunnerInvocation, type RunnerMode, RunnerModeInfo, RunnerPluginManifest, RunnerRegistry, type RunnerSpawnOptions, SETTINGS_ENV_ALLOWLIST, SETTINGS_ENV_REFUSED, STATE_DIR, STOPPED_TOOL_RESULT, SYMBOL_LANGUAGES, Session, SessionBroadcaster, type SessionData, type SessionDeps, type SessionMeta, type SessionPlanner, type SessionRuntimeSettings, SettingsService, type ShellDialect, type SkillInfo, type SkillMetadata, SkillsService, type SpawnSpec, StdioAgentAdapter, TASK_QUERY_ANSWER_OR_OPS, TASK_QUERY_FIELDS, TASK_QUERY_PROTOCOL, TASK_QUERY_REMINDER, TRUNCATED_PLAN_REPAIR_INSTRUCTION, Task, TaskOp, TaskOrchestrator, type TaskQuery, type TaskQueryCatalog, type TaskQueryField, TaskSnapshot, TmuxRunner, type TmuxRunnerDeps, type TokenCarriers, type ToolCall, ToolOutcome, type ToolResult, type UserSettings, Verdict, VerdictEngine, type VerdictListener, WINDOWS_MAX_COMMAND_LINE, type WorkspaceCheckDeps, WorkspaceNotAProjectError, WorkspaceNotFoundError, type WorkspaceProjectCheckDeps, admitSettingsEnv, applyHeadLimit, assertInstallablePluginUrl, assertPlainPluginName, assertWorkspaceExists, assertWorkspaceIsProject, augmentPromptWithPriorOutputs, augmentedPath, bearerHeaderValue, buildConversationSystemPrompt, buildFallbackGrepArgs, buildGlobArgs, buildGrepArgs, buildMergePrompt, buildModifyDuringExecutionPrompt, buildModifyPlanPrompt, buildPlanWithResults, buildResearchPrompt, buildResearchToolsPrompt, buildRunnerInvocation, buildShellInvocation, buildSplitPrompt, buildSubagentSystemPrompt, clampThinkingEffort, classifyCommand, classifyPlannerReply, classifyPluginSource, clearAugmentedPathCache, clearDaemonToken, clearResearchShellCache, clearState, clipboardCopyCommand, coerceAssignments, collectDirectDependencyOutputs, composeAugmentedPrompt, configuredProviders, createAiService, createSkillsService, daemonTokenPath, defaultLogger, definitionPattern, deleteSession, discoverGeminiModels, effectiveAllowlist, ensureDir, ensureStateDirIgnored, executionLogBlock, extractPrdBlock, extractPresentedToken, filterFallbackByAnchoredInclude, filterModelsForPrompt, formatSearchOutput, generatePlanWithRepair, getLatestSession, getProviderMeta, getSettingsPath, getStateDir, globalDataDir, grantScopeFor, hasTmux, includeGlobFor, isCliProvider, isExecutableResolved, isOpenAiProvider, isPlainPluginName, isValidManifest, killTree, languageForId, listSessions, loadSession, loadSessionPlanState, loadState, mapAgentTool, migrateOldConfigDir, mintDaemonToken, mintSessionId, modelContextBlock, modifyValidationFeedback, normalizeAgentArgs, normalizeGeminiModel, parseTaskQueryJson, pendingEditRulesBlock, planDirectLaunch, planShellLaunch, posixShellQuote, prefixModelId, providerForRunner, reEmitPlanPrompt, reEmitTaskOpsPrompt, reEmitTaskQueryPrompt, readDaemonToken, referencePattern, renderPlanMap, renderPriorOutputs, renderTaskQueryAnswer, repairLoop, researchShellWarning, researchToolsPath, resolveArgs, resolvePluginInstallDir, resolveProviderFromPrefix, resolveResearchShell, resolveSkillInvocation, resolveWithin, retargetTaskRunner, runnerAssignment, runnerForProvider, sanitizeSlug, savePrdMarkdown, saveSession, saveState, sessionRuntimeSettings, stateExists, stripAnsi, stripModelPrefix, summarizeOutput, taskOpsRejectedPrompt, taskQuerySignature, textHasTaskQuery, tmuxSessionName, tmuxSocketName, tmuxWindowName, tokenSubprotocols, tokensMatch, truncatedPlanReEmitPrompt, wellKnownBinDirs, windowsCommandLine, withPath, wrapWithPty };

package/dist/index.js

@@ -40,6 +40,7 @@ __export(index_exports, {
   BaseAiService: () => BaseAiService,
   BaseConfig: () => BaseConfig,
   BaseFileSystem: () => BaseFileSystem,
+  CHECKPOINT_TRUNCATE_LENGTH: () => CHECKPOINT_TRUNCATE_LENGTH,
   CLAUDE_CODE_MANIFEST: () => CLAUDE_CODE_MANIFEST,
   CLI_PROVIDERS: () => CLI_PROVIDERS,
   CMD_EXE_MAX_COMMAND_LINE: () => CMD_EXE_MAX_COMMAND_LINE,
@@ -288,6 +289,7 @@ __export(index_exports, {
   toOrchestratorOptions: () => toOrchestratorOptions,
   tokenSubprotocols: () => tokenSubprotocols,
   tokensMatch: () => tokensMatch,
+  truncateCheckpointSummary: () => truncateCheckpointSummary,
   truncatedPlanReEmitPrompt: () => truncatedPlanReEmitPrompt,
   updateTaskInPlan: () => updateTaskInPlan,
   validateModifiedPlan: () => validateModifiedPlan,
@@ -9419,9 +9421,11 @@ function buildShellInvocation(command, args) {
   const inner = [command, ...args].map(posixShellQuote).join(" ");
   return { shellPath: "/bin/bash", shellArgs: ["-lc", inner] };
 }
-function wrapWithPty(command, args) {
+function wrapWithPty(command, args, opts = {}) {
   const inner = [command, ...args].map(posixShellQuote).join(" ");
-  return { command: "script", args: ["-q", "-e", "-f", "-c", inner, "/dev/null"] };
+  const watcher = opts.controlChannel ? 'exec 4<&0; ( while read -r C R <&3; do stty cols "$C" rows "$R" <&4; done ) & ' : "";
+  const setup = opts.size ? `stty cols ${opts.size.cols} rows ${opts.size.rows}; ` : "";
+  return { command: "script", args: ["-q", "-e", "-f", "-c", `${watcher}${setup}${inner}`, "/dev/null"] };
 }
 
 // src/utils/launch.ts
@@ -12777,6 +12781,12 @@ function executionSummary(tasks) {
     failed: tasks.filter((t) => t.status === "failed").length
   };
 }
+var CHECKPOINT_TRUNCATE_LENGTH = 120;
+function truncateCheckpointSummary(summary) {
+  const firstLine = summary.split("\n")[0].trim();
+  if (firstLine.length <= CHECKPOINT_TRUNCATE_LENGTH) return firstLine;
+  return firstLine.slice(0, CHECKPOINT_TRUNCATE_LENGTH - 1) + "\u2026";
+}
 
 // src/utils/sessionStore.ts
 var fs6 = __toESM(require("fs"));
@@ -14527,17 +14537,25 @@ var HeadlessSession = class extends AbstractTerminalSession {
   spawnImpl;
   process = null;
   outputBuffer = "";
+  controlStream = null;
   get isStarted() {
     return this.process !== null;
   }
-  start(launch, cwd, resolvedPath, env) {
+  start(launch, cwd, resolvedPath, env, options) {
     if (this.exited || this.process) return;
+    const stdio = ["pipe", "pipe", "pipe"];
+    if (options?.controlChannel) stdio.push("pipe");
     this.process = this.spawnImpl(launch.file, launch.args, {
       env: withPath(process.env, resolvedPath, env),
-      stdio: ["pipe", "pipe", "pipe"],
+      stdio,
       cwd,
       windowsVerbatimArguments: launch.verbatim
     });
+    if (options?.controlChannel) {
+      this.controlStream = this.process.stdio?.[3] ?? null;
+      this.controlStream?.on("error", () => {
+      });
+    }
     const onData = (data) => {
       const raw = data.toString();
       this.outputBuffer += stripAnsi(raw);
@@ -14570,6 +14588,12 @@ Process error: ${err.message}
       this.process.stdin.write(text);
     }
   }
+  /** PTY resize requests from a surface that owns the terminal rendering the wrapper. */
+  writeControl(text) {
+    if (this.controlStream && !this.controlStream.destroyed) {
+      this.controlStream.write(text);
+    }
+  }
 };
 var HeadlessRunner = class extends AbstractRunner {
   spawnImpl;
@@ -14595,7 +14619,7 @@ var HeadlessRunner = class extends AbstractRunner {
     return new HeadlessSession(id, taskId, this.spawnImpl);
   }
   /** Everything up to, but not including, spawning — so a surface that owns its own child reaches the same decisions. */
-  async prepareLaunch(opts) {
+  async prepareLaunch(opts, ptyOptions) {
     const interactive = this.defaultInteractive;
     const invocation = buildRunnerInvocation({
       runner: opts.runner,
@@ -14612,7 +14636,7 @@ var HeadlessRunner = class extends AbstractRunner {
     const manifest = opts.registry?.get(opts.runner)?.manifest;
     const pty = (manifest?.runner.requiresTty === true || interactive) && this.hasScriptCmd();
     const resolvedPath = await this.resolvePath();
-    const { command, args } = pty ? wrapWithPty(invocation.command, invocation.args) : { command: invocation.command, args: invocation.args };
+    const { command, args } = pty ? wrapWithPty(invocation.command, invocation.args, ptyOptions) : { command: invocation.command, args: invocation.args };
     return {
       launch: await planDirectLaunch(command, args, this.launchDeps),
       resolvedPath,
@@ -15932,6 +15956,7 @@ var PlannerModelMemory = class {
   BaseAiService,
   BaseConfig,
   BaseFileSystem,
+  CHECKPOINT_TRUNCATE_LENGTH,
   CLAUDE_CODE_MANIFEST,
   CLI_PROVIDERS,
   CMD_EXE_MAX_COMMAND_LINE,
@@ -16180,6 +16205,7 @@ var PlannerModelMemory = class {
   toOrchestratorOptions,
   tokenSubprotocols,
   tokensMatch,
+  truncateCheckpointSummary,
   truncatedPlanReEmitPrompt,
   updateTaskInPlan,
   validateModifiedPlan,