@deepseek-harness-tui/dsh-tui 0.13.0 → 0.14.0

package/lib/types/backends/claude/channels.js

@@ -0,0 +1,275 @@
+/**
+ * The Claude backend's channel profiles (`~/.dsh-tui/backends/claude/
+ * channels.json`): the relay channels the user routes through, each with the
+ * model mapping that says what a requested id actually runs. First-class user
+ * data on purpose — the settings-env tier heuristics (modelEnv.ts) guess the
+ * mapping from ANTHROPIC_*_MODEL; a profile states it.
+ *
+ * Shape:
+ *
+ * ```json
+ * {
+ *   "active": "zhipu",
+ *   "channels": [
+ *     {
+ *       "id": "zhipu",
+ *       "name": "智谱",
+ *       "baseUrl": "https://open.bigmodel.cn/api/anthropic",
+ *       "tokenRef": "CHANNEL_OPEN_BIGMODEL_CN_TOKEN",
+ *       "env": { "ANTHROPIC_LOG": "debug" },
+ *       "models": { "claude-opus-5-5[1m]": "glm-5.3[1M]" },
+ *       "tiers": { "opus": "glm-5.3[1M]", "haiku": "glm-5.3-flash" }
+ *     }
+ *   ]
+ * }
+ * ```
+ *
+ * `models` is an exact id → actual map (matched exactly, then
+ * base-normalized like model-names.json); `tiers` maps a tier keyword
+ * (haiku/opus/sonnet/fable, plus `default` for the ANTHROPIC_MODEL
+ * fallback) to the model that serves it — the env heuristics promoted to
+ * user data. Both fields are optional.
+ *
+ * A profile can also carry the session's connection: `baseUrl` is the
+ * relay endpoint the CLI child is pointed at, `tokenRef` names its
+ * credential in the DSH credential store (`~/.dsh/.credentials.yaml`, as
+ * /provider does; channels.json never holds a token) and `env` holds
+ * channel-private variables. The active profile's connection is injected at
+ * spawn (auth.ts: the child env plus the SDK `settings` flag layer, which
+ * outranks the CLI settings `env`).
+ *
+ * Best-effort like every `~/.dsh-tui` preference (prefs.ts): a missing or
+ * corrupt file reads as no channels (a corrupt one is moved aside by the
+ * next save, never overwritten), a failed write is reported to the caller's
+ * debug log and the session carries on. The id is a stable slug of the name,
+ * so a re-import (or a hand edit) refreshes the same row.
+ */
+import { readFileSync, renameSync } from 'node:fs';
+import { join } from 'node:path';
+import { channelProfileSlug } from '../../channel/channel-slug.js';
+import { DATA_DIR } from '../../utils/paths.js';
+import { writeFileAtomic } from '../shared/atomic-file.js';
+const FILE = 'channels.json';
+/** The stable id of a channel name (shared with the /channel wizard). */
+export const channelSlug = channelProfileSlug;
+/** Narrow one parsed object to a string→string record (empty keys/values drop). */
+function stringMap(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const out = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === 'string' && key.trim() !== '' && entry.trim() !== '')
+            out[key.trim()] = entry.trim();
+    }
+    return Object.keys(out).length === 0 ? undefined : out;
+}
+/** Narrow a parsed document to what persists (anything else reads as absent). */
+export function parseChannels(parsed) {
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+        return { channels: [] };
+    const record = parsed;
+    const channels = [];
+    for (const raw of Array.isArray(record.channels) ? record.channels : []) {
+        if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+            continue;
+        const entry = raw;
+        if (typeof entry.id !== 'string' || entry.id.trim() === '')
+            continue;
+        const id = entry.id.trim();
+        if (channels.some(channel => channel.id === id))
+            continue;
+        const name = typeof entry.name === 'string' && entry.name.trim() !== '' ? entry.name.trim() : id;
+        const models = stringMap(entry.models);
+        const tiers = stringMap(entry.tiers);
+        const baseUrl = typeof entry.baseUrl === 'string' && entry.baseUrl.trim() !== '' ? entry.baseUrl.trim() : undefined;
+        const tokenRef = typeof entry.tokenRef === 'string' && entry.tokenRef.trim() !== '' ? entry.tokenRef.trim() : undefined;
+        const channelEnv = stringMap(entry.env);
+        channels.push({
+            id, name,
+            ...(models === undefined ? {} : { models }),
+            ...(tiers === undefined ? {} : { tiers }),
+            ...(baseUrl === undefined ? {} : { baseUrl }),
+            ...(tokenRef === undefined ? {} : { tokenRef }),
+            ...(channelEnv === undefined ? {} : { env: channelEnv }),
+        });
+    }
+    const active = typeof record.active === 'string' && channels.some(channel => channel.id === record.active)
+        ? record.active
+        : undefined;
+    return { channels, ...(active === undefined ? {} : { active }) };
+}
+/** The channel whose mapping is live (undefined when none is active). */
+export function activeProfileOf(data) {
+    return data.active === undefined ? undefined : data.channels.find(channel => channel.id === data.active);
+}
+/** Apply `setActive` (pure): a no-op for an id the file does not hold. */
+function activated(current, id) {
+    return current.channels.some(channel => channel.id === id) ? { ...current, active: id } : current;
+}
+/** Apply `save` (pure): an upsert by id that keeps the roster order. */
+function saved(current, profile) {
+    const index = current.channels.findIndex(channel => channel.id === profile.id);
+    return { ...current, channels: index === -1 ? [...current.channels, profile] : current.channels.map((channel, at) => at === index ? profile : channel) };
+}
+/** Apply `remove` (pure): the row goes, and `active` with it when it
+ *  named the removed channel (nothing else changes). */
+function removed(current, id) {
+    const channels = current.channels.filter(channel => channel.id !== id);
+    if (channels.length === current.channels.length)
+        return current;
+    const active = current.active === id ? undefined : current.active;
+    return { channels, ...(active === undefined ? {} : { active }) };
+}
+/** The file-backed profiles under `<dir>` (default `~/.dsh-tui/backends/claude`). */
+export function fileClaudeChannels(dir = join(DATA_DIR, 'backends', 'claude'), debug = () => undefined) {
+    const path = join(dir, FILE);
+    /** The document, and whether a file is there that could not be read or
+     *  parsed (it reads as no channels). */
+    const load = () => {
+        let text;
+        try {
+            text = readFileSync(path, 'utf8');
+        }
+        catch (error) {
+            const code = error.code;
+            return { data: { channels: [] }, damaged: code !== 'ENOENT' && code !== 'ENOTDIR' };
+        }
+        try {
+            return { data: parseChannels(JSON.parse(text)), damaged: false };
+        }
+        catch {
+            return { data: { channels: [] }, damaged: true };
+        }
+    };
+    const read = () => load().data;
+    const commit = (next) => {
+        try {
+            writeFileAtomic(dir, FILE, `${JSON.stringify(next, null, 2)}\n`);
+        }
+        catch (error) {
+            debug(`claude: channels write failed (${error instanceof Error ? error.message : String(error)})`);
+        }
+    };
+    return {
+        read,
+        setActive: id => {
+            const current = read();
+            if (current.active === id)
+                return;
+            if (!current.channels.some(channel => channel.id === id)) {
+                debug(`claude: channels setActive ignored unknown id ${id}`);
+                return;
+            }
+            commit(activated(current, id));
+        },
+        save: profile => {
+            const current = load();
+            if (current.damaged) {
+                // A damaged file (a hand edit gone wrong) still holds the user's
+                // profiles: it moves aside instead of being replaced by this save.
+                const aside = `${path}.damaged-${Date.now()}`;
+                try {
+                    renameSync(path, aside);
+                    debug(`claude: channels.json could not be read; kept as ${aside}`);
+                }
+                catch (error) {
+                    debug(`claude: channels.json could not be read nor moved aside (${error instanceof Error ? error.message : String(error)}); not saving`);
+                    return;
+                }
+            }
+            commit(saved(current.data, profile));
+        },
+        remove: id => {
+            const current = read();
+            if (!current.channels.some(channel => channel.id === id)) {
+                debug(`claude: channels remove ignored unknown id ${id}`);
+                return;
+            }
+            commit(removed(current, id));
+        },
+    };
+}
+/** An in-memory store (tests, embedders without a home directory). */
+export function memoryClaudeChannels(initial = { channels: [] }) {
+    let data = parseChannels(initial);
+    return {
+        get data() { return data; },
+        read: () => data,
+        setActive: id => { data = activated(data, id); },
+        save: profile => { data = saved(data, profile); },
+        remove: id => { data = removed(data, id); },
+    };
+}
+/** The tier env keys the import reads (modelEnv.ts's TIER_ENV_KEYS, restated
+ *  for the env→tiers promotion; `default` carries ANTHROPIC_MODEL). */
+const IMPORT_TIER_KEYS = [
+    ['haiku', 'ANTHROPIC_DEFAULT_HAIKU_MODEL'],
+    ['opus', 'ANTHROPIC_DEFAULT_OPUS_MODEL'],
+    ['sonnet', 'ANTHROPIC_DEFAULT_SONNET_MODEL'],
+    ['fable', 'ANTHROPIC_DEFAULT_FABLE_MODEL'],
+];
+const pickEnv = (env, key) => {
+    const value = env[key];
+    return typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
+};
+/**
+ * The channel profile hiding in the CLI settings `env`: the ANTHROPIC_BASE_URL
+ * host names it, the ANTHROPIC_DEFAULT_*_MODEL (+ ANTHROPIC_MODEL) values
+ * become its tiers. Exact `models` are never guessed — those stay the user's
+ * own hand-written entries, and a re-import of the same id keeps them.
+ * Undefined when the env holds neither a base URL nor any model value.
+ */
+export function importFromSettingsEnv(env, existing) {
+    const baseUrl = pickEnv(env, 'ANTHROPIC_BASE_URL');
+    let host;
+    if (baseUrl !== undefined) {
+        try {
+            host = new URL(baseUrl).host || undefined;
+        }
+        catch {
+            host = undefined;
+        }
+    }
+    const tiers = {};
+    for (const [tier, envKey] of IMPORT_TIER_KEYS) {
+        const model = pickEnv(env, envKey);
+        if (model !== undefined)
+            tiers[tier] = model;
+    }
+    const fallback = pickEnv(env, 'ANTHROPIC_MODEL');
+    if (fallback !== undefined)
+        tiers.default = fallback;
+    if (host === undefined && Object.keys(tiers).length === 0)
+        return undefined;
+    const name = host ?? pickEnv(env, 'ANTHROPIC_CUSTOM_MODEL_OPTION_NAME') ?? 'settings';
+    const id = channelSlug(name);
+    // A refresh of the same channel keeps the user's exact models and the
+    // connection fields the env cannot speak to (the import only owns what it
+    // can honestly derive: name + tiers + a parseable base URL — an invalid
+    // one names the channel but never becomes the connection).
+    const keeps = existing !== undefined && existing.id === id;
+    const models = keeps ? existing.models : undefined;
+    const importedBaseUrl = host === undefined ? undefined : baseUrl;
+    const keptBaseUrl = keeps && importedBaseUrl === undefined ? existing.baseUrl : undefined;
+    const tokenRef = keeps ? existing.tokenRef : undefined;
+    const channelEnv = keeps ? existing.env : undefined;
+    return {
+        id, name,
+        ...(models === undefined ? {} : { models }),
+        ...(Object.keys(tiers).length === 0 ? {} : { tiers }),
+        ...(importedBaseUrl === undefined && keptBaseUrl === undefined ? {} : { baseUrl: importedBaseUrl ?? keptBaseUrl }),
+        ...(tokenRef === undefined ? {} : { tokenRef }),
+        ...(channelEnv === undefined ? {} : { env: channelEnv }),
+    };
+}
+/** The channel token in the CLI settings env: the value of
+ *  `ANTHROPIC_AUTH_TOKEN`, for the caller to move into the credential store
+ *  — the profile itself only ever records the derived `tokenRef`. */
+export function importTokenFromSettingsEnv(env) {
+    return pickEnv(env, 'ANTHROPIC_AUTH_TOKEN');
+}
+/** A channel profile's connection carries anything spawn-shaping. */
+export function hasChannelConnection(profile) {
+    return profile !== undefined && (profile.baseUrl !== undefined || profile.tokenRef !== undefined
+        || (profile.env !== undefined && Object.keys(profile.env).length > 0));
+}

package/lib/types/backends/claude/contract.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Version contract of the Claude backend.
+ * The SDK is pinned exactly (`package.json` optional peer + dev dependency);
+ * the CLI it drives is validated per version read from
+ * `system/init.claude_code_version`. Drift is reported (startup notice and a
+ * `/doctor` line), never a hard stop: capability detection
+ * (`init.capabilities`) decides behaviour, the version only explains it.
+ */
+/** Backend id of the Claude Agent backend (`AgentSessionRef.backendId`). */
+export declare const CLAUDE_BACKEND_ID = "claude";
+/** User-facing backend name. Brand guidance allows "Claude Agent", never
+ *  "Claude Code". */
+export declare const CLAUDE_BACKEND_LABEL = "Claude Agent";
+/** How a user re-enters a Claude session from a shell: the launcher's
+ *  backend flag plus the session id (DSH's `resume.txt` never holds one). */
+export declare function claudeResumeCommand(sessionId: string): string;
+/** The exact `@anthropic-ai/claude-agent-sdk` version this backend is
+ *  validated against (mirrors the package.json pin). */
+export declare const VALIDATED_SDK_VERSION = "0.3.287";
+/** CLI versions validated with {@link VALIDATED_SDK_VERSION} (the SDK's own
+ *  `manifest.json` parity version). */
+export declare const VALIDATED_CLI_VERSIONS: readonly string[];
+/** Init capabilities this backend relies on when present (feature-detected,
+ *  never version-sniffed). */
+export declare const CLI_CAPABILITY: {
+    /** `command_lifecycle` frames: user rows land on `started`. */
+    readonly lifecycle: "msg_lifecycle_v1";
+    /** `interrupt()` answers with `still_queued`. */
+    readonly interruptReceipt: "interrupt_receipt_v1";
+    /** `interrupt` honours `cancel_queued` (drop queued inputs with the turn). */
+    readonly interruptCancelQueued: "interrupt_cancel_queued_v1";
+};
+/** The CLI version when it is outside the validated set, else undefined. */
+export declare function cliVersionDrift(version: string | undefined): string | undefined;
+/** The SDK version when it differs from the pin, else undefined. */
+export declare function sdkVersionDrift(version: string | undefined): string | undefined;
+//# sourceMappingURL=contract.d.ts.map

package/lib/types/backends/claude/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../src/backends/claude/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,WAAW,CAAA;AAEzC;qBACqB;AACrB,eAAO,MAAM,oBAAoB,iBAAiB,CAAA;AAElD;6EAC6E;AAC7E,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;wDACwD;AACxD,eAAO,MAAM,qBAAqB,YAAY,CAAA;AAE9C;uCACuC;AACvC,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAgB,CAAA;AAEpE;8BAC8B;AAC9B,eAAO,MAAM,cAAc;IACzB,+DAA+D;;IAE/D,iDAAiD;;IAEjD,8EAA8E;;CAEtE,CAAA;AAEV,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG/E;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG/E"}

package/lib/types/backends/claude/contract.js

@@ -0,0 +1,46 @@
+/**
+ * Version contract of the Claude backend.
+ * The SDK is pinned exactly (`package.json` optional peer + dev dependency);
+ * the CLI it drives is validated per version read from
+ * `system/init.claude_code_version`. Drift is reported (startup notice and a
+ * `/doctor` line), never a hard stop: capability detection
+ * (`init.capabilities`) decides behaviour, the version only explains it.
+ */
+/** Backend id of the Claude Agent backend (`AgentSessionRef.backendId`). */
+export const CLAUDE_BACKEND_ID = 'claude';
+/** User-facing backend name. Brand guidance allows "Claude Agent", never
+ *  "Claude Code". */
+export const CLAUDE_BACKEND_LABEL = 'Claude Agent';
+/** How a user re-enters a Claude session from a shell: the launcher's
+ *  backend flag plus the session id (DSH's `resume.txt` never holds one). */
+export function claudeResumeCommand(sessionId) {
+    return `dsh-tui --backend claude --resume ${sessionId}`;
+}
+/** The exact `@anthropic-ai/claude-agent-sdk` version this backend is
+ *  validated against (mirrors the package.json pin). */
+export const VALIDATED_SDK_VERSION = '0.3.287';
+/** CLI versions validated with {@link VALIDATED_SDK_VERSION} (the SDK's own
+ *  `manifest.json` parity version). */
+export const VALIDATED_CLI_VERSIONS = ['2.1.287'];
+/** Init capabilities this backend relies on when present (feature-detected,
+ *  never version-sniffed). */
+export const CLI_CAPABILITY = {
+    /** `command_lifecycle` frames: user rows land on `started`. */
+    lifecycle: 'msg_lifecycle_v1',
+    /** `interrupt()` answers with `still_queued`. */
+    interruptReceipt: 'interrupt_receipt_v1',
+    /** `interrupt` honours `cancel_queued` (drop queued inputs with the turn). */
+    interruptCancelQueued: 'interrupt_cancel_queued_v1',
+};
+/** The CLI version when it is outside the validated set, else undefined. */
+export function cliVersionDrift(version) {
+    if (version === undefined || version === '')
+        return undefined;
+    return VALIDATED_CLI_VERSIONS.includes(version) ? undefined : version;
+}
+/** The SDK version when it differs from the pin, else undefined. */
+export function sdkVersionDrift(version) {
+    if (version === undefined || version === '')
+        return undefined;
+    return version === VALIDATED_SDK_VERSION ? undefined : version;
+}

package/lib/types/backends/claude/controls.d.ts

@@ -0,0 +1,134 @@
+/**
+ * The Claude session's control capabilities: model, effort, permission mode, compaction, the
+ * CLI's own slash commands, MCP status, context usage and the account — each
+ * a thin typed wrapper over the live `Query`'s control requests.
+ *
+ * Every write is confirmed the way the CLI reports it (the next
+ * `message_start.model`, `system/status.permissionMode`, `compact_boundary`):
+ * the wrappers emit the change as soon as the control request succeeds and
+ * the translator's own tracking keeps later frames from repeating it.
+ * The user's model / effort / permission-mode choice persists in `~/.dsh-tui`
+ * under a backend-scoped key (never in Claude's settings files).
+ */
+import type { AccountInfo, Query, SDKControlGetContextUsageResponse } from '@anthropic-ai/claude-agent-sdk';
+import type { AccountView, ChannelProfileView, ContextUsageView, EffortOption, McpServerView, ModelOption, ModelRef, ModelSwitchOutcome, ModeOption } from '../../agent/capabilities.js';
+import type { AgentEvent, CommandInfo } from '../../agent/events.js';
+import { type ClaudeChannelTokens } from '../shared/channel-tokens.js';
+import { type ClaudeChannels } from './channels.js';
+import type { ClaudePrefs } from './prefs.js';
+/** What the controls read from and write to the live session. */
+export interface ClaudeControlsDeps {
+    /** The live query (it changes when the session reconnects). */
+    query(): Pick<Query, 'setModel' | 'setPermissionMode' | 'applyFlagSettings' | 'supportedModels' | 'supportedCommands' | 'mcpServerStatus' | 'reconnectMcpServer' | 'toggleMcpServer' | 'getContextUsage' | 'accountInfo'>;
+    /** Deliver events (model/mode/effort changes). */
+    emit(events: readonly AgentEvent[]): void;
+    /** Push one user input (native `/compact` or `/init` command text). */
+    submitText(text: string): Promise<void>;
+    /** The model the session runs (translator's view). */
+    currentModel(): string;
+    /** The backend-native permission mode (translator's view). */
+    currentMode(): string;
+    /** Record a confirmed model / mode in the translator (dedupes later frames). */
+    noteModel(model: string): readonly AgentEvent[];
+    noteMode(mode: string): readonly AgentEvent[];
+    readonly prefs: ClaudePrefs;
+    /** The channel-profile store (channels.json); the session wires the file
+     *  store by default and tests an in-memory one. */
+    readonly channels: ClaudeChannels;
+    /** The channel-token credential seam (~/.dsh/.credentials.yaml, the
+     *  /provider precedent); the session wires the file store by default.
+     *  Token material moves between this seam and the spawn pipeline only. */
+    readonly tokens?: ClaudeChannelTokens;
+    /** The env the CLI child applies (settings `env` + live env), read lazily
+     *  by the settings import. Absent = nothing to import from. */
+    settingsEnv?(): Record<string, string | undefined>;
+    debug(message: string): void;
+    /** The channel's model truth (settings `env` + live env), read lazily on
+     *  the first model-list call: a relay's cosmetic tier name must not hide
+     *  the model that actually serves the request (see modelEnv.ts). */
+    modelTruth?(): {
+        actualFor(requestedId: string): string | undefined;
+    };
+}
+/** Context usage → the neutral view (no free/buffer pseudo-categories as "used"). */
+export declare function contextUsageView(usage: SDKControlGetContextUsageResponse): ContextUsageView;
+/** Account info → the neutral view (the email is never surfaced). */
+export declare function accountView(info: AccountInfo, apiKeySource: string | undefined): AccountView;
+/** Build the capabilities (catalogs seeded from the handshake by `seed`). */
+export declare function createClaudeControls(deps: ClaudeControlsDeps): {
+    capabilities: {
+        models: {
+            list(): Promise<readonly ModelOption[]>;
+            current: () => ModelRef;
+            display: () => string | undefined;
+            set(ref: ModelRef): Promise<ModelSwitchOutcome>;
+        };
+        effort: {
+            readonly levelsFallback: true | undefined;
+            levels(): readonly EffortOption[];
+            current: () => string | undefined;
+            set(id: string | null): Promise<void>;
+        };
+        modes: {
+            list: () => readonly ModeOption[];
+            cycle: () => readonly ModeOption[];
+            current: () => string;
+            set(id: string): Promise<void>;
+        };
+        channels: {
+            list: () => readonly ChannelProfileView[];
+            activeId: () => string | undefined;
+            setActive: (id: string) => void;
+            importFromSettings: () => ChannelProfileView | undefined;
+            save: (input: {
+                readonly id: string;
+                readonly name: string;
+                readonly baseUrl?: string;
+                readonly token?: string;
+                readonly env?: Readonly<Record<string, string>>;
+                readonly models?: Readonly<Record<string, string>>;
+                readonly tiers?: Readonly<Record<string, string>>;
+            }) => ChannelProfileView;
+            remove: (id: string) => boolean;
+            peekSettingsImport: () => {
+                tiers: Readonly<Record<string, string>>;
+                baseUrl?: string | undefined;
+            } | undefined;
+        };
+        init: {
+            run: () => Promise<void>;
+        };
+        compact: {
+            run: () => Promise<void>;
+        };
+        commands: {
+            list(): Promise<readonly CommandInfo[]>;
+        };
+        mcp: {
+            status(): Promise<readonly McpServerView[]>;
+            reconnect: (name: string) => Promise<void>;
+            toggle: (name: string, enabled: boolean) => Promise<void>;
+        };
+        context: {
+            usage(detail: "summary" | "full"): Promise<ContextUsageView>;
+        };
+    };
+    /** The handshake's catalogs (`initializationResult().models/commands`),
+     *  read without a round trip; malformed entries are skipped. */
+    seed(init: Readonly<Record<string, unknown>> | undefined): void;
+    /** The session confirmed the model by other means than a switch (the
+     *  open/resume seed, `system/init`, `message_start`): check the effort
+     *  as convergeEffort does. A model without a catalog row keeps it. */
+    noteConfirmedModel(model: string): void;
+    /** `system/init.terminal_slash_commands` (terminal-only, never offered). */
+    setTerminalOnly(names: readonly string[]): void;
+};
+/** The localized label of a backend-native permission mode. */
+export declare function modeLabel(id: string): string;
+/** The one-line explanation of a backend-native permission mode (the
+ *  picker's second row: what the mode actually does — never a repeat of the
+ *  label). Unknown ids have none. */
+export declare function modeDescription(id: string): string | undefined;
+/** The localized label of an effort level. */
+export declare function effortLabel(id: string): string;
+//# sourceMappingURL=controls.d.ts.map

package/lib/types/backends/claude/controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../../../src/backends/claude/controls.ts"],"names":[],"mappings":"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"}