dsh-plugin-bridge 0.3.0 → 0.3.2

package/lib/dsh-alpha-host.js

@@ -0,0 +1,276 @@
+/**
+ * DSH v0.1.2 alpha typed-controller adapter.
+ *
+ * The alpha removed the legacy ApiProxy service.  Keep that product change at
+ * this boundary: migration code continues to consume BridgeHost, while this
+ * adapter talks to the Host controllers structurally so the package can still
+ * be built against the current rc.2 SDK.
+ */
+import { randomUUID } from 'node:crypto';
+import { createApiProxyHost, probeApiProxy } from './api-rpc.js';
+import { REQUIRED_BRIDGE_CAPABILITIES, } from './host.js';
+import { RpcError } from './rpc.js';
+const ALPHA_METHODS = {
+    'session.list': services => services.sessionController?.list,
+    'session.create': services => services.sessionController?.create,
+    'session.history': services => services.sessionController?.inspect,
+    'session.models': services => services.sessionController?.modelCatalog,
+    'session.selectModel': services => services.sessionController?.selectModel,
+    'session.prompt': services => services.sessionController?.prompt,
+    'session.cancel': services => services.sessionController?.cancel,
+    'session.rename': services => services.sessionController?.rename,
+    'workspace.list': services => services.workspaceRegistry?.list,
+    'workspace.archiveSession': services => services.workspaceController?.archiveSession,
+    'agentPreset.list': services => services.agentPresets?.remoteExportList,
+    'goal.create': services => services.goals?.remoteExportCreate,
+    'goal.pause': services => services.goals?.pause,
+};
+function service(ctx, name) {
+    try {
+        const getter = ctx.get;
+        if (typeof getter === 'function') {
+            const found = getter.call(ctx, name);
+            if (found !== undefined)
+                return found;
+        }
+    }
+    catch {
+        // Cordis returns undefined for an unavailable optional service; custom
+        // Context implementations may throw instead, so fall through to fixtures.
+    }
+    try {
+        return ctx[name];
+    }
+    catch {
+        return undefined;
+    }
+}
+function servicesOf(ctx) {
+    return {
+        apiProxy: service(ctx, 'apiProxy'),
+        sessionController: service(ctx, 'sessionController'),
+        workspaceRegistry: service(ctx, 'workspaceRegistry'),
+        workspaceController: service(ctx, 'workspaceController'),
+        agentPresets: service(ctx, 'agentPresets'),
+        goals: service(ctx, 'goals'),
+    };
+}
+function failureOf(error) {
+    const value = error;
+    return value?.failure ?? value?.rpc ?? {
+        code: value?.code,
+        message: value?.message,
+        details: value?.details,
+    };
+}
+async function invoke(method, operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        if (error instanceof RpcError)
+            throw error;
+        const failure = failureOf(error);
+        throw new RpcError(method, failure.code ?? 'internal', failure.message ?? (error instanceof Error ? error.message : String(error)), failure.details);
+    }
+}
+function required(method, value) {
+    if (value === undefined)
+        throw new RpcError(method, 'unavailable', `DSH alpha host 没有提供 ${method}`);
+    return value;
+}
+function projectionValues(row) {
+    const values = row?.projections?.values;
+    return values !== null && typeof values === 'object' ? values : {};
+}
+function sessionRow(row) {
+    const source = row;
+    const values = projectionValues(row);
+    const preset = typeof values.agentPreset === 'string'
+        ? values.agentPreset
+        : typeof source.agentPreset === 'string' ? source.agentPreset : undefined;
+    return {
+        sessionId: String(source.sessionId ?? ''),
+        ...(typeof source.running === 'boolean' ? { running: source.running } : {}),
+        ...(typeof source.blank === 'boolean' ? { blank: source.blank } : {}),
+        ...(typeof source.cwd === 'string' ? { cwd: source.cwd } : {}),
+        ...(preset === undefined ? {} : { agentPreset: preset }),
+        ...(typeof source.parentSessionId === 'string' ? { parentSessionId: source.parentSessionId } : {}),
+        ...Object.keys(values).length === 0 ? {} : { projections: { values } },
+    };
+}
+function currentModel(row) {
+    const selection = projectionValues(row).modelSelection;
+    if (selection === null || typeof selection !== 'object')
+        return undefined;
+    const record = selection;
+    const candidate = record.next ?? record.lastUsed;
+    if (candidate === null || typeof candidate !== 'object')
+        return undefined;
+    const model = candidate;
+    if (typeof model.provider !== 'string' || typeof model.model !== 'string')
+        return undefined;
+    return {
+        provider: model.provider,
+        model: model.model,
+        ...(typeof model.reasoningEffort === 'string' ? { reasoningEffort: model.reasoningEffort } : {}),
+    };
+}
+function paginateHistory(events, beforeSeq, maxMessages) {
+    const visible = beforeSeq === undefined ? [...events] : events.filter(event => (event.seq ?? -1) < beforeSeq);
+    let count = 0;
+    let cut = 0;
+    for (let index = visible.length - 1; index >= 0; index -= 1) {
+        const type = visible[index]?.type;
+        if (type !== 'user/message' && type !== 'assistant/message')
+            continue;
+        count += 1;
+        if (count >= maxMessages) {
+            cut = index;
+            break;
+        }
+    }
+    return {
+        events: visible.slice(cut).map(event => ({ event })),
+        hasMore: cut > 0,
+    };
+}
+async function resolvedAgent(services, sessionId) {
+    const resolve = required('session.resolveAgent', services.sessionController?.resolveAgent);
+    const result = await invoke('session.resolveAgent', () => resolve.call(services.sessionController, sessionId));
+    if (result.error !== undefined) {
+        throw new RpcError('session.resolveAgent', result.error.code ?? 'internal', result.error.message ?? 'DSH alpha 无法恢复目标会话', result.error.details);
+    }
+    return required('session.resolveAgent', result.agent);
+}
+/** Probe the real alpha services instead of the adapter's always-present closures. */
+export function probeDshAlphaHost(input) {
+    const services = servicesOf(input);
+    return REQUIRED_BRIDGE_CAPABILITIES.map(method => ({
+        method,
+        available: typeof ALPHA_METHODS[method]?.(services) === 'function',
+    }));
+}
+/** Create the semantic BridgeHost over DSH v0.1.2 typed Host controllers. */
+export function createDshAlphaHost(input, signal) {
+    const services = servicesOf(input);
+    const controller = services.sessionController;
+    const abort = signal ?? new AbortController().signal;
+    const host = {
+        descriptor: Object.freeze({ id: 'dsh-typed-controllers', version: '0.1.2-alpha', transport: 'in-process' }),
+        sessions: Object.freeze({
+            list: async (request = {}) => {
+                const list = required('session.list', controller?.list);
+                const value = await invoke('session.list', () => list.call(controller, request, abort));
+                return { items: (value.items ?? []).map(sessionRow) };
+            },
+            create: async (request) => {
+                const create = required('session.create', controller?.create);
+                return await invoke('session.create', () => create.call(controller, request));
+            },
+            history: async (request) => {
+                const inspect = required('session.history', controller?.inspect);
+                const value = await invoke('session.history', () => inspect.call(controller, request.sessionId, abort));
+                return paginateHistory(value.events, request.beforeSeq, request.maxMessages ?? 60);
+            },
+            models: async ({ sessionId }) => {
+                const list = required('session.list', controller?.list);
+                const catalog = required('session.models', controller?.modelCatalog);
+                const [listed, available] = await Promise.all([
+                    invoke('session.list', () => list.call(controller, {}, abort)),
+                    invoke('session.models', () => catalog.call(controller)),
+                ]);
+                const row = (listed.items ?? []).find(item => item.sessionId === sessionId);
+                return {
+                    ...available,
+                    current: currentModel(row) ?? available.default,
+                };
+            },
+            selectModel: request => {
+                const select = required('session.selectModel', controller?.selectModel);
+                return invoke('session.selectModel', () => select.call(controller, { ...request }));
+            },
+            prompt: request => {
+                const prompt = required('session.prompt', controller?.prompt);
+                return invoke('session.prompt', () => prompt.call(controller, {
+                    ...request,
+                    requestId: `bridge-${randomUUID()}`,
+                }, abort));
+            },
+            cancel: request => {
+                const cancel = required('session.cancel', controller?.cancel);
+                return invoke('session.cancel', () => cancel.call(controller, request));
+            },
+            rename: request => {
+                const rename = required('session.rename', controller?.rename);
+                return invoke('session.rename', () => rename.call(controller, request));
+            },
+            attachment: request => {
+                const attachment = required('session.attachment', controller?.attachment);
+                return invoke('session.attachment', () => attachment.call(controller, request));
+            },
+        }),
+        workspaces: Object.freeze({
+            list: async () => {
+                const list = required('workspace.list', services.workspaceRegistry?.list);
+                const rows = await invoke('workspace.list', () => list.call(services.workspaceRegistry));
+                return {
+                    items: rows.map((item) => {
+                        const row = item;
+                        return {
+                            workspaceId: String(row.id ?? row.workspaceId ?? ''),
+                            sessionIds: Array.isArray(row.sessionIds) ? row.sessionIds.map(String) : [],
+                        };
+                    }),
+                };
+            },
+            archiveSession: request => {
+                const archive = required('workspace.archiveSession', services.workspaceController?.archiveSession);
+                return invoke('workspace.archiveSession', () => archive.call(services.workspaceController, request));
+            },
+        }),
+        presets: Object.freeze({
+            list: async () => {
+                const list = required('agentPreset.list', services.agentPresets?.remoteExportList);
+                return await invoke('agentPreset.list', () => list.call(services.agentPresets));
+            },
+        }),
+        goals: Object.freeze({
+            create: async (request) => {
+                const agent = await resolvedAgent(services, request.sessionId);
+                const create = required('goal.create', services.goals?.remoteExportCreate);
+                return await invoke('goal.create', () => create.call(services.goals, agent, {
+                    objective: request.objective,
+                    maxGoalRounds: request.maxGoalRounds,
+                }));
+            },
+            pause: async (request) => {
+                const agent = await resolvedAgent(services, request.sessionId);
+                const pause = required('goal.pause', services.goals?.pause);
+                return await invoke('goal.pause', () => pause.call(services.goals, agent, request.ref));
+            },
+            clear: async (request) => {
+                const agent = await resolvedAgent(services, request.sessionId);
+                const clear = required('goal.clear', services.goals?.clear);
+                return await invoke('goal.clear', () => clear.call(services.goals, agent, request.ref));
+            },
+        }),
+    };
+    return Object.freeze(host);
+}
+/** Prefer the stable rc.2 path when present; otherwise use alpha controllers. */
+export function resolveDshHost(input, signal) {
+    const services = servicesOf(input);
+    if (services.apiProxy !== undefined)
+        return createApiProxyHost(services.apiProxy, signal);
+    if (services.sessionController !== undefined)
+        return createDshAlphaHost(services, signal);
+    throw new RpcError('bridge.host', 'unavailable', '当前 DSH 没有可用的 apiProxy 或 typed sessionController');
+}
+/** Probe the active generation using its native surface. */
+export function probeDshHost(input) {
+    const services = servicesOf(input);
+    if (services.apiProxy !== undefined)
+        return probeApiProxy(services.apiProxy);
+    return probeDshAlphaHost(services);
+}

package/lib/index.d.ts

@@ -2,9 +2,8 @@ import type { Context } from '@deepseek-ai/cordis';
 import Schema from '@deepseek-ai/schemastery';
 export declare const name = "dsh-plugin-bridge";
 /**
- * `commands` 是入口，`apiProxy` 是引擎——两个都是硬依赖：
- * 缺哪个这个插件都无事可做，与其静默半挂，不如让 cordis 挂起等待。
- * 两者在官方 `web` profile 里都在（base 挂 commands，web-app 挂 api-gateway）。
+ * `commands` 是跨版本入口，唯一硬依赖。执行时优先使用 rc.2 的 `apiProxy`，
+ * alpha 则改走 typed controllers；doctor 探测实际选中的那一面并 fail closed。
  */
 export declare const inject: string[];
 export interface Config {

package/lib/index.js

@@ -13,16 +13,15 @@ import { mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import Schema from '@deepseek-ai/schemastery';
-import { createApiProxyHost, probeApiProxy } from './api-rpc.js';
 import { createBridgeCommand } from './command.js';
 import { SOURCE_CHAR_BUDGET, SUMMARY_CHAR_BUDGET } from './compression.js';
+import { probeDshHost, resolveDshHost } from './dsh-alpha-host.js';
 export const name = 'dsh-plugin-bridge';
 /**
- * `commands` 是入口，`apiProxy` 是引擎——两个都是硬依赖：
- * 缺哪个这个插件都无事可做，与其静默半挂，不如让 cordis 挂起等待。
- * 两者在官方 `web` profile 里都在（base 挂 commands，web-app 挂 api-gateway）。
+ * `commands` 是跨版本入口，唯一硬依赖。执行时优先使用 rc.2 的 `apiProxy`，
+ * alpha 则改走 typed controllers；doctor 探测实际选中的那一面并 fail closed。
  */
-export const inject = ['commands', 'apiProxy'];
+export const inject = ['commands'];
 /** 命令是同步返回的，等压缩工人不能等太久。 */
 const DEFAULT_PREVIEW_TIMEOUT_MS = 180_000;
 export const Config = Schema.object({
@@ -63,10 +62,9 @@ export function commandConfigOf(config = {}) {
     };
 }
 export function apply(ctx, config = {}) {
-    const apiProxyOf = () => ctx.apiProxy;
     const command = createBridgeCommand({
-        hostFor: (signal) => createApiProxyHost(apiProxyOf(), signal),
-        probe: () => probeApiProxy(apiProxyOf()),
+        hostFor: (signal) => resolveDshHost(ctx, signal),
+        probe: () => probeDshHost(ctx),
         config: commandConfigOf(config),
         writeSummary: writeSummaryFile,
         readSummary: (path) => readFileSync(path, 'utf8'),

package/lib/migrate.d.ts

@@ -31,6 +31,8 @@ export declare function findSession(host: BridgeHostInput, sessionId: string): P
 export declare function findWorkspaceId(input: BridgeHostInput, sessionId: string): Promise<string | undefined>;
 /** 可作为迁移目标的 preset（去掉 broken 的）。 */
 export declare function listPresets(input: BridgeHostInput): Promise<PresetRow[]>;
+/** Map the one upstream internal rename without making either generation mandatory. */
+export declare function resolvePresetTarget(requested: string, presets: readonly PresetRow[]): string;
 /**
  * 选压缩工人的模型。
  *

package/lib/migrate.js

@@ -50,6 +50,16 @@ export async function listPresets(input) {
     const res = await host.presets.list();
     return (res.presets ?? []).filter((preset) => preset.broken === undefined);
 }
+/** Map the one upstream internal rename without making either generation mandatory. */
+export function resolvePresetTarget(requested, presets) {
+    if (presets.some(preset => preset.id === requested))
+        return requested;
+    if (requested === 'code' && presets.some(preset => preset.id === 'ptc'))
+        return 'ptc';
+    if (requested === 'ptc' && presets.some(preset => preset.id === 'code'))
+        return 'code';
+    return requested;
+}
 /** 新会话的落点：优先同工作区，否则同 cwd，再否则交给 host 默认。 */
 async function placement(host, source, sessionId) {
     const workspaceId = await findWorkspaceId(host, sessionId).catch(() => undefined);
@@ -278,7 +288,7 @@ function imageFallbackAllowed(error) {
         return false;
     if (error.code === 'unavailable' || error.code === 'empty-image')
         return true;
-    if (error.code !== 'attachment-error')
+    if (error.code !== 'attachment-error' && error.code !== 'session/attachment-invalid')
         return false;
     const reason = error.details && typeof error.details === 'object' && 'reason' in error.details
         ? String(error.details.reason)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-bridge",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Previewable cross-preset session migration for DeepSeek Harness with bounded, fixed-schema handoffs",
   "type": "module",
   "main": "lib/index.js",
@@ -13,6 +13,7 @@
     "reports/v0.2.6-rc11-vision-report.md",
     "reports/native-workbench-2026-08-25.md",
     "reports/native-workbench-2026-08-25.raw.json",
+    "reports/dsh-0.1.2-alpha.2-compat-2026-08-31.md",
     "cordis.patch.yml",
     "README.md",
     "README.zh.md"
@@ -48,8 +49,8 @@
     "client": {
       "inject": [
         "@deepseek-ai/dsh-api-remotes",
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-conversation"
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-chat"
       ],
       "platform": "web"
     }
@@ -59,16 +60,17 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.7 || ^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7 || ^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7 || ^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7 || ^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7 || ^0.1.1-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": { "optional": true },
     "@deepseek-ai/dsh-api-remotes": { "optional": true },
-    "@deepseek-ai/dsh-client-runtime": { "optional": true },
+    "@deepseek-ai/dsh-client-ui-chat": { "optional": true },
     "@deepseek-ai/dsh-client-ui-conversation": { "optional": true },
     "@deepseek-ai/dsh-client-ui-primitives": { "optional": true },
     "@deepseek-ai/dsh-client-ui-slots": { "optional": true },
@@ -78,12 +80,15 @@
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
     "@types/node": "^26.2.0",
     "@types/react": "~18.3.1",
     "react": "^18.3.1",

package/reports/dsh-0.1.2-alpha.2-compat-2026-08-31.md

@@ -0,0 +1,64 @@
+# DSH 0.1.2-alpha.2 compatibility validation
+
+Date: 2026-08-31 (Asia/Shanghai)
+
+## Scope
+
+- Official host: `@deepseek-ai/dsh@0.1.2-alpha.2` from the npm registry
+- Upstream tag: `dsh-v0.1.2-alpha.2`
+- Upstream commit: `0a53fb55bea101816fa226bb964ae2bed71c343b`
+- Bridge branch: `codex/dsh-alpha2-compat`
+- Packed Bridge SHA-256: `4170fc548ad4c9f77d70bc9e47cef92da849b4fa608a6b7cf323f4ad972cb085`
+- All profiles, credentials copied for the run, sessions, packages, and browser state were isolated from the ordinary DSH home.
+
+## Compatibility changes covered
+
+- Accept alpha.2's `session/attachment-invalid` image rejection while retaining rc.2's `attachment-error` behavior.
+- Remove the alpha-deleted `@deepseek-ai/dsh-client-runtime` peer, development import, and bundler external.
+- Build against the split alpha.2 client contracts: API remotes/session controller, Chat command-row slot, renderer, Session UI, primitives, and slots.
+- Provide alpha.2's required localized labels to `MarkdownText` and `JsonTree`.
+- Add `ui-chat` to client injection so the package that owns `conversation.chat.commandview` is explicit rather than assumed from the official Web profile.
+- Treat Cordis as a host-provided optional peer while retaining its supported version range.
+
+## Automated evidence
+
+- Focused old/new image fallback tests passed.
+- Alpha manifest and split-client contract tests passed.
+- `npm run verify` passed build, typecheck, 167 tests, generated-lib drift, dataset checks, and packed-package smoke installation.
+- Source coverage: 93.58% lines, 78.10% branches, and 88.24% functions.
+
+## Official npm install evidence
+
+- The clean runtime reported DSH `0.1.2-alpha.2`.
+- Plugin add completed without a peer warning after the Cordis metadata correction.
+- `pnpm peers check`: no peer dependency issues.
+- The profile contained the Bridge dependency and bundle layer, and `node_modules/dsh-plugin-bridge` resolved.
+
+## Real WebUI evidence
+
+- Native `/bridge --doctor`: `dsh-typed-controllers`, 13/13 required methods.
+- `code` resolved to the official `ptc` preset.
+- Preview preserved `ORBIT-A2-731`, port `7643`, `PostgreSQL`, `src/alpha.ts`, and the `MongoDB` prohibition.
+- Preview, Text, and Markdown modes rendered. A Next-step edit in Text mode was the exact Next step delivered to the target.
+- At 1200x853 the card panel scrolled internally; toolbar and confirmation actions stayed outside it; the document had no overflow.
+- Confirm automatically opened the target under the official PTC mode.
+- The target restated all five facts and stopped for confirmation.
+- The target goal was visibly paused and contained the reviewed summary.
+- The original source remained separately selectable and retained its original model conversation.
+
+The run used three authorized model requests: source seed, preview worker, and target restatement.
+
+## Removal evidence
+
+After `dsh plugin --profile web remove dsh-plugin-bridge` and a WebUI restart:
+
+- the profile dependency was absent;
+- the bundle list contained only the official base and Web app;
+- the Bridge package was absent from profile `node_modules` and lock/profile text;
+- the browser loaded no Bridge client asset and contained zero `.dsh-bridge-card` nodes;
+- the fresh browser console contained zero errors;
+- historical command outcomes remained readable through the official generic command renderer.
+
+## Known boundary
+
+This run did not repeat a live raw-image/VLM transfer. Alpha.2's namespaced text-model image rejection is covered by deterministic migration regression tests; the earlier rc.2 vision report remains the live attachment-transfer evidence. Installation and removal still require one WebUI restart.