@fa-software/semi2-dsh 0.0.18 → 0.0.19-preview.20261001161030

package/lib/domains/skills/mcp-resources.js

@@ -64,10 +64,7 @@ export function createSkillResourceProvider(deps) {
         const project = await deps.projectForCwd(cwd);
         if (project === null)
             return [];
-        return [
-            ...skills.filter(skill => skill.projectId === project.id),
-            ...skills.filter(skill => skill.projectId === null),
-        ];
+        return [...skills.filter(skill => skill.projectId === project.id), ...skills.filter(skill => skill.projectId === null)];
     };
     const listResources = async (exec) => {
         const seen = new Set();
@@ -116,18 +113,19 @@ export function createSkillResourceProvider(deps) {
     };
     const dispatch = async (request, exec) => {
         switch (request.method) {
-            case 'resources/templates/list': return templateList();
-            case 'resources/list': return await listResources(exec);
-            case 'resources/read': return await readResource(request.uri, exec);
+            case 'resources/templates/list':
+                return templateList();
+            case 'resources/list':
+                return await listResources(exec);
+            case 'resources/read':
+                return await readResource(request.uri, exec);
         }
     };
     return {
         request(request, exec) {
             return dispatch(request, exec).catch((error) => {
                 deps.warn(`技能资源请求失败（${message(error)}）`);
-                return request.method === 'resources/read'
-                    ? errorResult(-32603, '技能资源读取失败')
-                    : { resources: [] };
+                return request.method === 'resources/read' ? errorResult(-32603, '技能资源读取失败') : { resources: [] };
             });
         },
     };

package/lib/domains/skills/provider.js

@@ -1,4 +1,4 @@
-import { installSkillResources, skillResourceHint, } from "./mcp-resources.js";
+import { installSkillResources, skillResourceHint } from "./mcp-resources.js";
 import { candidateOf, definitionOf } from "./candidates.js";
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
@@ -13,7 +13,7 @@ export function installHubSkills(ctx, deps) {
         state: () => deps.state(),
         projectForCwd: cwd => deps.projectForCwd(cwd),
         readFiles: skillId => deps.readFiles(skillId),
-        warn: (message) => {
+        warn: message => {
             deps.warn(message);
         },
     };
@@ -39,7 +39,7 @@ export function installHubSkills(ctx, deps) {
         const push = (skill) => {
             if (seen.has(skill.name))
                 return;
-            const candidate = candidateOf(skill, (message) => {
+            const candidate = candidateOf(skill, message => {
                 deps.warn(message);
             });
             if (candidate === null)
@@ -115,7 +115,7 @@ export function installHubSkills(ctx, deps) {
     };
     const disposers = [];
     try {
-        disposers.push(ctx.skills.registerProvider((control) => {
+        disposers.push(ctx.skills.registerProvider(control => {
             invalidate = () => {
                 control.invalidate();
             };

package/lib/domains/workspace/domain.js

@@ -1,6 +1,6 @@
-import { trackedWorkspaces, WorkspaceBook, } from "../../hub/workspace-book.js";
+import { trackedWorkspaces, WorkspaceBook } from "../../hub/workspace-book.js";
 import { renderWorkspaces } from "../../hub/status.js";
-import { projectForCwd, syncAll, syncBySlug, syncOne, } from "./resolve.js";
+import { projectForCwd, syncAll, syncBySlug, syncOne } from "./resolve.js";
 export class WorkspaceDomain {
     host;
     id = 'workspace';
@@ -23,7 +23,7 @@ export class WorkspaceDomain {
             missingProjects: this.missingProjects,
             gitSlugs: this.gitSlugs,
             tracked: () => this.tracked(),
-            publish: (notify) => {
+            publish: notify => {
                 this.host.patchState({ workspaces: this.tracked() });
                 if (notify)
                     this.host.emitWorkspacesUpdated();

package/lib/domains/workspace/feed.js

@@ -2,7 +2,7 @@ function describe(error) {
     return error instanceof Error ? error.message : String(error);
 }
 export function installWorkspaceFeed(ctx, handlers, warn) {
-    ctx.inject(['workspaceController'], (scoped) => {
+    ctx.inject(['workspaceController'], scoped => {
         const scope = scoped;
         const controller = scope.get('workspaceController');
         if (controller === undefined)

package/lib/domains/workspace/index.js

@@ -33,7 +33,7 @@ export const workspaceDomain = {
                 host.patchState({ workspaces: domain.tracked() });
                 host.emitWorkspacesUpdated();
             }),
-        }, (message) => {
+        }, message => {
             host.warn(message);
         });
         host.attach(domain);

package/lib/domains/workspace/resolve.js

@@ -1,4 +1,4 @@
-import { canonicalPath, pendingEntry, } from "../../hub/workspace-book.js";
+import { canonicalPath, pendingEntry } from "../../hub/workspace-book.js";
 import { matchProject, workspaceSlug } from "../../hub/git-slug.js";
 import { codeOf } from "../../hub/errors.js";
 /**
@@ -101,9 +101,7 @@ function resolveEntry(bag, entry, slug) {
  * 结果空 = 该 slug 确实不在可读范围内，记进负缓存免得每次会话都重问。
  */
 async function fetchProjects(bag, slugs) {
-    const wanted = [
-        ...new Set(slugs.map(slug => slug.trim().toLowerCase())),
-    ].filter(slug => slug !== '' && !bag.missingProjects.has(slug));
+    const wanted = [...new Set(slugs.map(slug => slug.trim().toLowerCase()))].filter(slug => slug !== '' && !bag.missingProjects.has(slug));
     if (wanted.length === 0 || !bag.host.hasConnection())
         return;
     try {

package/lib/hub/compile.js

@@ -23,11 +23,7 @@ export function connectionApiKeyEnv(connectionId) {
     return `SEMI2_MODEL_KEY_${connectionId.replaceAll('-', '').toUpperCase()}`;
 }
 export function protocolApi(protocol) {
-    return protocol === 'ANTHROPIC'
-        ? 'anthropic-messages'
-        : protocol === 'OPENAI_RESPONSES'
-            ? 'openai-responses'
-            : 'openai-completions';
+    return protocol === 'ANTHROPIC' ? 'anthropic-messages' : protocol === 'OPENAI_RESPONSES' ? 'openai-responses' : 'openai-completions';
 }
 export function modelName(model) {
     return model.displayName ?? model.upstreamId;
@@ -48,9 +44,7 @@ export function providerProfile(compiled) {
 export function remapSelections(compiled, routes) {
     const rewrite = (selection) => {
         const route = routes.get(selection.provider);
-        return route === undefined || route === selection.provider
-            ? selection
-            : { ...selection, provider: route };
+        return route === undefined || route === selection.provider ? selection : { ...selection, provider: route };
     };
     return {
         ...compiled,
@@ -103,15 +97,9 @@ function presetProvider(route, connection, models) {
         models: models.map(model => ({
             id: model.upstreamId,
             name: modelName(model),
-            ...(model.metadata.contextWindow === null
-                ? {}
-                : { contextWindow: model.metadata.contextWindow }),
-            ...(model.metadata.maxTokens === null
-                ? {}
-                : { maxTokens: model.metadata.maxTokens }),
-            ...(model.metadata.input === null
-                ? {}
-                : { input: model.metadata.input.map(modality) }),
+            ...(model.metadata.contextWindow === null ? {} : { contextWindow: model.metadata.contextWindow }),
+            ...(model.metadata.maxTokens === null ? {} : { maxTokens: model.metadata.maxTokens }),
+            ...(model.metadata.input === null ? {} : { input: model.metadata.input.map(modality) }),
         })),
     };
 }

package/lib/hub/credentials.js

@@ -2,7 +2,7 @@
 // 解析优先级：运行端契约 > dsh credentials（启动环境层 → provider 存储 → .env 文件层）> 进程 env 快照。
 // 启动环境层（`source: env`）的令牌只属 CNB 端（secret imports）；宿主 / 容器形态靠设置页登录（见 resolveConnectionFields 的筛选）。
 // 令牌不是一次性凭据：`SEMI2_ACCESS_TOKEN` 首次读取成功后从进程 env 删除，内存副本必须活满整个进程。
-import { credentialRef, } from '@deepseek-ai/dsh-credentials';
+import { credentialRef } from '@deepseek-ai/dsh-credentials';
 import { ConfigurationError } from "./errors.js";
 export const CONFIG_URL_REF = 'SEMI2_CONFIG_URL';
 export const ACCESS_TOKEN_REF = 'SEMI2_ACCESS_TOKEN';
@@ -19,9 +19,7 @@ async function resolveField(credentials, ref, explicit, fallback) {
     if (credentials !== undefined) {
         const resolved = await credentials.resolve(ref);
         const value = text(resolved?.value);
-        return value === undefined
-            ? undefined
-            : { value, source: resolved?.source ?? 'credentials' };
+        return value === undefined ? undefined : { value, source: resolved?.source ?? 'credentials' };
     }
     const value = text(fallback);
     return value === undefined ? undefined : { value, source: 'env' };
@@ -47,10 +45,7 @@ export async function resolveConnectionFields(credentials, runtimeContract, envi
     // 宿主 / 容器形态认这一层等于自锁——该层只读（dsh 拒绝 set/unset）又排在临时存储之前，设置页会只剩只读状态
     // （没有登录入口），登录写进去的令牌也读不回来（编排层另在启动时把它从进程 env 摘掉）。
     // 地址不是密钥、还是登录表单的预填来源，任何形态都保留；契约与登录存储的令牌一律照收。
-    const usable = token !== undefined &&
-        (token.source !== 'env' || runtimeContract?.platform === 'cnb')
-        ? token
-        : undefined;
+    const usable = token !== undefined && (token.source !== 'env' || runtimeContract?.platform === 'cnb') ? token : undefined;
     return {
         ...(url === undefined ? {} : { url }),
         ...(usable === undefined ? {} : { token: usable }),

package/lib/hub/errors.js

@@ -10,7 +10,5 @@ export class ConfigurationError extends Error {
 }
 /** 领域失败码归一：非 ConfigurationError 的异常一律按通用码处理。 */
 export function codeOf(error) {
-    return error instanceof ConfigurationError
-        ? error.code
-        : 'CONFIG_APPLY_FAILED';
+    return error instanceof ConfigurationError ? error.code : 'CONFIG_APPLY_FAILED';
 }

package/lib/hub/status.js

@@ -13,7 +13,7 @@ export const STATUS_BASE_FIELDS = [
 const MAX_LISTED_WORKSPACES = 20;
 /** `标题 → slug(项目名)`：只有命中 hub 项目的工作区才进这里，读一行就知道同步到了什么。 */
 export function renderWorkspaces(workspaces) {
-    const listed = workspaces.slice(0, MAX_LISTED_WORKSPACES).map((entry) => {
+    const listed = workspaces.slice(0, MAX_LISTED_WORKSPACES).map(entry => {
         const slug = entry.slug ?? '未解析';
         const project = entry.name ?? '未匹配';
         return `${entry.title} → ${slug}(${project})`;

package/lib/hub/workspace-book.js

@@ -60,9 +60,7 @@ export class WorkspaceBook {
             seen.add(item.path);
             this.pathById.set(item.workspaceId, item.path);
             const previous = this.byPath.get(item.path);
-            this.byPath.set(item.path, previous === undefined
-                ? pendingEntry(item.path, item.title)
-                : { ...previous, title: item.title, implicit: false });
+            this.byPath.set(item.path, previous === undefined ? pendingEntry(item.path, item.title) : { ...previous, title: item.title, implicit: false });
         }
         for (const [path, entry] of [...this.byPath]) {
             if (entry.implicit || seen.has(path))
@@ -78,9 +76,7 @@ export class WorkspaceBook {
     upsertWorkspace(view) {
         this.pathById.set(view.workspaceId, view.path);
         const previous = this.byPath.get(view.path);
-        const next = previous === undefined
-            ? pendingEntry(view.path, view.title)
-            : { ...previous, title: view.title, implicit: false };
+        const next = previous === undefined ? pendingEntry(view.path, view.title) : { ...previous, title: view.title, implicit: false };
         this.byPath.set(view.path, next);
         return next;
     }

package/lib/index.js

@@ -1,7 +1,8 @@
 import z from '@deepseek-ai/schemastery';
 import { installConfiguration } from "./service/config-service.js";
 import { installWebClient } from "./web/index.js";
-export { SEMI2_RUNTIME_SERVICE, SEMI2_SECTION_ORDERS, runtimeFromCnbEnv, semi2SectionOrder, } from "./contract.js";
+export { SEMI2_RUNTIME_SERVICE, SEMI2_SECTION_ORDERS, runtimeFromCnbEnv, semi2SectionOrder } from "./contract.js";
+export { cnbTokenPath, writeCnbSessionToken } from "./cnb-token.js";
 // 事件签名声明（semi2/config-updated / semi2/workspaces-updated）唯一出处。
 import "./events.js";
 export const name = 'semi2-dsh';
@@ -60,7 +61,7 @@ export function apply(ctx, config) {
         sync: scope => configuration.session.sync(scope),
         health: () => configuration.health.snapshot(),
         status: () => configuration.status(),
-    }, (contributor) => {
+    }, contributor => {
         configuration.registerHealth(contributor);
     }, { fenceTimeoutMs: options.webFenceTimeoutMs });
 }

package/lib/service/config-service.js

@@ -1,4 +1,4 @@
-import { createSemi2Api } from "../api/index.js";
+import { createRestApi } from "../api/rest.js";
 import { createPorts } from "./ports.js";
 import { Orchestrator } from "./orchestrator.js";
 import { reportEventResult } from "./audit.js";
@@ -30,12 +30,11 @@ export function installConfiguration(ctx, options = {}) {
     // api 门面读连接凭据的桥：闭包延迟求值（编排层构造完成后才可能被调用）。
     const engineRef = { current: undefined };
     const orchestrator = new Orchestrator(ctx, options.api ??
-        createSemi2Api({
+        createRestApi({
             readConnection: () => engineRef.current?.connection() ?? null,
             environment: { ...process.env },
             // 契约缺席即宿主直跑：本端标识回落 `host`，别让会话落成「未标注」。
-            readChannel: () => engineRef.current?.contract()?.channel ??
-                (engineRef.current?.platform === 'host' ? 'host' : undefined),
+            readChannel: () => engineRef.current?.contract()?.channel ?? (engineRef.current?.platform === 'host' ? 'host' : undefined),
         }), ports, { ...process.env }, options);
     engineRef.current = orchestrator;
     // 客户端会话日志的事实来源：旁听 dsh 的会话创建 / 销毁（服务缺席时自动跳过）。

package/lib/service/connection.js

@@ -2,7 +2,7 @@
 // 契约只解析一次（适配器在 apply 里同步 provide）；凭据三层解析在 hub/credentials（纯逻辑）。
 import { setTimeout as delay } from 'node:timers/promises';
 import { SEMI2_RUNTIME_SERVICE } from "../contract.js";
-import { connectionOf, resolveConnectionFields, } from "../hub/credentials.js";
+import { connectionOf, resolveConnectionFields } from "../hub/credentials.js";
 import { codeOf } from "../hub/errors.js";
 /** 等运行端契约出现的上限；超时按宿主直跑（无适配器）处理。 */
 export const CONTRACT_TIMEOUT_MS = 5_000;

package/lib/service/lifecycle.js

@@ -1,9 +1,9 @@
-import { clearConnection, connectionOf, storeConnection, } from "../hub/credentials.js";
+import { clearConnection, connectionOf, storeConnection } from "../hub/credentials.js";
 import { codeOf, ConfigurationError } from "../hub/errors.js";
 import { initialState } from "../hub/facts.js";
 import { appliedState, credentialsWritable, failedState } from "./status.js";
 import { DOMAINS } from "./registry.js";
-import { connectionSnapshot, exchangeCnbCredential, resolveConnectionWithRetry, resolveContract, } from "./connection.js";
+import { connectionSnapshot, exchangeCnbCredential, resolveConnectionWithRetry, resolveContract } from "./connection.js";
 /** 首次加载；未配凭据或失败只落到 state.error，绝不 throw，也不注入任何配置。 */
 export async function start(engine) {
     try {
@@ -191,7 +191,7 @@ async function ensureSnapshot(engine) {
     return connectionSnapshot(engine.ports, engine.environment, engine.contract());
 }
 async function exchange(engine, connection) {
-    return exchangeCnbCredential(engine.api, (message) => {
+    return exchangeCnbCredential(engine.api, message => {
         engine.warn(message);
     }, connection, engine.contract()?.platform);
 }

package/lib/service/orchestrator.js

@@ -1,5 +1,5 @@
 import { setTimeout as delay } from 'node:timers/promises';
-import { initialState, } from "../hub/facts.js";
+import { initialState } from "../hub/facts.js";
 import { DOMAINS } from "./registry.js";
 import { NOOP_WORKSPACE } from "./workspace-ops.js";
 import { CONTRACT_TIMEOUT_MS, CREDENTIAL_RETRY } from "./connection.js";
@@ -121,9 +121,7 @@ export class Orchestrator {
             domain.invalidate?.();
     }
     noteFailure(area, error) {
-        const code = error instanceof Error && 'code' in error
-            ? String(error.code)
-            : 'CONFIG_APPLY_FAILED';
+        const code = error instanceof Error && 'code' in error ? String(error.code) : 'CONFIG_APPLY_FAILED';
         this.warn(`${area}应用失败（${code}），该领域降级，其余领域照常`);
         return code;
     }

package/lib/service/ports.js

@@ -1,4 +1,4 @@
-import { transact, } from "./settings-tx.js";
+import { transact } from "./settings-tx.js";
 const SETTINGS_TIMEOUT_MS = 5_000;
 const NAMESPACE_WAIT_MS = 2_000;
 const WRITE_TIMEOUT_MS = 3_000;
@@ -7,8 +7,8 @@ export function createPorts(ctx, warn, options = {}) {
     const namespaceWaitMs = options.namespaceWaitMs ?? NAMESPACE_WAIT_MS;
     const writeTimeoutMs = options.writeTimeoutMs ?? WRITE_TIMEOUT_MS;
     const tx = { warn, namespaceWaitMs, writeTimeoutMs };
-    const service = (key) => new Promise((resolve) => {
-        ctx.inject([key], (injected) => {
+    const service = (key) => new Promise(resolve => {
+        ctx.inject([key], injected => {
             resolve(injected.get(key));
         });
     });
@@ -19,7 +19,7 @@ export function createPorts(ctx, warn, options = {}) {
             const timer = globalThis.setTimeout(() => {
                 resolve(undefined);
             }, settingsTimeoutMs);
-            ctx.inject(['settings'], (injected) => {
+            ctx.inject(['settings'], injected => {
                 globalThis.clearTimeout(timer);
                 resolve(injected.get('settings'));
             });

package/lib/service/registry.js

@@ -19,12 +19,6 @@ export const DOMAINS = [
     redmineDomain,
 ];
 /** 完整状态字段顺序（基座 + 按注册表顺序的领域字段）；状态视图与健康字段共用这一段。 */
-export const STATUS_FIELDS = [
-    ...STATUS_BASE_FIELDS,
-    ...DOMAINS.flatMap(domain => [...domain.statusKeys]),
-];
+export const STATUS_FIELDS = [...STATUS_BASE_FIELDS, ...DOMAINS.flatMap(domain => [...domain.statusKeys])];
 /** 健康字段键（能力 + 领域，值是 `状态:说明` 形式的编码串；读侧拆码）。 */
-export const HEALTH_FIELDS = [
-    'healthWeb',
-    ...DOMAINS.map(domain => `health:${domain.id}`),
-];
+export const HEALTH_FIELDS = ['healthWeb', ...DOMAINS.map(domain => `health:${domain.id}`)];

package/lib/service/sessions.js

@@ -46,13 +46,8 @@ async function reportCreated(engine, session) {
         ...(scope.workspacePath === null ? {} : { workspacePath: scope.workspacePath }),
         ...(scope.workspaceSlug === null ? {} : { workspaceSlug: scope.workspaceSlug }),
         ...(scope.projectSlug === null ? {} : { projectSlug: scope.projectSlug }),
-        ...(selection?.model === undefined || selection.model === ''
-            ? {}
-            : { modelId: selection.model }),
-        ...(selection?.reasoningEffort === undefined ||
-            selection.reasoningEffort === ''
-            ? {}
-            : { reasoningLevel: selection.reasoningEffort }),
+        ...(selection?.model === undefined || selection.model === '' ? {} : { modelId: selection.model }),
+        ...(selection?.reasoningEffort === undefined || selection.reasoningEffort === '' ? {} : { reasoningLevel: selection.reasoningEffort }),
         detail: { cwd: scope.workspacePath },
     });
 }
@@ -72,7 +67,7 @@ async function reportDisposed(engine, session) {
  * 返回订阅光纤（可 await 到就绪），测试据它确认监听已挂上。
  */
 export function installSessionReporting(engine, ctx = engine.ctx) {
-    return ctx.inject(['sessions'], (scoped) => {
+    return ctx.inject(['sessions'], scoped => {
         const track = (session, report) => {
             if (!isUserSession(session))
                 return;
@@ -80,10 +75,10 @@ export function installSessionReporting(engine, ctx = engine.ctx) {
                 engine.warn(`会话上报失败：${error instanceof Error ? error.message : String(error)}`);
             });
         };
-        scoped.on('session/created', (session) => {
+        scoped.on('session/created', session => {
             track(session, reportCreated);
         });
-        scoped.on('session/disposed', (session) => {
+        scoped.on('session/disposed', session => {
             track(session, reportDisposed);
         });
     });

package/lib/service/settings-tx.js

@@ -52,9 +52,7 @@ function viewOf(settings, ns) {
     };
 }
 function recordOf(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value)
-        ? value
-        : {};
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
 }
 /** 落一笔写：section 走 replace（缺则回退 update 的合并写入）、ops 走 mutate；都带上 CAS。 */
 function applyWrite(settings, ns, write, revision, options) {
@@ -75,8 +73,7 @@ function applyWrite(settings, ns, write, revision, options) {
 }
 /** 官方冲突（读与写之间有人改了段）：按结构判 code，防闭包内模块实例分裂时漏认。 */
 function isConflict(error) {
-    return error instanceof SettingsConflictError ||
-        (error instanceof Error && error.code === 'SETTINGS_CONFLICT');
+    return error instanceof SettingsConflictError || (error instanceof Error && error.code === 'SETTINGS_CONFLICT');
 }
 /** 到点返回 {@link EXPIRED}，否则原样给出结果；定时器总在返回前清掉。 */
 async function within(promise, ms) {
@@ -84,7 +81,7 @@ async function within(promise, ms) {
     try {
         return await Promise.race([
             promise,
-            new Promise((resolve) => {
+            new Promise(resolve => {
                 timer = globalThis.setTimeout(() => {
                     resolve(EXPIRED);
                 }, ms);

package/lib/service/status.js

@@ -1,4 +1,4 @@
-import { statusFields, workspaceTabs, WORKSPACE_TABS_FIELD, } from "../hub/status.js";
+import { statusFields, workspaceTabs, WORKSPACE_TABS_FIELD } from "../hub/status.js";
 import { aggregateHealth, healthText } from "./health.js";
 import { DOMAINS } from "./registry.js";
 import { reportEvent } from "./audit.js";
@@ -55,9 +55,7 @@ export async function failedState(engine, code) {
 /** boot 事实 → ready 状态（技能切片取自 skills 领域；项目缓存随装配作废，由工作区同步重取）。 */
 export function appliedState(engine, boot, compiled, errorCode) {
     const defaultModelId = boot.runtimeDefaultModelId ?? null;
-    const selection = compiled === null || defaultModelId === null
-        ? null
-        : (compiled.selections.get(defaultModelId) ?? null);
+    const selection = compiled === null || defaultModelId === null ? null : (compiled.selections.get(defaultModelId) ?? null);
     const skills = engine.peer('skills')?.skills() ?? null;
     const current = engine.state();
     return {
@@ -67,16 +65,14 @@ export function appliedState(engine, boot, compiled, errorCode) {
         consoleUrl: engine.connection()?.url ?? current.consoleUrl,
         loadedAt: new Date().toISOString(),
         identity: boot.runtimeViewer ?? null,
-        model: selection === null
-            ? null
-            : { id: selection.model, provider: selection.provider },
+        model: selection === null ? null : { id: selection.model, provider: selection.provider },
         skills,
         projects: [],
     };
 }
 /** 健康快照：领域项按注册表（缺席记 unavailable）+ 能力贡献者按登记。 */
 export function healthSnapshot(engine) {
-    return aggregateHealth(DOMAINS.map(domain => domain.id), (id) => {
+    return aggregateHealth(DOMAINS.map(domain => domain.id), id => {
         // 本端没有 settings 服务：没有任何领域被装配（写不进去就不装），整端记不适用。
         if (engine.settingsMissing()) {
             return { state: 'unavailable', note: '本端无 settings 服务，不注入配置' };

package/lib/types/api/bootstrap.d.ts

@@ -0,0 +1,23 @@
+import { decodeModelConfiguration } from './http-models.ts';
+import { decodeSkill } from './http-assets.ts';
+import type { operations } from './generated/http.ts';
+type WireBootstrap = operations['runtimeBootstrap']['responses'][200]['content']['application/json'];
+export type RuntimeViewer = WireBootstrap['viewer'];
+export type RuntimeBlock<T> = {
+    status: 'ok';
+    data: T;
+} | {
+    status: 'error';
+    code: string;
+};
+export interface BootstrapEnvelope {
+    viewer: RuntimeViewer;
+    models: RuntimeBlock<ReturnType<typeof decodeModelConfiguration>>;
+    skills: RuntimeBlock<ReturnType<typeof decodeSkill>[]>;
+    selfPortrait: RuntimeBlock<string>;
+    redmine: WireBootstrap['redmine'];
+}
+/** 失败块不得伪装成空配置；缺块或未知状态说明协议不完整。 */
+export declare function decodeBlock<T>(value: unknown, decode: (data: unknown) => T): RuntimeBlock<T>;
+export declare function decodeBootstrap(value: unknown): BootstrapEnvelope;
+export {};

package/lib/types/api/facts.d.ts

@@ -0,0 +1,41 @@
+import type { decodeCredential, decodeModel, protocol, reasoning } from './http-models.ts';
+import type { decodeEvent, decodeFileContent, decodeProfile, decodeProject, decodeSkill } from './http-assets.ts';
+import type { RuntimeViewer } from './bootstrap.ts';
+/** 解码后的领域事实；HTTP 空值在这里保留，不与读取失败合并。 */
+export type RuntimeModel = ReturnType<typeof decodeModel>;
+export type RuntimeProject = ReturnType<typeof decodeProject>;
+export type RuntimeCredential = ReturnType<typeof decodeCredential>;
+export type ModelProtocol = ReturnType<typeof protocol>;
+export type ReasoningLevel = NonNullable<ReturnType<typeof reasoning>>;
+export type InputModality = NonNullable<RuntimeModel['metadata']['input']>[number];
+export interface BootFacts {
+    runtimeViewer: RuntimeViewer | null;
+    runtimeModels: RuntimeModel[] | null;
+    runtimeModelCredentials: RuntimeCredential[] | null;
+    runtimeDefaultModelId: string | null;
+    runtimeHeadlessModels: {
+        planModelId: string | null;
+        executeModelId: string | null;
+    } | null;
+    runtimeSkillCatalog: ReturnType<typeof decodeSkill>[] | null;
+    runtimeSelfPortrait: string | null;
+    runtimeRedmine: {
+        baseUrl: string | null;
+        apiKey: string | null;
+    } | null;
+}
+export interface WorkspaceFacts {
+    runtimeProjects: RuntimeProject[] | null;
+}
+export interface CredentialFacts {
+    runtimeModelCredentials: RuntimeCredential[] | null;
+}
+export interface SkillFileFacts {
+    runtimeSkillFiles: ReturnType<typeof decodeFileContent>[] | null;
+}
+export interface ProjectProfileFacts {
+    runtimeProjectProfile: ReturnType<typeof decodeProfile> | null;
+}
+export interface ReportedEventFacts {
+    runtimeReportEvent: ReturnType<typeof decodeEvent>;
+}