@jingyi0605/codingns4dsh 0.2.0-rc.2 → 0.2.0-rc.3

package/data/build/dist/host/cli-adapters/feature.js

@@ -8,6 +8,11 @@ import { GrokBuildDriver } from './grok-driver.js';
 import { OpenCodeDriver } from './opencode-driver.js';
 import { MiniMaxCodeDriver } from './mcode-driver.js';
 import { ZcodeAppServerDriver } from './zcode-driver.js';
+import { CodeBuddyCliDriver, WorkBuddyCliDriver } from './codebuddy-driver.js';
+import { CursorCliDriver } from './cursor-driver.js';
+import { KiroCliDriver } from './kiro-driver.js';
+import { QoderCliDriver } from './qoder-driver.js';
+import { AntigravityDriver } from './antigravity-driver.js';
 import { CodingNsCliAdapterRegistry } from './registry.js';
 import { CodingNsCliSessionStore } from './session-store.js';
 import { CodingNsDshMessageProjector } from './dsh-message-projector.js';
@@ -20,6 +25,10 @@ import { dispatchBridgeSubagent } from '../cli-bridge/dispatch.js';
 import { startSubagentBridgeServer } from '../cli-bridge/bridge-server.js';
 import { setSubagentBridge } from '../cli-bridge/bridge-holder.js';
 import { delegateCapability, dispatchDelegateSubagent } from './delegate-dispatch.js';
+import { setMaxNativeSubagentsPerParent } from './native-subagent-dispatch.js';
+import { containsDelegationCarrier, rewriteDelegationMessages } from './delegation-mention-rewrite.js';
+import { clearDelegationAuthorization, setDelegationAuthorization } from './delegation-authorization.js';
+import { debugInfo } from '../../shared/debug.js';
 export function createCliAdaptersFeature(options = {}) {
     return {
         descriptor: {
@@ -45,7 +54,7 @@ export function createCliAdaptersFeature(options = {}) {
             if (nativeSessions !== undefined) {
                 const migration = sessionStore.migrateLegacySessions(expandMigrationChain(nativeSessions, nativeSessions.list()));
                 if (migration.migrated > 0 || migration.unresolved > 0) {
-                    console.info('codingns4dsh: 旧外部会话适配器迁移完成', migration);
+                    debugInfo('codingns4dsh: 旧外部会话适配器迁移完成', migration);
                 }
             }
             const registry = options.registry ?? new CodingNsCliAdapterRegistry([
@@ -59,6 +68,13 @@ export function createCliAdaptersFeature(options = {}) {
                 new GrokBuildDriver(),
                 new MiniMaxCodeDriver(),
                 new ZcodeAppServerDriver(),
+                new CodeBuddyCliDriver(),
+                new WorkBuddyCliDriver(),
+                new CursorCliDriver(),
+                new KiroCliDriver(),
+                new QoderCliDriver(),
+                new QoderCliDriver({ variant: 'qoder-cn' }),
+                new AntigravityDriver(),
             ], context.services.settings?.get().agentAdapters, {
                 sessionStore,
                 ...(context.services.settings === undefined ? {} : { settings: context.services.settings }),
@@ -102,10 +118,14 @@ export function createCliAdaptersFeature(options = {}) {
                 });
                 context.resources.add(disposeNativeEvents);
             }
+            registerDelegationAgentHooks(context.services.dshContext, registry, context.resources);
             context.resources.add(context.services.rpc.register('cli', (action, payload) => {
                 switch (action) {
                     case 'catalog': return registry.catalog();
-                    case 'models': return registry.models(readAdapterId(payload));
+                    case 'models': {
+                        const adapterId = readAdapterId(payload);
+                        return adapterId === 'dsh' ? readDshModelCatalog(context.services.dshContext) : registry.models(adapterId);
+                    }
                     case 'adapter/set': return setAdapterEnabled(context.services.settings, registry, payload);
                     case 'session/get': return registry.getSession(readSessionId(payload));
                     case 'session/set': return registry.setSession(readSessionId(payload), readSessionConfig(payload));
@@ -189,7 +209,16 @@ export function createCliAdaptersFeature(options = {}) {
             const scheduleSubagentBridgeSync = (enabled) => {
                 bridgeSync = bridgeSync.then(() => syncSubagentBridge(enabled), () => syncSubagentBridge(enabled));
             };
-            await syncSubagentBridge(normalizeSubagentBridgeSettings(context.services.settings?.get().subagentBridge).enabled);
+            const syncSubagentBridgeSettings = (raw) => {
+                const bridgeSettings = normalizeSubagentBridgeSettings(raw);
+                // 并发上限先于桥接启停生效：桥接开启后立刻到达的并行调用必须看到用户配置，
+                // 否则第一批派发仍会撞上缺省上限。
+                setMaxNativeSubagentsPerParent(bridgeSettings.maxConcurrentSubagents);
+                scheduleSubagentBridgeSync(bridgeSettings.enabled);
+            };
+            // 初始值必须在任何派发之前落地：桥接开启后第一批并行调用就会读取上限。
+            syncSubagentBridgeSettings(context.services.settings?.get().subagentBridge);
+            await bridgeSync;
             context.resources.add(async () => {
                 const server = bridgeServer;
                 bridgeServer = undefined;
@@ -204,7 +233,7 @@ export function createCliAdaptersFeature(options = {}) {
                     registry.syncPreferences(next.agentAdapterPreferences);
                     sessionStore.sync(next.cliSessions);
                     subscriptions = buildSubscriptions(next);
-                    scheduleSubagentBridgeSync(normalizeSubagentBridgeSettings(next.subagentBridge).enabled);
+                    syncSubagentBridgeSettings(next.subagentBridge);
                 }));
             }
             const events = context.services.events;
@@ -231,7 +260,26 @@ export function createCliAdaptersFeature(options = {}) {
                     // 被恢复成 dsh，但 provider 已明确指向外部 Agent；继续旁路会让
                     // 第二轮直接落入 DSH 空流，并丢失外部驱动的 usage/context 修正。
                     const dshSelection = readDshSelection(value);
-                    const messages = Array.isArray(value?.messages) ? value.messages.filter(isMessage) : [];
+                    let messages = Array.isArray(value?.messages) ? value.messages.filter(isMessage) : [];
+                    // 委派 carrier 只在普通对话提交时消费。选择 Agent 本身不会经过这里，也不会创建
+                    // 子会话；Agent Loop 请求会在 agent/pre-step 边界完成改写。这里仅保留
+                    // 非 Agent Loop 手工 llm/stream 调用的错误消费和外部 Agent 局部解析。
+                    if (containsDelegationCarrier(messages)) {
+                        const delegation = rewriteDelegationMessages(messages, await registry.catalog());
+                        if (delegation.kind === 'error') {
+                            yield* delegationErrorStream(`${delegation.error.code}: ${delegation.error.message}`);
+                            return;
+                        }
+                        if (delegation.kind === 'rewritten') {
+                            // DSH Agent Loop 传入的 options 是深冻结对象，不能把改写结果写回
+                            // `value.messages`。外部适配器只消费本地快照，原生 Agent 的 carrier
+                            // 已在 agent/pre-step 中被替换并持久化。
+                            setDelegationAuthorization(sessionId, delegation.value.targets);
+                            messages = [...delegation.value.messages];
+                        }
+                    }
+                    else if (sessionId !== '')
+                        clearDelegationAuthorization(sessionId);
                     const selectedExternalAdapter = selectExternalAdapter(dshSelection.providerId, inferMessageAdapter(messages), registry);
                     // DSH 的 modelSelection 只描述 DSH 自己那条模型路由（例如 glor/deepseek）。
                     // 只有它明确指向即将接管的外部适配器时，model/effort 才属于该适配器；
@@ -264,6 +312,8 @@ export function createCliAdaptersFeature(options = {}) {
                     }
                     const cwd = resolveSessionCwd(context.services.nativeSessions, sessionId, value);
                     const turnInput = extractTurnInput(messages, context.services.dshContext);
+                    const turnOptions = readCliTurnOptions(value);
+                    const runtimeEnv = readCliRuntimeEnv(value);
                     // 权限状态必须与 DSH 会话当前生效值同源。驱动不能自行假设“完全权限”，
                     // 也不能把缺省当成“已确认无限制”：解析失败时留空，由驱动沿用保守默认。
                     const permission = resolveSessionPermission(context.services.dshContext, sessionId);
@@ -273,17 +323,22 @@ export function createCliAdaptersFeature(options = {}) {
                     // 条 usage 到达前失去投影。
                     const input = {
                         sessionId,
-                        messages,
+                        messages: turnInput.messages,
                         prompt: turnInput.prompt,
                         ...(turnInput.attachments.length === 0 ? {} : { attachments: turnInput.attachments }),
                         ...(permission === undefined ? {} : { permission }),
+                        ...(turnOptions.plan === true ? { plan: true } : {}),
+                        ...(turnOptions.forkSession === true ? { forkSession: true } : {}),
+                        ...(turnOptions.enableAskUserQuestion === true ? { enableAskUserQuestion: true } : {}),
+                        ...(runtimeEnv === undefined ? {} : { runtimeEnv }),
                         ...(config.modelId ? { modelId: config.modelId } : {}),
                         ...(config.effortId ? { effortId: config.effortId } : {}),
+                        ...(config.serviceTierId ? { serviceTierId: config.serviceTierId } : {}),
                         ...(config.providerSessionId ? { providerSessionId: config.providerSessionId } : {}),
                         ...(config.rawStoreRef ? { rawStoreRef: config.rawStoreRef } : {}),
                         ...(cwd === undefined ? {} : { cwd }),
                         ...(isAbortSignal(value?.signal) ? { signal: value.signal } : {}),
-                        ...(registry.supportsSegmentedTurns(config.adapterId)
+                        ...((registry.supportsSegmentedTurns(config.adapterId) || registry.supportsToolStepSplitting(config.adapterId))
                             && nativeSessions?.available === true
                             && nativeSessions.injectNextStep !== undefined
                             && (nativeSessions.canInjectNextStep === undefined
@@ -304,6 +359,10 @@ export function createCliAdaptersFeature(options = {}) {
                     input.signal?.addEventListener('abort', discardSuspendedTurn, { once: true });
                     if (input.signal?.aborted)
                         discardSuspendedTurn();
+                    // DSH UI 的会话未读绿点由 api-session/status 的 true -> false 转换驱动。
+                    // 外部适配器绕过 DSH 原生 Agent Loop，必须在真正执行外部流前补发同一状态，
+                    // 否则外部子会话完成后虽已写入历史，侧栏却永远不会生成 completionUnread。
+                    publishExternalSessionStatus(context.services.events, sessionId, true);
                     try {
                         for await (const chunk of registry.execute({ ...input, adapterId: config.adapterId })) {
                             if (chunk.type === 'step-boundary') {
@@ -336,12 +395,20 @@ export function createCliAdaptersFeature(options = {}) {
                     }
                     finally {
                         input.signal?.removeEventListener('abort', discardSuspendedTurn);
+                        publishExternalSessionStatus(context.services.events, sessionId, false);
                     }
                 });
                 if (typeof dispose === 'function')
                     context.resources.add(() => { dispose(); });
             }
-            context.resources.add(async () => { await registry.dispose(); await sessionStore.flush(); setAdapterRegistry(undefined); });
+            context.resources.add(async () => {
+                // DSH 先停用设置上下文再执行异步资源清理时，旧的写队列不能继续调用
+                // configEditor，否则会出现 inactive context 并污染退出日志。
+                sessionStore.dispose();
+                await registry.dispose();
+                await sessionStore.flush();
+                setAdapterRegistry(undefined);
+            });
         },
     };
 }
@@ -350,6 +417,83 @@ function requireTeam(context) {
         throw new Error('DSH_TEAM_NATIVE_UNAVAILABLE');
     return context.services.nativeTeam;
 }
+/** 发布外部回合运行状态，让 DSH 原生 UI 能正确维护完成未读标记。 */
+function publishExternalSessionStatus(events, sessionId, running) {
+    if (sessionId.trim() === '' || events?.emit === undefined)
+        return;
+    try {
+        events.emit('api-session/status', sessionId, running);
+    }
+    catch {
+        // 状态提示是 UI 增强能力，不能因为精简 Host 没有完整事件转发器而阻断回合。
+    }
+}
+/**
+ * 在 Agent Loop 的可变输入边界消费委派 carrier。
+ *
+ * `llm/stream` 收到的 LOOP 请求由 DSH 深冻结，监听器只能读取；如果在那里改写
+ * `messages`，会直接抛出只读属性异常。`agent/pre-step` 返回新的决策消息，随后由
+ * Agent Loop 负责把改写后的内容写入当前会话并构造下一次只读 LLM 请求。
+ */
+function registerDelegationAgentHooks(dshContext, registry, resources) {
+    if (dshContext === undefined || typeof dshContext.on !== 'function')
+        return;
+    const disposers = [];
+    const register = (name, listener) => {
+        const disposer = dshContext.on(name, listener, { global: true });
+        if (typeof disposer === 'function')
+            disposers.push(disposer);
+    };
+    register('agent/pre-step', async (payload, next) => {
+        const record = asRecord(payload);
+        const sessionId = readAgentSessionId(record?.agent);
+        const messages = Array.isArray(record?.messages) ? record.messages.filter(isMessage) : [];
+        let delegation;
+        if (containsDelegationCarrier(messages)) {
+            delegation = rewriteDelegationMessages(messages, await registry.catalog());
+            if (delegation.kind === 'error')
+                clearDelegationAuthorization(sessionId);
+            else if (delegation.kind === 'rewritten') {
+                setDelegationAuthorization(sessionId, delegation.value.targets);
+            }
+        }
+        const decision = await next();
+        if (delegation?.kind !== 'rewritten' || !isEnterPreStepDecision(decision))
+            return decision;
+        // `next()` 可能已经追加系统上下文或模型切换通知，只替换它前面的本轮用户消息。
+        const suffix = decision.messages.slice(messages.length);
+        return {
+            ...decision,
+            messages: [...delegation.value.messages, ...suffix],
+        };
+    });
+    // 正常结束、异常结束和中断最终都会进入 idle；在此清理本轮授权，避免下一轮
+    // 没有 carrier 时继承上一轮的目标白名单。
+    register('agent/status', (payload) => {
+        const record = asRecord(payload);
+        if (record?.status === 'idle')
+            clearDelegationAuthorization(readAgentSessionId(record?.agent));
+    });
+    register('agent/disposed', (payload) => {
+        clearDelegationAuthorization(readAgentSessionId(asRecord(payload)?.agent));
+    });
+    resources.add(() => {
+        for (const dispose of disposers.reverse())
+            dispose();
+    });
+}
+function isEnterPreStepDecision(value) {
+    const record = asRecord(value);
+    return record?.kind === 'enter' && Array.isArray(record.messages);
+}
+function readAgentSessionId(value) {
+    const record = asRecord(value);
+    if (typeof record?.id === 'string' && record.id.trim() !== '')
+        return record.id.trim();
+    const session = asRecord(record?.session);
+    const header = asRecord(session?.header);
+    return typeof header?.id === 'string' ? header.id.trim() : '';
+}
 /** DSH Context 可能在测试或嵌入式宿主里缺少目标服务；缺失时按不可用处理。 */
 function readOptionalContextService(ctx, name) {
     if (ctx === undefined)
@@ -361,6 +505,49 @@ function readOptionalContextService(ctx, name) {
         return undefined;
     }
 }
+/** 将 DSH 原生 session/modelCatalog 归一化为委派选择器复用的模型目录契约。 */
+async function readDshModelCatalog(ctx) {
+    const controller = readOptionalContextService(ctx, 'sessionController');
+    if (isRecord(controller) && typeof controller.modelCatalog === 'function') {
+        try {
+            const raw = await controller.modelCatalog();
+            const record = asRecord(raw);
+            const groups = Array.isArray(record?.groups)
+                ? record.groups.flatMap((group) => normalizeDshModelGroup(group))
+                : [];
+            const defaultSelection = asRecord(record?.default);
+            const defaultModel = typeof defaultSelection?.model === 'string' && defaultSelection.model.trim() !== '' ? defaultSelection.model.trim() : null;
+            const defaultEffort = typeof defaultSelection?.reasoningEffort === 'string' && defaultSelection.reasoningEffort.trim() !== '' ? defaultSelection.reasoningEffort.trim() : null;
+            if (groups.length > 0)
+                return { groups, currentModel: defaultModel, currentEffort: defaultEffort };
+            if (defaultModel !== null)
+                return { groups: [{ id: 'dsh', name: 'DeepSeek Harness', models: [{ id: defaultModel, name: defaultModel, efforts: defaultEffort === null ? [] : [defaultEffort] }] }], currentModel: defaultModel, currentEffort: defaultEffort };
+        }
+        catch (error) {
+            debugInfo('codingns4dsh: DSH 模型目录读取失败', { error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    // 精简 Host 没有 sessionController 时仍给出稳定的“跟随 DSH 当前模型”选项，
+    // 这样 dsh 目标不会退化成无模型可选，实际请求继续沿用 DSH 当前路由。
+    return { groups: [{ id: 'dsh', name: 'DeepSeek Harness', models: [{ id: 'provider-default', name: '跟随 DSH 当前模型', efforts: [] }] }], currentModel: 'provider-default', currentEffort: null, fallback: true };
+}
+function normalizeDshModelGroup(value) {
+    const record = asRecord(value);
+    const id = typeof record?.id === 'string' && record.id.trim() !== '' ? record.id.trim() : 'dsh';
+    const name = typeof record?.name === 'string' && record.name.trim() !== '' ? record.name.trim() : id;
+    const models = Array.isArray(record?.models) ? record.models.flatMap((item) => {
+        const model = asRecord(item);
+        const modelId = typeof model?.id === 'string' ? model.id.trim() : '';
+        if (modelId === '')
+            return [];
+        const reasoning = asRecord(model?.reasoning);
+        const efforts = Array.isArray(reasoning?.efforts)
+            ? reasoning.efforts.flatMap((effort) => typeof asRecord(effort)?.id === 'string' ? [String(asRecord(effort)?.id)] : [])
+            : [];
+        return [{ id: modelId, name: typeof model?.name === 'string' && model.name.trim() !== '' ? model.name.trim() : modelId, ...(typeof model?.description === 'string' && model.description.trim() !== '' ? { description: model.description.trim() } : {}), efforts }];
+    }) : [];
+    return { id, name, models };
+}
 /**
  * DSH 原生 Provider 可能只返回一个 finish(stop)。不能把这个空回合当作成功，
  * 否则 Session 会落下一条空 assistant/message，用户只能看到“一秒结束”。
@@ -387,6 +574,13 @@ async function* guardDshNativeStream(next) {
     yield { type: 'block-end', index: 1, block: { type: 'text', text: message } };
     yield { type: 'finish', reason: { kind: 'error', failure: { message, code: 'PROVIDER_ERROR' } } };
 }
+/** carrier 解析失败也必须以可读的 DSH 错误事件结束当前轮次。 */
+async function* delegationErrorStream(message) {
+    yield { type: 'block-start', index: 1, blockType: 'text' };
+    yield { type: 'text-delta', index: 1, text: message };
+    yield { type: 'block-end', index: 1, block: { type: 'text', text: message } };
+    yield { type: 'finish', reason: { kind: 'error', failure: { message, code: 'DELEGATE_ERROR' } } };
+}
 function isDshFinishChunk(value) {
     const record = asRecord(value);
     return record?.type === 'finish';
@@ -437,9 +631,8 @@ function readDelegateRequest(value) {
     const record = asRecord(value);
     const sessionId = readSessionId(value);
     const adapterId = readAdapterId(value);
-    // 这里不能复用 readPrompt：它把空 prompt 当成非法参数直接抛错，而 `/委派` 允许任务
-    // 留空——popupSelect 打开时焦点在弹层，草稿里往往只剩 `/委派` 本身。留空交给派发内核
-    // 回退到会话最近一条人类消息，因此只做类型与去空白处理，空串原样传下去。
+    // 这里不能复用 readPrompt：旧 Client 可能仍传入空 prompt，空串要交给派发内核返回
+    // 结构化空任务错误；不得读取历史消息补齐任务。
     const rawPrompt = record?.prompt;
     if (rawPrompt !== undefined && typeof rawPrompt !== 'string')
         throw new Error('prompt 必须是字符串');
@@ -458,8 +651,12 @@ function readSessionConfig(value) {
         adapterId,
         ...(typeof record?.modelId === 'string' && record.modelId.trim() ? { modelId: record.modelId.trim() } : {}),
         ...(typeof record?.effortId === 'string' && record.effortId.trim() ? { effortId: record.effortId.trim() } : {}),
+        // `default` 是显式的“标准速度”选择，不能当作空值丢弃，否则关掉 Fast 会被
+        // Registry 回退成上一次记住的加速档。
+        ...(typeof record?.serviceTierId === 'string' && record.serviceTierId.trim() ? { serviceTierId: record.serviceTierId.trim() } : {}),
         ...(typeof record?.providerId === 'string' && record.providerId.trim() ? { providerId: record.providerId.trim() } : {}),
         ...(typeof record?.providerSessionId === 'string' && record.providerSessionId.trim() ? { providerSessionId: record.providerSessionId.trim() } : {}),
+        ...(typeof record?.rawStoreRef === 'string' && record.rawStoreRef.trim() ? { rawStoreRef: record.rawStoreRef.trim() } : {}),
     };
 }
 function readSessionListOptions(value) {
@@ -505,6 +702,33 @@ function readDshSelection(value) {
         ...(providerId === undefined ? {} : { providerId }),
     };
 }
+/** 读取 DSH/Host 明确下发给外部 CLI 的运行选项；缺省值不改变 Provider 行为。 */
+function readCliTurnOptions(value) {
+    const candidates = [
+        value,
+        asRecord(value?.options),
+        asRecord(value?.request),
+        asRecord(asRecord(value?.request)?.options),
+        asRecord(value?.config),
+    ];
+    const read = (keys) => candidates.some((candidate) => keys.some((key) => candidate?.[key] === true));
+    const plan = read(['plan']);
+    const forkSession = read(['forkSession', 'fork']);
+    const enableAskUserQuestion = read(['enableAskUserQuestion', 'askUserQuestion']);
+    return {
+        ...(plan ? { plan: true } : {}),
+        ...(forkSession ? { forkSession: true } : {}),
+        ...(enableAskUserQuestion ? { enableAskUserQuestion: true } : {}),
+    };
+}
+/** 父仓库通过运行时环境开启 ask_user_question；保留同一兼容入口。 */
+function readCliRuntimeEnv(value) {
+    const candidate = asRecord(value?.runtimeEnv) ?? asRecord(asRecord(value?.options)?.runtimeEnv);
+    if (candidate === null)
+        return undefined;
+    const entries = Object.entries(candidate).filter(([, item]) => typeof item === 'string');
+    return entries.length === 0 ? undefined : Object.fromEntries(entries);
+}
 /** DSH Session 快照把最近选择放在 modelSelection.lastUsed/next。 */
 function readModelSelectionCandidates(value) {
     const result = [];
@@ -575,7 +799,9 @@ function selectExternalAdapter(selectedProvider, messageAdapter, registry) {
 function inferMessageAdapter(messages) {
     for (let index = messages.length - 1; index >= 0; index -= 1) {
         const source = asRecord(messages[index].source);
-        if (source?.kind !== 'model' || source.plugin !== 'codingns4dsh')
+        // 旧会话和 DSH 原生投影的 source 形状不完全一致；只要是模型消息就读取
+        // provider，最终仍由 selectExternalAdapter 校验是否为已启用外部适配器。
+        if (source?.kind !== 'model')
             continue;
         const provider = source.provider;
         if (typeof provider === 'string' && provider.trim() !== '')
@@ -596,12 +822,31 @@ async function setAdapterEnabled(settings, registry, value) {
 function extractTurnInput(messages, dshContext) {
     for (let index = messages.length - 1; index >= 0; index -= 1) {
         const message = messages[index];
-        if (message !== undefined && isInjectedStepNotice(message))
-            return { prompt: extractText(message.content), attachments: [] };
-        if (message !== undefined && isHumanUserMessage(message))
-            return extractMessageInput(message.content, dshContext);
+        if (message !== undefined && isInjectedStepNotice(message)) {
+            return { prompt: extractText(message.content), attachments: [], messages };
+        }
+        if (message !== undefined && isHumanUserMessage(message)) {
+            const direct = extractMessageInput(message.content, dshContext);
+            const referenceIndexes = messages
+                .slice(index + 1)
+                .map((candidate, offset) => isSessionReferenceContext(candidate) ? index + 1 + offset : -1)
+                .filter((candidateIndex) => candidateIndex >= 0);
+            const referenceText = referenceIndexes
+                .map(referenceIndex => messages[referenceIndex])
+                .filter((candidate) => candidate !== undefined)
+                .map(candidate => extractText(candidate.content))
+                .filter(text => text.trim() !== '');
+            const forwarded = referenceIndexes.length === 0
+                ? messages
+                : messages.filter((_candidate, candidateIndex) => !referenceIndexes.includes(candidateIndex));
+            return {
+                prompt: [direct.prompt, ...referenceText].filter(text => text.trim() !== '').join('\n\n').trim(),
+                attachments: direct.attachments,
+                messages: forwarded,
+            };
+        }
     }
-    return { prompt: '', attachments: [] };
+    return { prompt: '', attachments: [], messages };
 }
 /** DSH 为工具分段注入的继续提示必须成为下一次 Provider 请求的 prompt。 */
 function isInjectedStepNotice(message) {
@@ -622,6 +867,12 @@ function isHumanUserMessage(message) {
         return false;
     return message.source.kind === undefined || message.source.kind === 'user';
 }
+/** DSH 为当前用户消息生成的只读跨会话快照，允许进入外部 Agent 的当前 prompt。 */
+function isSessionReferenceContext(message) {
+    if (message.role !== 'user' || !isRecord(message.source))
+        return false;
+    return message.source.kind === 'session-reference' && message.source.form === 'recall';
+}
 function extractText(content) {
     if (typeof content === 'string')
         return content;
@@ -830,7 +1081,7 @@ function nativeEventType(value) {
     const record = asRecord(value);
     return typeof record?.type === 'string' ? record.type : undefined;
 }
-function isMessage(value) { const record = asRecord(value); return (record?.role === 'user' || record?.role === 'assistant' || record?.role === 'system') && 'content' in record; }
+function isMessage(value) { const record = asRecord(value); return (record?.role === 'user' || record?.role === 'assistant' || record?.role === 'system' || record?.role === 'tool') && 'content' in record; }
 function isAbortSignal(value) { return asRecord(value)?.aborted === true || (asRecord(value)?.addEventListener instanceof Function); }
 function safeError(error) { return error instanceof Error ? error.message.slice(0, 512) : String(error).slice(0, 512); }
 //# sourceMappingURL=feature.js.map