---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/skills/interfaces/SkillScriptConfig.md
description: 'Tier-3 execution controls, workspace, policy, and output/time ceilings.'
---

# Interface: SkillScriptConfig

Defined in: [src/batteries/skills/types.ts:85](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L85)

Tier-3 execution controls, workspace, policy, and output/time ceilings.

## Properties

| Property                                                            | Type                                                                                                                                                                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Defined in                                                                                                                  |
| ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
|  `defaultTimeoutSeconds` | `number`                                                                                                                                                                                                                   | Default timeout used when the model omits one.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | [src/batteries/skills/types.ts:101](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L101) |
|  `failOnNonzeroExit?`        | `boolean`                                                                                                                                                                                                                  | Whether a nonzero child exit code is a tool failure. Default (or omitted) `true`: a script that exits nonzero throws [E\_SKILL\_SCRIPT\_FAILED](../variables/E_SKILL_SCRIPT_FAILED.md), so a host can detect a broken or rejected script programmatically rather than parsing the exit code out of the acknowledgement string. Set `false` to keep the plain acknowledgement behaviour — any completed run, whatever its exit code, returns the success string — for skills whose scripts use exit codes as ordinary signalling rather than pass/fail. Output is spooled either way; on the failure path the retrievable id is carried in the error. | [src/batteries/skills/types.ts:115](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L115) |
|  `handle`                               | [`SandboxHandle`](../../sandbox/interfaces/SandboxHandle.md)                                                                                                                                                               | Child-process handle used to execute scripts under the derived policy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | [src/batteries/skills/types.ts:87](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L87)   |
|  `hostEnvIsolated`             | `boolean`                                                                                                                                                                                                                  | Declares whether the interpreter cannot inherit host environment variables.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | [src/batteries/skills/types.ts:105](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L105) |
|  `interpreterReadPaths`   | readonly `string`\[]                                                                                                                                                                                                        | Host files interpreters may read in addition to the materialized skill root.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | [src/batteries/skills/types.ts:97](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L97)   |
|  `interpreters`                   | [`Readonly`](https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype)<[`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)<`string`, readonly `string`\[]>> | Allowlisted interpreter argv prefixes keyed by [SkillScriptSpec.interpreter](SkillScriptSpec.md#property-interpreter).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | [src/batteries/skills/types.ts:95](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L95)   |
|  `maxOutputBytes`               | `number`                                                                                                                                                                                                                   | Output ceiling preventing unbounded child-process results.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | [src/batteries/skills/types.ts:103](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L103) |
|  `maxTimeoutSeconds`         | `number`                                                                                                                                                                                                                   | Hard upper bound for model-requested script timeouts.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | [src/batteries/skills/types.ts:99](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L99)   |
|  `policy`                               | [`SandboxPolicy`](../../sandbox/interfaces/SandboxPolicy.md)                                                                                                                                                               | Baseline policy narrowed to the skill's declared capabilities.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | [src/batteries/skills/types.ts:91](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L91)   |
|  `translator`                       | [`PathTranslator`](../../sandbox/interfaces/PathTranslator.md)                                                                                                                                                             | Maps source paths into the sandbox namespace.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | [src/batteries/skills/types.ts:93](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L93)   |
|  `workspace`                         | [`SkillWorkspace`](SkillWorkspace.md)                                                                                                                                                                                      | Materializes bundled files and disposes roots when the skill leaves the loaded set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | [src/batteries/skills/types.ts:89](https://github.com/NHTIO/ADK/blob/v1.20260911.0/src/src/batteries/skills/types.ts#L89)   |