Skip to main content
Options for a long-lived, caller-managed Session. Turn cancellation is intentionally absent; pass a signal to each Session operation instead.

Example

Properties

cwd?

Working directory fixed for the new session.

maxBudgetUsd?

Maximum model cost per operation in USD.

maxTurns?

Maximum model turns per operation.

model?

provider/model id for this session.

outputFormat?

Structured-output contract for the session.

parentId?

Optional parent session id for server-side hierarchy.

permission?

Server permission rules, distinct from permissionMode.

permissionMode?

Runtime permission behavior for the session.

title?

Explicit session title; defaults to "Agent session".