Interface: LaunchTerminalOptions

@termwright/driver

---

@termwright/driver / LaunchTerminalOptions

Interface: LaunchTerminalOptions

Defined in: driver/src/session.ts:211

Stable application-facing options accepted by launchTerminal.

Extends

• LaunchOptions

Properties

artifactSecurity?

readonly optional artifactSecurity?: ArtifactSecurityPolicy

Defined in: driver/src/api.ts:135

One policy for every artifact boundary. Defaults to secure redacted.

Inherited from

LaunchOptions.artifactSecurity

---

columns?

readonly optional columns?: number

Defined in: driver/src/api.ts:113

Inherited from

LaunchOptions.columns

---

command

readonly command: readonly string[]

Defined in: driver/src/api.ts:88

Inherited from

LaunchOptions.command

---

cwd?

readonly optional cwd?: string

Defined in: driver/src/api.ts:89

Inherited from

LaunchOptions.cwd

---

debug?

readonly optional debug?: boolean

Defined in: driver/src/api.ts:97

Streams a live log of API calls, waits, revisions and diagnostics to stderr. Also enabled by TERMWRIGHT_DEBUG=1 (=all adds raw PTY traffic).

Inherited from

LaunchOptions.debug

---

env?

readonly optional env?: Readonly<Record<string, string>>

Defined in: driver/src/api.ts:90

Inherited from

LaunchOptions.env

---

envMode?

readonly optional envMode?: EnvMode

Defined in: driver/src/api.ts:92

Defaults to 'replace': a test process’s secrets are not the child’s.

Inherited from

LaunchOptions.envMode

---

logs?

readonly optional logs?: readonly AppLogSource[]

Defined in: driver/src/api.ts:103

Log files to follow for the lifetime of the session. A file that does not exist yet is waited for; one that already exists is followed from its current end, so a session never replays a previous run.

Inherited from

LaunchOptions.logs

---

modesObservable?

readonly optional modesObservable?: boolean

Defined in: driver/src/session.ts:217

Whether the child’s input-mode requests are observable. Defaults to true for every certified backend, including pinned passthrough ConPTY. Set false only for an embedding or synthetic backend that cannot expose DECSET.

---

operationBudget?

readonly optional operationBudget?: OperationBudget

Defined in: driver/src/api.ts:132

Inherited from

LaunchOptions.operationBudget

---

recording?

readonly optional recording?: RecordingOptions

Defined in: driver/src/api.ts:133

Inherited from

LaunchOptions.recording

---

requiredCapabilities?

readonly optional requiredCapabilities?: readonly ("semantic-tree" | "stable-identity" | "intended-geometry" | "clipped-geometry" | "painted-region" | "pointer-geometry" | "pointer-hit-testing" | "focus" | "scroll" | "render-order" | "action-strategies" | "keyboard-input" | "pointer-input" | "focus-input" | "paired-revisions")[]

Defined in: driver/src/api.ts:146

Capabilities that must be present in the frozen session contract. Launch waits for negotiation and throws CapabilityUnavailableError before returning a harness when any requirement is missing.

Inherited from

LaunchOptions.requiredCapabilities

---

rows?

readonly optional rows?: number

Defined in: driver/src/api.ts:114

Inherited from

LaunchOptions.rows

---

scrollbackLines?

readonly optional scrollbackLines?: number

Defined in: driver/src/api.ts:130

Inherited from

LaunchOptions.scrollbackLines

---

semanticFrameQueueCapacity?

readonly optional semanticFrameQueueCapacity?: number

Defined in: driver/src/api.ts:129

Negotiated ceiling for semantic frames in flight between a framework probe and the driver. Defaults to 32 and is capped at 256. Compatible probes may use it as their publication budget; a full queue still fails closed instead of dropping or retrying a semantic revision.

Inherited from

LaunchOptions.semanticFrameQueueCapacity

---

semanticNegotiationMs?

readonly optional semanticNegotiationMs?: number

Defined in: driver/src/api.ts:122

Maximum time to discover an optional semantic adapter. Defaults to 2,000 ms for generic auto-detection. A peer accepted within that window keeps its own bounded hello deadline; peers first seen afterwards are refused. When requiredCapabilities is non-empty, the default discovery budget is the larger of 2,000 ms and the session ready timeout.

Inherited from

LaunchOptions.semanticNegotiationMs

---

shellIntegration?

readonly optional shellIntegration?: "external" | "termwright-posix" | "termwright-powershell"

Defined in: driver/src/api.ts:140

Termwright-managed modes instrument an interactive shell with exact command markers. Test authors should normally use terminal.openShell().

Inherited from

LaunchOptions.shellIntegration

---

terminalProfile?

readonly optional terminalProfile?: TerminalProfileId

Defined in: driver/src/api.ts:112

Terminal profile: which width tables and which of the switches terminals disagree on this session uses. The built-in ids are 'default' and 'cjk-wide'.

It is recorded with the session so a replay, a screenshot and the runner pane can count characters exactly as the live session did.

Inherited from

LaunchOptions.terminalProfile

---

timeouts?

readonly optional timeouts?: TimeoutClasses

Defined in: driver/src/api.ts:131

Inherited from

LaunchOptions.timeouts