dsh-plugin-subagent-director 0.1.0

package/lib/client/index.js.map

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

package/lib/client/locales.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Bilingual dictionaries for the Subagent Director settings namespace.
+ * The key union (SubagentDirectorKey) is the compile-time contract: both
+ * locales must carry every key, so a one-sided edit is a type error before it
+ * ever reaches the runtime's bilingual balance check.
+ */
+/** Keys for the settings.subagentDirector namespace (bilingual, enforced). */
+export type SubagentDirectorKey = 'nav' | 'sectionIntro' | 'defaultsHeading' | 'defaultsHint' | 'defaultProvider' | 'defaultModel' | 'defaultReasoningEffort' | 'restoreDefaults' | 'provider' | 'model' | 'reasoningEffort' | 'persona' | 'rolesHeading' | 'rolesHint' | 'addRole' | 'emptyRoles' | 'roleId' | 'roleDisplayName' | 'roleDescription' | 'rolePersona' | 'setDefaultRole' | 'defaultRoleBadge' | 'deleteRole' | 'confirmDeleteRole' | 'removeRoleDone' | 'addedRole' | 'roleUpdated' | 'conflict' | 'rejected' | 'fatal' | 'loadError' | 'readonly' | 'save' | 'cancel' | 'fallbackOnInvalid' | 'roleIdPlaceholder' | 'displayNamePlaceholder' | 'descriptionPlaceholder' | 'personaPlaceholder' | 'modelOptional' | 'providerMissing' | 'restoreDone' | 'invalidRoleId' | 'bridgeUnavailable' | 'modelRanOn' | 'modelNotRecorded' | 'modelRanOnTitle';
+/** English dictionary ($subagentDirector). */
+export declare const en: Record<SubagentDirectorKey, string>;
+/** Chinese dictionary. */
+export declare const zh: Record<SubagentDirectorKey, string>;
+//# sourceMappingURL=locales.d.ts.map

package/lib/client/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,wBAAwB,GACxB,iBAAiB,GACjB,UAAU,GACV,OAAO,GACP,iBAAiB,GACjB,SAAS,GACT,cAAc,GACd,WAAW,GACX,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,iBAAiB,GACjB,iBAAiB,GACjB,aAAa,GACb,gBAAgB,GAChB,kBAAkB,GAClB,YAAY,GACZ,mBAAmB,GACnB,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,UAAU,GACV,UAAU,GACV,OAAO,GACP,WAAW,GACX,UAAU,GACV,MAAM,GACN,QAAQ,GACR,mBAAmB,GACnB,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,mBAAmB,GACnB,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,CAAC;AAEtB,8CAA8C;AAC9C,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAgDlD,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAgDlD,CAAC"}

package/lib/client/locales.js

@@ -0,0 +1,107 @@
+/**
+ * Bilingual dictionaries for the Subagent Director settings namespace.
+ * The key union (SubagentDirectorKey) is the compile-time contract: both
+ * locales must carry every key, so a one-sided edit is a type error before it
+ * ever reaches the runtime's bilingual balance check.
+ */
+/** English dictionary ($subagentDirector). */
+export const en = {
+    "nav": "Subagent Director",
+    "sectionIntro": "Choose the LLM provider and model each subagent uses, and define role templates that bind a model and persona to a delegation.",
+    "defaultsHeading": "Default model",
+    "defaultsHint": "Used when a call or role does not name a provider/model.",
+    "defaultProvider": "Provider",
+    "defaultModel": "Model",
+    "defaultReasoningEffort": "Reasoning effort",
+    "restoreDefaults": "Restore defaults",
+    "provider": "Provider",
+    "model": "Model",
+    "reasoningEffort": "Reasoning effort",
+    "persona": "Persona",
+    "rolesHeading": "Role templates",
+    "rolesHint": "A role binds delegation guidance, a persona, and optionally a provider/model to a subagent.",
+    "addRole": "Add role",
+    "emptyRoles": "No role templates yet. Add one to start planning subagent responsibilities.",
+    "roleId": "Role id",
+    "roleDisplayName": "Display name",
+    "roleDescription": "Delegation guidance",
+    "rolePersona": "Persona",
+    "setDefaultRole": "Set as default",
+    "defaultRoleBadge": "Default",
+    "deleteRole": "Delete",
+    "confirmDeleteRole": "Delete role “{id}”? Roles referenced by defaultRole will fall back to the plugin default.",
+    "removeRoleDone": "Role removed",
+    "addedRole": "Role added",
+    "roleUpdated": "Role updated",
+    "conflict": "The settings changed on the server. Reloading your edits — please review and retry.",
+    "rejected": "The change was rejected by the settings provider.",
+    "fatal": "Could not save: {message}",
+    "loadError": "Could not load preference settings.",
+    "readonly": "Settings are read-only in this deployment.",
+    "save": "Save",
+    "cancel": "Cancel",
+    "fallbackOnInvalid": "Fall back to the parent agent when a role-bound model is invalid",
+    "roleIdPlaceholder": "e.g. code-reviewer",
+    "displayNamePlaceholder": "e.g. Code Reviewer",
+    "descriptionPlaceholder": "When to delegate to this role and what it should do…",
+    "personaPlaceholder": "Optional behavior/identity text injected into the subagent…",
+    "modelOptional": "Save the card to apply changes",
+    "providerMissing": "No provider selected",
+    "restoreDone": "Defaults restored",
+    "invalidRoleId": "Role id must be kebab-case (lowercase letters, digits, single hyphens).",
+    "bridgeUnavailable": "The Subagent Director settings bridge is not available on this server. Please update/restart the web application so it installs the /subagent-director channel.",
+    "modelRanOn": "Subagent ran on",
+    "modelNotRecorded": "Subagent model not recorded yet",
+    "modelRanOnTitle": "Model route: {model}"
+};
+/** Chinese dictionary. */
+export const zh = {
+    "nav": "子代理导演",
+    "sectionIntro": "为每个子代理选择 LLM 供应商与模型，并以角色模板把模型与 persona 绑定到每次委派。",
+    "defaultsHeading": "默认模型",
+    "defaultsHint": "当某次调用或角色未指定供应商/模型时使用。",
+    "defaultProvider": "供应商",
+    "defaultModel": "模型",
+    "defaultReasoningEffort": "推理强度",
+    "restoreDefaults": "恢复默认",
+    "provider": "供应商",
+    "model": "模型",
+    "reasoningEffort": "推理强度",
+    "persona": "人设",
+    "rolesHeading": "角色模板",
+    "rolesHint": "角色把委派指引、persona 与可选的供应商/模型绑定到子代理。",
+    "addRole": "添加角色",
+    "emptyRoles": "还没有角色模板。添加一个以开始规划子代理职责。",
+    "roleId": "角色 id",
+    "roleDisplayName": "显示名称",
+    "roleDescription": "委派指引",
+    "rolePersona": "人设",
+    "setDefaultRole": "设为默认",
+    "defaultRoleBadge": "默认",
+    "deleteRole": "删除",
+    "confirmDeleteRole": "删除角色“{id}”？若 defaultRole 引用了它，将回退到插件默认值。",
+    "removeRoleDone": "角色已删除",
+    "addedRole": "角色已添加",
+    "roleUpdated": "角色已更新",
+    "conflict": "服务端设置已变更。已重新加载你的编辑——请复核并重试。",
+    "rejected": "更改被设置提供方拒绝。",
+    "fatal": "无法保存：{message}",
+    "loadError": "无法加载偏好设置。",
+    "readonly": "当前部署中设置为只读。",
+    "save": "保存",
+    "cancel": "取消",
+    "fallbackOnInvalid": "当角色绑定的模型无效时回退到父代理",
+    "roleIdPlaceholder": "例如 code-reviewer",
+    "displayNamePlaceholder": "例如 代码审查员",
+    "descriptionPlaceholder": "何时委派给此角色、让其做什么……",
+    "personaPlaceholder": "注入子代理的可选行为/身份文案……",
+    "modelOptional": "保存卡片以应用更改",
+    "providerMissing": "未选择供应商",
+    "restoreDone": "已恢复默认",
+    "invalidRoleId": "角色 id 必须为 kebab-case（小写字母、数字、单个连字符）。",
+    "bridgeUnavailable": "此服务器尚未提供 Subagent Director 设置桥接通道（/subagent-director）。请重启 Web 应用以安装该通道后再试。",
+    "modelRanOn": "子代理实际运行于",
+    "modelNotRecorded": "尚未记录到子代理模型",
+    "modelRanOnTitle": "模型路由：{model}"
+};
+//# sourceMappingURL=locales.js.map

package/lib/client/locales.js.map

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

package/lib/client/store-logic.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Pure settings-write logic for the Subagent Director client (no React, no wire
+ * calls). Everything here is a function of its inputs so the revision state
+ * machine, path-op construction, and conflict handling are unit-testable in a
+ * plain node environment without a running host.
+ *
+ * The persisted section shape mirrors the Host schema (see src/settings.ts):
+ *   {
+ *     defaultProvider?, defaultModel?, defaultReasoningEffort?,
+ *     defaultRole?, fallbackOnInvalid?,
+ *     roles?: { [id]: { displayName, description, persona?, provider?,
+ *                       model?, reasoningEffort?, toolFilter? } }
+ *   }
+ */
+import type { SettingsPathOpView } from '@deepseek-ai/dsh-host-apiproxy/api';
+/** One role as the user edits it in a card (empty string = "clear the field"). */
+export interface RoleDraft {
+    displayName: string;
+    description: string;
+    persona?: string;
+    provider?: string;
+    model?: string;
+    reasoningEffort?: string;
+}
+/** A persisted role template. */
+export interface StoredRole {
+    displayName: string;
+    description: string;
+    persona?: string;
+    provider?: string;
+    model?: string;
+    reasoningEffort?: string;
+}
+/** The persisted user-layer section (fields optional). */
+export interface StoredSection {
+    defaultProvider?: string;
+    defaultModel?: string;
+    defaultReasoningEffort?: string;
+    defaultRole?: string;
+    fallbackOnInvalid?: boolean;
+    roles?: Record<string, StoredRole>;
+}
+/** Path of the roles map from the section root. */
+export declare const ROLES_PATH: readonly ['roles'];
+/** Normalize an optional string: blank/whitespace becomes undefined (removed). */
+export declare function optional(value: string | undefined): string | undefined;
+/** Blank/whitespace-only check used to decide "clear to undefined". */
+export declare function isBlank(value: string | undefined | null): boolean;
+/** Kebab-case role ids (mirrors the Host validator in src/settings.ts). */
+export declare const KEBAB_CASE: RegExp;
+/** Generate a kebab-case id from a display name; falls back to a prefix + counter. */
+export declare function roleIdFromName(name: string, existing: ReadonlySet<string>, prefix?: string): string;
+/**
+ * Build the path ops that create or fully replace one role. A single set at the
+ * role's root writes every field at once (mutate resolves against the stored
+ * section, so intermediate objects materialize).
+ */
+export declare function addRoleOps(id: string, role: RoleDraft | StoredRole): SettingsPathOpView[];
+/**
+ * Diff one role between its stored value and the edited draft. Only changed
+ * fields become ops; clearing a field becomes an unset that restores the
+ * composition base / removes the user override.
+ */
+export declare function updateRoleOps(id: string, before: StoredRole | undefined, draft: RoleDraft): SettingsPathOpView[];
+/**
+ * Ops to remove one role. When it was the defaultRole, the reference is cleared
+ * too so a stale default never points at a removed role.
+ */
+export declare function removeRoleOps(id: string, current: Pick<StoredSection, 'defaultRole'>): SettingsPathOpView[];
+/** Ops to promote one role to the default. */
+export declare function setDefaultRoleOps(id: string): SettingsPathOpView[];
+/** Ops for the default-model row: each cleared field is unset, changed fields set. */
+export interface DefaultModelEdits {
+    provider?: string;
+    model?: string;
+    reasoningEffort?: string;
+}
+export declare function defaultModelOps(before: StoredSection, edits: DefaultModelEdits): SettingsPathOpView[];
+/** Ops to clear every default-model field and the defaultRole back to composition defaults. */
+export declare function restoreDefaultsOps(current: StoredSection): SettingsPathOpView[];
+/** Whether a section's defaultRole references a role that currently exists. */
+export declare function defaultRoleValid(section: StoredSection): boolean;
+/** Classification of a settings.mutate failure for the UI's conflict handling. */
+export type MutationErrorKind = 'conflict' | 'rejected' | 'fatal';
+/** Map an RPC error code to a UI outcome; unknown/undefined errors are fatal. */
+export declare function classifyMutateError(code: string | undefined, _message?: string): MutationErrorKind;
+/**
+ * The revision state machine: after a successful mutate the server returns the
+ * next revision; after a conflict the editor must re-read (drop pending edits)
+ * and start from the freshly described revision. Collapses cleanly to a pure
+ * function for testing.
+ */
+export interface RevisionState {
+    /** Revision the next write must carry as expectedRevision. */
+    revision: number;
+    /** True once a conflict was observed, so the store knows to reload. */
+    conflicted: boolean;
+}
+/** Advance after a successful write. */
+export declare function advanceRevision(state: RevisionState, serverRevision: number): RevisionState;
+/** Mark a conflict: keep the stale revision (the editor must reload). */
+export declare function markConflict(state: RevisionState): RevisionState;
+/** Rebase after a reload picked up the fresh namespace. */
+export declare function adoptRevision(_state: RevisionState, freshRevision: number): RevisionState;
+//# sourceMappingURL=store-logic.d.ts.map

package/lib/client/store-logic.d.ts.map

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

package/lib/client/store-logic.js

@@ -0,0 +1,143 @@
+/** Path of the roles map from the section root. */
+export const ROLES_PATH = ['roles'];
+/** Normalize an optional string: blank/whitespace becomes undefined (removed). */
+export function optional(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? undefined : trimmed;
+}
+/** Blank/whitespace-only check used to decide "clear to undefined". */
+export function isBlank(value) {
+    return value === undefined || value === null || value.trim().length === 0;
+}
+/** Kebab-case role ids (mirrors the Host validator in src/settings.ts). */
+export const KEBAB_CASE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Generate a kebab-case id from a display name; falls back to a prefix + counter. */
+export function roleIdFromName(name, existing, prefix = 'role') {
+    const base = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const candidate = base.length > 0 ? base : prefix;
+    if (!existing.has(candidate))
+        return candidate;
+    for (let i = 2; i < 1000; i++) {
+        if (!existing.has(candidate + '-' + i))
+            return candidate + '-' + i;
+    }
+    return candidate + '-' + Date.now().toString(36);
+}
+/**
+ * Build the path ops that create or fully replace one role. A single set at the
+ * role's root writes every field at once (mutate resolves against the stored
+ * section, so intermediate objects materialize).
+ */
+export function addRoleOps(id, role) {
+    return [
+        {
+            op: 'set',
+            path: [ROLES_PATH[0], id],
+            value: {
+                displayName: role.displayName,
+                description: role.description,
+                ...optional(role.persona) !== undefined ? { persona: optional(role.persona) } : {},
+                ...optional(role.provider) !== undefined ? { provider: optional(role.provider) } : {},
+                ...optional(role.model) !== undefined ? { model: optional(role.model) } : {},
+                ...optional(role.reasoningEffort) !== undefined ? { reasoningEffort: optional(role.reasoningEffort) } : {}
+            }
+        }
+    ];
+}
+/** Field-by-field set-edits when a value changed from the stored role; unset when cleared. */
+function fieldEdit(path, stored, next) {
+    const store = typeof stored === 'string' ? stored : undefined;
+    const normalized = optional(next);
+    if (normalized === store)
+        return undefined;
+    if (normalized === undefined)
+        return { op: 'unset', path: [...path] };
+    return { op: 'set', path: [...path], value: normalized };
+}
+/**
+ * Diff one role between its stored value and the edited draft. Only changed
+ * fields become ops; clearing a field becomes an unset that restores the
+ * composition base / removes the user override.
+ */
+export function updateRoleOps(id, before, draft) {
+    const b = before ?? {};
+    const ops = [];
+    const push = (op) => { if (op)
+        ops.push(op); };
+    const base = [ROLES_PATH[0], id];
+    push(fieldEdit([...base, 'displayName'], b.displayName, draft.displayName));
+    push(fieldEdit([...base, 'description'], b.description, draft.description));
+    push(fieldEdit([...base, 'persona'], b.persona, draft.persona));
+    push(fieldEdit([...base, 'provider'], b.provider, draft.provider));
+    push(fieldEdit([...base, 'model'], b.model, draft.model));
+    push(fieldEdit([...base, 'reasoningEffort'], b.reasoningEffort, draft.reasoningEffort));
+    return ops;
+}
+/**
+ * Ops to remove one role. When it was the defaultRole, the reference is cleared
+ * too so a stale default never points at a removed role.
+ */
+export function removeRoleOps(id, current) {
+    const ops = [{ op: 'unset', path: [ROLES_PATH[0], id] }];
+    if (current.defaultRole === id)
+        ops.push({ op: 'unset', path: ['defaultRole'] });
+    return ops;
+}
+/** Ops to promote one role to the default. */
+export function setDefaultRoleOps(id) {
+    return [{ op: 'set', path: ['defaultRole'], value: id }];
+}
+export function defaultModelOps(before, edits) {
+    const ops = [];
+    const push = (op) => { if (op)
+        ops.push(op); };
+    push(fieldEdit(['defaultProvider'], before.defaultProvider, edits.provider));
+    push(fieldEdit(['defaultModel'], before.defaultModel, edits.model));
+    push(fieldEdit(['defaultReasoningEffort'], before.defaultReasoningEffort, edits.reasoningEffort));
+    return ops;
+}
+/** Ops to clear every default-model field and the defaultRole back to composition defaults. */
+export function restoreDefaultsOps(current) {
+    const ops = [];
+    if (current.defaultProvider !== undefined)
+        ops.push({ op: 'unset', path: ['defaultProvider'] });
+    if (current.defaultModel !== undefined)
+        ops.push({ op: 'unset', path: ['defaultModel'] });
+    if (current.defaultReasoningEffort !== undefined)
+        ops.push({ op: 'unset', path: ['defaultReasoningEffort'] });
+    if (current.defaultRole !== undefined)
+        ops.push({ op: 'unset', path: ['defaultRole'] });
+    return ops;
+}
+/** Whether a section's defaultRole references a role that currently exists. */
+export function defaultRoleValid(section) {
+    const role = section.defaultRole;
+    return role === undefined || (section.roles?.[role] !== undefined);
+}
+/** Map an RPC error code to a UI outcome; unknown/undefined errors are fatal. */
+export function classifyMutateError(code, _message) {
+    if (code === 'settings-conflict')
+        return 'conflict';
+    if (code === 'settings-rejected' || code === 'schema-validation')
+        return 'rejected';
+    return 'fatal';
+}
+/** Advance after a successful write. */
+export function advanceRevision(state, serverRevision) {
+    return { revision: serverRevision, conflicted: false };
+}
+/** Mark a conflict: keep the stale revision (the editor must reload). */
+export function markConflict(state) {
+    return { revision: state.revision, conflicted: true };
+}
+/** Rebase after a reload picked up the fresh namespace. */
+export function adoptRevision(_state, freshRevision) {
+    return { revision: freshRevision, conflicted: false };
+}
+//# sourceMappingURL=store-logic.js.map

package/lib/client/store-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-logic.js","sourceRoot":"","sources":["../../src/client/store-logic.ts"],"names":[],"mappings":"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"}

package/lib/client/store.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Subagent Director settings page store: one snapshot joining the configurable
+ * provider directory (llm.providers), the model catalog (llm.models), and the
+ * plugin's own settings namespace. The settings namespace is read/written
+ * through the plugin's self-published `/subagent-director` RPC channel (see
+ * ../remote.ts) because the Host apiproxy's exposedNamespaces() allowlist
+ * answers `settings-not-exposed` for namespaces outside the model-provider
+ * plane; llm.providers/llm.models still ride `connection.api.llm`. The host
+ * stays the single fact source: every write travels as path ops through the
+ * bridge's settingsMutate endpoint with an expectedRevision optimistic lock,
+ * and pushed invalidations (settings/document-updated, llm/adapters-updated,
+ * connection/reset) refresh the page.
+ */
+import type { ClientConnectionRpc, ConfigurableProviderView, IApiClient, ModelProviderGroup, SettingsNamespaceView } from '@deepseek-ai/dsh-client-connection/client';
+import type { SubagentDirectorKey } from './locales.js';
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import { type DefaultModelEdits, type MutationErrorKind, type RoleDraft, type StoredRole, type StoredSection } from './store-logic.js';
+/** The settings namespace this page reads and writes. */
+export declare const SUBAGENT_DIRECTOR_NS = "subagent-director";
+/** Page snapshot rendered by the section component. */
+export interface SubagentOptionsState {
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    /** Whole-load failure text; write failures stay in the calling card. */
+    error: string | null;
+    /** Whether the settings provider accepts writes. */
+    writable: boolean;
+    /** Namespace view (redacted). */
+    namespace: SettingsNamespaceView | undefined;
+    /** The plugin's own user-layer section, cast to its known shape. */
+    section: StoredSection | undefined;
+    /** Current expectedRevision for the next mutate. */
+    revision: number;
+    /** Configurable provider directory. */
+    providers: readonly ConfigurableProviderView[];
+    /** Model catalog groups (provider → models → reasoning efforts). */
+    models: readonly ModelProviderGroup[];
+    /** The plugin name surfaced to the section. */
+    loading: boolean;
+}
+/** Initial empty snapshot. */
+export declare function initialSubagentOptionsState(): SubagentOptionsState;
+/** Human text for a rejected wire call. */
+export declare function messageOf(error: unknown): string;
+/**
+ * Raised when the /subagent-director bridge channel is not reachable on the
+ * current transport (a Host that predates the bridge answers nothing). The
+ * store surfaces this as the localized `bridgeUnavailable` copy instead of a
+ * raw transport string.
+ */
+export declare class BridgeUnavailableError extends Error {
+    constructor();
+}
+/** Whether a thrown value means the bridge channel could not be called at all. */
+export declare function isBridgeUnavailable(error: unknown): boolean;
+/** Wire faces the settings page needs: the bridge RPC caller, the llm face, and copy. */
+export interface StoreWire {
+    /** Generic RPC caller for the self-published /subagent-director channel. */
+    rpc: ClientConnectionRpc;
+    /** llm catalog/adapters face (still connection.api.llm). */
+    llm: IApiClient['llm'];
+    /** Section copy binder (for the localized bridge-unavailable message). */
+    t: (key: SubagentDirectorKey) => string;
+}
+/** The settings page controller (one per settings surface). */
+export declare class SubagentOptionsStore {
+    readonly store: SnapshotStore<SubagentOptionsState>;
+    private readonly wire;
+    private generation;
+    constructor(wire: StoreWire);
+    /**
+     * Call one bridge endpoint over the generic RPC channel. Returns the RpcResult
+     * (ok or error branch). A transport-level rejection — the Host has no
+     * /subagent-director channel — is folded into BridgeUnavailableError so the
+     * caller can show the localized message.
+     */
+    private callBridge;
+    /** Refresh the whole page snapshot: provider directory + model catalog + own namespace. */
+    load(): Promise<void>;
+    /** Human text for a bridge RPC error branch. */
+    private errorMessage;
+    /**
+     * Run one mutate and update the snapshot's revision. Returns a failure
+     * message (localized by the caller) or undefined on success. A
+     * settings-conflict re-reads the namespace and returns the conflict kind so
+     * the UI can show the "please review and retry" message.
+     */
+    private mutate;
+    private reloadNamespace;
+    /** Error code of a bridge RPC error branch, when present. */
+    private errorCode;
+    addRole(id: string, draft: RoleDraft): Promise<string | undefined>;
+    updateRole(id: string, before: StoredRole | undefined, draft: RoleDraft): Promise<string | undefined>;
+    removeRole(id: string): Promise<string | undefined>;
+    setDefaultRole(id: string): Promise<string | undefined>;
+    setDefaultModel(edits: DefaultModelEdits): Promise<string | undefined>;
+    restoreDefaults(): Promise<string | undefined>;
+}
+/** Outcome of one write so the UI can pick the right message. */
+export interface MutationOutcome {
+    ok: boolean;
+    kind: MutationErrorKind;
+    message: string | undefined;
+}
+//# sourceMappingURL=store.d.ts.map

package/lib/client/store.d.ts.map

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