feat: add --terminal flag to control clientCapabilities.terminal

src/cli-core.ts

@@ -290,6 +290,7 @@ async function handlePrompt(
     promptRetries: globalFlags.promptRetries,
     verbose: globalFlags.verbose,
     waitForCompletion: flags.wait !== false,
+    terminal: globalFlags.terminal,
   });
 
   if ("queued" in result) {
@@ -362,6 +363,7 @@ async function handleExec(
     suppressSdkConsoleErrors: outputPolicy.suppressSdkConsoleErrors,
     timeoutMs: globalFlags.timeout,
     verbose: globalFlags.verbose,
+    terminal: globalFlags.terminal,
     promptRetries: globalFlags.promptRetries,
     sessionOptions: {
       model: globalFlags.model,
@@ -543,6 +545,7 @@ async function handleSetMode(
     authPolicy: globalFlags.authPolicy,
     timeoutMs: globalFlags.timeout,
     verbose: globalFlags.verbose,
+    terminal: globalFlags.terminal,
   });
 
   if (globalFlags.verbose && result.loadError) {
@@ -618,6 +621,7 @@ async function handleSetConfigOption(
     authPolicy: globalFlags.authPolicy,
     timeoutMs: globalFlags.timeout,
     verbose: globalFlags.verbose,
+    terminal: globalFlags.terminal,
   });
 
   if (globalFlags.verbose && result.loadError) {
@@ -712,6 +716,7 @@ async function handleSessionsNew(
     authPolicy: globalFlags.authPolicy,
     timeoutMs: globalFlags.timeout,
     verbose: globalFlags.verbose,
+    terminal: globalFlags.terminal,
     sessionOptions: {
       model: globalFlags.model,
       allowedTools: globalFlags.allowedTools,
@@ -752,6 +757,7 @@ async function handleSessionsEnsure(
     authPolicy: globalFlags.authPolicy,
     timeoutMs: globalFlags.timeout,
     verbose: globalFlags.verbose,
+    terminal: globalFlags.terminal,
     sessionOptions: {
       model: globalFlags.model,
       allowedTools: globalFlags.allowedTools,

src/cli/flags.ts

@@ -42,6 +42,7 @@ export type GlobalFlags = PermissionFlags & {
   model?: string;
   allowedTools?: string[];
   maxTurns?: number;
+  terminal?: boolean;
   promptRetries?: number;
 };
 
@@ -233,7 +234,8 @@ export function addGlobalFlags(command: Command): Command {
       "Queue owner idle TTL before shutdown (0 = keep alive forever) (default: 300)",
       parseTtlSeconds,
     )
-    .option("--verbose", "Enable verbose debug logs");
+    .option("--verbose", "Enable verbose debug logs")
+    .option("--terminal", "Enable terminal capability (default: true)", true);
 }
 
 export function addSessionOption(command: Command): Command {
@@ -309,6 +311,7 @@ export function resolveGlobalFlags(command: Command, config: ResolvedAcpxConfig)
     model: typeof opts.model === "string" ? parseNonEmptyValue("Model", opts.model) : undefined,
     allowedTools: Array.isArray(opts.allowedTools) ? opts.allowedTools : undefined,
     maxTurns: typeof opts.maxTurns === "number" ? opts.maxTurns : undefined,
+    terminal: opts.terminal !== false,
     promptRetries: typeof opts.promptRetries === "number" ? opts.promptRetries : undefined,
     approveAll: opts.approveAll ? true : undefined,
     approveReads: opts.approveReads ? true : undefined,

src/client.ts

@@ -1104,7 +1104,7 @@ export class AcpClient {
             readTextFile: true,
             writeTextFile: true,
           },
-          terminal: true,
+          terminal: this.options.terminal !== false,
         },
         clientInfo: {
           name: "acpx",

src/session-runtime.ts

@@ -190,6 +190,7 @@ export type RunOnceOptions = {
   suppressSdkConsoleErrors?: boolean;
   verbose?: boolean;
   sessionOptions?: SessionAgentOptions;
+  terminal?: boolean;
   promptRetries?: number;
 } & TimedRunOptions;
 
@@ -205,6 +206,7 @@ export type SessionCreateOptions = {
   authPolicy?: AuthPolicy;
   verbose?: boolean;
   sessionOptions?: SessionAgentOptions;
+  terminal?: boolean;
 } & TimedRunOptions;
 
 export type SessionSendOptions = {
@@ -226,6 +228,7 @@ export type SessionSendOptions = {
   waitForCompletion?: boolean;
   ttlMs?: number;
   maxQueueDepth?: number;
+  terminal?: boolean;
   client?: AcpClient;
   promptRetries?: number;
 } & TimedRunOptions;
@@ -243,6 +246,7 @@ export type SessionEnsureOptions = {
   verbose?: boolean;
   walkBoundary?: string;
   sessionOptions?: SessionAgentOptions;
+  terminal?: boolean;
 } & TimedRunOptions;
 
 export type SessionCancelOptions = {
@@ -263,6 +267,7 @@ export type SessionSetModeOptions = {
   authCredentials?: Record<string, string>;
   authPolicy?: AuthPolicy;
   verbose?: boolean;
+  terminal?: boolean;
 } & TimedRunOptions;
 
 export type SessionSetModelOptions = {
@@ -284,6 +289,7 @@ export type SessionSetConfigOptionOptions = {
   authCredentials?: Record<string, string>;
   authPolicy?: AuthPolicy;
   verbose?: boolean;
+  terminal?: boolean;
 } & TimedRunOptions;
 
 function toPromptResult(
@@ -337,6 +343,7 @@ type RunSessionPromptOptions = {
   timeoutMs?: number;
   suppressSdkConsoleErrors?: boolean;
   verbose?: boolean;
+  terminal?: boolean;
   promptRetries?: number;
   onClientAvailable?: (controller: ActiveSessionController) => void;
   onClientClosed?: () => void;
@@ -665,6 +672,7 @@ async function runSessionPrompt(options: RunSessionPromptOptions): Promise<Sessi
       authPolicy: options.authPolicy,
       suppressSdkConsoleErrors: options.suppressSdkConsoleErrors,
       verbose: options.verbose,
+      terminal: options.terminal,
       sessionOptions: sessionOptionsFromRecord(record),
     });
   client.updateRuntimeOptions({
@@ -956,6 +964,7 @@ export async function runOnce(options: RunOnceOptions): Promise<RunPromptResult>
       options.onClientOperation?.(operation);
     },
     sessionOptions: options.sessionOptions,
+    terminal: options.terminal,
   });
 
   try {
@@ -1136,6 +1145,7 @@ export async function createSessionWithClient(
     authPolicy: options.authPolicy,
     verbose: options.verbose,
     sessionOptions: options.sessionOptions,
+    terminal: options.terminal,
   });
 
   try {
@@ -1257,6 +1267,7 @@ export async function runSessionQueueOwner(options: QueueOwnerRuntimeOptions): P
     authPolicy: options.authPolicy,
     suppressSdkConsoleErrors: options.suppressSdkConsoleErrors,
     verbose: options.verbose,
+    terminal: options.terminal,
     sessionOptions: sessionOptionsFromRecord(sessionRecord),
   });
   const ttlMs = normalizeQueueOwnerTtlMs(options.ttlMs);
@@ -1276,6 +1287,7 @@ export async function runSessionQueueOwner(options: QueueOwnerRuntimeOptions): P
         authPolicy: options.authPolicy,
         timeoutMs,
         verbose: options.verbose,
+        terminal: options.terminal,
       });
     },
     setSessionModelFallback: async (modelId: string, timeoutMs?: number) => {
@@ -1301,6 +1313,7 @@ export async function runSessionQueueOwner(options: QueueOwnerRuntimeOptions): P
         authPolicy: options.authPolicy,
         timeoutMs,
         verbose: options.verbose,
+        terminal: options.terminal,
       });
       return result.response;
     },
@@ -1481,6 +1494,7 @@ export async function sendSessionDirect(options: SessionSendOptions): Promise<Se
     timeoutMs: options.timeoutMs,
     suppressSdkConsoleErrors: options.suppressSdkConsoleErrors,
     verbose: options.verbose,
+    terminal: options.terminal,
     client: options.client,
   });
 }
@@ -1523,6 +1537,7 @@ export async function setSessionMode(
     authPolicy: options.authPolicy,
     timeoutMs: options.timeoutMs,
     verbose: options.verbose,
+    terminal: options.terminal,
   });
 }
 
@@ -1591,6 +1606,7 @@ export async function setSessionConfigOption(
     authPolicy: options.authPolicy,
     timeoutMs: options.timeoutMs,
     verbose: options.verbose,
+    terminal: options.terminal,
   });
 }
 

src/session-runtime/prompt-runner.ts

@@ -67,6 +67,7 @@ type WithConnectedSessionOptions<T> = {
   authPolicy?: AuthPolicy;
   timeoutMs?: number;
   verbose?: boolean;
+  terminal?: boolean;
   onClientAvailable?: (controller: ActiveSessionController) => void;
   onClientClosed?: () => void;
   run: (client: AcpClient, sessionId: string, record: SessionRecord) => Promise<T>;
@@ -92,6 +93,7 @@ async function withConnectedSession<T>(
     authCredentials: options.authCredentials,
     authPolicy: options.authPolicy,
     verbose: options.verbose,
+    terminal: options.terminal,
     sessionOptions: sessionOptionsFromRecord(record),
   });
   let activeSessionIdForControl = record.acpSessionId;
@@ -181,6 +183,7 @@ export type RunSessionSetModeDirectOptions = {
   authPolicy?: AuthPolicy;
   timeoutMs?: number;
   verbose?: boolean;
+  terminal?: boolean;
   onClientAvailable?: (controller: ActiveSessionController) => void;
   onClientClosed?: () => void;
 };
@@ -195,6 +198,7 @@ export type RunSessionSetConfigOptionDirectOptions = {
   authPolicy?: AuthPolicy;
   timeoutMs?: number;
   verbose?: boolean;
+  terminal?: boolean;
   onClientAvailable?: (controller: ActiveSessionController) => void;
   onClientClosed?: () => void;
 };
@@ -223,6 +227,7 @@ export async function runSessionSetModeDirect(
     authPolicy: options.authPolicy,
     timeoutMs: options.timeoutMs,
     verbose: options.verbose,
+    terminal: options.terminal,
     onClientAvailable: options.onClientAvailable,
     onClientClosed: options.onClientClosed,
     run: async (client, sessionId, record) => {
@@ -276,6 +281,7 @@ export async function runSessionSetConfigOptionDirect(
     authPolicy: options.authPolicy,
     timeoutMs: options.timeoutMs,
     verbose: options.verbose,
+    terminal: options.terminal,
     onClientAvailable: options.onClientAvailable,
     onClientClosed: options.onClientClosed,
     run: async (client, sessionId, record) => {

src/session-runtime/queue-owner-process.ts

@@ -18,6 +18,7 @@ export type QueueOwnerRuntimeOptions = {
   verbose?: boolean;
   ttlMs?: number;
   maxQueueDepth?: number;
+  terminal?: boolean;
   promptRetries?: number;
 };
 
@@ -32,6 +33,7 @@ type SessionSendLike = {
   verbose?: boolean;
   ttlMs?: number;
   maxQueueDepth?: number;
+  terminal?: boolean;
   promptRetries?: number;
 };
 
@@ -130,6 +132,7 @@ export function queueOwnerRuntimeOptionsFromSend(
     verbose: options.verbose,
     ttlMs: options.ttlMs,
     maxQueueDepth: options.maxQueueDepth,
+    terminal: options.terminal,
     promptRetries: options.promptRetries,
   };
 }

src/types.ts

@@ -178,6 +178,7 @@ export type AcpClientOptions = {
   onAcpOutputMessage?: (direction: AcpMessageDirection, message: AcpJsonRpcMessage) => void;
   onSessionUpdate?: (notification: SessionNotification) => void;
   onClientOperation?: (operation: ClientOperation) => void;
+  terminal?: boolean;
 };
 
 export const SESSION_RECORD_SCHEMA = "acpx.session.v1" as const;