> ## Documentation Index
> Fetch the complete documentation index at: https://cognitio-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Interface: AgentSessionOptions

> Generated from the public TypeScript API.

Options for a long-lived, caller-managed Session.

Turn cancellation is intentionally absent; pass a signal to each Session
operation instead.

## Example

```ts theme={null}
const session = await agent.createSession({
  title: "Release review",
  parentId: "ses_parent",
})
```

## Properties

### cwd?

```ts theme={null}
optional cwd?: string;
```

Working directory fixed for the new session.

***

### maxBudgetUsd?

```ts theme={null}
optional maxBudgetUsd?: number;
```

Maximum model cost per operation in USD.

***

### maxTurns?

```ts theme={null}
optional maxTurns?: number;
```

Maximum model turns per operation.

***

### model?

```ts theme={null}
optional model?: ModelId;
```

`provider/model` id for this session.

***

### outputFormat?

```ts theme={null}
optional outputFormat?: OutputFormatSpec<unknown>;
```

Structured-output contract for the session.

***

### parentId?

```ts theme={null}
optional parentId?: string;
```

Optional parent session id for server-side hierarchy.

***

### permission?

```ts theme={null}
optional permission?: PermissionRuleset;
```

Server permission rules, distinct from `permissionMode`.

***

### permissionMode?

```ts theme={null}
optional permissionMode?: PermissionMode;
```

Runtime permission behavior for the session.

***

### title?

```ts theme={null}
optional title?: string;
```

Explicit session title; defaults to `"Agent session"`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.