Skip to content
2 min read · 329 words

Interface: SkillScriptConfig

Defined in: src/batteries/skills/types.ts:85

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

Properties

PropertyTypeDescriptionDefined in
defaultTimeoutSecondsnumberDefault timeout used when the model omits one.src/batteries/skills/types.ts:101
failOnNonzeroExit?booleanWhether a nonzero child exit code is a tool failure. Default (or omitted) true: a script that exits nonzero throws E_SKILL_SCRIPT_FAILED, 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
handleSandboxHandleChild-process handle used to execute scripts under the derived policy.src/batteries/skills/types.ts:87
hostEnvIsolatedbooleanDeclares whether the interpreter cannot inherit host environment variables.src/batteries/skills/types.ts:105
interpreterReadPathsreadonly string[]Host files interpreters may read in addition to the materialized skill root.src/batteries/skills/types.ts:97
interpretersReadonly<Record<string, readonly string[]>>Allowlisted interpreter argv prefixes keyed by SkillScriptSpec.interpreter.src/batteries/skills/types.ts:95
maxOutputBytesnumberOutput ceiling preventing unbounded child-process results.src/batteries/skills/types.ts:103
maxTimeoutSecondsnumberHard upper bound for model-requested script timeouts.src/batteries/skills/types.ts:99
policySandboxPolicyBaseline policy narrowed to the skill's declared capabilities.src/batteries/skills/types.ts:91
translatorPathTranslatorMaps source paths into the sandbox namespace.src/batteries/skills/types.ts:93
workspaceSkillWorkspaceMaterializes bundled files and disposes roots when the skill leaves the loaded set.src/batteries/skills/types.ts:89