@ganglion/xacpx 0.17.0-beta.7 → 0.17.0-beta.8

package/README.md

@@ -124,6 +124,7 @@ The essentials to get going. Full references: **CLI → [cli-reference.md](./doc
 | `xacpx login` / `logout` | Log in / out of WeChat |
 | `xacpx start` / `stop` / `restart` / `status` | Manage the background service |
 | `xacpx update` | Update xacpx and installed plugins |
+| `xacpx adapter list` / `update <name>` / `registry` | Manage verified Codex/Claude ACP adapter pins and their npm registry |
 | `xacpx doctor` | Run environment diagnostics |
 | `xacpx channel add <name>` | Add a message channel (Feishu / Yuanbao / …) |
 | `xacpx ws add` / `xacpx agent add <name>` | Register a workspace / agent |

package/dist/adapters/adapter-catalog.d.ts

@@ -0,0 +1,25 @@
+export declare const MANAGED_ADAPTERS: {
+    readonly codex: {
+        readonly packageName: "@agentclientprotocol/codex-acp";
+        readonly binName: "codex-acp";
+        readonly defaultVersion: "1.1.4";
+    };
+    readonly claude: {
+        readonly packageName: "@agentclientprotocol/claude-agent-acp";
+        readonly binName: "claude-agent-acp";
+        readonly defaultVersion: "0.59.0";
+    };
+};
+export type ManagedAdapterId = keyof typeof MANAGED_ADAPTERS;
+export type AdapterVersionOverrides = Partial<Record<ManagedAdapterId, string>>;
+export declare function isManagedAdapterId(value: string): value is ManagedAdapterId;
+export declare function listManagedAdapterIds(): ManagedAdapterId[];
+export declare function isExactAdapterVersion(value: string): boolean;
+export declare function effectiveAdapterVersion(id: ManagedAdapterId, overrides: AdapterVersionOverrides | undefined): string;
+export declare function buildManagedAdapterCommand(id: ManagedAdapterId, version: string, registry?: string): string;
+export declare function resolveManagedAdapterCommand(driver: string, overrides?: AdapterVersionOverrides, registry?: string): string | undefined;
+export declare function isManagedAdapterCommand(driver: string, command: string | undefined): boolean;
+export declare function managedAdapterRegistryFromCommand(command: string | undefined): string | undefined;
+/** A recorded generated command is derived state, so a newer configured/default
+ * version replaces it. Truly custom commands remain sticky for session identity. */
+export declare function preferCurrentManagedAdapterCommand(driver: string, recorded: string | undefined, current: string | undefined): string | undefined;

package/dist/adapters/adapter-registry.d.ts

@@ -0,0 +1,18 @@
+export declare const DEFAULT_ADAPTER_REGISTRY = "https://registry.npmjs.org/";
+export declare class AdapterRegistryPackageNotFoundError extends Error {
+    readonly registry: string;
+    readonly code = "E404";
+    constructor(registry: string);
+}
+/** Validates and canonicalizes a registry URL before it reaches config or argv. */
+export declare function normalizeAdapterRegistry(value: string): string;
+export declare function effectiveAdapterRegistry(configured: string | undefined): string;
+/** npm chooses a scope-specific registry over the generic registry, so both
+ * flags are required to override company .npmrc files deterministically. */
+export declare function adapterRegistryNpmArgs(registry: string): string[];
+export declare function adapterRegistryE404Guidance(registry: string): string;
+export declare function isAdapterRegistryNotFoundOutput(output: string): boolean;
+/** Runtime errors can also contain API/model 404s. Only classify them as an
+ * adapter registry failure when npm itself is present in the diagnostic. */
+export declare function isNpmAdapterRegistryNotFoundOutput(output: string): boolean;
+export declare function describeAdapterRegistryError(error: unknown): string;

package/dist/bridge/bridge-main.js

@@ -1194,6 +1194,7 @@ Help: /help ssn`,
 var recovery;
 var init_recovery = __esm(() => {
   recovery = {
+    adapterRegistryE404: (registry, officialRegistry) => `npm registry ${registry} returned E404 for the managed adapter. Run \`xacpx adapter registry set ${officialRegistry}\` and \`xacpx restart\`, or ask your registry administrator to proxy/allowlist the @agentclientprotocol scope.`,
     transientSessionFailed: "The scheduled task's temporary session failed to start; this run was not executed.",
     transientSessionHint: "Temporary sessions are created automatically at run time — no manual action needed. To reschedule, use /lt.",
     sessionUnavailable: (alias) => `Current session "${alias}" is temporarily unavailable.`,
@@ -1705,6 +1706,8 @@ var init_cli = __esm(() => {
       "xacpx doctor - Run diagnostics",
       "xacpx version - Show version",
       "xacpx agent|agents list|add|rm|templates - Manage local agents",
+      "xacpx adapter list|check [name]|update (<name>|--all)|set <name> <version>|reset <name> - Manage ACP adapter versions",
+      "xacpx adapter registry [set <url>|reset] - Manage the ACP adapter npm registry",
       "xacpx workspace list|add [name] [--raw]|rm <name> - Manage local workspaces (alias: ws)",
       "xacpx later|lt list|cancel <id> - Manage local scheduled tasks",
       "xacpx mcp-stdio [--coordinator-session <session>] [--source-handle <handle>] [--workspace <name>] - Start MCP stdio server"
@@ -1745,6 +1748,25 @@ var init_cli = __esm(() => {
     agentSaved: (name) => `Agent "${name}" saved`,
     agentNotFound: (name) => `Agent "${name}" not found.`,
     agentRemoved: (name) => `Agent "${name}" removed`,
+    adapterListHeader: "Managed ACP adapters:",
+    adapterListRow: (id, effective, defaultVersion, source) => `${id}: effective=${effective} default=${defaultVersion} source=${source}`,
+    adapterSourceDefault: "xacpx-default",
+    adapterSourceConfigured: "configured",
+    adapterUnsupported: (id) => `Unsupported managed adapter "${id}". Available: codex, claude`,
+    adapterInvalidVersion: (version) => `Adapter version must be an exact semver value: ${version}`,
+    adapterVersionUnavailable: (id, version) => `${id} adapter version ${version} is not published by npm.`,
+    adapterLatestUnavailable: (id) => `Could not resolve the latest ${id} adapter version from npm.`,
+    adapterCheckRow: (id, effective, latest) => `${id}: effective=${effective} latest=${latest}`,
+    adapterAlreadyLatest: (id, version) => `${id} already uses the latest adapter version ${version}.`,
+    adapterVerifying: (id, version) => `Verifying ${id} adapter ${version} with ACP initialize...`,
+    adapterSaved: (id, version) => `${id} adapter version set to ${version}.`,
+    adapterReset: (id, version) => `${id} adapter override removed; effective version is ${version}.`,
+    adapterFailed: (id, detail) => `Failed to update ${id} adapter: ${detail}`,
+    adapterRestartRequired: "Restart the xacpx daemon before using the new adapter settings.",
+    adapterRegistryCurrent: (registry, source) => `Adapter registry: ${registry} (source=${source})`,
+    adapterRegistrySaved: (registry) => `Adapter registry set to ${registry}.`,
+    adapterRegistryReset: (registry) => `Adapter registry override removed; using ${registry}.`,
+    adapterInvalidRegistry: (detail) => `Invalid adapter registry: ${detail}`,
     laterIdEmpty: "Scheduled task ID cannot be empty.",
     laterNotFound: (id) => `Pending scheduled task #${id} not found.`,
     laterNotFoundHint: "Run xacpx later list to see current pending tasks.",
@@ -2291,6 +2313,7 @@ var init_native_session2 = __esm(() => {
 var recovery2;
 var init_recovery2 = __esm(() => {
   recovery2 = {
+    adapterRegistryE404: (registry, officialRegistry) => `npm registry ${registry} 返回了 managed adapter E404。请执行 \`xacpx adapter registry set ${officialRegistry}\` 和 \`xacpx restart\`，或让私源管理员代理/放行 @agentclientprotocol scope。`,
     transientSessionFailed: "定时任务的临时会话启动失败，本次任务未能执行。",
     transientSessionHint: "临时会话由系统在执行时自动创建，无需手动操作；如需重排，请用 /lt 重新安排。",
     sessionUnavailable: (alias) => `当前会话「${alias}」暂时不可用。`,
@@ -2802,6 +2825,8 @@ var init_cli2 = __esm(() => {
       "xacpx doctor - 运行诊断",
       "xacpx version - 查看版本",
       "xacpx agent|agents list|add|rm|templates - 管理本机 Agent",
+      "xacpx adapter list|check [name]|update (<name>|--all)|set <name> <version>|reset <name> - 管理 ACP adapter 版本",
+      "xacpx adapter registry [set <url>|reset] - 管理 ACP adapter npm registry",
       "xacpx workspace list|add [name] [--raw]|rm <name> - 管理本机工作区（别名：ws）",
       "xacpx later|lt list|cancel <id> - 管理本机待执行定时任务",
       "xacpx mcp-stdio [--coordinator-session <session>] [--source-handle <handle>] [--workspace <name>] - 启动 MCP stdio 服务"
@@ -2842,6 +2867,25 @@ var init_cli2 = __esm(() => {
     agentSaved: (name) => `Agent「${name}」已保存`,
     agentNotFound: (name) => `没有找到 Agent「${name}」。`,
     agentRemoved: (name) => `Agent「${name}」已删除`,
+    adapterListHeader: "受管 ACP adapter：",
+    adapterListRow: (id, effective, defaultVersion, source) => `${id}：生效=${effective} 默认=${defaultVersion} 来源=${source}`,
+    adapterSourceDefault: "xacpx 默认",
+    adapterSourceConfigured: "本机配置",
+    adapterUnsupported: (id) => `不支持受管 adapter「${id}」。可用：codex、claude`,
+    adapterInvalidVersion: (version) => `Adapter 版本必须是精确 semver：${version}`,
+    adapterVersionUnavailable: (id, version) => `npm 未发布 ${id} adapter 版本 ${version}。`,
+    adapterLatestUnavailable: (id) => `无法从 npm 获取 ${id} adapter 的最新版本。`,
+    adapterCheckRow: (id, effective, latest) => `${id}：生效=${effective} 最新=${latest}`,
+    adapterAlreadyLatest: (id, version) => `${id} 已使用最新 adapter 版本 ${version}。`,
+    adapterVerifying: (id, version) => `正在通过 ACP initialize 验证 ${id} adapter ${version}…`,
+    adapterSaved: (id, version) => `${id} adapter 版本已设置为 ${version}。`,
+    adapterReset: (id, version) => `${id} adapter 本机覆盖已删除；当前生效版本为 ${version}。`,
+    adapterFailed: (id, detail) => `${id} adapter 更新失败：${detail}`,
+    adapterRestartRequired: "请重启 xacpx daemon 后再使用新的 adapter 配置。",
+    adapterRegistryCurrent: (registry, source) => `Adapter registry：${registry}（来源=${source}）`,
+    adapterRegistrySaved: (registry) => `Adapter registry 已设置为 ${registry}。`,
+    adapterRegistryReset: (registry) => `Adapter registry 本机覆盖已删除；当前使用 ${registry}。`,
+    adapterInvalidRegistry: (detail) => `Adapter registry 无效：${detail}`,
     laterIdEmpty: "定时任务 ID 不能为空。",
     laterNotFound: (id) => `未找到待执行的定时任务 #${id}。`,
     laterNotFoundHint: "可以用 xacpx later list 查看当前待执行任务。",