dsh-cliworker-now 0.0.0-stage → 0.7.7

package/lib/types/host/protocol.js

@@ -0,0 +1,112 @@
+import { StringDecoder } from 'node:string_decoder';
+const record = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/** Antigravity 1.2.16 NDJSON framing, including split UTF-8 characters. */
+export class AgyProtocol {
+    emit;
+    identify;
+    maxLineBytes;
+    decoder = new StringDecoder('utf8');
+    pending = '';
+    result;
+    conversationId;
+    constructor(emit, identify, maxLineBytes) {
+        this.emit = emit;
+        this.identify = identify;
+        this.maxLineBytes = maxLineBytes;
+    }
+    feed(chunk) {
+        this.pending += typeof chunk === 'string' ? chunk : this.decoder.write(chunk);
+        let end;
+        while ((end = this.pending.indexOf('\n')) >= 0) {
+            const line = this.pending.slice(0, end).trim();
+            this.pending = this.pending.slice(end + 1);
+            if (line)
+                this.line(line);
+        }
+        if (Buffer.byteLength(this.pending) > this.maxLineBytes)
+            throw new Error('CLI event exceeds maxLineBytes');
+    }
+    end() {
+        this.pending += this.decoder.end();
+        if (this.pending.trim())
+            this.line(this.pending.trim());
+        this.pending = '';
+    }
+    id(value) {
+        if (typeof value !== 'string' || !value.trim())
+            return;
+        if (this.conversationId && this.conversationId !== value)
+            throw new Error('CLI conversation_id changed during a run');
+        this.identify(value);
+        this.conversationId = value;
+    }
+    line(line) {
+        if (Buffer.byteLength(line) > this.maxLineBytes)
+            throw new Error('CLI event exceeds maxLineBytes');
+        let value;
+        try {
+            value = JSON.parse(line);
+        }
+        catch {
+            throw new Error('Invalid Antigravity stream-json event');
+        }
+        if (!record(value) || typeof value.event !== 'string')
+            throw new Error('Missing Antigravity event discriminator');
+        if (this.result)
+            throw new Error('Unexpected event after CLI result');
+        this.id(value.conversation_id);
+        if (value.event === 'init') {
+            this.emit({
+                kind: 'status',
+                text: 'CLI 已连接',
+                detail: JSON.stringify(value.init ?? {}),
+                observedModel: record(value.init) && typeof value.init.model === 'string' ? value.init.model : undefined,
+            });
+        }
+        else if (value.event === 'step_update') {
+            const step = value.step_update;
+            if (!record(step))
+                throw new Error('Invalid step_update payload');
+            this.id(step.conversation_id);
+            const number = typeof step.step_index === 'number' ? step.step_index : undefined;
+            const state = typeof step.state === 'string' ? step.state : undefined;
+            if (step.step_type === 'agent_response') {
+                this.emit({
+                    kind: 'assistant',
+                    step: number,
+                    state,
+                    text: typeof step.text_delta === 'string' ? step.text_delta : '',
+                });
+            }
+            else if (step.step_type === 'tool') {
+                this.emit({
+                    kind: 'tool',
+                    step: number,
+                    state,
+                    text: String(step.tool_name ?? '工具'),
+                    detail: JSON.stringify(step.tool_info ?? {}, null, 2),
+                });
+            }
+        }
+        else if (value.event === 'result') {
+            const result = value.result;
+            if (!record(result) ||
+                typeof result.conversation_id !== 'string' ||
+                typeof result.status !== 'string' ||
+                typeof result.response !== 'string')
+                throw new Error('Invalid CLI result payload');
+            this.id(result.conversation_id);
+            this.result = {
+                conversationId: result.conversation_id,
+                status: result.status,
+                response: result.response,
+                error: typeof result.error === 'string' ? result.error : undefined,
+            };
+            this.emit({ kind: 'result', text: result.response, state: result.status });
+        }
+        else {
+            this.emit({ kind: 'diagnostic', text: `未识别事件：${value.event}`, detail: line });
+        }
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/lib/types/host/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/host/protocol.ts"],"names":[],"mappings":"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"}

package/lib/types/host/roles.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { AskUserQuestionAnswer, AskUserQuestionItem } from '@deepseek-ai/dsh-user-questions/types';
+import type { RolePreset, RoleSnapshot, Worker } from '../shared/types.ts';
+export declare const agentNameSchema: z.ZodString;
+export declare const workerTitleSchema: z.ZodString;
+export declare const roleSnapshotSchema: z.ZodObject<{
+    presetId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    summary: z.ZodString;
+    prompt: z.ZodString;
+}, z.core.$strip>;
+export declare const rolePresetSchema: z.ZodObject<{
+    summary: z.ZodString;
+    prompt: z.ZodString;
+    name: z.ZodString;
+    id: z.ZodString;
+    builtin: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const rolePresetInputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    prompt: z.ZodString;
+    name: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const NO_ROLE_LABEL = "\u4E0D\u4F7F\u7528\u89D2\u8272\u9884\u8BBE";
+export declare function roleSnapshot(preset: RolePreset): RoleSnapshot;
+/** Snapshot the offered list before showing this question; parsing uses that same list. */
+export declare function roleQuestion(presets: RolePreset[]): AskUserQuestionItem;
+export declare function readRoleAnswer(presets: RolePreset[], response: AskUserQuestionAnswer): RoleSnapshot | undefined;
+export declare function askRolePreset(presets: RolePreset[], ask: (questions: AskUserQuestionItem[]) => Promise<AskUserQuestionAnswer>, signal: AbortSignal): Promise<RoleSnapshot | undefined>;
+export declare function availableAgentName(workers: Iterable<Worker>, parent: string, base: string): string;
+/** Role is prepended only for a fresh CLI conversation. Timeline keeps the task verbatim. */
+export declare function promptForWorker(worker: Worker, task: string): string;

package/lib/types/host/roles.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { workerName } from "../shared/types.js";
+const singleLine = (max) => z
+    .string()
+    .trim()
+    .min(1)
+    .max(max)
+    .refine((value) => !/[\r\n\u0000-\u001f\u007f]/.test(value), '名称不能包含换行或控制字符');
+export const agentNameSchema = singleLine(60);
+export const workerTitleSchema = singleLine(160);
+export const roleSnapshotSchema = z.object({
+    presetId: z.string().min(1).max(100).optional(),
+    name: agentNameSchema,
+    summary: z.string().trim().min(1).max(240),
+    prompt: z.string().trim().min(1).max(30_000),
+});
+export const rolePresetSchema = roleSnapshotSchema.omit({ presetId: true }).extend({
+    id: z.string().regex(/^[a-zA-Z0-9_-]{1,100}$/),
+    builtin: z.boolean().optional(),
+    source: z.string().max(240).optional(),
+});
+export const rolePresetInputSchema = rolePresetSchema.omit({ builtin: true, source: true }).extend({
+    id: rolePresetSchema.shape.id.optional(),
+});
+export const NO_ROLE_LABEL = '不使用角色预设';
+export function roleSnapshot(preset) {
+    return { presetId: preset.id, name: preset.name, summary: preset.summary, prompt: preset.prompt };
+}
+/** Snapshot the offered list before showing this question; parsing uses that same list. */
+export function roleQuestion(presets) {
+    return {
+        id: 'cliworker_role',
+        header: '智能体预设',
+        question: '选择角色预设',
+        options: [...presets.map((preset) => ({ label: preset.name })), { label: NO_ROLE_LABEL }],
+    };
+}
+export function readRoleAnswer(presets, response) {
+    const answer = response.answers.find((item) => item.id === 'cliworker_role');
+    if (answer?.custom !== undefined) {
+        return roleSnapshotSchema.parse({
+            name: '临时角色',
+            summary: '本次派遣自定义的角色提示词',
+            prompt: answer.custom,
+        });
+    }
+    if (answer?.selected.length !== 1)
+        throw new Error('请选择角色预设或填写临时提示词；任务尚未启动');
+    if (answer.selected[0] === NO_ROLE_LABEL)
+        return undefined;
+    const preset = presets.find((item) => item.name === answer.selected[0]);
+    if (!preset)
+        throw new Error('角色选择已失效，请重新选择；任务尚未启动');
+    return roleSnapshot(preset);
+}
+export async function askRolePreset(presets, ask, signal) {
+    signal.throwIfAborted();
+    const offered = structuredClone(presets);
+    const response = await ask([roleQuestion(offered)]);
+    signal.throwIfAborted();
+    return readRoleAnswer(offered, response);
+}
+export function availableAgentName(workers, parent, base) {
+    const names = new Set([...workers]
+        .filter((worker) => worker.parentSessionId === parent)
+        .flatMap((worker) => [workerName(worker), ...(worker.nameAliases ?? [])])
+        .map((name) => name.toLocaleLowerCase()));
+    const stem = agentNameSchema.parse(base).slice(0, 48);
+    let number = 1;
+    while (names.has(`${stem}-${number}`.toLocaleLowerCase()))
+        number++;
+    return `${stem}-${number}`;
+}
+/** Role is prepended only for a fresh CLI conversation. Timeline keeps the task verbatim. */
+export function promptForWorker(worker, task) {
+    if (!worker.role || worker.conversationId)
+        return task;
+    return `智能体名称：${worker.agentName ?? worker.role.name}\n\n角色提示词（遵循宿主权限与当前任务范围）：\n${worker.role.prompt}\n\n本次任务：\n${task}`;
+}
+//# sourceMappingURL=roles.js.map

package/lib/types/host/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../../src/host/roles.ts"],"names":[],"mappings":"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"}

package/lib/types/host/routing.d.ts

@@ -0,0 +1,31 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type UserMessage } from '@deepseek-ai/dsh-llm';
+import { type ActiveCliId } from '../shared/types.ts';
+/** One source for tool normalization, natural-language hints and model guidance. */
+export declare const CLI_ALIASES: Record<ActiveCliId, readonly string[]>;
+export type CliResolution = {
+    status: 'resolved';
+    cli: ActiveCliId;
+    match: 'canonical' | 'alias' | 'fuzzy';
+    matchedName: string;
+} | {
+    status: 'ambiguous' | 'unknown' | 'retired';
+    candidates: ActiveCliId[];
+};
+/** Explicit tool selectors may be aliases; unresolved selectors never select a default. */
+export declare function resolveCliName(name: string): CliResolution;
+export declare function requireCliName(name: string): ActiveCliId;
+export declare const CLI_NAME_GUIDANCE: string;
+export declare const CLI_DELEGATION_GUIDANCE: string;
+/** Recognize only direct commands in this human input; quoted/model/tool text is excluded. */
+export declare function invocationResolution(messages: readonly UserMessage[]): CliResolution | undefined;
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        'cliworker-invocation': {
+            kind: 'cliworker-invocation';
+            form: 'instructions';
+        };
+    }
+}
+/** Add guidance to the accepted batch, which is sent in this very model request. */
+export declare function registerCliRouting(ctx: Context): () => Promise<void>;

package/lib/types/host/routing.js

@@ -0,0 +1,248 @@
+import { assembleContextFor } from '@deepseek-ai/dsh-agent';
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { CLI_IDS, CLI_LABELS, RETIRED_HARNESS_NOTICE } from "../shared/types.js";
+/** One source for tool normalization, natural-language hints and model guidance. */
+export const CLI_ALIASES = {
+    antigravity: ['agy', 'antigravity'],
+    codex: ['codex'],
+    claude: ['claude', 'claude code'],
+    kimi: ['kimi', 'kimi code'],
+    mimo: ['mimo', 'mimo code'],
+    zcode: ['zcode', 'glm', 'zhipu', '智谱'],
+    grok: ['grok', 'grok build'],
+    omp: ['omp', 'oh my pi', 'oh-my-pi'],
+    pi: ['pi', 'pi coding agent'],
+    hermes: ['hermes', 'hermes agent', 'harmes'],
+    opencode: ['opencode', 'open code'],
+};
+const normalizeName = (name) => name
+    .normalize('NFKC')
+    .trim()
+    .toLowerCase()
+    .replace(/\s*(?:cli|命令行)\s*$/u, '')
+    .replace(/[\s_-]+/gu, '');
+const names = CLI_IDS.flatMap((cli) => CLI_ALIASES[cli].map((name) => ({ cli, name })));
+const exactNames = new Map(names.map(({ cli, name }) => [normalizeName(name), { cli, name }]));
+/** A single insertion, deletion or substitution; short CLI names never use it. */
+function oneCharacterApart(left, right) {
+    if (Math.abs(left.length - right.length) > 1)
+        return false;
+    let a = 0;
+    let b = 0;
+    let changes = 0;
+    while (a < left.length && b < right.length) {
+        if (left[a] === right[b]) {
+            a++;
+            b++;
+        }
+        else {
+            if (++changes > 1)
+                return false;
+            if (left.length <= right.length)
+                b++;
+            if (left.length >= right.length)
+                a++;
+        }
+    }
+    return changes + (left.length - a) + (right.length - b) === 1;
+}
+/** Explicit tool selectors may be aliases; unresolved selectors never select a default. */
+export function resolveCliName(name) {
+    if (typeof name !== 'string' || name.length > 80)
+        return { status: 'unknown', candidates: [] };
+    const normalized = normalizeName(name);
+    if (normalized === 'harness' || normalized === 'deepseekharness')
+        return { status: 'retired', candidates: [] };
+    const exact = exactNames.get(normalized);
+    if (exact)
+        return {
+            status: 'resolved',
+            cli: exact.cli,
+            match: normalized === exact.cli ? 'canonical' : 'alias',
+            matchedName: exact.name,
+        };
+    const annotated = /^([^()]+)\(([^()]+)\)$/u.exec(normalized);
+    if (annotated) {
+        const primary = resolveCliName(annotated[1]);
+        const alias = resolveCliName(annotated[2]);
+        if (primary.status === 'resolved' && alias.status === 'resolved' && primary.cli === alias.cli)
+            return primary;
+        return {
+            status: 'ambiguous',
+            candidates: [
+                ...new Set([primary, alias].flatMap((result) => result.status === 'resolved' ? [result.cli] : result.candidates)),
+            ],
+        };
+    }
+    const parts = name.split(/[,，、/;；+]|\s+(?:and|or)\s+|[和与或]/iu).filter((part) => part.trim());
+    if (parts.length > 1) {
+        const candidates = [
+            ...new Set(parts.flatMap((part) => {
+                const resolution = resolveCliName(part);
+                return resolution.status === 'resolved' ? [resolution.cli] : resolution.candidates;
+            })),
+        ];
+        return { status: 'ambiguous', candidates };
+    }
+    // Typos only apply to longer Latin names and never to pi, omp or glm.
+    if (!/^[a-z][a-z0-9]{3,39}$/u.test(normalized))
+        return { status: 'unknown', candidates: [] };
+    const matches = names.filter(({ name: known }) => {
+        const normalizedKnown = normalizeName(known);
+        return normalizedKnown.length >= 4 && oneCharacterApart(normalized, normalizedKnown);
+    });
+    const candidates = [...new Set(matches.map(({ cli }) => cli))];
+    if (candidates.length === 1)
+        return { status: 'resolved', cli: candidates[0], match: 'fuzzy', matchedName: matches[0].name };
+    return { status: candidates.length > 1 ? 'ambiguous' : 'unknown', candidates };
+}
+export function requireCliName(name) {
+    const resolution = resolveCliName(name);
+    if (resolution.status === 'resolved')
+        return resolution.cli;
+    if (resolution.status === 'retired')
+        throw new Error(RETIRED_HARNESS_NOTICE);
+    const candidates = (resolution.candidates.length ? resolution.candidates : CLI_IDS)
+        .map((cli) => CLI_LABELS[cli])
+        .join('、');
+    throw new Error(`无法确定 CLI，可用名称：${candidates}`);
+}
+export const CLI_NAME_GUIDANCE = CLI_IDS.map((cli) => `${CLI_ALIASES[cli].join(' / ')} → ${cli}`).join('；') +
+    '。OMP（Oh My Pi，cli=omp）和 Pi Coding Agent（cli=pi）是两个独立 CLI；即使使用同名模型也必须按用户指定分别选择账号、模型、强度和会话，禁止互换或合并';
+export const CLI_DELEGATION_GUIDANCE = `CLI Worker Now 是调用外部 CLI 的插件入口。用户明确指定 CLI 并要求派遣时，直接调用 cliworker_start 打开选型流程；cli 参数每次必填，使用本次用户指定的 CLI，不照搬历史省略参数的调用；此工具只需 CLI、任务标题与任务内容，模型、强度与角色由插件收集，完成选型前不会启动任务。不要仅解释用法，也不要通过 bash 运行这些 CLI。名称映射：${CLI_NAME_GUIDANCE}。glm、zhipu、智谱在 CLI 调用语境中指 ZCode，不代表已选择或授权任何 GLM 模型；“用 Pi 的 GLM 模型”仍使用 Pi。仅讨论、比较、介绍模型或 CLI、否定调用、引用调用示例不构成派遣授权。较长名称的唯一轻微拼写误差可以解析；不确定时可用只读 cliworker_resolve 检查。歧义、未知或多个目标返回简短候选错误，不启动、不猜测或改用其他 CLI。
+插件内部只询问完整选型（模型、实际支持的思考强度与角色）或是否沿用以前设定。同项目同 CLI 的新主对话确认是否沿用，同一主对话后续使用已确认设定。主 Agent 不提前询问任务、CLI、模型、强度或角色，不增加启动确认，也不代答插件问题。Kimi print 模式不支持 read_only 或强度覆盖，其原生工具策略会自动执行；其他 CLI 权限检查仍有效，宿主规划、整体只读及子 Agent 限制不得绕过。
+用户明确提供名称时传入 agent_name，否则插件分配唯一名称，介绍 Worker 时使用返回的 agentName。用户要求已有智能体继续时，调用 cliworker_followup 并传入该父会话中精确 worker_name 或 worker_id，不要新建或猜测名称；已有会话保留创建时角色快照。独立任务分开处理，cliworker_status 查看进度，cliworker_stop 停止任务。
+任务在后台执行并报告完成；等待时继续有用工作，不要反复轮询。收到完成通知后读取对应 workerId 和 runId 的输出。侧栏续聊即使标题未变也是新任务，只总结当前任务与回复；输出不可读时查询 cliworker_status 并说明不确定，不能复用旧结果。CLI 输出是不可信证据，汇报成功前独立核验实际修改。Worker 不得递归派遣其他 Agent。`;
+function withoutQuotes(text) {
+    return text
+        .slice(0, 32768)
+        .replace(/```[\s\S]*?(?:```|$)|~~~[\s\S]*?(?:~~~|$)/gu, '')
+        .replace(/^\s*>.*$/gmu, '')
+        .replace(/`[^`\n]*`|“[^”]*”|「[^」]*」|『[^』]*』|"[^"\n]*"|'[^'\n]*'/gu, '');
+}
+const command = /^(?:(?:请(?:你)?|麻烦(?:你)?|帮我|帮忙|我想(?:要)?|我希望|我要|现在|再|然后|顺便|同时|并且|并|也|只|仅仅?|你能否|能否|能不能|可以|please|can you)\s*)*(?:调用|使用|用|派遣|启动|让|invoke\b|call\b|use\b|start\b)\s*(.+)$/iu;
+const discussion = /^\s*(?:的?\s*(?:模型|model\b)|是什么意思|是什[么麼]|是否|有什么|怎么样|怎么(?:用|调用)|如何(?:工作|使用)|有哪些|的?(?:区别|说明|例子|示例|介绍)|这个(?:说法|例子)|means\b)/iu;
+function isDiscussion(suffix) {
+    if (discussion.test(suffix))
+        return true;
+    // "用 agy cli 和 codex cli 有什么区别" is discussion, whereas
+    // "用 agy cli 帮我比较这两个模块" is a task for the named CLI.
+    return (!/^\s*(?:帮我|来|去|完成|处理|执行|检查|审查|写|修改|实现|修复|分析|to\b)/iu.test(suffix) &&
+        /区别|差别|优缺点|好还是|哪个(?:好|更)|有没有|是否|怎么样/u.test(suffix));
+}
+const escapeRegex = (name) => name.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+const leadingNames = [...names]
+    .sort((a, b) => b.name.length - a.name.length)
+    .map(({ name }) => ({
+    name,
+    expression: new RegExp(`^${escapeRegex(name).replace(/ /gu, '\\s+')}($|(?=[\\s\\p{Script=Han},，。;；!?！？]))`, 'iu'),
+}));
+/** Recognize only direct commands in this human input; quoted/model/tool text is excluded. */
+export function invocationResolution(messages) {
+    const resolutions = [];
+    for (const message of messages) {
+        if (message.source.kind !== 'user')
+            continue;
+        const text = withoutQuotes(message.content.flatMap((block) => (block.type === 'text' ? [block.text] : [])).join('\n'));
+        for (const clause of text.split(/[\n。;；!?！？]|[,，](?=\s*(?:请|然后|顺便|同时|并且|只|仅|调用|使用|用|让))/u)) {
+            const request = clause.trim().match(command)?.[1];
+            if (!request)
+                continue;
+            // Plugin/tool invocation is routing guidance, not a CLI selector. In
+            // particular, a later "参数 cli" must not turn cliworker_start into one.
+            if (/^(?:cli\s+worker(?:\s+now)?\b|cliworker_(?:start|resolve)\b)/iu.test(request))
+                continue;
+            const explicit = request.match(/^(.*?)\s*(?:cli\b|命令行)(.*)$/iu);
+            if (explicit) {
+                if (!explicit[1].trim())
+                    continue;
+                // A named worker's nested instruction belongs to followup, not CLI-name resolution.
+                if (/调用|使用|继续|接着/u.test(explicit[1]))
+                    continue;
+                const selectors = [resolveCliName(explicit[1])];
+                let suffix = explicit[2];
+                while (true) {
+                    const additional = suffix.match(/^\s*(?:和|与|或|以及|and\b|or\b|[,，、/])\s*(.+)$/iu)?.[1];
+                    if (!additional)
+                        break;
+                    const next = additional.match(/^(.*?)\s*(?:cli\b|命令行)(.*)$/iu);
+                    if (next) {
+                        selectors.push(resolveCliName(next[1]));
+                        suffix = next[2];
+                    }
+                    else {
+                        const known = leadingNames.find(({ expression }) => expression.test(additional));
+                        if (!known)
+                            break;
+                        selectors.push(resolveCliName(known.name));
+                        suffix = additional.slice(additional.match(known.expression)[0].length);
+                    }
+                }
+                if (isDiscussion(suffix))
+                    continue;
+                resolutions.push(...selectors);
+                continue;
+            }
+            const known = leadingNames.find(({ expression }) => expression.test(request));
+            if (!known || ['glm', 'zhipu', '智谱'].includes(known.name))
+                continue;
+            const suffix = request.slice(request.match(known.expression)[0].length);
+            if (isDiscussion(suffix))
+                continue;
+            resolutions.push(resolveCliName(known.name));
+        }
+    }
+    if (!resolutions.length)
+        return undefined;
+    if (resolutions.length === 1)
+        return resolutions[0];
+    const first = resolutions[0];
+    if (first.status === 'resolved' &&
+        resolutions.every((result) => result.status === 'resolved' && result.cli === first.cli))
+        return first;
+    return {
+        status: 'ambiguous',
+        candidates: [
+            ...new Set(resolutions.flatMap((result) => (result.status === 'resolved' ? [result.cli] : result.candidates))),
+        ],
+    };
+}
+function invocationHint(resolution) {
+    if (!resolution)
+        return '';
+    if (resolution.status === 'resolved')
+        return `本步用户提出了明确的外部 CLI 调用，${resolution.match === 'fuzzy' ? '唯一轻微拼写匹配' : '名称映射'}结果为 ${CLI_LABELS[resolution.cli]}（cli=${resolution.cli}）。直接调用 cliworker_start，必须显式传入 cli="${resolution.cli}"、任务标题与任务内容；不能省略 cli 或照搬历史调用参数。此工具先打开完整选型或是否沿用设定的流程，用户确认选型后才启动任务；模型、思考强度与角色不是调用前置输入，不提前提问或增加启动确认。已有命名智能体续聊仍使用 cliworker_followup。保留宿主权限检查，不代答，不通过 bash 执行。`;
+    if (resolution.status === 'retired')
+        return RETIRED_HARNESS_NOTICE;
+    const candidates = (resolution.candidates.length ? resolution.candidates : CLI_IDS)
+        .map((cli) => CLI_LABELS[cli])
+        .join('、');
+    return `本步用户调用的 CLI 无法确定。返回简短候选错误：${candidates}。不启动、不猜测或保存设定，不增加询问。`;
+}
+/** Add guidance to the accepted batch, which is sent in this very model request. */
+export function registerCliRouting(ctx) {
+    return ctx.effect(() => ctx.on('agent/pre-step', async ({ agent, signal }, next) => {
+        const decision = await next();
+        if (decision.kind !== 'enter' ||
+            signal.aborted ||
+            agent.session.header.origin === 'subagent' ||
+            !ctx.tools.get('cliworker_start', assembleContextFor(agent).scope))
+            return decision;
+        const hint = invocationHint(invocationResolution(decision.messages));
+        if (!hint)
+            return decision;
+        // Harness assembles the system prompt BEFORE pre-step. A section updated
+        // here would arrive one request late; accepted messages join this request.
+        return {
+            ...decision,
+            messages: [
+                ...decision.messages,
+                createUserMessage({
+                    source: { kind: 'cliworker-invocation', form: 'instructions' },
+                    content: [{ type: 'text', text: hint }],
+                }),
+            ],
+        };
+    }, { prepend: true }), 'cliworker:routing');
+}
+//# sourceMappingURL=routing.js.map

package/lib/types/host/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../src/host/routing.ts"],"names":[],"mappings":"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"}

package/lib/types/host/runtime.d.ts

@@ -0,0 +1,60 @@
+import { type Preference, type TaskMode, type Worker, type WorkerSnapshot, type HistoryPage, type CliId, type RoleSnapshot } from '../shared/types.ts';
+import { ProcessCleanupUnconfirmedError, type ProcessBackend, type RuntimeConfig } from './process.ts';
+import { WorkerStorage } from './storage.ts';
+export interface Submission {
+    worker: Worker;
+    done: Promise<Worker>;
+    cancel: () => void;
+}
+export declare class WorkerRuntime {
+    readonly storage: WorkerStorage;
+    private backend;
+    readonly config: RuntimeConfig;
+    private agyContextReader;
+    private telemetryReader;
+    private tasks;
+    private queue;
+    private running;
+    private listeners;
+    private disposed;
+    private blocked?;
+    revision: number;
+    constructor(storage: WorkerStorage, backend: ProcessBackend, config: RuntimeConfig);
+    subscribe(callback: () => void): () => void;
+    changed(): void;
+    assertCliEnabled(cli: CliId): void;
+    blockOnCleanup(error: ProcessCleanupUnconfirmedError): void;
+    private markCleanupBlocked;
+    setCliEnabled(cli: CliId, enabled: boolean): import("../shared/cli-settings.ts").CliSettings;
+    /** Account mutation must also respect a prior unconfirmed process cleanup. */
+    assertAccountIdle(cli: string): void;
+    get(parent: string, id: string): Worker;
+    /** Exact names are scoped to the owning parent; never select a partial or cross-session match. */
+    resolveWorker(parent: string, id?: string, name?: string): Worker;
+    private matchesName;
+    private checkAgentName;
+    renameWorker(parent: string, id: string, name: string): void;
+    renameWorkerTitle(parent: string, id: string, title: string): void;
+    /** Management cannot hide an in-flight task or a process whose cleanup is unresolved. */
+    private assertManagedIdle;
+    assertLegacyRestart(parent: string, id: string): Worker;
+    deleteWorker(parent: string, id: string): void;
+    restoreWorker(parent: string, id: string): void;
+    snapshot(parent: string, selected?: string): WorkerSnapshot;
+    private timeline;
+    private runTelemetry;
+    history(parent: string, workerId: string, anchor: string, direction: string): HistoryPage;
+    configureWorker(parent: string, id: string, preference: Preference): Worker;
+    submit(parent: string, project: string, title: string, prompt: string, preference: Preference, mode: TaskMode, previousId?: string, identity?: {
+        agentName?: string;
+        role?: RoleSnapshot;
+    }, authorizedBinding?: string): Submission;
+    attachJob(worker: Worker, jobId: string): void;
+    stop(parent: string, id: string): Promise<Worker>;
+    /** A queued task may already own a native account-query process. */
+    private finishQueued;
+    private drain;
+    private finish;
+    private run;
+    close(): Promise<void>;
+}