2e7cdddb89
# Conflicts: # .agents/notes/implemented/feature/2026-07-14-cross-family-fs-sandbox.i18n.yaml # .agents/notes/implemented/feature/2026-07-14-cross-family-fs-sandbox.md # .agents/notes/implemented/feature/2026-07-14-cross-family-fs-sandbox.zh.md # docs/capability-seams.md # docs/cordis-catalog/events.md # docs/cordis-catalog/services.md # docs/event-producer-consumer.md # docs/module-graph.md # docs/persistence-catalog.md # docs/rfc/INDEX.md # examples/acp-agent/README.md # examples/acp-agent/fs.cordis.snapshot.yml # examples/acp-agent/fs.cordis.yml # examples/acp-agent/tests/snapshots/escalation-approved/session.jsonl # examples/acp-agent/tests/snapshots/escalation-rejected/session.jsonl # examples/acp-agent/tests/snapshots/hook-cc-pretool-ask/session.jsonl # examples/acp-agent/tests/snapshots/permission-switching/session.jsonl # examples/acp-agent/tests/snapshots/workspace-context/system-prompt.expected.md # examples/acp-agent/tests/snapshots/workspace-context/tool-schemas.expected.json # examples/acp-agent/tests/snapshots/workspace-edit/system-prompt.expected.md # examples/acp-agent/tests/snapshots/workspace-edit/tool-schemas.expected.json # packages/bash/bash/src/index.ts # packages/bash/tool-bash/package.json # packages/bash/tool-bash/src/index.ts # packages/bash/tool-bash/tests/tools.spec.ts # packages/cordis/tool-cordis/src/api-catalog.ts # packages/fs/README.md # packages/fs/tool-fs/src/edit.ts # packages/fs/tool-fs/src/write.ts # packages/sandbox/README.md # pnpm-lock.yaml
105 lines
3.6 KiB
Markdown
105 lines
3.6 KiB
Markdown
<!-- Generated by scripts/gen-website-api.ts — do not edit by hand. Run `pnpm run gen-website-api` to regenerate. -->
|
|
|
|
# ctx.permission
|
|
|
|
`PermissionService` — provided by `@deepseek-ai/dsh-permission`.
|
|
|
|
Owns the deployment's permission presets and their write path. Requires a confining `ctx.bash` executor and `ctx.approval`; unmatched knob values are reported as CUSTOM_PRESET, not an error.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/ui/permission/src/index.ts#L97)
|
|
|
|
### ctx.permission.names
|
|
|
|
```ts website-api
|
|
/**
|
|
* The advertised preset names, in the preset table's declaration order.
|
|
* @returns every switchable preset name.
|
|
*/
|
|
get names(): readonly string[]
|
|
```
|
|
|
|
The advertised preset names, in the preset table's declaration order.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/ui/permission/src/index.ts#L137)
|
|
|
|
### ctx.permission.current(events)
|
|
|
|
```ts website-api
|
|
/**
|
|
* Resolve the preset matching the effective knob values. A still-matching
|
|
* last selection wins shared-bundle ties; otherwise the first table match
|
|
* wins, or {@link CUSTOM_PRESET} when no entry matches.
|
|
* @param events - the session's events in log order.
|
|
* @returns the effective preset name, or `custom` when nothing matches.
|
|
*/
|
|
current(events: readonly SessionEvent[]): string
|
|
```
|
|
|
|
Resolve the preset matching the effective knob values. A still-matching last selection wins shared-bundle ties; otherwise the first table match wins, or CUSTOM_PRESET when no entry matches.
|
|
|
|
- `events` — the session's events in log order.
|
|
|
|
**Returns** the effective preset name, or `custom` when nothing matches.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/ui/permission/src/index.ts#L148)
|
|
|
|
### ctx.permission.resolve(name)
|
|
|
|
```ts website-api
|
|
/**
|
|
* Resolve a preset's knob bundle.
|
|
* @param name - the preset name to resolve.
|
|
* @returns the configured bundle.
|
|
* @throws when `name` is not in the table.
|
|
*/
|
|
resolve(name: string): PresetSpec
|
|
```
|
|
|
|
Resolve a preset's knob bundle.
|
|
|
|
- `name` — the preset name to resolve.
|
|
|
|
**Returns** the configured bundle.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/ui/permission/src/index.ts#L169)
|
|
|
|
### ctx.permission.optionOf(name)
|
|
|
|
```ts website-api
|
|
/**
|
|
* Build the client option for a table entry or {@link CUSTOM_PRESET}. A
|
|
* missing label falls back to the table key.
|
|
* @param name - a table key, or `custom`.
|
|
* @returns the option a client renders.
|
|
* @throws when `name` is neither a table key nor `custom`.
|
|
*/
|
|
optionOf(name: string): PresetOption
|
|
```
|
|
|
|
Build the client option for a table entry or CUSTOM_PRESET. A missing label falls back to the table key.
|
|
|
|
- `name` — a table key, or `custom`.
|
|
|
|
**Returns** the option a client renders.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/ui/permission/src/index.ts#L184)
|
|
|
|
### ctx.permission.set(session, name)
|
|
|
|
```ts website-api
|
|
/**
|
|
* Record a changed preset, then update each changed knob through its own
|
|
* setter. Selecting the effective preset again appends nothing.
|
|
* @param session - the session the switch belongs to.
|
|
* @param name - the preset to switch to; unknown names throw.
|
|
*/
|
|
set(session: Session, name: string): void
|
|
```
|
|
|
|
Record a changed preset, then update each changed knob through its own setter. Selecting the effective preset again appends nothing.
|
|
|
|
- `session` — the session the switch belongs to.
|
|
- `name` — the preset to switch to; unknown names throw.
|
|
|
|
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/ui/permission/src/index.ts#L198)
|