@jingyi0605/codingns4dsh 0.2.1-beta.12 → 0.2.1-beta.13

package/data/build/dist/host/cli-adapters/management-methods.js

@@ -0,0 +1,135 @@
+import { codexStandaloneDirectory } from './management-installation.js';
+// Official evidence: docs/调查报告/20261016-外部Agent官方安装与更新方式.md.
+export const AGENT_MANAGEMENT_DEFINITIONS = {
+    'command-code': { sourceUrl: 'https://commandcode.ai/docs/quickstart', npm: 'command-code', update: ['update'], note: 'Requires Node.js 22 or newer.' },
+    'claude-code': { sourceUrl: 'https://code.claude.com/docs/en/setup', npm: '@anthropic-ai/claude-code', script: 'https://claude.ai/install.sh', powershell: 'https://claude.ai/install.ps1', update: ['update'], brew: ['--cask', 'claude-code'] },
+    kimi: { sourceUrl: 'https://www.kimi.com/code/docs/en/kimi-code-cli/guides/getting-started.html', npm: '@moonshot-ai/kimi-code', note: 'Requires Node.js 22.19+. The Python kimi-cli distribution is archived. Review the official migration guide before replacing it; sessions and sign-in are not migrated by this action. Native installations use the interactive kimi upgrade command in a terminal.' },
+    gemini: { sourceUrl: 'https://geminicli.com/docs/get-started/installation/', npm: '@google/gemini-cli', brew: ['gemini-cli'], note: 'Requires Node.js 20 or newer. Use the package manager that owns the current installation.' },
+    pi: { sourceUrl: 'https://pi.dev/docs/latest/quickstart', npm: '@earendil-works/pi-coding-agent', npmArgs: ['--ignore-scripts'], update: ['update'], note: 'Requires Node.js 22.19+. npm updates retain the installed package, including official 0.x releases. The built-in updater is for native installations.' },
+    codex: { sourceUrl: 'https://developers.openai.com/codex/cli/', npm: '@openai/codex', script: 'https://chatgpt.com/codex/install.sh', scriptShell: 'sh', brew: ['--cask', 'codex'], note: 'Updates preserve the detected package manager and installation location. The standalone installer also updates standalone installations.' },
+    opencode: { sourceUrl: 'https://dev.opencode.ai/v2/docs', script: 'https://opencode.ai/v2/install', npm: '@opencode/cli', update: ['upgrade'], windowsManual: true, note: 'New installations use OpenCode v2. Existing installations use their built-in updater. The v2 guide does not support Windows package-manager installation.' },
+    grok: { sourceUrl: 'https://docs.x.ai/build/overview', script: 'https://x.ai/cli/install.sh', update: ['update'], windowsManual: true, note: 'Use the official Windows guide for Windows installation. WinGet installations must be updated through WinGet.' },
+    mcode: { sourceUrl: 'https://github.com/MiniMax-AI/minimax-code', script: 'https://filecdn.minimax.chat/public/install.sh', powershell: 'https://filecdn.minimax.chat/public/install.ps1', npm: '@minimax-ai/code', npmArgs: ['--registry=https://registry.npmjs.org/', '--ignore-scripts=false', '--include=optional', '--allow-scripts=@minimax-ai/code,better-sqlite3'], note: 'npm requires Node.js 22.19+ (22.x), 24.2+ (24.x), 25, or 26. Use the same npm prefix as the original installation. The native installer does not support Alpine/musl.' },
+    zcode: { sourceUrl: 'https://zcode.z.ai/en/docs/install', manual: true, note: 'Download the official ZCode application for your platform. Update through ZCode or the current official installer; its bundled runtime is managed by the application.' },
+    codebuddy: { sourceUrl: 'https://www.codebuddy.ai/docs/cli/troubleshooting', npm: '@tencent-ai/codebuddy-code', npmArgs: ['--registry=https://registry.npmjs.org/'], update: ['update'], note: 'Requires Node.js 18.20+. npm updates use the same official registry as release checks, avoiding stale mirrors and silent failures in the built-in updater.' },
+    workbuddy: { sourceUrl: 'https://www.workbuddy.ai/', manual: true, note: 'Install the official WorkBuddy application. To update, open Personal center → Check for updates. WorkBuddy manages its bundled Agent runtime.' },
+    'cursor-cli': { sourceUrl: 'https://cursor.com/docs/cli/installation', script: 'https://cursor.com/install', powershell: 'https://cursor.com/install?win32=true', update: ['update'] },
+    'kiro-cli': { sourceUrl: 'https://kiro.dev/docs/getting-started/installation/', script: 'https://cli.kiro.dev/install', update: ['update', '--non-interactive'], windowsManual: true },
+    qoder: { sourceUrl: 'https://docs.qoder.com/cli/installation', script: 'https://qoder.com/install', powershell: 'https://qoder.com/install.ps1', update: ['update'] },
+    'qoder-cn': { sourceUrl: 'https://docs.qoder.cn/en/cli/installation', script: 'https://static.qoder.com.cn/qoder-cli-cn/install.sh', powershell: 'https://static.qoder.com.cn/qoder-cli-cn/install.ps1', update: ['update'] },
+    antigravity: { sourceUrl: 'https://www.antigravity.google/docs/cli/install/', script: 'https://antigravity.google/cli/install.sh', powershell: 'https://antigravity.google/cli/install.ps1', update: ['update'] },
+    doubao: { sourceUrl: 'https://www.doubao.com/download/desktop', manual: true, note: 'Download the official Doubao desktop application. Use its update flow or the current official installer, then re-detect it here.' },
+};
+export function managementNpmPackage(adapter) {
+    return adapter.id === 'pi' && /@mariozechner[\\/]/u.test(adapter.command ?? '')
+        ? '@mariozechner/pi-coding-agent' : AGENT_MANAGEMENT_DEFINITIONS[adapter.id]?.npm;
+}
+export function managementMethods(adapter, action, platform, arch) {
+    const definition = AGENT_MANAGEMENT_DEFINITIONS[adapter.id];
+    if (definition === undefined)
+        throw new Error('This Agent has no verified installation method.');
+    const methods = [];
+    const note = definition.note ?? 'Follow the official prerequisites. Updating does not sign you in or change your Agent settings.';
+    const manual = (instructions = note) => ({ id: 'manual', label: 'Official guide', command: null, instructions, executable: false });
+    const bundled = /\.app[\\/]Contents[\\/]|[\\/]resources[\\/]app(?:\.asar)?[\\/]/iu.test(adapter.command ?? '');
+    const unsupported = !['darwin', 'linux', 'win32'].includes(platform)
+        || (platform === 'win32' && arch === 'arm64' && ['qoder', 'qoder-cn'].includes(adapter.id));
+    if (definition.manual || unsupported || bundled) {
+        const instructions = bundled ? 'This runtime is bundled with an application. Update the owning application using its official instructions.'
+            : unsupported ? `No automated method is supported for ${platform}/${arch}. Check the official platform requirements. ${note}` : note;
+        return { sourceUrl: definition.sourceUrl, methods: [manual(instructions)] };
+    }
+    const command = (id, label, file, args, instructions = note) => {
+        methods.push({ id, label, command: [file, ...args].map(displayArgument).join(' '), instructions, executable: true, invocation: { file, args } });
+    };
+    if (action === 'update' && definition.update && adapter.command) {
+        command('native', 'Built-in updater', adapter.command, definition.update);
+    }
+    if (action === 'install' || (action === 'update' && adapter.id === 'codex')) {
+        if (platform === 'win32' && definition.powershell) {
+            const script = `$ErrorActionPreference = 'Stop'; irm '${definition.powershell}' | iex`;
+            command('installer', 'Official PowerShell installer', 'powershell.exe', ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command', script]);
+            methods[methods.length - 1] = { ...methods.at(-1), command: `irm '${definition.powershell}' | iex` };
+        }
+        else if (platform !== 'win32' && definition.script) {
+            const script = `curl -fsSL '${definition.script}' | ${definition.scriptShell ?? 'bash'}`;
+            command('installer', 'Official installer', 'bash', ['-o', 'pipefail', '-c', script]);
+            methods[methods.length - 1] = { ...methods.at(-1), command: script };
+        }
+    }
+    const npmPackage = managementNpmPackage(adapter);
+    if (npmPackage && !(platform === 'win32' && definition.windowsManual)) {
+        command('npm', 'npm (global)', 'npm', ['install', '-g', `${npmPackage}@latest`, ...(definition.npmArgs ?? [])]);
+    }
+    if (definition.brew && platform !== 'win32' && (!definition.brew.includes('--cask') || platform === 'darwin')) {
+        command('brew', 'Homebrew', 'brew', [action === 'install' ? 'install' : 'upgrade', ...definition.brew]);
+    }
+    methods.push(manual(methods.length === 0 ? `No unattended command has been verified for ${platform}. Follow the official guide. ${note}` : note));
+    return { sourceUrl: definition.sourceUrl, methods };
+}
+function displayArgument(value) {
+    return /^[\w@./:=,+-]+$/u.test(value) ? value : JSON.stringify(value);
+}
+/** Select only a matching package owner or an official self-updater. */
+export function automaticUpdateMethod(adapter, methods, platform) {
+    const definition = AGENT_MANAGEMENT_DEFINITIONS[adapter.id];
+    const path = (adapter.command ?? '').replaceAll('\\', '/');
+    const absolute = platform === 'win32' ? /^(?:[A-Za-z]:\/|\/\/)/u.test(path) : path.startsWith('/');
+    const has = (id) => methods.some(method => method.id === id && method.executable);
+    if (!definition || !adapter.installed)
+        return undefined;
+    if (adapter.id === 'claude-code' && path === 'claude' && has('native'))
+        return 'native';
+    if (!absolute)
+        return undefined;
+    if (adapter.id === 'kimi' && Number(adapter.version?.match(/^v?(\d+)\./u)?.[1] ?? 0) < 2)
+        return undefined;
+    const brew = path.match(/^(.*)\/(?:Cellar|Caskroom)\/([^/]+)\//u);
+    const brewPackage = brew?.[2];
+    if (brew && has('brew') && (definition.brew?.at(-1) === brewPackage || (adapter.id === 'claude-code' && brewPackage === 'claude-code@latest'))) {
+        const method = methods.find(method => method.id === 'brew');
+        const file = `${brew[1]}/bin/brew`;
+        const args = [...method.invocation.args.slice(0, -1), brewPackage];
+        methods[methods.indexOf(method)] = { ...method, command: [file, ...args].map(displayArgument).join(' '), invocation: { file, args } };
+        return 'brew';
+    }
+    if (/\/(?:scoop|WinGet|nix\/store)\//iu.test(path))
+        return undefined;
+    if (['command-code', 'claude-code', 'opencode'].includes(adapter.id) && has('native') && !brew)
+        return 'native';
+    if (/\/(?:\.bun|\.pnpm)\//iu.test(path))
+        return undefined;
+    const npmPackage = managementNpmPackage(adapter);
+    if (npmPackage && has('npm')) {
+        const marker = `${platform === 'win32' ? '' : '/lib'}/node_modules/${npmPackage}/`;
+        const index = path.indexOf(marker);
+        if (index > 0 && (!brew || /^node(?:@\d+)?$/u.test(brewPackage))) {
+            const method = methods.find(method => method.id === 'npm');
+            const args = [...method.invocation.args, '--prefix', path.slice(0, index)];
+            methods[methods.indexOf(method)] = { ...method, command: ['npm', ...args].map(displayArgument).join(' '), invocation: { file: 'npm', args } };
+            return 'npm';
+        }
+    }
+    // These distributions require their package manager, not a guessed self-update.
+    if (brew || /\/node_modules\//iu.test(path))
+        return undefined;
+    if (adapter.id === 'codex' && has('installer')) {
+        const directory = codexStandaloneDirectory(path, platform);
+        if (!directory || path !== `${directory.replace(/\/$/u, '')}/codex`)
+            return undefined;
+        const method = methods.find(method => method.id === 'installer');
+        // Pass the directory as an argument: spaces and shell syntax must never become shell code.
+        const script = `curl -fsSL '${definition.script}' | CODEX_NON_INTERACTIVE=1 CODEX_INSTALL_DAEMON_ONLY=0 CODEX_INSTALL_DEFER_SELECTION=0 CODEX_INSTALL_DIR="$1" sh -s -- --release latest`;
+        const args = ['-o', 'pipefail', '-c', script, 'codingns-codex-update', directory];
+        methods[methods.indexOf(method)] = { ...method,
+            command: `curl -fsSL '${definition.script}' | CODEX_NON_INTERACTIVE=1 CODEX_INSTALL_DIR=${displayArgument(directory)} sh -s -- --release latest`,
+            invocation: { file: 'bash', args } };
+        return 'installer';
+    }
+    if (platform === 'win32' && adapter.id === 'grok')
+        return undefined;
+    if (adapter.id === 'pi' && !/\/\.local\//u.test(path))
+        return undefined;
+    return has('native') ? 'native' : undefined;
+}
+//# sourceMappingURL=management-methods.js.map

package/data/build/dist/host/cli-adapters/management-methods.js.map

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

package/data/build/dist/host/cli-adapters/management-process.d.ts

@@ -0,0 +1,7 @@
+import type { ManagementCommand } from './management-methods.js';
+export type ManagementRunner = (command: ManagementCommand, signal: AbortSignal, onOutput: (text: string) => void) => Promise<number | null>;
+/** Run a fixed publisher command without an interactive shell or privilege escalation. */
+export declare const runManagementCommand: ManagementRunner;
+/** Apply redaction to the whole bounded buffer so chunk boundaries cannot split a secret. */
+export declare function managementOutput(text: string): string;
+//# sourceMappingURL=management-process.d.ts.map

package/data/build/dist/host/cli-adapters/management-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-process.d.ts","sourceRoot":"","sources":["../../../../../src/host/cli-adapters/management-process.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;AAE5I,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,EAAE,gBA8BlC,CAAA;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD"}

package/data/build/dist/host/cli-adapters/management-process.js

@@ -0,0 +1,51 @@
+import { spawn } from 'node:child_process';
+import { homedir } from 'node:os';
+import { stripVTControlCharacters } from 'node:util';
+import { commandEnvironment, resolveCommandPath, terminateChildProcess, windowsShellInvocation, WINDOWS } from './process-utils.js';
+/** Run a fixed publisher command without an interactive shell or privilege escalation. */
+export const runManagementCommand = async (command, signal, onOutput) => {
+    signal.throwIfAborted();
+    const file = await resolveCommandPath(command.file);
+    if (file === null)
+        throw new Error(`Required command is unavailable: ${command.file}. Install the prerequisite and try again.`);
+    signal.throwIfAborted();
+    const batch = WINDOWS && /\.(?:cmd|bat)$/iu.test(file);
+    const invocation = batch ? windowsShellInvocation(file, command.args) : { command: file, args: command.args };
+    return new Promise((resolve, reject) => {
+        const child = spawn(invocation.command, [...invocation.args], {
+            cwd: homedir(), env: { ...commandEnvironment(file), NO_COLOR: '1', FORCE_COLOR: '0' },
+            stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
+            detached: !WINDOWS, ...(batch ? { windowsVerbatimArguments: true } : {}),
+        });
+        const stop = () => {
+            if (!WINDOWS && child.pid !== undefined) {
+                try {
+                    process.kill(-child.pid, 'SIGKILL');
+                    return;
+                }
+                catch { /* Fall back if the process group has already exited. */ }
+            }
+            terminateChildProcess(child, 'SIGKILL');
+        };
+        const output = (chunk) => onOutput(chunk);
+        child.stdout.setEncoding('utf8').on('data', output);
+        child.stderr.setEncoding('utf8').on('data', output);
+        signal.addEventListener('abort', stop, { once: true });
+        if (signal.aborted)
+            stop();
+        child.once('error', reject);
+        child.once('close', (code) => {
+            signal.removeEventListener('abort', stop);
+            resolve(code);
+        });
+    });
+};
+/** Apply redaction to the whole bounded buffer so chunk boundaries cannot split a secret. */
+export function managementOutput(text) {
+    return stripVTControlCharacters(text)
+        .replace(/(https?:\/\/)[^\s/@]+:[^\s/@]+@/giu, '$1[redacted]@')
+        .replace(/((?:authorization|token|api[_-]?key|password)\s*[:=]\s*)(?:Bearer\s+)?[^\s,;]+/giu, '$1[redacted]')
+        .replace(/\b(?:sk|ghp|gho|npm)_[A-Za-z0-9_-]{12,}\b|\bsk-[A-Za-z0-9_-]{12,}\b/gu, '[redacted]')
+        .replace(/[\x00-\x08\x0b-\x1f\x7f]/gu, '');
+}
+//# sourceMappingURL=management-process.js.map

package/data/build/dist/host/cli-adapters/management-process.js.map

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

package/data/build/dist/host/cli-adapters/management.d.ts

@@ -0,0 +1,32 @@
+import type { CodingNsCliAdapterDescriptor } from '../../shared/contracts/cli-adapter.js';
+import type { CliManagementAction, CliManagementOperation, CliManagementPlan } from '../../shared/contracts/cli-management.js';
+import { type ManagementRunner } from './management-process.js';
+export interface ManagementRegistry {
+    refreshCatalog(adapterId: string): Promise<readonly CodingNsCliAdapterDescriptor[]>;
+    beginMaintenance(adapterId: string): () => void;
+}
+/** One Host-owned operation survives dialog closure, but never feature disposal. */
+export declare class CliManagementService {
+    private readonly registry;
+    private readonly options;
+    private operation;
+    private disposed;
+    constructor(registry: ManagementRegistry, options?: {
+        readonly run?: ManagementRunner;
+        readonly platform?: NodeJS.Platform;
+        readonly arch?: string;
+        readonly timeoutMs?: number;
+        readonly resolveCommand?: (command: string) => Promise<string | null>;
+    });
+    plan(adapterId: string, action: CliManagementAction): Promise<CliManagementPlan>;
+    private preparePlan;
+    start(payload: unknown): CliManagementOperation;
+    status(): CliManagementOperation | null;
+    cancel(id: string): CliManagementOperation | null;
+    dispose(): Promise<void>;
+    rpc(action: string, payload: unknown): Promise<unknown>;
+    private perform;
+    private detectResult;
+    private assertAvailable;
+}
+//# sourceMappingURL=management.d.ts.map

package/data/build/dist/host/cli-adapters/management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../../../../src/host/cli-adapters/management.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AACzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAK9H,OAAO,EAA0C,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAEvG,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,4BAA4B,EAAE,CAAC,CAAA;IACnF,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,IAAI,CAAA;CAChD;AASD,oFAAoF;AACpF,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAsB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHnF,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAQ;gBAEK,QAAQ,EAAE,kBAAkB,EAAmB,OAAO,GAAE;QACnF,QAAQ,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAA;QAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;QACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;KACjE;IAEA,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAIxE,WAAW;IAqBzB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB;IAgB/C,MAAM,IAAI,sBAAsB,GAAG,IAAI;IAIvC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAM3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAY/C,OAAO;YA2CP,YAAY;IAM1B,OAAO,CAAC,eAAe;CAGxB"}

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

@@ -0,0 +1,172 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { CodingNsRpcError } from '../rpc-table.js';
+import { automaticUpdateMethod, managementMethods, AGENT_MANAGEMENT_DEFINITIONS } from './management-methods.js';
+import { resolveManagementInstallation } from './management-installation.js';
+import { isNewerAgentVersion } from './update-check.js';
+import { managementOutput, runManagementCommand } from './management-process.js';
+/** One Host-owned operation survives dialog closure, but never feature disposal. */
+export class CliManagementService {
+    registry;
+    options;
+    operation;
+    disposed = false;
+    constructor(registry, options = {}) {
+        this.registry = registry;
+        this.options = options;
+    }
+    async plan(adapterId, action) {
+        return (await this.preparePlan(adapterId, action)).plan;
+    }
+    async preparePlan(adapterId, action) {
+        this.assertAvailable();
+        const adapter = (await this.registry.refreshCatalog(adapterId)).find((entry) => entry.id === adapterId);
+        this.assertAvailable();
+        if (adapter === undefined)
+            throw failure('INVALID_AGENT', 'Unknown Agent.');
+        if (adapter.detectionState !== 'ready' || adapter.detectionFailure)
+            throw failure('DETECTION_FAILED', 'Re-detect this Agent successfully before installing or updating it.');
+        if ((action === 'install') === adapter.installed)
+            throw failure('STATE_CHANGED', 'The installation state changed. Close this dialog and re-detect the Agent.');
+        const platform = this.options.platform ?? process.platform;
+        const resolved = action === 'update' && adapter.command
+            ? await (this.options.resolveCommand ?? ((command) => resolveManagementInstallation(command, AGENT_MANAGEMENT_DEFINITIONS[adapter.id]?.npm)))(adapter.command) : null;
+        this.assertAvailable();
+        const installation = action === 'update' ? { ...adapter, command: resolved } : adapter;
+        const { sourceUrl, methods } = managementMethods(installation, action, platform, this.options.arch ?? process.arch);
+        const automaticMethodId = action === 'update' ? automaticUpdateMethod(installation, methods, platform) : methods.find(method => method.executable)?.id;
+        const publicMethods = methods.map(({ invocation: _invocation, ...method }) => method);
+        const fingerprint = createHash('sha256').update(JSON.stringify({ adapterId, action, platform, version: adapter.version, command: adapter.command, methods: publicMethods, automaticMethodId })).digest('hex');
+        const plan = { adapter, action, platform, sourceUrl, methods: publicMethods, fingerprint,
+            ...(automaticMethodId === undefined ? {} : { automaticMethodId }) };
+        return { plan, methods };
+    }
+    start(payload) {
+        this.assertAvailable();
+        const input = readInput(payload);
+        const methodId = readString(input, 'methodId');
+        const fingerprint = readString(input, 'fingerprint');
+        if (this.operation?.snapshot.state === 'running')
+            throw failure('BUSY', 'Another Agent installation or update is already running on this Host.');
+        const release = this.registry.beginMaintenance(input.adapterId);
+        const operation = {
+            snapshot: { id: randomUUID(), adapterId: input.adapterId, action: input.action, state: 'running', output: '' },
+            controller: new AbortController(), completion: Promise.resolve(), output: '',
+        };
+        this.operation = operation;
+        operation.completion = this.perform(operation, methodId, fingerprint).finally(release);
+        return { ...operation.snapshot };
+    }
+    status() {
+        return this.operation === undefined ? null : { ...this.operation.snapshot, output: managementOutput(this.operation.output) };
+    }
+    cancel(id) {
+        if (this.operation?.snapshot.id !== id)
+            throw failure('STATE_CHANGED', 'This operation is no longer current.');
+        if (this.operation.snapshot.state === 'running')
+            this.operation.controller.abort(new Error('Operation cancelled. Files already installed are not rolled back.'));
+        return this.status();
+    }
+    async dispose() {
+        this.disposed = true;
+        this.operation?.controller.abort(new Error('Agent management stopped.'));
+        await this.operation?.completion;
+    }
+    async rpc(action, payload) {
+        const input = record(payload);
+        if (input.catalogHostId !== 'local')
+            throw failure('LOCAL_ONLY', 'Agent installation and updates are available only for the local Host.');
+        switch (action) {
+            case 'management/plan': {
+                const request = readInput(payload);
+                return this.plan(request.adapterId, request.action);
+            }
+            case 'management/start': return this.start(payload);
+            case 'management/status': return this.status();
+            case 'management/cancel': return this.cancel(readString(input, 'operationId'));
+            default: throw failure('INVALID_REQUEST', 'Unknown Agent management action.');
+        }
+    }
+    async perform(operation, methodId, fingerprint) {
+        const { adapterId, action } = operation.snapshot;
+        const signal = operation.controller.signal;
+        const timer = setTimeout(() => operation.controller.abort(new Error('The operation timed out. Check the official guide before retrying.')), this.options.timeoutMs ?? 10 * 60_000);
+        timer.unref?.();
+        let executed = false;
+        let state = 'succeeded';
+        try {
+            signal.throwIfAborted();
+            const { plan, methods } = await this.preparePlan(adapterId, action);
+            signal.throwIfAborted();
+            if (plan.fingerprint !== fingerprint)
+                throw failure('STATE_CHANGED', 'The Agent or installation method changed. Reopen the action to review it again.');
+            if (action === 'update' && methodId !== plan.automaticMethodId)
+                throw failure('METHOD_UNAVAILABLE', 'No matching automatic updater was identified. Re-detect the installation or follow the official guide.');
+            const method = methods.find((entry) => entry.id === methodId);
+            if (!method?.executable || method.invocation === undefined)
+                throw failure('MANUAL_REQUIRED', 'Use the official guide for this installation method.');
+            executed = true;
+            const code = await (this.options.run ?? runManagementCommand)(method.invocation, signal, (chunk) => {
+                operation.output = (operation.output + chunk).slice(-32_768);
+            });
+            signal.throwIfAborted();
+            if (code !== 0)
+                throw failure('COMMAND_FAILED', `The command exited with ${code === null ? 'no exit code' : `code ${code}`}. Review its output and the official guide.`);
+            const adapter = await this.detectResult(adapterId);
+            signal.throwIfAborted();
+            operation.snapshot = { ...operation.snapshot, adapter };
+            if (!adapter.installed || adapter.detectionState !== 'ready' || adapter.detectionFailure) {
+                throw failure('VERIFY_FAILED', 'The command completed, but the Agent could not be verified. Check PATH and prerequisites, then re-detect.');
+            }
+            if (action === 'update' && plan.adapter.version && (!adapter.version || isNewerAgentVersion(plan.adapter.version, adapter.version, adapter.id) !== true)) {
+                throw failure('VERSION_UNCHANGED', `The updater finished, but the detected version did not advance (${plan.adapter.version} → ${adapter.version ?? 'unknown'}). Its release channel, registry cache, or installation path may differ from the update check. Review the output and refresh before retrying.`);
+            }
+        }
+        catch (error) {
+            const message = signal.aborted ? signal.reason : error;
+            state = signal.aborted && !String(message).includes('timed out') ? 'cancelled' : 'failed';
+            operation.snapshot = { ...operation.snapshot, error: managementOutput(message instanceof Error ? message.message : String(message)) };
+            if (executed && !this.disposed && operation.snapshot.adapter === undefined) {
+                try {
+                    operation.snapshot = { ...operation.snapshot, adapter: await this.detectResult(adapterId) };
+                }
+                catch { /* Preserve the command error if detection also fails. */ }
+            }
+        }
+        finally {
+            clearTimeout(timer);
+            operation.snapshot = { ...operation.snapshot, state };
+        }
+    }
+    async detectResult(adapterId) {
+        const adapter = (await this.registry.refreshCatalog(adapterId)).find((entry) => entry.id === adapterId);
+        if (adapter === undefined)
+            throw failure('INVALID_AGENT', 'The Agent is no longer registered.');
+        return adapter;
+    }
+    assertAvailable() {
+        if (this.disposed)
+            throw failure('UNAVAILABLE', 'Agent management is stopped.');
+    }
+}
+function readInput(payload) {
+    const input = record(payload);
+    const adapterId = readString(input, 'adapterId');
+    if (input.action !== 'install' && input.action !== 'update')
+        throw failure('INVALID_REQUEST', 'Choose install or update.');
+    return { ...input, adapterId, action: input.action };
+}
+function record(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        throw failure('INVALID_REQUEST', 'Invalid Agent management request.');
+    return value;
+}
+function readString(input, key) {
+    const value = input[key];
+    if (typeof value !== 'string' || !value.trim() || value.length > 256)
+        throw failure('INVALID_REQUEST', `Invalid ${key}.`);
+    return value;
+}
+function failure(code, message) {
+    return new CodingNsRpcError(`CODINGNS_CLI_MANAGEMENT_${code}`, message);
+}
+//# sourceMappingURL=management.js.map

package/data/build/dist/host/cli-adapters/management.js.map

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

package/data/build/dist/host/cli-adapters/model-catalog.d.ts

@@ -18,6 +18,7 @@ export declare function resolveGeminiEfforts(modelId: string): readonly string[]
  */
 export declare const CLAUDE_EFFORT_LEVELS: readonly ["low", "medium", "high", "xhigh", "max"];
 export declare const CLAUDE_CATALOG: CodingNsCliModelCatalog;
+export declare function knownClaudeContextWindow(modelId: string | undefined): number | undefined;
 export declare const KIMI_CATALOG: CodingNsCliModelCatalog;
 export declare const GEMINI_CATALOG: CodingNsCliModelCatalog;
 export declare const CODEX_CATALOG: CodingNsCliModelCatalog;

package/data/build/dist/host/cli-adapters/model-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../../../../src/host/cli-adapters/model-catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../../../../src/host/cli-adapters/model-catalog.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/cli-adapters/model-catalog.js

@@ -52,6 +52,68 @@ export const CLAUDE_CATALOG = staticCatalog('claude', 'Claude', [
     { id: 'opus', efforts: CLAUDE_EFFORT_LEVELS },
     { id: 'haiku', efforts: CLAUDE_EFFORT_LEVELS },
 ]);
+/**
+ * Claude Code 的 stream-json usage 通常不带上下文容量；这些是 CLI 当前
+ * 已确认的模型/别名窗口，只用于 Provider 首个 usage 到达前的占位。
+ * `result.modelUsage[*].contextWindow` 到达后由驱动优先采用实测值。
+ */
+const CLAUDE_CONTEXT_WINDOWS = new Map([
+    ['claude-haiku-4-5', 200_000],
+    ['claude-haiku-4-5-20251001', 200_000],
+    ['claude-haiku-4.5', 200_000],
+    ['claude-haiku-3-5', 200_000],
+    ['claude-opus-4', 200_000],
+    ['claude-opus-4-0', 200_000],
+    ['claude-opus-4-20250514', 200_000],
+    ['claude-opus-4-1', 200_000],
+    ['claude-opus-4-1-20250805', 200_000],
+    ['claude-opus-4-5', 200_000],
+    ['claude-opus-4-5-20251101', 200_000],
+    ['claude-opus-4-6', 200_000],
+    ['claude-opus-4-6-v1', 200_000],
+    ['claude-opus-4-7', 1_000_000],
+    ['claude-opus-4-8', 1_000_000],
+    ['claude-opus-5', 1_000_000],
+    ['claude-opus-5-5', 1_000_000],
+    ['claude-fable-5', 1_000_000],
+    ['claude-fable-5-1', 1_000_000],
+    ['claude-mythos-5', 1_000_000],
+    ['claude-mythos-5-1', 1_000_000],
+    ['claude-sonnet-4', 200_000],
+    ['claude-sonnet-4-0', 200_000],
+    ['claude-sonnet-4-20250514', 200_000],
+    ['claude-sonnet-4-5', 200_000],
+    ['claude-sonnet-4-5-20250929', 200_000],
+    ['claude-sonnet-4-6', 200_000],
+    ['claude-sonnet-5', 1_000_000],
+    ['claude-sonnet-5-5', 1_000_000],
+    ['haiku', 200_000],
+    ['opus', 1_000_000],
+    ['sonnet', 1_000_000],
+]);
+export function knownClaudeContextWindow(modelId) {
+    if (modelId === undefined)
+        return undefined;
+    const normalized = modelId.trim().toLowerCase();
+    if (normalized === '')
+        return undefined;
+    if (/\[1m\]$/u.test(normalized))
+        return 1_000_000;
+    const candidates = new Set([normalized]);
+    const providerModel = normalized.indexOf('claude-');
+    if (providerModel >= 0)
+        candidates.add(normalized.slice(providerModel));
+    for (const candidate of [...candidates]) {
+        candidates.add(candidate.replace(/\.(?=\d)/gu, '-'));
+        candidates.add(candidate.replace(/(?:-v\d+(?::\d+)?|-\d{8}|@\d{8})$/u, ''));
+    }
+    for (const candidate of candidates) {
+        const contextWindow = CLAUDE_CONTEXT_WINDOWS.get(candidate);
+        if (contextWindow !== undefined)
+            return contextWindow;
+    }
+    return undefined;
+}
 export const KIMI_CATALOG = staticCatalog('kimi', 'Kimi', [
     { id: 'provider-default', name: '跟随 Kimi 默认模型', efforts: ['off', 'low', 'medium', 'high', 'xhigh', 'max'] },
     { id: 'kimi-k2.5', efforts: ['off', 'low', 'medium', 'high', 'xhigh', 'max'] },