@ordewell/core 0.4.18 → 0.4.20

package/dist/{ITerminalRunner-E3-6QNUS.d.mts → ITerminalRunner-CuNYBnqK.d.mts}

@@ -247,6 +247,14 @@ interface PluginRunnerDef {
     env?: Record<string, string>;
     /** When true, the runner requires a PTY. HeadlessRunner wraps with `script` to allocate one. */
     requiresTty?: boolean;
+    /**
+     * True when this runner's interactive prompt flag (e.g. opencode's
+     * `--prompt`) only pre-fills its TUI's composer instead of running it, so a
+     * surface driving that TUI unattended must send an explicit Enter after
+     * launch. Only takes effect while the resolved invocation is interactive —
+     * see `RunnerInvocation.submitPromptKey`.
+     */
+    submitPromptKey?: boolean;
 }
 interface PluginFeatures {
     modelSelection: boolean;
@@ -390,6 +398,8 @@ interface RunnerInvocation {
     args: string[];
     env: Record<string, string>;
     promptInArgs: boolean;
+    /** True when a surface running this invocation on a real TTY must send an explicit Enter once the process starts. */
+    submitPromptKey: boolean;
 }
 /**
  * Persistent storage seam for plugin manifests. The RunnerRegistry delegates
@@ -458,6 +468,14 @@ interface ITerminalSession {
     kill(): void;
     getOutput(): string;
     write(text: string): void;
+    /**
+     * True when the session runs the agent as a raw-mode TUI (a real PTY for the
+     * VS Code terminal, a tmux window). Such a surface submits an input line on
+     * the Enter keystroke (`\r`), so a synchronized resume token terminated with
+     * `\n` only types the line and never sends it. A line-oriented piped session
+     * (`defaultInteractive = false`) leaves this false and accepts `\n`.
+     */
+    readonly interactive?: boolean;
     /**
      * Optional transport-level control channel: PTY resize requests for a session
      * whose runner renders a TUI. Absent on transports without a resizable PTY

package/dist/{ITerminalRunner-CbLHKXT5.d.ts → ITerminalRunner-Da1gIAFX.d.ts}

@@ -247,6 +247,14 @@ interface PluginRunnerDef {
     env?: Record<string, string>;
     /** When true, the runner requires a PTY. HeadlessRunner wraps with `script` to allocate one. */
     requiresTty?: boolean;
+    /**
+     * True when this runner's interactive prompt flag (e.g. opencode's
+     * `--prompt`) only pre-fills its TUI's composer instead of running it, so a
+     * surface driving that TUI unattended must send an explicit Enter after
+     * launch. Only takes effect while the resolved invocation is interactive —
+     * see `RunnerInvocation.submitPromptKey`.
+     */
+    submitPromptKey?: boolean;
 }
 interface PluginFeatures {
     modelSelection: boolean;
@@ -390,6 +398,8 @@ interface RunnerInvocation {
     args: string[];
     env: Record<string, string>;
     promptInArgs: boolean;
+    /** True when a surface running this invocation on a real TTY must send an explicit Enter once the process starts. */
+    submitPromptKey: boolean;
 }
 /**
  * Persistent storage seam for plugin manifests. The RunnerRegistry delegates
@@ -458,6 +468,14 @@ interface ITerminalSession {
     kill(): void;
     getOutput(): string;
     write(text: string): void;
+    /**
+     * True when the session runs the agent as a raw-mode TUI (a real PTY for the
+     * VS Code terminal, a tmux window). Such a surface submits an input line on
+     * the Enter keystroke (`\r`), so a synchronized resume token terminated with
+     * `\n` only types the line and never sends it. A line-oriented piped session
+     * (`defaultInteractive = false`) leaves this false and accepts `\n`.
+     */
+    readonly interactive?: boolean;
     /**
      * Optional transport-level control channel: PTY resize requests for a session
      * whose runner renders a TUI. Absent on transports without a resizable PTY

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 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-4rDGr8Su.mjs';
 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-4rDGr8Su.mjs';
-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-E3-6QNUS.mjs';
-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-E3-6QNUS.mjs';
+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-CuNYBnqK.mjs';
+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-CuNYBnqK.mjs';
 import { I as IApproval, d as ApprovalRequest, a as ApprovalMode } from './ApprovalPolicy-BVhGdECT.mjs';
 export { A as ApprovalKind, b as ApprovalPolicy, c as ApprovalPolicyOptions, e as ApprovalSource, D as DENY_ALL } from './ApprovalPolicy-BVhGdECT.mjs';
 import { R as RunnerModeInfo } from './ModeResolver-mtIWrLXn.mjs';
@@ -936,10 +936,11 @@ interface HeadlessRunnerDeps {
 }
 declare class HeadlessSession extends AbstractTerminalSession {
     private spawnImpl;
+    readonly interactive: boolean;
     private process;
     private outputBuffer;
     private controlStream;
-    constructor(id: string, taskId: string, spawnImpl: SpawnFn);
+    constructor(id: string, taskId: string, spawnImpl: SpawnFn, interactive?: boolean);
     get isStarted(): boolean;
     start(launch: LaunchPlan, cwd: string, resolvedPath: string, env?: Record<string, string>, options?: {
         controlChannel?: boolean;
@@ -958,6 +959,8 @@ interface PreparedLaunch {
     env: Record<string, string>;
     /** True when the invocation was wrapped in `script` to allocate a PTY. */
     pty: boolean;
+    /** True when the started process needs an explicit Enter sent to submit its pre-filled prompt. */
+    submitPromptKey: boolean;
 }
 declare class HeadlessRunner extends AbstractRunner<HeadlessSession> {
     private spawnImpl;
@@ -2868,6 +2871,14 @@ declare class VerdictEngine {
     private touchIdle;
     /** Tear down idle tracking for a task; broadcasts the null transition if it was idle. */
     private clearIdle;
+    /**
+     * Submit a synchronized resume token to the paused session. An interactive
+     * TUI only accepts the Enter keystroke (`\r`) — a `\n` types the token into
+     * its composer without sending it, leaving the agent paused until a human
+     * presses Enter. A line-oriented piped session has no composer; it reads a
+     * `\n`-terminated line, and the leading newline flushes a partial line.
+     */
+    private resumeToken;
     approveCheckpoint(taskId: string): void;
     rejectCheckpoint(taskId: string, reason: string): void;
     /**
@@ -3166,6 +3177,8 @@ declare class TmuxSession extends AbstractTerminalSession {
     private pollIntervalMs;
     private logPath;
     private socket;
+    /** A tmux window is a real TTY running the agent's TUI, so it submits on Enter. */
+    readonly interactive = true;
     private outputBuffer;
     private offset;
     private timer;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 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-4rDGr8Su.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-4rDGr8Su.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-CbLHKXT5.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-CbLHKXT5.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-Da1gIAFX.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-Da1gIAFX.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-Ob-ihQbI.js';
@@ -936,10 +936,11 @@ interface HeadlessRunnerDeps {
 }
 declare class HeadlessSession extends AbstractTerminalSession {
     private spawnImpl;
+    readonly interactive: boolean;
     private process;
     private outputBuffer;
     private controlStream;
-    constructor(id: string, taskId: string, spawnImpl: SpawnFn);
+    constructor(id: string, taskId: string, spawnImpl: SpawnFn, interactive?: boolean);
     get isStarted(): boolean;
     start(launch: LaunchPlan, cwd: string, resolvedPath: string, env?: Record<string, string>, options?: {
         controlChannel?: boolean;
@@ -958,6 +959,8 @@ interface PreparedLaunch {
     env: Record<string, string>;
     /** True when the invocation was wrapped in `script` to allocate a PTY. */
     pty: boolean;
+    /** True when the started process needs an explicit Enter sent to submit its pre-filled prompt. */
+    submitPromptKey: boolean;
 }
 declare class HeadlessRunner extends AbstractRunner<HeadlessSession> {
     private spawnImpl;
@@ -2868,6 +2871,14 @@ declare class VerdictEngine {
     private touchIdle;
     /** Tear down idle tracking for a task; broadcasts the null transition if it was idle. */
     private clearIdle;
+    /**
+     * Submit a synchronized resume token to the paused session. An interactive
+     * TUI only accepts the Enter keystroke (`\r`) — a `\n` types the token into
+     * its composer without sending it, leaving the agent paused until a human
+     * presses Enter. A line-oriented piped session has no composer; it reads a
+     * `\n`-terminated line, and the leading newline flushes a partial line.
+     */
+    private resumeToken;
     approveCheckpoint(taskId: string): void;
     rejectCheckpoint(taskId: string, reason: string): void;
     /**
@@ -3166,6 +3177,8 @@ declare class TmuxSession extends AbstractTerminalSession {
     private pollIntervalMs;
     private logPath;
     private socket;
+    /** A tmux window is a real TTY running the agent's TUI, so it submits on Enter. */
+    readonly interactive = true;
     private outputBuffer;
     private offset;
     private timer;

package/dist/index.js

@@ -8114,19 +8114,29 @@ var VerdictEngine = class {
       for (const l of this.idleListeners) l(taskId, null);
     }
   }
+  /**
+   * Submit a synchronized resume token to the paused session. An interactive
+   * TUI only accepts the Enter keystroke (`\r`) — a `\n` types the token into
+   * its composer without sending it, leaving the agent paused until a human
+   * presses Enter. A line-oriented piped session has no composer; it reads a
+   * `\n`-terminated line, and the leading newline flushes a partial line.
+   */
+  resumeToken(session, line) {
+    return session.interactive ? `${line}\r` : `
+${line}
+`;
+  }
   approveCheckpoint(taskId) {
     const session = this.pausedSessions.get(taskId);
     if (session) {
-      session.write("\nORDEWELL_CONTINUE\n");
+      session.write(this.resumeToken(session, "ORDEWELL_CONTINUE"));
       this.pausedSessions.delete(taskId);
     }
   }
   rejectCheckpoint(taskId, reason) {
     const session = this.pausedSessions.get(taskId);
     if (session) {
-      session.write(`
-ORDEWELL_REJECT: ${reason}
-`);
+      session.write(this.resumeToken(session, `ORDEWELL_REJECT: ${reason}`));
       this.pausedSessions.delete(taskId);
     }
   }
@@ -14392,7 +14402,8 @@ function resolveArgs(manifest, ctx) {
     command: manifest.runner.command,
     args,
     env,
-    promptInArgs: manifest.runner.promptInArgs
+    promptInArgs: manifest.runner.promptInArgs,
+    submitPromptKey: manifest.runner.submitPromptKey === true && isInteractive(ctx)
   };
 }
 function parseBlockOpen(raw) {
@@ -14633,11 +14644,13 @@ function defaultHasScriptCmd() {
   }
 }
 var HeadlessSession = class extends AbstractTerminalSession {
-  constructor(id, taskId, spawnImpl) {
+  constructor(id, taskId, spawnImpl, interactive = false) {
     super(id, taskId);
     this.spawnImpl = spawnImpl;
+    this.interactive = interactive;
   }
   spawnImpl;
+  interactive;
   process = null;
   outputBuffer = "";
   controlStream = null;
@@ -14719,7 +14732,7 @@ var HeadlessRunner = class extends AbstractRunner {
     this.launchDeps = { resolvePath: this.resolvePath, ...deps.launchDeps };
   }
   createSession(id, taskId) {
-    return new HeadlessSession(id, taskId, this.spawnImpl);
+    return new HeadlessSession(id, taskId, this.spawnImpl, this.defaultInteractive);
   }
   /** Everything up to, but not including, spawning — so a surface that owns its own child reaches the same decisions. */
   async prepareLaunch(opts, ptyOptions) {
@@ -14744,7 +14757,8 @@ var HeadlessRunner = class extends AbstractRunner {
       launch: await planDirectLaunch(command, args, this.launchDeps),
       resolvedPath,
       env: invocation.env,
-      pty
+      pty,
+      submitPromptKey: invocation.submitPromptKey
     };
   }
   async spawn(opts) {
@@ -14754,6 +14768,7 @@ var HeadlessRunner = class extends AbstractRunner {
     const modeStr = opts.mode === "plan" ? "plan" : "build";
     console.error(`[headless] Starting ${opts.runner} [${modeStr}] (${opts.modelId || "default"}) for task ${opts.taskId.slice(0, 8)}${prepared.pty ? " (PTY)" : ""}`);
     session.start(prepared.launch, opts.cwd, prepared.resolvedPath, prepared.env);
+    if (prepared.submitPromptKey) session.write("\r");
     this.registerSession(id, session);
     return session;
   }
@@ -14836,6 +14851,8 @@ var TmuxSession = class extends AbstractTerminalSession {
   pollIntervalMs;
   logPath;
   socket;
+  /** A tmux window is a real TTY running the agent's TUI, so it submits on Enter. */
+  interactive = true;
   outputBuffer = "";
   offset = 0;
   timer = null;
@@ -15053,6 +15070,7 @@ var TmuxRunner = class extends AbstractRunner {
     );
     invocation.env = { ...invocation.env, PATH: await this.resolvePath() };
     await session.start(invocation.command, invocation.args, opts.cwd, invocation.env);
+    if (invocation.submitPromptKey) session.write("\r");
     this.registerSession(id, session);
     return session;
   }
@@ -15521,7 +15539,12 @@ var OPENCODE_MANIFEST = {
       OPENCODE_CONFIG_CONTENT: "{{if interactiveVariant}}{{opencodeVariantConfig}}{{/if}}"
     },
     promptInArgs: true,
-    requiresTty: true
+    requiresTty: true,
+    // `--prompt` only pre-fills the TUI's composer; it does not submit it.
+    // (`opencode run` — the headless subcommand — has no such gap: its
+    // message is a positional arg that runs immediately.) An unattended
+    // surface driving the TUI must press Enter itself.
+    submitPromptKey: true
   },
   features: {
     modelSelection: true,