@ai-workbench/remote-agent 0.8.23 → 0.8.24

package/README.md

@@ -1,4 +1,4 @@
-# AI Workbench 远程助手 · @ai-workbench/remote-agent@0.8.23 · 插件 → 添加插件
+# AI Workbench 远程助手 · @ai-workbench/remote-agent@0.8.24 · 插件 → 添加插件
 
 通过官方 DSH 插件入口使用 Claude（远程主机）与 Codex（远程主机）。登录和工作区来源由“远程主机连接”组件提供；员工在原生工作区和模型菜单中选择文件夹与型号。
 
@@ -43,3 +43,5 @@ Codex 员工端只使用随包提供的原生组件，通道等待本次组件
 工程验证、独立审查、固定包摘要及实际设备验收分别记录在 `docs/evidence/2026-10-24-X-executor-readiness/` 和项目 X 回执中。插件不修改 DSH 核心，不添加启动器或自定义 profile。
 
 远程助手参数页只显示官方 ConfigForms 当前值，不提供保存、放弃或恢复继承值；修改请使用 DSH 官方 Config“打开配置文件”入口。
+
+模型目录在官方启动读取时获取，并在连接变为 connected 时经官方注册刷新；官方菜单打开或重试读取缓存是 DSH 官方限制，本插件不改官方菜单或核心。真正不支持的推理档位由 DSH 预检，其英文提示保留为观察项。

package/dist/acp.js

@@ -484,7 +484,7 @@ export class AcpSession {
         signal?.addEventListener('abort', abort, { once: true });
         try {
             const hello = await this.stage('acp-initialize', () => this.connection.agent.request(acp.methods.agent.initialize, {
-                protocolVersion: acp.PROTOCOL_VERSION, clientInfo: { name: '@ai-workbench/remote-agent', version: '0.8.23' },
+                protocolVersion: acp.PROTOCOL_VERSION, clientInfo: { name: '@ai-workbench/remote-agent', version: '0.8.24' },
                 clientCapabilities: { fs: { readTextFile: false, writeTextFile: false }, terminal: false, session: { notices: {} }, ...(this.employeeMeta ? { _meta: { awEmployeeExecution: { version: 1, closeReason: 1 } } } : {}) },
             }, { cancellationSignal: signal }));
             if (hello.protocolVersion !== acp.PROTOCOL_VERSION)

package/dist/employee-mcp.js

@@ -152,7 +152,7 @@ export async function openEmployeeMcp(options) {
             return tools.call(request.params.name, request.params.arguments ?? {}, signal, event => { if (sink)
                 observeUsing(event, sink); });
         });
-        mcp.onerror = () => { observeConnection?.({ layer: 'relay', initiator: 'mcp.server-error', reason: 'EMPLOYEE_MCP_PROTOCOL_OR_TRANSPORT_ERROR', action: 'failure' }); observe({ kind: 'session', severity: 'warning', code: 'CLAUDE_EMPLOYEE_MCP_UNKNOWN', summary: '本机工具连接出现协议或传输错误；恢复后可在原会话继续。' }); };
+        mcp.onerror = () => { observeConnection?.({ layer: 'relay', initiator: 'mcp.server-error', reason: 'EMPLOYEE_MCP_PROTOCOL_OR_TRANSPORT_ERROR', action: 'failure' }); observe({ kind: 'session', severity: 'warning', code: 'CLAUDE_EMPLOYEE_MCP_UNKNOWN', summary: '本机工具连接中断，在途结果未知，没有重放；恢复后可在原会话继续。' }); };
         mcp.onclose = () => { observeConnection?.({ layer: 'relay', initiator: 'mcp.client-closed', reason: 'MCP_CLIENT_CLOSED', action: 'close' }); clients.delete(mcp); transports.delete(transport); };
         void mcp.connect(transport).catch(error => { observeConnection?.({ layer: 'relay', initiator: 'mcp.connect-failure', reason: closeCode(error, 'MCP_CONNECT_FAILED'), action: 'close' }); socket.destroy(); });
     });

package/dist/index.d.ts

@@ -74,8 +74,8 @@ export declare class CodexRemoteAdapter extends LlmAdapter {
     listModels(provider: string): Promise<(LlmResolvedModelInfo & {
         catalog: HostModel;
     })[]>;
-    resolveModel(provider: string, id: string, _signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
-    prepareCall(provider: string, id: string, _signal?: AbortSignal): Promise<{
+    resolveModel(provider: string, id: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
+    prepareCall(provider: string, id: string, signal?: AbortSignal): Promise<{
         model: LlmResolvedModelInfo;
         stream: (options: GenerateOptions) => AsyncGenerator<StreamChunk, any, any>;
     }>;

package/dist/index.js

@@ -27,7 +27,7 @@ import { createClaudeLocalProvider } from "./claude-local.js";
 import { readLocalUserTurn } from "./local-user-turn.js";
 import { readEmployeeWorkspace } from "./employee-workspace.js";
 import { createPreflightDiagnostics } from "./preflight-diagnostic.js";
-import { installModelInputRetention } from "./model-input-retention.js";
+import { installModelInputRetention, markModelPreparationFailure } from "./model-input-retention.js";
 import { dshPermissionSource, permissionMode } from "./permissions.js";
 export { readDshPermissions } from "./permissions.js";
 export const name = 'ai-workbench-remote-agent';
@@ -121,8 +121,33 @@ export class CodexRemoteAdapter extends LlmAdapter {
     finally {
         catalog.release();
     } }
-    async resolveModel(provider, id, _signal) { return this.modelPresentation.resolve(provider, id) ?? { provider, id, name: id }; }
-    async prepareCall(provider, id, _signal) { return { model: await this.resolveModel(provider, id), stream: (options) => this.stream(options) }; }
+    async resolveModel(provider, id, signal) {
+        const displayed = this.modelPresentation.resolve(provider, id);
+        if (displayed)
+            return displayed;
+        const active = signal ? AbortSignal.any([signal, this.lifetime.signal]) : this.lifetime.signal;
+        const catalog = await this.catalog(active);
+        try {
+            active.throwIfAborted();
+            this.modelPresentation.remember(catalog);
+            const resolved = this.modelPresentation.resolve(provider, id);
+            if (!resolved)
+                throw new LlmError('所选模型当前不可用，请打开模型菜单重新选择。', 'MODEL_CATALOG_UNAVAILABLE');
+            return resolved;
+        }
+        finally {
+            catalog.release();
+        }
+    }
+    async prepareCall(provider, id, signal) {
+        try {
+            return { model: await this.resolveModel(provider, id, signal), stream: (options) => this.stream(options) };
+        }
+        catch (error) {
+            markModelPreparationFailure(provider, error, signal);
+            throw error;
+        }
+    }
     providerRetryPolicy() { return { mode: 'normal', maxRetries: 0, retryableCodes: [], initialDelayMs: 0, maxDelayMs: 0, jitterRatio: 0 }; }
     cleanupRuntime(runtime, cause = { layer: 'adapter', initiator: 'adapter.cleanup-runtime', reason: 'RUNTIME_CLEANUP', action: 'dispose' }) {
         runtime.closeDiagnostics?.record(cause);
@@ -665,12 +690,18 @@ export function apply(ctx, live) {
         }
         return managerForProfile().recordLoginFailure({ sessionId, code, diagnostic, context: { turn, step } });
     }, modelDirectory, preflightDiagnostics, dshPermissionSource(ctx));
-    for (const agent of AGENTS)
-        void adapter.listModels(agent.id).catch(() => ctx.logger('remote-agent').warn('模型列表暂不可用，打开菜单时可重新读取'));
     const ids = AGENTS.map(agent => agent.id);
     const entries = () => AGENTS.map(agent => ({ provider: agent.id, displayName: agent.name[language], settingsNs: actualSettingsNamespace ?? settingsNamespace, settingsPath: [] }));
     const directory = ctx.llm.registerConfigurableProviders(entries());
     const registration = ctx.llm.registerAdapter(ids, adapter);
+    let connection;
+    ctx.on('ai-workbench/connection-state', state => {
+        const previous = connection;
+        connection = state;
+        // Official replacement invalidates the browser's shared catalog and loads it.
+        if (state.phase === 'connected' && (previous?.phase !== 'connected' || previous.instanceId !== state.instanceId || previous.epoch !== state.epoch))
+            registration.replace(ids);
+    });
     installModelInputRetention(ctx, { isOurProvider: provider => ids.includes(provider), diagnosticForAttempt: position => preflightDiagnostics.forPreparation(position.sessionId, position), preflightDiagnostic: (provider, message) => diagnostic('preflight', provider, message), diagnostic: (provider, message) => diagnostic('input', provider, message) });
     const cleanup = async (id) => { try {
         await adapter.detachSession(id);

package/dist/presentation.d.ts

@@ -1,6 +1,5 @@
 /** Functional wording from connect-api appendix D1-D3 (L0.5.1 candidate). */
 export declare const REMOTE_CODEX_NAME = "Codex\uFF08\u8FDC\u7A0B\u4E3B\u673A\uFF09";
 export declare const CONNECTION_REQUIRED = "\u8FDC\u7A0B\u4E3B\u673A\u8FDE\u63A5\u7EC4\u4EF6\u6CA1\u6709\u88C5\u597D\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002";
-export declare const TEST_HOST_NOTICE = "\u8FDC\u7A0B\u4E3B\u673A\u6B63\u5728\u4F7F\u7528\u6D4B\u8BD5\u914D\u7F6E\uFF0C\u9047\u5230\u95EE\u9898\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002";
 /** Employee failures use business language; diagnostic codes remain separately available. */
 export declare function employeeFailure(code: string, brand?: 'codex' | 'claude'): string;

package/dist/presentation.js

@@ -1,7 +1,6 @@
 /** Functional wording from connect-api appendix D1-D3 (L0.5.1 candidate). */
 export const REMOTE_CODEX_NAME = 'Codex（远程主机）';
 export const CONNECTION_REQUIRED = '远程主机连接组件没有装好，请联系管理员。';
-export const TEST_HOST_NOTICE = '远程主机正在使用测试配置，遇到问题请联系管理员。';
 /** Employee failures use business language; diagnostic codes remain separately available. */
 export function employeeFailure(code, brand = 'codex') {
     const messages = {

package/dist/provider.d.ts

@@ -89,18 +89,6 @@ export type RuntimeProvider = ((request: RuntimeRequest) => Promise<Runtime>) &
     preflight?: (request: RuntimeRequest) => Promise<void>;
 };
 export interface ConnectTarget {
-    hostContext?: {
-        enforcement: 'production' | 'test';
-        checkExitCode: 0 | 1;
-        failedChecks: {
-            id: string;
-            status: string;
-        }[];
-        unverifiedChecks: {
-            id: string;
-            status: string;
-        }[];
-    };
     host: string;
     username: string;
     port: number;
@@ -165,8 +153,6 @@ declare module '@deepseek-ai/cordis' {
 export declare function awaitL<T>(operation: () => Promise<T>, signal?: AbortSignal): Promise<T>;
 export declare function unwrap<T>(result: Result<T>): T;
 export declare function validateTarget(t: ConnectTarget): void;
-/** Only the declared public check identifiers/statuses, never provider evidence. */
-export declare function hostContextNotice(t: ConnectTarget): string | undefined;
 export declare function identity(t: ConnectTarget): string;
 /** Reject draft.3 and legacy runtime rather than inventing workspace bindings. */
 export declare function requireNativeWorkspace(api: ConnectApi): asserts api is ConnectApi & NativeWorkspaceApi;

package/dist/provider.js

@@ -2,7 +2,7 @@ import { hostWorkspaceGuard } from "./host-workspace.js";
 import { connectNeedError } from "./connect-need.js";
 import { loginDiagnostic, loginReason } from "./login-diagnostic.js";
 import { NeedError } from "./remote.js";
-import { CONNECTION_REQUIRED, TEST_HOST_NOTICE } from "./presentation.js";
+import { CONNECTION_REQUIRED } from "./presentation.js";
 import { CODEX_AGENT } from "./agents.js";
 export function requireLoginCoordinator(api) {
     if (!['getConnectionState', 'getLoginPromptState', 'requestLoginPrompt', 'refreshLoginPrompts'].every(key => typeof api[key] === 'function'))
@@ -118,19 +118,6 @@ export function validateTarget(t) {
         || ![t.projectRoot, t.session.command, t.session.root, t.session.settingsPath].every(p => typeof p === 'string' && p.startsWith('/'))) {
         throw new NeedError('CONNECT_API_MISMATCH', '我需要 connect-api 0.3.0 的可信主机、项目和 session 能力；旧目标不能继续使用', 'L 提供的完整 0.3.0 目标');
     }
-    hostContextNotice(t);
-}
-/** Only the declared public check identifiers/statuses, never provider evidence. */
-export function hostContextNotice(t) {
-    const h = t.hostContext;
-    if (h === undefined)
-        return;
-    const checks = (items) => Array.isArray(items) && items.every(item => item && typeof item.id === 'string' && typeof item.status === 'string');
-    if (!h || (h.enforcement !== 'test' && h.enforcement !== 'production') || (h.checkExitCode !== 0 && h.checkExitCode !== 1) || !checks(h.failedChecks) || !checks(h.unverifiedChecks))
-        throw new NeedError('CONNECT_API_MISMATCH', '主机检查背景无效，不能假定已通过生产检查', 'L 提供的有效 hostContext');
-    if (h.enforcement !== 'test')
-        return;
-    return TEST_HOST_NOTICE;
 }
 export function identity(t) { return `${t.username}@${t.host}:${t.port}`; }
 /** Reject draft.3 and legacy runtime rather than inventing workspace bindings. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-workbench/remote-agent",
-  "version": "0.8.23",
+  "version": "0.8.24",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",