Versión: 0.18.0

Interface: BaseSessionConfig

The minimum a config object needs to drive buildSessionOptions() — a concrete agent's own config type (e.g. a Config) extends this with whatever domain fields it needs (a course URL, credentials, ...), which buildSessionOptions() itself never looks at directly: only AgentSpec's methods receive the full concrete config.

Properties

Property	Type	Description	Defined in
`deniedPaths?`	`string`[]	Files or directories the agent must never read, search or write, e.g. a config file holding a password (see hooks/fileScopeGate.ts).	core/agentSpec.ts:52
`extraReadableDirs?`	`string`[]	Directories besides `sourcesDir`/`extraWritableDirs` the agent may read and search (Read, Glob, Grep), never write. Read and Glob reach nothing else on the disk but what the kit knows the agent needs (see hooks/fileScopeGate.ts).	core/agentSpec.ts:50
`extraWritableDirs?`	`string`[]	Directories besides `knowledgeDir`/`sourcesDir` where Write/Edit are allowed (see hooks/fileScopeGate.ts).	core/agentSpec.ts:44
`knowledgeDir?`	`string`	Where the agent writes its own notes (the "wiki"). Setting this or `sourcesDir` is what gives the session the file tools (Read/Write/Edit/Glob/Grep, scoped — see hooks/fileScopeGate.ts); without either, the agent has no file access at all.	core/agentSpec.ts:35
`language?`	`string`	The language ("en", "es", "fr", "de") the agent replies in and the kit's interface uses. `--language=<code>` on the command line wins over it; without either, the system's language (see language.ts). Pass the same value to the chat, wizard or progress view.	core/agentSpec.ts:60
`mode`	`Mode`	-	core/agentSpec.ts:27
`projectDir`	`string`	Project root (the session's cwd): the folder under which the agent's notes, sources and runs live.	core/agentSpec.ts:29
`secrets?`	`string`[]	Extra values (e.g. a password) to scrub out of the transcript log — see hooks/transcriptLogger.ts.	core/agentSpec.ts:54
`sourcesDir?`	`string`	Original files, kept as obtained and apart from the notes in `knowledgeDir`: material the user drops in, plus whatever the agent saves with `save_to_sources` (downloaded documents, transcripts...). The agent can read and search it but never edit it — Write/ Edit are scoped to `knowledgeDir` — and `save_to_sources` never overwrites.	core/agentSpec.ts:42
`timeZone?`	`string`	The time zone the date and time tools answer in (`current_time`, `date_math`), an IANA name such as "Europe/Madrid"; the system's if not given.	core/agentSpec.ts:65

Properties​

Properties