docs: align prose with runtime contracts

This commit is contained in:
Tianyi Cui
2026-07-14 16:21:41 +08:00
parent 26b4b036fc
commit f0fc20ca42
84 changed files with 162 additions and 146 deletions

View File

@@ -34,7 +34,7 @@ function permissionOption(currentValue: string): object {
type: 'select',
currentValue,
options: [
{ value: 'workspace-write', name: 'workspace-write', description: 'Write inside the workspace; wider retries require approval.' },
{ value: 'workspace-write', name: 'workspace-write', description: 'Write inside the workspace and permitted temporary directories; wider retries require approval.' },
{ value: 'danger-full-access', name: 'danger-full-access', description: 'Full file access without approval prompts.' },
],
}

View File

@@ -102,7 +102,7 @@ export class PermissionService extends Service {
})).default({
'workspace-write': {
sandbox: 'workspace-write', approval: 'ask',
name: 'workspace-write', description: 'Write inside the workspace; wider retries require approval.',
name: 'workspace-write', description: 'Write inside the workspace and permitted temporary directories; wider retries require approval.',
},
'danger-full-access': {
sandbox: 'danger-full-access', approval: 'never',

View File

@@ -222,9 +222,9 @@ export interface Config {
}
/**
* Approval request and policy service. It logs each ask/outcome pair, applies
* session policy before answerers, and exposes deterministic policy changes to
* the model through prompt and pre-step notices.
* Approval service that applies session policy before answerers and logs every
* ask/outcome pair to the requesting session. It exposes deterministic policy
* changes to the model through prompt and pre-step notices.
*/
export class ApprovalService extends Service {
static Config: z<Config> = z.object({