@krischoichoi/channel-harness 0.6.0

package/lib/commands/help.js

@@ -0,0 +1,89 @@
+/**
+ * The `/help` command (spec §13).
+ *
+ * Discovery is read LIVE from the official registry — never from a static
+ * list: `deps.listCommands(agent)` returns the effective view after global +
+ * agent-scope shadowing, so Harness plugins that register new commands
+ * (e.g. /compact, /goal, /plan) appear on the channel side without a channel
+ * upgrade. `/help <name>` resolves one command via `deps.findCommand`.
+ * The registry is reached through deps (bridged from the plugin ctx) — never
+ * through `invocation.agent.ctx`, which the agent-loop scope does not inject.
+ */
+import {} from '@deepseek-ai/dsh-commands';
+const copy = {
+    zh: {
+        title: '可用指令',
+        none: '当前没有可用指令。',
+        unknown: '未知指令：',
+        usage: '用法',
+        descriptions: {
+            stop: '立即停止当前任务',
+            new: '开启全新会话',
+            help: '列出可用指令或查看单个指令用法',
+            status: '查看当前会话、Agent 与模型状态',
+            version: '查看渠道 Bundle 版本、Harness 基线与更新提示',
+            models: '列出已注册的模型 Provider 及模型',
+            model: '查看或切换当前会话模型',
+        },
+    },
+    en: {
+        title: 'Available commands',
+        none: 'No commands are currently available.',
+        unknown: 'Unknown command: ',
+        usage: 'Usage',
+        descriptions: {
+            stop: 'Stop the current task immediately',
+            new: 'Start a new session',
+            help: 'List available commands or show usage for one command',
+            status: 'Show the current session, agent, and model status',
+            version: 'Show the channel bundle version, Harness baseline, and update hint',
+            models: 'List registered model providers and their models',
+            model: 'Show or change the current session model',
+        },
+    },
+};
+function descriptionFor(locale, name, fallback) {
+    const descriptions = copy[locale].descriptions;
+    return descriptions[name] ?? fallback;
+}
+function usageFor(name, hint) {
+    return '/' + name + (hint ? ' ' + hint : '');
+}
+export function createHelpCommand(deps) {
+    return {
+        name: 'help',
+        description: 'List available commands or show usage for one command',
+        input: { hint: '[command]' },
+        handler(invocation) {
+            const locale = deps.locale();
+            const strings = copy[locale];
+            const name = invocation.rawInput.trim();
+            if (name.length > 0) {
+                const def = deps.findCommand(invocation.agent, name);
+                if (!def) {
+                    return { kind: 'error', text: strings.unknown + '`/' + name + '`' };
+                }
+                const lines = ['**/' + def.name + '**'];
+                const description = descriptionFor(locale, def.name, def.description);
+                if (description)
+                    lines.push('', description);
+                if (def.input?.hint) {
+                    lines.push('', '**' + strings.usage + '**', '`' + usageFor(def.name, def.input.hint) + '`');
+                }
+                return { kind: 'success', text: lines.join('\n') };
+            }
+            const defs = deps.listCommands(invocation.agent);
+            if (defs.length === 0) {
+                return { kind: 'success', text: strings.none };
+            }
+            const lines = ['**' + strings.title + '**', ''];
+            for (const def of defs) {
+                const usage = usageFor(def.name, def.input?.hint);
+                const description = descriptionFor(locale, def.name, def.description);
+                lines.push('- `' + usage + '`' + (description ? ' - ' + description : ''));
+            }
+            return { kind: 'success', text: lines.join('\n') };
+        },
+    };
+}
+//# sourceMappingURL=help.js.map

package/lib/commands/help.js.map

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

package/lib/commands/index.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Channel command plane.
+ *
+ * Composes the channel command factories and installs them into an Agent
+ * scoped context via the official `@deepseek-ai/dsh-commands` registry —
+ * there is no custom ChannelCommandRegistry / CommandMap here. Each factory
+ * returns an official `CommandDefinition`; `installChannelCommands` mounts a
+ * command-injected child plugin under the Agent's exact context. Channel
+ * commands register in the AGENT scope, so they shadow same-named globals and
+ * a same-scope duplicate throws (no custom priority/reserved-name system —
+ * spec §11/§43).
+ *
+ * The `deps` argument is the bridge hook surface channel commands need —
+ * every capability a handler uses arrives as a NARROW injected function or
+ * object, mirroring `/new`'s `startNewSession`. Handlers must NEVER read
+ * Harness services through `invocation.agent.ctx` (the agent-loop scoped
+ * context does not inject `commands` / `llm` — Cordis throws "without
+ * inject"); the bridge lazily bridges them through `deps` instead, exactly
+ * like the official compact/goal/plan commands close over their plugin ctx.
+ */
+import { type Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { CommandDefinition, CommandDescriptor } from '@deepseek-ai/dsh-commands';
+import type { LlmCallConfig, LlmModelInfo, LlmProviderInfo, LlmResolvedModelInfo } from '@deepseek-ai/dsh-llm';
+import type { ChannelModelSelectionController } from '../model-selection.js';
+import type { ChannelCommandLocale } from './locale.js';
+/**
+ * Narrow LLM seam handed to model commands (discovery + exact resolution).
+ * Structural subset of `ctx.llm` (`LlmRuntime`); the bridge bridges it lazily
+ * so handlers never touch the agent scoped context.
+ */
+export interface ChannelModelCatalog {
+    /** Registered provider routes (display metadata). */
+    listProviders(): LlmProviderInfo[];
+    /** Advisory model catalog for one provider (never request validation). */
+    listModels(provider: string): Promise<LlmModelInfo[]>;
+    /** Exact model metadata resolution, independent of the advisory catalog. */
+    resolveModelInfo(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
+    /** Validate a call config (incl. reasoning effort) against the exact model. */
+    resolveCallConfig(config: LlmCallConfig, signal?: AbortSignal): Promise<LlmCallConfig>;
+}
+/**
+ * Sanitized bundle update status (structural mirror of channel-control's
+ * `BundleUpdateStatus`; channel-harness carries no dependency edge on the
+ * control-plane package — it probes it live via `ctx.get('channelControl')`).
+ */
+export interface ChannelVersionInfo {
+    currentVersion: string;
+    update?: {
+        version: string;
+        tag: 'latest' | 'next';
+        crossLine: boolean;
+        commands: string[];
+    };
+    checkedAt?: number;
+}
+/** Bridge-provided capabilities available to channel commands. */
+export interface ChannelCommandDependencies {
+    /** Start a brand-new Harness session for the current conversation. */
+    startNewSession(agent: Agent): Promise<void>;
+    /** Harness session/default model view used by /status, /model and images. */
+    modelSelection: ChannelModelSelectionController;
+    /** Effective command view for an agent (global + agent-scope shadow). */
+    listCommands(agent: Agent): readonly CommandDescriptor[];
+    /** Resolve one effective command definition (scoped shadow or global). */
+    findCommand(agent: Agent, name: string): CommandDefinition | undefined;
+    /** Current explicit Harness Host locale; evaluated for every invocation. */
+    locale(): ChannelCommandLocale;
+    /** Harness LLM catalog seam (discovery + exact resolution), bridged lazily. */
+    llm: ChannelModelCatalog;
+    /**
+     * Live bundle update-status probe for /version (bridged from the plugin ctx
+     * over `ctx.get('channelControl')`). Optional: undefined when the control
+     * plane is absent — /version then degrades to the version-only output.
+     */
+    versionInfo?(): Promise<ChannelVersionInfo | undefined>;
+    /**
+     * Per-conversation mirror toggle backing (issue #5). The bridge binds it to
+     * the durable binding store; the state lives on `SessionBinding.mirror`.
+     */
+    mirror?: {
+        /** Current mirror state for the agent's bound conversation. */
+        get(agent: Agent): Promise<boolean>;
+        /** Toggle and persist the mirror state. */
+        set(agent: Agent, on: boolean): Promise<void>;
+    };
+    /**
+     * Rebind/attach an existing session to the current conversation (issue #6).
+     * `resolve` never mutates: it fail-closes on ambiguous prefixes, sessions
+     * bound elsewhere, and preset conflicts. `confirm` performs the rebind.
+     */
+    bind?: {
+        resolve(agent: Agent, query: string): Promise<ChannelBindResolution>;
+        confirm(agent: Agent, sessionId: string): Promise<void>;
+    };
+}
+/**
+ * Outcome of the fail-closed `/bind` resolution (issue #6). `resolved` still
+ * carries the two refusal flags — `boundElsewhere` / `conflict` — so the
+ * command can present the exact refusal reason before any mutation.
+ */
+export interface ChannelBindResolution {
+    kind: 'resolved' | 'missing' | 'ambiguous';
+    /** Unique target when `kind: 'resolved'`. */
+    sessionId?: string;
+    /** Ambiguous prefix candidates when `kind: 'ambiguous'` (bounded list). */
+    candidates?: string[];
+    /** Persisted Agent preset of the target (undefined = none recorded). */
+    preset?: string;
+    /** Target is already bound to a different conversation. */
+    boundElsewhere?: boolean;
+    /** Target's persisted preset conflicts with this conversation's route. */
+    conflict?: boolean;
+}
+export type ChannelCommandDisposer = () => Promise<void>;
+/**
+ * Install the channel commands on an Agent scoped context. Registrations live
+ * for the life of that Agent scope and unwind together with it when the Agent
+ * is disposed.
+ */
+export declare function installChannelCommands(agentCtx: Context, deps: ChannelCommandDependencies): Promise<ChannelCommandDisposer>;
+//# sourceMappingURL=index.d.ts.map

package/lib/commands/index.d.ts.map

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

package/lib/commands/index.js

@@ -0,0 +1,63 @@
+/**
+ * Channel command plane.
+ *
+ * Composes the channel command factories and installs them into an Agent
+ * scoped context via the official `@deepseek-ai/dsh-commands` registry —
+ * there is no custom ChannelCommandRegistry / CommandMap here. Each factory
+ * returns an official `CommandDefinition`; `installChannelCommands` mounts a
+ * command-injected child plugin under the Agent's exact context. Channel
+ * commands register in the AGENT scope, so they shadow same-named globals and
+ * a same-scope duplicate throws (no custom priority/reserved-name system —
+ * spec §11/§43).
+ *
+ * The `deps` argument is the bridge hook surface channel commands need —
+ * every capability a handler uses arrives as a NARROW injected function or
+ * object, mirroring `/new`'s `startNewSession`. Handlers must NEVER read
+ * Harness services through `invocation.agent.ctx` (the agent-loop scoped
+ * context does not inject `commands` / `llm` — Cordis throws "without
+ * inject"); the bridge lazily bridges them through `deps` instead, exactly
+ * like the official compact/goal/plan commands close over their plugin ctx.
+ */
+import {} from '@deepseek-ai/cordis';
+import { createNewCommand } from './new.js';
+import { createStopCommand } from './stop.js';
+import { createHelpCommand } from './help.js';
+import { createStatusCommand } from './status.js';
+import { createModelsCommand } from './models.js';
+import { createModelCommand } from './model.js';
+import { createVersionCommand } from './version.js';
+import { createMirrorCommand } from './mirror.js';
+import { createBindCommand } from './bind.js';
+const commandFactories = [
+    createStopCommand,
+    createNewCommand,
+    createHelpCommand,
+    createStatusCommand,
+    createModelsCommand,
+    createModelCommand,
+    createVersionCommand,
+    createMirrorCommand,
+    createBindCommand,
+];
+/**
+ * Install the channel commands on an Agent scoped context. Registrations live
+ * for the life of that Agent scope and unwind together with it when the Agent
+ * is disposed.
+ */
+export function installChannelCommands(agentCtx, deps) {
+    const fiber = agentCtx.inject(['commands'], function* channelCommands(ctx) {
+        for (const factory of commandFactories) {
+            yield ctx.commands.register(factory(deps));
+        }
+    });
+    return fiber.await().then(() => {
+        let disposing;
+        return () => disposing ??= quiesceFiber(fiber);
+    });
+}
+async function quiesceFiber(fiber) {
+    await Promise.resolve(fiber.dispose());
+    while (fiber.inertia !== undefined)
+        await fiber.inertia;
+}
+//# sourceMappingURL=index.js.map

package/lib/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAgB,MAAM,qBAAqB,CAAC;AAInD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAkG9C,MAAM,gBAAgB,GAAG;IACvB,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,oBAAoB;IACpB,mBAAmB;IACnB,iBAAiB;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAiB,EACjB,IAAgC;IAEhC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,GAAG;QACvE,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;YACvC,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAC7B,IAAI,SAAoC,CAAC;QACzC,OAAO,GAAG,EAAE,CAAC,SAAS,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAAoC;IAC9D,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,OAAO,CAAC;AAC1D,CAAC"}

package/lib/commands/locale.d.ts

@@ -0,0 +1,9 @@
+/** Languages persisted by Harness's `locale.preference` settings namespace. */
+export type ChannelCommandLocale = 'zh' | 'en';
+/**
+ * Read the public Harness locale namespace through an optional settings seam.
+ * Browser-only navigator fallback is unavailable to IM channels, so an absent
+ * or invalid explicit preference preserves the channel's historical zh copy.
+ */
+export declare function commandLocaleFromSettings(settings: unknown): ChannelCommandLocale;
+//# sourceMappingURL=locale.d.ts.map

package/lib/commands/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/commands/locale.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;AAY/C;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG,oBAAoB,CAYjF"}

package/lib/commands/locale.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+const settingsReaderSchema = z.custom((value) => typeof value === 'object' && value !== null &&
+    typeof Reflect.get(value, 'get') === 'function', { message: 'expected a Harness settings reader' });
+const localeSettingsSchema = z.object({
+    preference: z.enum(['zh', 'en']).optional(),
+}).passthrough();
+/**
+ * Read the public Harness locale namespace through an optional settings seam.
+ * Browser-only navigator fallback is unavailable to IM channels, so an absent
+ * or invalid explicit preference preserves the channel's historical zh copy.
+ */
+export function commandLocaleFromSettings(settings) {
+    const reader = settingsReaderSchema.safeParse(settings);
+    if (!reader.success)
+        return 'zh';
+    try {
+        // SettingsProvider.get relies on its receiver; call the validated method
+        // against the original service rather than zod's parsed object.
+        const section = reader.data.get.call(settings, 'locale');
+        const parsed = localeSettingsSchema.safeParse(section);
+        return parsed.success ? (parsed.data.preference ?? 'zh') : 'zh';
+    }
+    catch {
+        return 'zh';
+    }
+}
+//# sourceMappingURL=locale.js.map

package/lib/commands/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../src/commands/locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,UAAU,EACjD,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAClD,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC,WAAW,EAAE,CAAC;AAEjB;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAiB;IACzD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,yEAAyE;QACzE,gEAAgE;QAChE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/lib/commands/mirror.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `/mirror` command (issue #5).
+ *
+ * Opt-in per-conversation toggle: when ON, turns initiated OUTSIDE the channel
+ * (web/CLI) on this bound session deliver their final assistant text to the
+ * bound conversation as buffered replies. Default OFF — a non-channel turn
+ * never auto-routes without explicit owner consent. The state lives on the
+ * durable binding (`SessionBinding.mirror`), so it survives restarts and is
+ * consulted by the ReplyRouter at delivery time.
+ */
+import { type CommandDefinition } from '@deepseek-ai/dsh-commands';
+import type { ChannelCommandDependencies } from './index.js';
+export declare function createMirrorCommand(deps: ChannelCommandDependencies): CommandDefinition;
+//# sourceMappingURL=mirror.d.ts.map

package/lib/commands/mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.d.ts","sourceRoot":"","sources":["../../src/commands/mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,iBAAiB,CAiCvF"}

package/lib/commands/mirror.js

@@ -0,0 +1,44 @@
+/**
+ * The `/mirror` command (issue #5).
+ *
+ * Opt-in per-conversation toggle: when ON, turns initiated OUTSIDE the channel
+ * (web/CLI) on this bound session deliver their final assistant text to the
+ * bound conversation as buffered replies. Default OFF — a non-channel turn
+ * never auto-routes without explicit owner consent. The state lives on the
+ * durable binding (`SessionBinding.mirror`), so it survives restarts and is
+ * consulted by the ReplyRouter at delivery time.
+ */
+import {} from '@deepseek-ai/dsh-commands';
+export function createMirrorCommand(deps) {
+    return {
+        name: 'mirror',
+        description: 'Mirror web-initiated replies to this conversation (opt-in)',
+        async handler(invocation) {
+            if (!deps.mirror) {
+                return { kind: 'error', text: '当前部署不支持镜像模式。' };
+            }
+            const arg = invocation.rawInput.trim().toLowerCase();
+            if (arg === '') {
+                const on = await deps.mirror.get(invocation.agent);
+                return {
+                    kind: 'success',
+                    text: on
+                        ? '镜像模式：已开启。Web 端发起的回复会同步发送到本会话。'
+                        : '镜像模式：已关闭。Web 端发起的回复不会发送到本会话（用法：/mirror on|off）。',
+                };
+            }
+            if (arg !== 'on' && arg !== 'off') {
+                return { kind: 'error', text: '用法：/mirror on|off（不带参数查看当前状态）。' };
+            }
+            const on = arg === 'on';
+            await deps.mirror.set(invocation.agent, on);
+            return {
+                kind: 'success',
+                text: on
+                    ? '镜像模式已开启：Web 端发起的回复将同步发送到本会话。'
+                    : '镜像模式已关闭：Web 端发起的回复不再发送到本会话。',
+            };
+        },
+    };
+}
+//# sourceMappingURL=mirror.js.map

package/lib/commands/mirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.js","sourceRoot":"","sources":["../../src/commands/mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAA0B,MAAM,2BAA2B,CAAC;AAGnE,MAAM,UAAU,mBAAmB,CAAC,IAAgC;IAClE,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4DAA4D;QACzE,KAAK,CAAC,OAAO,CAAC,UAAU;YACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;YACjD,CAAC;YACD,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAErD,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;gBACf,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACnD,OAAO;oBACL,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,EAAE;wBACN,CAAC,CAAC,+BAA+B;wBACjC,CAAC,CAAC,iDAAiD;iBACtD,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;gBAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC;YACnE,CAAC;YAED,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC;YACxB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,EAAE;oBACN,CAAC,CAAC,8BAA8B;oBAChC,CAAC,CAAC,6BAA6B;aAClC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/commands/model.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The `/model` command (spec §18–§29).
+ *
+ * Harness owns model routing. The command validates the requested model and
+ * delegates the current-Session switch to the official Host RPC or the
+ * headless Agent model-selection hook. The same operation updates the shared
+ * default so future Sessions use the selected model as well.
+ *
+ * Validation: provider must come from `ctx.llm.listProviders()` (spec §28);
+ * the exact model is resolved ONCE via `ctx.llm.resolveModelInfo` — catalog
+ * membership is ADVISORY and never rejects a model id (spec §17/§29). An
+ * optional reasoning effort is then validated against that exact model's own
+ * `reasoning.efforts` metadata (the same predicate the official
+ * `resolveCallConfig` applies), so unsupported efforts reject without
+ * provider I/O and without a second metadata resolution.
+ */
+import { type CommandDefinition } from '@deepseek-ai/dsh-commands';
+import type { ChannelCommandDependencies } from './index.js';
+export declare function createModelCommand(deps: ChannelCommandDependencies): CommandDefinition;
+//# sourceMappingURL=model.d.ts.map

package/lib/commands/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/commands/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAInE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,0BAA0B,GAAG,iBAAiB,CAkFtF"}

package/lib/commands/model.js

@@ -0,0 +1,106 @@
+/**
+ * The `/model` command (spec §18–§29).
+ *
+ * Harness owns model routing. The command validates the requested model and
+ * delegates the current-Session switch to the official Host RPC or the
+ * headless Agent model-selection hook. The same operation updates the shared
+ * default so future Sessions use the selected model as well.
+ *
+ * Validation: provider must come from `ctx.llm.listProviders()` (spec §28);
+ * the exact model is resolved ONCE via `ctx.llm.resolveModelInfo` — catalog
+ * membership is ADVISORY and never rejects a model id (spec §17/§29). An
+ * optional reasoning effort is then validated against that exact model's own
+ * `reasoning.efforts` metadata (the same predicate the official
+ * `resolveCallConfig` applies), so unsupported efforts reject without
+ * provider I/O and without a second metadata resolution.
+ */
+import {} from '@deepseek-ai/dsh-commands';
+import { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+export function createModelCommand(deps) {
+    return {
+        name: 'model',
+        description: 'Show or switch the current model',
+        input: { hint: '[<provider> <model> [<reasoningEffort>]]' },
+        async handler(invocation) {
+            const llm = deps.llm;
+            const args = invocation.rawInput
+                .trim()
+                .split(/\s+/)
+                .filter((token) => token.length > 0);
+            if (args.length === 0) {
+                const selection = await deps.modelSelection.current(invocation.agent);
+                if (!selection) {
+                    return { kind: 'success', text: ['当前模型', '', '（未解析到模型选择）'].join('\n') };
+                }
+                return { kind: 'success', text: formatSelection('当前模型', selection) };
+            }
+            if (args.length > 3) {
+                return { kind: 'error', text: '用法：/model [<provider> <model> [<reasoningEffort>]]' };
+            }
+            const [providerId, modelId, effort] = args;
+            if (!modelId) {
+                return { kind: 'error', text: '用法：/model [<provider> <model> [<reasoningEffort>]]' };
+            }
+            // 1. Provider must be a registered route (spec §28).
+            const providers = llm.listProviders();
+            if (!providers.some((p) => p.id === providerId)) {
+                return {
+                    kind: 'error',
+                    text: '未找到 Provider: ' + providerId + (providers.length > 0 ? '\n\n可用：\n' + providers.map((p) => p.id).join('\n') : ''),
+                };
+            }
+            // 2. Exact model metadata resolution (catalog membership is advisory).
+            let resolved;
+            try {
+                resolved = await llm.resolveModelInfo(providerId, modelId, invocation.signal);
+            }
+            catch (error) {
+                return { kind: 'error', text: '模型解析失败：' + errorMessage(error) };
+            }
+            // 3. Reasoning-effort validation against the exact model's metadata
+            //    (spec §29). `resolved.reasoning.efforts` is the adapter-owned truth
+            //    for this exact route; the same predicate the official
+            //    `resolveCallConfig` applies — reject an explicit unsupported effort
+            //    here, without a second metadata resolution or provider I/O.
+            let reasoningEffort;
+            if (effort) {
+                const supported = resolved?.reasoning?.efforts ?? [];
+                if (!supported.some((e) => String(e.id) === effort)) {
+                    return {
+                        kind: 'error',
+                        text: 'Reasoning effort 不被支持: ' + effort + (supported.length > 0 ? '\n\n支持：' + supported.map((e) => String(e.id)).join(', ') : ''),
+                    };
+                }
+                reasoningEffort = ReasoningEffortId(effort);
+            }
+            // 4. Delegate the live Session switch. The controller also persists the
+            // shared default for future Sessions, matching Harness's model command.
+            const selection = {
+                provider: providerId,
+                model: modelId,
+                ...(reasoningEffort ? { reasoningEffort } : {}),
+            };
+            try {
+                await deps.modelSelection.select(invocation.agent, selection);
+            }
+            catch (error) {
+                return { kind: 'error', text: '模型切换失败：' + errorMessage(error) };
+            }
+            // 5. Report success.
+            return {
+                kind: 'success',
+                text: formatSelection('模型已切换：', selection) + '\n\n当前会话从下一次模型执行开始生效；该选择也会成为新会话默认。',
+            };
+        },
+    };
+}
+function formatSelection(header, selection) {
+    const lines = [header, '', 'Provider: ' + selection.provider, 'Model: ' + selection.model];
+    if (selection.reasoningEffort)
+        lines.push('Reasoning: ' + String(selection.reasoningEffort));
+    return lines.join('\n');
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=model.js.map

package/lib/commands/model.js.map

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

package/lib/commands/models.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `/models` command (spec §15–§17).
+ *
+ * Model DISCOVERY only: reads the Harness LLM adapter registry through the
+ * official `deps.llm` catalog seam (listProviders / listModels) — the channel never
+ * touches provider HTTP endpoints and never treats the catalog as
+ * authoritative. Catalog membership is ADVISORY (spec §17): it is used for
+ * display only; `/model` performs exact resolution separately. A provider
+ * whose model listing fails must not fail the whole command (spec §15).
+ */
+import { type CommandDefinition } from '@deepseek-ai/dsh-commands';
+import type { ChannelCommandDependencies } from './index.js';
+export declare function createModelsCommand(deps: ChannelCommandDependencies): CommandDefinition;
+//# sourceMappingURL=models.d.ts.map

package/lib/commands/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/commands/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,KAAK,EAAE,0BAA0B,EAAuB,MAAM,YAAY,CAAC;AAElF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,iBAAiB,CAkCvF"}

package/lib/commands/models.js

@@ -0,0 +1,67 @@
+/**
+ * The `/models` command (spec §15–§17).
+ *
+ * Model DISCOVERY only: reads the Harness LLM adapter registry through the
+ * official `deps.llm` catalog seam (listProviders / listModels) — the channel never
+ * touches provider HTTP endpoints and never treats the catalog as
+ * authoritative. Catalog membership is ADVISORY (spec §17): it is used for
+ * display only; `/model` performs exact resolution separately. A provider
+ * whose model listing fails must not fail the whole command (spec §15).
+ */
+import {} from '@deepseek-ai/dsh-commands';
+export function createModelsCommand(deps) {
+    return {
+        name: 'models',
+        description: 'List registered model providers and their models',
+        input: { hint: '[provider]' },
+        async handler(invocation) {
+            const llm = deps.llm;
+            const providers = llm.listProviders();
+            const filter = invocation.rawInput.trim();
+            if (filter.length > 0) {
+                const provider = providers.find((p) => p.id === filter);
+                if (!provider) {
+                    return {
+                        kind: 'error',
+                        text: '未找到 Provider: ' + filter + availableSuffix(providers),
+                    };
+                }
+                return { kind: 'success', text: (await buildProviderLines(llm, provider)).join('\n') };
+            }
+            if (providers.length === 0) {
+                return { kind: 'success', text: '当前没有已注册的模型 Provider。' };
+            }
+            const sections = await Promise.all(providers.map((p) => buildProviderLines(llm, p)));
+            const lines = [];
+            for (const section of sections) {
+                if (lines.length > 0)
+                    lines.push('');
+                lines.push(...section);
+            }
+            return { kind: 'success', text: lines.join('\n') };
+        },
+    };
+}
+function availableSuffix(providers) {
+    if (providers.length === 0)
+        return '';
+    return '\n\n可用：\n' + providers.map((p) => p.id).join('\n');
+}
+async function buildProviderLines(llm, provider) {
+    const lines = [provider.name + ' (' + provider.id + ')'];
+    try {
+        const models = await llm.listModels(provider.id);
+        if (models.length === 0) {
+            lines.push('- (无模型)');
+        }
+        else {
+            for (const model of models)
+                lines.push('- ' + model.id);
+        }
+    }
+    catch {
+        lines.push('- 模型目录获取失败');
+    }
+    return lines;
+}
+//# sourceMappingURL=models.js.map