@openvulcan/dsh-vulcancode 0.0.0-stage → 0.4.3

package/node_modules/@openvulcan/dsh-vulcan-reasoning/lib/client.js

@@ -0,0 +1,509 @@
+window.__ModuleLoader__.load({
+	id: "@openvulcan/dsh-vulcan-reasoning",
+	factory: (platformRequire) => {
+		var definitions = {
+		"./dsh-client": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+
+		},
+		"./i18n": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.en = exports.zh = exports.NAMESPACE = void 0;
+			// Labels for the per-model editor in dsh's interface language.
+			// 随 dsh 界面语言切换的每模型编辑器文案。
+			exports.NAMESPACE = 'vulcan-reasoning';
+			// Chinese copy for the provider card and all form states.
+			// 提供商卡片及各表单状态的中文文案。
+			exports.zh = {
+			    title: '自定义思考级别',
+			    lead: '为当前模型设置对话中可选的思考级别，以及提供商实际接收的值。传输值以模型接口支持的参数为准。',
+			    loading: '正在读取模型配置…',
+			    loadFailed: '读取模型配置失败',
+			    saveFailed: '保存失败',
+			    conflict: '模型配置已被其他操作修改。请重新读取后再保存。',
+			    readonly: '当前设置为只读。',
+			    empty: '此提供商没有可编辑的模型。',
+			    reload: '重新读取',
+			    model: '模型',
+			    mode: '思考配置',
+			    inherit: '跟随模型目录',
+			    disabled: '关闭思考',
+			    custom: '自定义级别',
+			    wire: '接口传输值',
+			    offHint: '关闭级别可留空',
+			    levelRequired: '请至少启用一个思考级别。',
+			    wireRequired: '每个已启用的思考级别都需要填写接口传输值。',
+			    providerDefault: '必须保留提供商的默认级别',
+			    save: '保存思考配置',
+			    saving: '保存中…',
+			    saved: '思考配置已保存。',
+			    reselect: '已有会话若选中了已移除的级别，请在输入框的模型选择器中重新选择。',
+			};
+			// English copy mirrors the Chinese dictionary.
+			// 英文文案与中文词典保持同样的键。
+			exports.en = {
+			    title: 'Custom thinking levels',
+			    lead: 'Choose the thinking levels offered in conversations and the value sent for each level. Use wire values supported by the model endpoint.',
+			    loading: 'Reading model settings…',
+			    loadFailed: 'Could not read model settings',
+			    saveFailed: 'Could not save',
+			    conflict: 'The model settings changed. Reload them before saving again.',
+			    readonly: 'The current settings are read-only.',
+			    empty: 'This provider has no editable models.',
+			    reload: 'Reload',
+			    model: 'Model',
+			    mode: 'Thinking configuration',
+			    inherit: 'Follow the model catalog',
+			    disabled: 'Disable thinking',
+			    custom: 'Custom levels',
+			    wire: 'Wire value',
+			    offHint: 'Leave blank for off',
+			    levelRequired: 'Enable at least one thinking level.',
+			    wireRequired: 'Enter a wire value for every enabled thinking level.',
+			    providerDefault: 'Keep the provider’s default thinking level',
+			    save: 'Save thinking configuration',
+			    saving: 'Saving…',
+			    saved: 'Thinking configuration saved.',
+			    reselect: 'If an existing conversation uses a removed level, select the model and level again in the composer.',
+			};
+
+		},
+		"./index": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.inject = void 0;
+			exports.apply = apply;
+			const jsx_runtime_1 = require("react/jsx-runtime");
+			const i18n_1 = require("./i18n");
+			const page_1 = require("./page");
+			const shared_1 = require("./shared");
+			const style_1 = require("./style");
+			// Services supplied by dsh before this browser contribution runs.
+			// 此浏览器扩展运行前由 dsh 提供的服务。
+			exports.inject = ['slots', 'locale', 'remote', 'remote.settings', 'remote.session'];
+			/**
+			 * Register the localized editor in the existing pi-ai provider-card slot.
+			 * 在现有 pi-ai 提供商卡片插槽注册本地化编辑器。
+			 */
+			function apply(ctx) {
+			    ctx.effect(() => (0, style_1.installStyle)(), 'vulcan-reasoning: stylesheet');
+			    ctx.effect(() => ctx.locale.register(i18n_1.NAMESPACE, { en: i18n_1.en, zh: i18n_1.zh }), 'vulcan-reasoning: dictionaries');
+			    ctx.slots.inject('settings.models.provider-card', () => ctx.slots.register({
+			        name: 'settings.models.provider-card',
+			        key: shared_1.PI_AI_NAMESPACE,
+			        locale: i18n_1.NAMESPACE,
+			    }, props => (0, jsx_runtime_1.jsx)(page_1.ProviderReasoning, { ...props, remote: ctx.remote, t: props.t })));
+			}
+
+		},
+		"./page": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.ProviderReasoning = ProviderReasoning;
+			const jsx_runtime_1 = require("react/jsx-runtime");
+			const react_1 = require("react");
+			const shared_1 = require("./shared");
+			/**
+			 * Read a provider's redacted native settings and, for inherited models, its live catalog.
+			 * 读取提供商的原生脱敏设置，并在模型继承时读取其当前模型目录。
+			 */
+			async function readSnapshot(remote, provider) {
+			    // The describe response is the authority for write permission and optimistic concurrency.
+			    // describe 响应提供写权限和乐观并发控制所需的权威信息。
+			    const described = await remote.settings.describe();
+			    if (!described.ok)
+			        throw new Error(described.error.message);
+			    // Read only the namespace that declared this provider card.
+			    // 仅从声明该提供商卡片的命名空间读取配置。
+			    const namespace = described.value.namespaces.find(entry => entry.ns === shared_1.PI_AI_NAMESPACE);
+			    if (namespace === undefined)
+			        throw new Error('The pi-ai settings namespace is unavailable');
+			    // The card represents an existing provider profile, whose exact ID is supplied by the host.
+			    // 此卡片代表已存在的提供商配置，其准确标识由宿主提供。
+			    const profile = (0, shared_1.profileOf)(namespace.value, provider);
+			    if (profile === undefined)
+			        throw new Error('The pi-ai provider is no longer configured');
+			    // An explicit model list already supplies the IDs and needs no extra catalog request.
+			    // 显式模型列表已提供模型标识，无需额外读取目录。
+			    let catalog = [];
+			    if (profile.models === undefined || profile.models.length === 0) {
+			        // Inherited model IDs come from the native selector's provider group.
+			        // 继承的模型标识来自原生选择器的提供商分组。
+			        const response = await remote.session.modelCatalog();
+			        if (!response.ok)
+			            throw new Error(response.error.message);
+			        // Preserve a native catalog failure instead of presenting it as an empty provider.
+			        // 保留原生目录错误，避免将其显示为空提供商。
+			        const failure = response.value.failures.find(entry => entry.id === provider);
+			        if (failure !== undefined)
+			            throw new Error(failure.message);
+			        catalog = response.value.groups.find(group => group.id === provider)?.models ?? [];
+			    }
+			    return { revision: namespace.revision, writable: described.value.writable, profile, catalog };
+			}
+			/**
+			 * Render a collapsible editor for a configured pi-ai provider and use dsh's permission hooks.
+			 * 为已配置的 pi-ai 提供商渲染可折叠编辑器，并使用 dsh 的权限 Hook。
+			 */
+			function ProviderReasoning({ provider, configured, useRemoteAccess, remote, t }) {
+			    // Read access controls visibility; mutation access controls only the save form.
+			    // 读取权限控制可见性，写入权限只控制保存表单。
+			    const readable = useRemoteAccess('settings/describe');
+			    // Save controls follow the current client's settings mutation access.
+			    // 保存控件遵循当前客户端的设置写入权限。
+			    const writable = useRemoteAccess('settings/mutate');
+			    // Defer network reads until the card is opened, and keep drafts mounted on collapse.
+			    // 等待卡片展开后才发起读取，折叠时保持草稿挂载。
+			    const [opened, setOpened] = (0, react_1.useState)(false);
+			    if (!configured || !readable)
+			        return null;
+			    return ((0, jsx_runtime_1.jsxs)("details", { className: "vrs", onToggle: event => { if (event.currentTarget.open)
+			            setOpened(true); }, children: [(0, jsx_runtime_1.jsx)("summary", { children: t('title') }), opened ? (0, jsx_runtime_1.jsx)(ReasoningEditor, { provider: provider.provider, remote: remote, writable: writable, t: t }, provider.provider) : null] }));
+			}
+			/**
+			 * Render model selection, editable level mappings and saving for one provider route.
+			 * 渲染单一提供商路由的模型选择、级别映射编辑与保存操作。
+			 */
+			function ReasoningEditor({ provider, remote, writable, t }) {
+			    // Resource and reload generation track one revision-bearing provider snapshot.
+			    // 资源与重读代数共同跟踪带修订版本的提供商快照。
+			    const [resource, setResource] = (0, react_1.useState)({ kind: 'loading' });
+			    // Increment this generation to start a fresh native settings read.
+			    // 递增此代数以发起一次新的原生设置读取。
+			    const [generation, setGeneration] = (0, react_1.useState)(0);
+			    // Use the last model the user selected while it remains in the loaded list.
+			    // 只要最近选中的模型仍在加载后的列表中，就沿用该选择。
+			    const [selected, setSelected] = (0, react_1.useState)();
+			    // Keep unsaved work by model ID when switching models or reloading after a conflict.
+			    // 切换模型或在冲突后重读时，按模型标识保留未保存的内容。
+			    const [drafts, setDrafts] = (0, react_1.useState)(() => new Map());
+			    // A save updates the current revision and publishes success or a specific failure.
+			    // 保存会更新当前修订版本，并报告成功或具体失败。
+			    const [saving, setSaving] = (0, react_1.useState)(false);
+			    // Retain the failure text beside the draft that could not be saved.
+			    // 在未保存成功的草稿旁保留失败信息。
+			    const [error, setError] = (0, react_1.useState)();
+			    // Publish confirmation only after the host accepts the mutation.
+			    // 仅在宿主接受写入后显示保存确认。
+			    const [saved, setSaved] = (0, react_1.useState)(false);
+			    (0, react_1.useEffect)(() => {
+			        // Ignore reads from an obsolete load or an unmounted provider card.
+			        // 忽略已经失效的读取以及已卸载提供商卡片的返回结果。
+			        let active = true;
+			        readSnapshot(remote, provider).then(snapshot => {
+			            if (active)
+			                setResource({ kind: 'ready', snapshot });
+			        }, (failure) => {
+			            if (active)
+			                setResource({ kind: 'failed', message: messageOf(failure) });
+			        });
+			        return () => { active = false; };
+			    }, [remote, provider, generation]);
+			    /** Request a fresh snapshot without losing the form drafts. */
+			    /** 请求最新快照并保留表单草稿。 */
+			    const reload = () => {
+			        setSaved(false);
+			        setError(undefined);
+			        setResource({ kind: 'loading' });
+			        setGeneration(value => value + 1);
+			    };
+			    if (resource.kind === 'loading')
+			        return (0, jsx_runtime_1.jsx)("p", { className: "vrs-form vrs-hint", role: "status", children: t('loading') });
+			    if (resource.kind === 'failed') {
+			        return ((0, jsx_runtime_1.jsxs)("div", { className: "vrs-form", children: [(0, jsx_runtime_1.jsxs)("p", { className: "vrs-error", role: "alert", children: [t('loadFailed'), ": ", resource.message] }), (0, jsx_runtime_1.jsx)("div", { className: "vrs-actions", children: (0, jsx_runtime_1.jsx)("button", { type: "button", onClick: reload, children: t('reload') }) })] }));
+			    }
+			    // Use the last accepted snapshot and initially select its first listed model.
+			    // 使用最近接受的快照，并默认选中目录中的首个模型。
+			    const { snapshot } = resource;
+			    // Derive the choices from the adapter's configured or inherited catalog.
+			    // 从适配器的显式或继承目录生成模型选项。
+			    const models = (0, shared_1.modelOptions)(snapshot.profile, snapshot.catalog);
+			    // Use the first listed model when no valid selection has been made.
+			    // 尚未选择有效模型时使用列表中的第一项。
+			    const model = models.find(entry => entry.id === selected) ?? models[0];
+			    if (model === undefined)
+			        return (0, jsx_runtime_1.jsx)("p", { className: "vrs-form vrs-hint", children: t('empty') });
+			    // Read-only clients can still switch models and inspect their saved mappings.
+			    // 只读客户端仍可切换模型并查看已保存的级别映射。
+			    const canWrite = writable && snapshot.writable;
+			    // A pending value exists only after the user edited this model.
+			    // 只有用户编辑过此模型才存在待保存值。
+			    const pending = drafts.get(model.id);
+			    // Before editing, show exactly the effective native settings for the model.
+			    // 编辑前显示该模型当前生效的原生配置。
+			    const draft = pending ?? (0, shared_1.draftOf)(model.efforts);
+			    // The encoder reports an error before invalid values can reach the host.
+			    // 编码器会在无效值到达宿主之前报告错误。
+			    const encoded = (0, shared_1.encodeDraft)(draft, snapshot.profile.reasoning);
+			    /** Store the replacement draft for the displayed model. */
+			    /** 保存当前显示模型的替换草稿。 */
+			    const change = (next) => {
+			        setSaved(false);
+			        setError(undefined);
+			        setDrafts(current => new Map(current).set(model.id, next));
+			    };
+			    /** Enable or disable the named level, leaving its wire value for the user to enter. */
+			    /** 启用或停用指定级别，并由用户填写其传输值。 */
+			    const toggle = (level, enabled) => {
+			        // Detach the edited dictionary so no other model's draft is mutated.
+			        // 复制待编辑的字典，避免修改其他模型的草稿。
+			        const values = { ...draft.values };
+			        if (enabled)
+			            values[level] = '';
+			        else
+			            delete values[level];
+			        change({ ...draft, values });
+			    };
+			    /** Apply this model's draft at the loaded revision and adopt the committed settings. */
+			    /** 在已加载的修订版本上应用此模型的草稿，并采用提交后的配置。 */
+			    const save = async (event) => {
+			        event.preventDefault();
+			        if (!canWrite || saving || pending === undefined || !encoded.ok)
+			            return;
+			        setSaving(true);
+			        setError(undefined);
+			        setSaved(false);
+			        try {
+			            // Use the host's revision check so a concurrently edited model list is never overwritten.
+			            // 使用宿主的修订检查，防止覆盖并发修改过的模型列表。
+			            const result = await remote.settings.mutate(shared_1.PI_AI_NAMESPACE, [
+			                (0, shared_1.reasoningOp)(snapshot.profile, provider, model.id, encoded.value),
+			            ], snapshot.revision);
+			            if (!result.ok) {
+			                setError(result.error.code === 'settings/conflict' ? t('conflict') : result.error.message);
+			                return;
+			            }
+			            // The mutation returns the committed profile, including the revision for the next save.
+			            // 写入返回提交后的配置及下一次保存需要的修订版本。
+			            const profile = (0, shared_1.profileOf)(result.value.value, provider);
+			            if (profile === undefined) {
+			                setResource({ kind: 'failed', message: 'The committed settings no longer contain this provider' });
+			                return;
+			            }
+			            setResource({ kind: 'ready', snapshot: { ...snapshot, profile, revision: result.value.revision } });
+			            setDrafts(current => {
+			                // Clear just the model that committed; other unsaved models remain editable.
+			                // 仅清除已提交模型的草稿，其他未保存模型仍可编辑。
+			                const remaining = new Map(current);
+			                remaining.delete(model.id);
+			                return remaining;
+			            });
+			            setSaved(true);
+			        }
+			        catch (failure) {
+			            setError(messageOf(failure));
+			        }
+			        finally {
+			            setSaving(false);
+			        }
+			    };
+			    return ((0, jsx_runtime_1.jsxs)("form", { className: "vrs-form", onSubmit: event => { void save(event); }, children: [(0, jsx_runtime_1.jsx)("p", { className: "vrs-hint", children: t('lead') }), (0, jsx_runtime_1.jsxs)("label", { className: "vrs-control", children: [t('model'), (0, jsx_runtime_1.jsx)("select", { value: model.id, disabled: saving, onChange: event => { setSelected(event.currentTarget.value); setSaved(false); setError(undefined); }, children: models.map(entry => (0, jsx_runtime_1.jsx)("option", { value: entry.id, children: entry.name === entry.id ? entry.id : `${entry.name} · ${entry.id}` }, entry.id)) })] }), (0, jsx_runtime_1.jsxs)("fieldset", { className: "vrs-fields", disabled: !canWrite || saving, children: [(0, jsx_runtime_1.jsxs)("label", { className: "vrs-control", children: [t('mode'), (0, jsx_runtime_1.jsxs)("select", { value: draft.mode, onChange: event => { change({ ...draft, mode: event.currentTarget.value }); }, children: [(0, jsx_runtime_1.jsx)("option", { value: "inherit", children: t('inherit') }), (0, jsx_runtime_1.jsx)("option", { value: "disabled", children: t('disabled') }), (0, jsx_runtime_1.jsx)("option", { value: "custom", children: t('custom') })] })] }), draft.mode === 'custom' ? ((0, jsx_runtime_1.jsx)("div", { className: "vrs-levels", children: shared_1.LEVELS.map(level => ((0, jsx_runtime_1.jsxs)("div", { className: "vrs-level", children: [(0, jsx_runtime_1.jsxs)("label", { children: [(0, jsx_runtime_1.jsx)("input", { type: "checkbox", checked: draft.values[level] !== undefined, onChange: event => { toggle(level, event.currentTarget.checked); } }), level] }), (0, jsx_runtime_1.jsx)("input", { type: "text", "aria-label": `${t('wire')} · ${level}`, disabled: draft.values[level] === undefined, placeholder: level === 'off' ? t('offHint') : t('wire'), value: draft.values[level] ?? '', onChange: event => { change({ ...draft, values: { ...draft.values, [level]: event.currentTarget.value } }); } })] }, level))) })) : null, (0, jsx_runtime_1.jsx)("div", { className: "vrs-actions", children: (0, jsx_runtime_1.jsx)("button", { type: "submit", disabled: pending === undefined || !encoded.ok, children: t(saving ? 'saving' : 'save') }) })] }), !canWrite ? (0, jsx_runtime_1.jsx)("p", { className: "vrs-hint", children: t('readonly') }) : null, encoded.ok ? null : ((0, jsx_runtime_1.jsxs)("p", { className: "vrs-hint", children: [t(encoded.issue), encoded.issue === 'providerDefault' ? `: ${snapshot.profile.reasoning}` : ''] })), error === undefined ? null : (0, jsx_runtime_1.jsxs)("p", { className: "vrs-error", role: "alert", children: [t('saveFailed'), ": ", error] }), saved ? (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("p", { role: "status", children: t('saved') }), (0, jsx_runtime_1.jsx)("p", { className: "vrs-hint", children: t('reselect') })] }) : null, error === undefined ? null : (0, jsx_runtime_1.jsx)("div", { className: "vrs-actions", children: (0, jsx_runtime_1.jsx)("button", { type: "button", disabled: saving, onClick: reload, children: t('reload') }) })] }));
+			}
+			/**
+			 * Render a caught remote or local failure as a user-visible message.
+			 * 将捕获的远程或本地错误转为用户可见的消息。
+			 */
+			function messageOf(failure) {
+			    return failure instanceof Error ? failure.message : String(failure);
+			}
+
+		},
+		"./shared": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.LEVELS = exports.PI_AI_NAMESPACE = exports.PACKAGE_NAME = void 0;
+			exports.profileOf = profileOf;
+			exports.modelOptions = modelOptions;
+			exports.draftOf = draftOf;
+			exports.encodeDraft = encodeDraft;
+			exports.reasoningOp = reasoningOp;
+			// The client bundle ID matches the suite dependency's package name.
+			// 客户端包标识与套件依赖的包名一致。
+			exports.PACKAGE_NAME = '@openvulcan/dsh-vulcan-reasoning';
+			// The settings namespace and provider-card key registered by dsh's pi-ai adapter.
+			// dsh 的 pi-ai 适配器注册的设置命名空间及提供商卡片键。
+			exports.PI_AI_NAMESPACE = 'llm-pi-ai';
+			// The level keys accepted by both supported dsh pi-ai schemas, in escalation order.
+			// 两个受支持的 dsh pi-ai 模式接受的级别键，按思考强度递增排列。
+			exports.LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
+			/**
+			 * Read a provider profile by its exact route ID from the pi-ai namespace's effective value.
+			 * 从 pi-ai 命名空间的生效配置中按准确路由标识读取提供商配置。
+			 */
+			function profileOf(value, provider) {
+			    if (typeof value !== 'object' || value === null)
+			        return undefined;
+			    // Only this registered namespace has the providers dictionary described by the adapter.
+			    // 只有此已注册的命名空间具有适配器定义的 providers 字典。
+			    const config = value;
+			    // Catalog IDs are dictionary keys and must resolve to a stored own entry.
+			    // 目录标识是字典键，只能解析为配置中自身拥有的条目。
+			    const profiles = config.providers;
+			    return typeof profiles === 'object' && profiles !== null && Object.hasOwn(profiles, provider) ? profiles[provider] : undefined;
+			}
+			/**
+			 * List configured models when the profile replaces the catalog, or pair inherited models with their overrides.
+			 * 配置替换模型目录时列出配置模型，否则为继承的模型附上对应的覆盖项。
+			 */
+			function modelOptions(profile, catalog) {
+			    // The adapter treats an empty models array as inheritance.
+			    // 适配器将空的 models 数组视为继承模型目录。
+			    const configured = profile.models;
+			    if (configured !== undefined && configured.length > 0) {
+			        return configured.map(model => ({ id: model.id, name: model.name ?? model.id, efforts: model.reasoningEfforts }));
+			    }
+			    // Overrides are keyed by the exact inherited model ID.
+			    // 覆盖项以继承模型的准确标识为键。
+			    const overrides = profile.modelOverrides;
+			    return catalog.map(model => ({
+			        ...model,
+			        efforts: overrides !== undefined && Object.hasOwn(overrides, model.id) ? overrides[model.id]?.reasoningEfforts : undefined,
+			    }));
+			}
+			/**
+			 * Convert the stored native field into the editor's mode and per-level text inputs.
+			 * 将原生存储字段转换为编辑器的模式与各级别文本输入。
+			 */
+			function draftOf(efforts) {
+			    if (efforts === undefined)
+			        return { mode: 'inherit', values: {} };
+			    if (efforts === false)
+			        return { mode: 'disabled', values: {} };
+			    // A present off level with a null wire value is edited as an enabled blank input.
+			    // 已启用但传输值为 null 的 off 级别，在表单中显示为已启用的空输入。
+			    const values = {};
+			    for (const level of exports.LEVELS) {
+			        // An absent key keeps the level unchecked.
+			        // 未配置的键在表单中保持未勾选。
+			        const wire = efforts[level];
+			        if (wire !== undefined)
+			            values[level] = wire ?? '';
+			    }
+			    return { mode: 'custom', values };
+			}
+			/**
+			 * Validate a draft and its compatibility with the provider default, returning the native field.
+			 * 校验草稿及其与提供商默认级别的兼容性，并返回对应的原生字段。
+			 */
+			function encodeDraft(draft, providerDefault) {
+			    if (draft.mode === 'inherit')
+			        return { ok: true, value: undefined };
+			    // pi-ai falls back to the provider default when a request has no explicit effort.
+			    // 请求未指定思考级别时，pi-ai 会使用提供商默认级别。
+			    if (providerDefault !== undefined) {
+			        if (draft.mode === 'disabled' && providerDefault !== 'off')
+			            return { ok: false, issue: 'providerDefault' };
+			        if (draft.mode === 'custom' && draft.values[providerDefault] === undefined)
+			            return { ok: false, issue: 'providerDefault' };
+			    }
+			    if (draft.mode === 'disabled')
+			        return { ok: true, value: false };
+			    if (!exports.LEVELS.some(level => level !== 'off' && draft.values[level] !== undefined)) {
+			        return { ok: false, issue: 'levelRequired' };
+			    }
+			    // A declaration must give each enabled thinking level its exact wire spelling.
+			    // 自定义配置必须为每个已启用的思考级别提供准确的传输值。
+			    const values = {};
+			    for (const level of exports.LEVELS) {
+			        // Trim the entered value and omit unchecked levels.
+			        // 修剪用户输入，并省略未勾选的级别。
+			        const wire = draft.values[level]?.trim();
+			        if (wire === undefined)
+			            continue;
+			        if (wire === '' && level !== 'off')
+			            return { ok: false, issue: 'wireRequired' };
+			        values[level] = wire === '' ? null : wire;
+			    }
+			    return { ok: true, value: values };
+			}
+			/**
+			 * Build the native write for one model ID in a provider profile, preserving all unrelated fields.
+			 * 为提供商配置中的一个模型标识生成原生写操作，并保留所有无关字段。
+			 */
+			function reasoningOp(profile, provider, modelId, efforts) {
+			    // The pi-ai provider directory addresses each profile by this path.
+			    // pi-ai 提供商目录按此路径定位各提供商配置。
+			    const path = ['providers', provider];
+			    // Use the whole current list for explicit models. dsh replaces arrays between layers.
+			    // 显式配置的模型使用当前完整列表，因为 dsh 在配置层之间替换数组。
+			    const models = profile.models;
+			    if (models !== undefined && models.length > 0) {
+			        if (!models.some(model => model.id === modelId))
+			            throw new Error('The configured model is no longer available');
+			        return {
+			            op: 'set',
+			            path: [...path, 'models'],
+			            value: models.map(model => {
+			                if (model.id !== modelId)
+			                    return model;
+			                // Remove only the old reasoning field so inheritance uses the installed catalog.
+			                // 仅移除旧的思考字段，使继承模式使用已安装的模型目录。
+			                const { reasoningEfforts: _previous, ...rest } = model;
+			                return efforts === undefined ? rest : { ...rest, reasoningEfforts: efforts };
+			            }),
+			        };
+			    }
+			    // The adapter permits sparse overrides only when the model list is inherited.
+			    // 适配器仅在继承模型列表时允许稀疏覆盖项。
+			    const field = [...path, 'modelOverrides', modelId, 'reasoningEfforts'];
+			    return efforts === undefined ? { op: 'unset', path: field } : { op: 'set', path: field, value: efforts };
+			}
+
+		},
+		"./style": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.installStyle = installStyle;
+			const shared_1 = require("./shared");
+			// Use dsh's colors so the editor follows both Vulcan and native themes.
+			// 使用 dsh 的颜色，使编辑器同时适配 Vulcan 主题和原生主题。
+			const CSS = `
+			.vrs { min-width: 0; color: var(--dsw-alias-label-primary); font-size: 13px; }
+			.vrs > summary { cursor: pointer; width: fit-content; color: var(--dsw-alias-label-secondary); }
+			.vrs > summary:focus-visible, .vrs :is(button,input,select):focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary); outline-offset: 2px; }
+			.vrs-form, .vrs-fields, .vrs-levels { display: grid; gap: 10px; min-width: 0; }
+			.vrs-form { margin-top: 10px; }
+			.vrs-fields { padding: 0; margin: 0; border: 0; }
+			.vrs-control { display: grid; gap: 4px; min-width: 0; }
+			.vrs-control select, .vrs-level input[type="text"] { box-sizing: border-box; min-width: 0; width: 100%; padding: 5px 8px; color: inherit; background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l3); border-radius: var(--dsw-radius-sm); font: inherit; }
+			.vrs-level { display: grid; grid-template-columns: minmax(5rem, 1fr) minmax(0, 2fr); align-items: center; gap: 8px; }
+			.vrs-level label { display: flex; align-items: center; gap: 6px; }
+			.vrs-actions { display: flex; flex-wrap: wrap; gap: 8px; }
+			.vrs button { padding: 5px 10px; font: inherit; cursor: pointer; color: inherit; background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l3); border-radius: var(--dsw-radius-sm); }
+			.vrs button[type="submit"] { color: var(--dsw-alias-label-primary-foreground); background: var(--dsw-alias-button-primary-fill); }
+			.vrs :is(button,input,select):disabled { opacity: .6; cursor: default; }
+			.vrs p { margin: 0; overflow-wrap: anywhere; }
+			.vrs-hint { color: var(--dsw-alias-label-secondary); }
+			.vrs-error { color: var(--dsw-alias-state-error-primary); }
+			`;
+			/**
+			 * Mount the editor's stylesheet and return a disposer for the mounted node.
+			 * 挂载编辑器样式表，并返回用于移除该节点的清理函数。
+			 */
+			function installStyle() {
+			    // The stylesheet belongs to the loaded plugin's lifetime.
+			    // 样式表的生命周期与插件加载周期一致。
+			    const tag = document.createElement('style');
+			    tag.dataset['plugin'] = shared_1.PACKAGE_NAME;
+			    tag.textContent = CSS;
+			    document.head.appendChild(tag);
+			    return () => { tag.remove(); };
+			}
+
+		},
+		};
+		var cache = {};
+		function load(request) {
+			if (!(request in definitions)) return platformRequire(request);
+			if (!(request in cache)) {
+				var module = { exports: {} };
+				cache[request] = module;
+				definitions[request](module, module.exports, load);
+			}
+			return cache[request].exports;
+		}
+		return load('./index');
+	}
+});

package/node_modules/@openvulcan/dsh-vulcan-reasoning/lib/index.d.ts

@@ -0,0 +1,6 @@
+export declare const name = "vulcan-reasoning";
+/**
+ * Mount the host entry. The browser contribution uses dsh's existing settings service.
+ * 挂载宿主入口。浏览器扩展使用 dsh 现有的设置服务。
+ */
+export declare function apply(): void;

package/node_modules/@openvulcan/dsh-vulcan-reasoning/lib/index.js

@@ -0,0 +1,8 @@
+// Cordis uses this identity to load the browser contribution with the suite.
+// Cordis 以此标识随套件加载浏览器扩展。
+export const name = 'vulcan-reasoning';
+/**
+ * Mount the host entry. The browser contribution uses dsh's existing settings service.
+ * 挂载宿主入口。浏览器扩展使用 dsh 现有的设置服务。
+ */
+export function apply() { }

package/node_modules/@openvulcan/dsh-vulcan-reasoning/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@openvulcan/dsh-vulcan-reasoning",
+  "version": "0.4.3",
+  "description": "Edit per-model thinking levels for pi-ai providers in DeepSeek Harness.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenVulcan/dsh-vulcancode.git",
+    "directory": "packages/dsh-vulcan-reasoning"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "!lib/**/*.test.*"
+  ],
+  "engines": {
+    "dsh": ">=0.2.1-rc.2 <0.3.0"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings-models"
+      ]
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/node_modules/@openvulcan/dsh-vulcan-style/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenVulcan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.