@ganglion/xacpx 0.9.0 → 0.9.2

package/dist/commands/command-hints.d.ts

@@ -8,4 +8,4 @@ export interface CommandHint {
  * 从 HELP_TOPICS 派生输入框命令提示（单一真源，与 /help 同源不漂移）。
  * 额外置顶 /help。
  */
-export declare function listWeacpxCommandHints(): CommandHint[];
+export declare function listXacpxCommandHints(): CommandHint[];

package/dist/commands/command-list.d.ts

@@ -1,3 +1,3 @@
-export declare const WEACPX_KNOWN_COMMAND_PREFIXES: readonly ["/help", "/agents", "/workspaces", "/sessions", "/tasks", "/status", "/cancel", "/stop", "/clear", "/mode", "/replymode", "/config", "/permission", "/pm", "/session", "/ss", "/ssn", "/workspace", "/ws", "/use", "/agent", "/delegate", "/dg", "/group", "/groups", "/task", "/later", "/lt"];
-export declare function isKnownWeacpxCommandPrefix(prefix: string): boolean;
-export declare function isKnownWeacpxCommandText(text: string): boolean;
+export declare const XACPX_KNOWN_COMMAND_PREFIXES: readonly ["/help", "/agents", "/workspaces", "/sessions", "/tasks", "/status", "/cancel", "/stop", "/clear", "/mode", "/replymode", "/config", "/permission", "/pm", "/session", "/ss", "/ssn", "/workspace", "/ws", "/use", "/agent", "/delegate", "/dg", "/group", "/groups", "/task", "/later", "/lt"];
+export declare function isKnownXacpxCommandPrefix(prefix: string): boolean;
+export declare function isKnownXacpxCommandText(text: string): boolean;

package/dist/commands/handlers/resolve-reply-mode.d.ts

@@ -0,0 +1,13 @@
+import type { AppConfig, ReplyMode } from "../../config/types";
+/**
+ * The per-channel default reply mode declared on `channels[].replyMode`, or
+ * `undefined` when the channel does not set one (so callers fall through to the
+ * global default). The channel is derived from the chatKey the same way the rest
+ * of the system scopes sessions.
+ */
+export declare function resolveChannelDefaultReplyMode(config: AppConfig | undefined, chatKey: string): ReplyMode | undefined;
+/**
+ * Effective reply mode precedence:
+ *   session override → per-channel default → global channel.replyMode → "verbose".
+ */
+export declare function resolveEffectiveReplyMode(config: AppConfig | undefined, chatKey: string, sessionOverride: ReplyMode | undefined): ReplyMode;

package/dist/config/types.d.ts

@@ -66,6 +66,7 @@ export interface ChannelRuntimeConfig {
     id: string;
     type: string;
     enabled: boolean;
+    replyMode?: ReplyMode;
     options?: Record<string, unknown>;
 }
 export interface PluginConfig {

package/dist/i18n/resolve-locale.d.ts

@@ -3,4 +3,5 @@ export declare function isLocale(value: unknown): value is Locale;
 export declare function resolveLocale(input?: {
     configLanguage?: string;
     env?: NodeJS.ProcessEnv;
+    systemLocale?: string;
 }): Locale;

package/dist/i18n/types.d.ts

@@ -27,10 +27,11 @@ export interface SessionMessages {
     replyModeHeader: string;
     replyModeSessionLabel: (alias: string) => string;
     replyModeGlobalDefault: (value: string) => string;
+    replyModeChannelDefault: (value: string) => string;
     replyModeSessionOverride: (value: string) => string;
     replyModeEffective: (value: string) => string;
     replyModeSet: (replyMode: string) => string;
-    replyModeReset: (globalDefault: string) => string;
+    replyModeReset: (effective: string) => string;
     statusHeader: string;
     statusNameLabel: (alias: string) => string;
     statusAgentLabel: (agent: string) => string;
@@ -503,6 +504,8 @@ export interface ConfigMessages {
     mustBePositiveNumber: (path: string) => string;
     channelTypeDisabled: string;
     channelReplyModeInvalid: string;
+    channelRuntimeNotFound: (id: string) => string;
+    channelRuntimeReplyModeInvalid: (id: string) => string;
     wechatReplyModeInvalid: string;
     wechatReplyModeMapped: (value: string) => string;
     agentNotFound: (name: string) => string;
@@ -658,6 +661,8 @@ export interface ChannelCliMessages {
     channelRemoved: (id: string) => string;
     cannotDisableLastEnabled: string;
     channelEnabledToggled: (id: string, enabled: boolean) => string;
+    channelReplyModeSet: (id: string, mode: string) => string;
+    channelReplyModeInvalid: (mode: string) => string;
     channelAccountAlreadyExists: (type: string, accountId: string) => string;
     channelAccountAdded: (type: string, accountId: string) => string;
     channelReEnabled: (type: string) => string;

package/dist/plugin-api.d.ts

@@ -6,7 +6,7 @@ export type { ChannelRuntimeConfig } from "./config/types.js";
 export type { CommandHint } from "./commands/command-hints.js";
 export type { AppLogger } from "./logging/app-logger.js";
 export type { WeacpxPlugin, XacpxPlugin } from "./plugins/types.js";
-export { WEACPX_PLUGIN_API_VERSION, WEACPX_PLUGIN_API_SUPPORTED_VERSIONS, WEACPX_PLUGIN_MIN_CORE_VERSION, } from "./plugins/types.js";
+export { XACPX_PLUGIN_API_VERSION, XACPX_PLUGIN_API_SUPPORTED_VERSIONS, XACPX_PLUGIN_MIN_CORE_VERSION, WEACPX_PLUGIN_API_VERSION, WEACPX_PLUGIN_API_SUPPORTED_VERSIONS, WEACPX_PLUGIN_MIN_CORE_VERSION, } from "./plugins/types.js";
 export { createConversationExecutor } from "./runtime/conversation-executor.js";
 export type { ConversationExecutor, ConversationExecutorLane } from "./runtime/conversation-executor.js";
 export { resolveTurnLane } from "./runtime/turn-lane.js";

package/dist/plugin-api.js

@@ -88,10 +88,11 @@ var init_session = __esm(() => {
     replyModeHeader: "Current reply mode:",
     replyModeSessionLabel: (alias) => `- Session: ${alias}`,
     replyModeGlobalDefault: (value) => `- Global default: ${value}`,
+    replyModeChannelDefault: (value) => `- Channel default: ${value}`,
     replyModeSessionOverride: (value) => `- Session override: ${value}`,
     replyModeEffective: (value) => `- Effective: ${value}`,
     replyModeSet: (replyMode) => `Current session reply mode set to: ${replyMode}`,
-    replyModeReset: (globalDefault) => `Session reply mode reset. Falling back to global default: ${globalDefault}`,
+    replyModeReset: (effective) => `Session reply mode reset. Now effective: ${effective}`,
     statusHeader: "Current session:",
     statusNameLabel: (alias) => `- Name: ${alias}`,
     statusAgentLabel: (agent) => `- Agent: ${agent}`,
@@ -634,6 +635,8 @@ var init_config = __esm(() => {
     mustBePositiveNumber: (path) => `${path} must be a positive number.`,
     channelTypeDisabled: "channel.type is a legacy single-channel field; /config set writes are disabled. Use `xacpx channel ...` to manage channels[], then restart xacpx.",
     channelReplyModeInvalid: "channel.replyMode only supports: stream, final, verbose",
+    channelRuntimeNotFound: (id) => `Channel "${id}" does not exist; add it first with \`xacpx channel add ${id}\`.`,
+    channelRuntimeReplyModeInvalid: (id) => `channels.${id}.replyMode only supports: stream, final, verbose`,
     wechatReplyModeInvalid: "wechat.replyMode only supports: stream, final, verbose",
     wechatReplyModeMapped: (value) => `${value} (mapped to channel.replyMode)`,
     agentNotFound: (name) => `Agent "${name}" does not exist. Create it first.`,
@@ -854,6 +857,8 @@ var init_channel_cli = __esm(() => {
     channelRemoved: (id) => `Channel ${id} removed`,
     cannotDisableLastEnabled: "Cannot disable the last enabled channel.",
     channelEnabledToggled: (id, enabled) => `Channel ${id} ${enabled ? "enabled" : "disabled"}`,
+    channelReplyModeSet: (id, mode) => `Channel ${id} default reply mode set to: ${mode}`,
+    channelReplyModeInvalid: (mode) => `reply mode must be stream / final / verbose, got: ${mode}`,
     channelAccountAlreadyExists: (type, accountId) => `Account ${accountId} already exists on channel ${type}; run xacpx channel rm ${type} --account ${accountId} first`,
     channelAccountAdded: (type, accountId) => `Channel ${type} account ${accountId} added`,
     channelReEnabled: (type) => `Channel ${type} was disabled; it has been automatically re-enabled.`,
@@ -1154,10 +1159,11 @@ var init_session2 = __esm(() => {
     replyModeHeader: "当前 reply mode：",
     replyModeSessionLabel: (alias) => `- 会话：${alias}`,
     replyModeGlobalDefault: (value) => `- 全局默认：${value}`,
+    replyModeChannelDefault: (value) => `- 频道默认：${value}`,
     replyModeSessionOverride: (value) => `- 当前会话覆盖：${value}`,
     replyModeEffective: (value) => `- 当前生效：${value}`,
     replyModeSet: (replyMode) => `已设置当前会话 reply mode：${replyMode}`,
-    replyModeReset: (globalDefault) => `已重置当前会话 reply mode，当前回退到全局默认：${globalDefault}`,
+    replyModeReset: (effective) => `已重置当前会话 reply mode，当前生效：${effective}`,
     statusHeader: "当前会话：",
     statusNameLabel: (alias) => `- 名称：${alias}`,
     statusAgentLabel: (agent2) => `- Agent：${agent2}`,
@@ -1700,6 +1706,8 @@ var init_config2 = __esm(() => {
     mustBePositiveNumber: (path) => `${path} 必须是正数。`,
     channelTypeDisabled: "channel.type 是旧单频道字段，/config set 已禁用写入；请使用 `xacpx channel ...` 管理 channels[]，然后重启 xacpx。",
     channelReplyModeInvalid: "channel.replyMode 只支持：stream、final、verbose",
+    channelRuntimeNotFound: (id) => `频道「${id}」不存在；请先用 \`xacpx channel add ${id}\` 添加。`,
+    channelRuntimeReplyModeInvalid: (id) => `channels.${id}.replyMode 只支持：stream、final、verbose`,
     wechatReplyModeInvalid: "wechat.replyMode 只支持：stream、final、verbose",
     wechatReplyModeMapped: (value) => `${value}（已映射到 channel.replyMode）`,
     agentNotFound: (name) => `Agent「${name}」不存在，请先创建。`,
@@ -1920,6 +1928,8 @@ var init_channel_cli2 = __esm(() => {
     channelRemoved: (id) => `频道 ${id} 已删除`,
     cannotDisableLastEnabled: "不能禁用最后一个启用的频道。",
     channelEnabledToggled: (id, enabled) => `频道 ${id} 已${enabled ? "启用" : "禁用"}`,
+    channelReplyModeSet: (id, mode) => `频道 ${id} 的默认 reply mode 已设置为：${mode}`,
+    channelReplyModeInvalid: (mode) => `reply mode 只支持 stream / final / verbose，收到：${mode}`,
     channelAccountAlreadyExists: (type, accountId) => `频道 ${type} 的账号 ${accountId} 已存在；先 xacpx channel rm ${type} --account ${accountId}`,
     channelAccountAdded: (type, accountId) => `频道 ${type} 账号 ${accountId} 已添加`,
     channelReEnabled: (type) => `频道 ${type} 此前是 disabled 状态，已自动启用。`,
@@ -2184,12 +2194,22 @@ var init_zh = __esm(() => {
 function isLocale(value) {
   return typeof value === "string" && VALID.includes(value);
 }
+function detectSystemLocale() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale || "";
+  } catch {
+    return "";
+  }
+}
 function resolveLocale(input = {}) {
   const { configLanguage, env = process.env } = input;
   if (isLocale(configLanguage))
     return configLanguage;
   const raw = env.LC_ALL || env.LC_MESSAGES || env.LANG || "";
-  return /^zh/i.test(raw) ? "zh" : "en";
+  if (raw)
+    return /^zh/i.test(raw) ? "zh" : "en";
+  const systemLocale = input.systemLocale ?? detectSystemLocale();
+  return /^zh/i.test(systemLocale) ? "zh" : "en";
 }
 var VALID;
 var init_resolve_locale = __esm(() => {
@@ -2285,19 +2305,19 @@ function cmpTuple(a, b) {
   return 0;
 }
 function validatePluginCompatibility(metadata, context) {
-  const { packageName, currentWeacpxVersion } = context;
+  const { packageName, currentXacpxVersion } = context;
   const apiVersion = metadata.apiVersion;
   if (typeof apiVersion !== "number") {
     throw new Error(t().pluginCli.compatMissingApiVersion(packageName));
   }
-  if (!WEACPX_PLUGIN_API_SUPPORTED_VERSIONS.includes(apiVersion)) {
-    const supported = WEACPX_PLUGIN_API_SUPPORTED_VERSIONS.join(", ");
+  if (!XACPX_PLUGIN_API_SUPPORTED_VERSIONS.includes(apiVersion)) {
+    const supported = XACPX_PLUGIN_API_SUPPORTED_VERSIONS.join(", ");
     throw new Error(t().pluginCli.compatUnsupportedApiVersion(packageName, apiVersion, supported));
   }
-  if (!currentWeacpxVersion || currentWeacpxVersion === "unknown") {
+  if (!currentXacpxVersion || currentXacpxVersion === "unknown") {
     return;
   }
-  const normalizedCurrent = normalizeCoreVersionForCompat(currentWeacpxVersion);
+  const normalizedCurrent = normalizeCoreVersionForCompat(currentXacpxVersion);
   const minVersion = metadata.minXacpxVersion ?? metadata.minWeacpxVersion;
   const minVersionField = metadata.minXacpxVersion !== undefined ? "minXacpxVersion" : "minWeacpxVersion";
   if (minVersion !== undefined) {
@@ -2312,7 +2332,7 @@ function validatePluginCompatibility(metadata, context) {
       throw new Error(t().pluginCli.compatInvalidMinVersionDetail(packageName, minVersionField, detail));
     }
     if (!satisfied) {
-      throw new Error(t().pluginCli.compatMinVersionNotSatisfied(packageName, minVersion, currentWeacpxVersion));
+      throw new Error(t().pluginCli.compatMinVersionNotSatisfied(packageName, minVersion, currentXacpxVersion));
     }
   }
   const compatibleVersions = metadata.compatibleXacpxVersions ?? metadata.compatibleWeacpxVersions;
@@ -2329,14 +2349,17 @@ function validatePluginCompatibility(metadata, context) {
       throw new Error(t().pluginCli.compatInvalidCompatibleVersionsDetail(packageName, compatibleField, detail));
     }
     if (!satisfied) {
-      throw new Error(t().pluginCli.compatCompatibleVersionsNotSatisfied(packageName, compatibleVersions, currentWeacpxVersion));
+      throw new Error(t().pluginCli.compatCompatibleVersionsNotSatisfied(packageName, compatibleVersions, currentXacpxVersion));
     }
   }
 }
-var WEACPX_PLUGIN_API_VERSION = 1, WEACPX_PLUGIN_API_SUPPORTED_VERSIONS, WEACPX_PLUGIN_MIN_CORE_VERSION = "0.5.0", SEMVER_RE;
+var XACPX_PLUGIN_API_VERSION = 1, XACPX_PLUGIN_API_SUPPORTED_VERSIONS, XACPX_PLUGIN_MIN_CORE_VERSION = "0.5.0", WEACPX_PLUGIN_API_VERSION, WEACPX_PLUGIN_API_SUPPORTED_VERSIONS, WEACPX_PLUGIN_MIN_CORE_VERSION, SEMVER_RE;
 var init_compatibility = __esm(() => {
   init_i18n();
-  WEACPX_PLUGIN_API_SUPPORTED_VERSIONS = [1];
+  XACPX_PLUGIN_API_SUPPORTED_VERSIONS = [1];
+  WEACPX_PLUGIN_API_VERSION = XACPX_PLUGIN_API_VERSION;
+  WEACPX_PLUGIN_API_SUPPORTED_VERSIONS = XACPX_PLUGIN_API_SUPPORTED_VERSIONS;
+  WEACPX_PLUGIN_MIN_CORE_VERSION = XACPX_PLUGIN_MIN_CORE_VERSION;
   SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)$/;
 });
 
@@ -2507,6 +2530,9 @@ export {
   getLocale,
   createConversationExecutor,
   createActiveTurnRegistry,
+  XACPX_PLUGIN_MIN_CORE_VERSION,
+  XACPX_PLUGIN_API_VERSION,
+  XACPX_PLUGIN_API_SUPPORTED_VERSIONS,
   WEACPX_PLUGIN_MIN_CORE_VERSION,
   WEACPX_PLUGIN_API_VERSION,
   WEACPX_PLUGIN_API_SUPPORTED_VERSIONS

package/dist/plugins/compatibility.d.ts

@@ -1,3 +1,6 @@
+export declare const XACPX_PLUGIN_API_VERSION: 1;
+export declare const XACPX_PLUGIN_API_SUPPORTED_VERSIONS: readonly number[];
+export declare const XACPX_PLUGIN_MIN_CORE_VERSION: "0.5.0";
 export declare const WEACPX_PLUGIN_API_VERSION: 1;
 export declare const WEACPX_PLUGIN_API_SUPPORTED_VERSIONS: readonly number[];
 export declare const WEACPX_PLUGIN_MIN_CORE_VERSION: "0.5.0";
@@ -13,6 +16,6 @@ export interface PluginCompatibilityMetadata {
 }
 export interface PluginCompatibilityContext {
     packageName: string;
-    currentWeacpxVersion: string;
+    currentXacpxVersion: string;
 }
 export declare function validatePluginCompatibility(metadata: PluginCompatibilityMetadata, context: PluginCompatibilityContext): void;

package/dist/plugins/types.d.ts

@@ -1,6 +1,6 @@
 import type { ChannelPluginDefinition } from "../channels/plugin.js";
-import { WEACPX_PLUGIN_API_VERSION, WEACPX_PLUGIN_API_SUPPORTED_VERSIONS, WEACPX_PLUGIN_MIN_CORE_VERSION } from "./compatibility.js";
-export { WEACPX_PLUGIN_API_VERSION, WEACPX_PLUGIN_API_SUPPORTED_VERSIONS, WEACPX_PLUGIN_MIN_CORE_VERSION, };
+import { XACPX_PLUGIN_API_VERSION, XACPX_PLUGIN_API_SUPPORTED_VERSIONS, XACPX_PLUGIN_MIN_CORE_VERSION, WEACPX_PLUGIN_API_VERSION, WEACPX_PLUGIN_API_SUPPORTED_VERSIONS, WEACPX_PLUGIN_MIN_CORE_VERSION } from "./compatibility.js";
+export { XACPX_PLUGIN_API_VERSION, XACPX_PLUGIN_API_SUPPORTED_VERSIONS, XACPX_PLUGIN_MIN_CORE_VERSION, WEACPX_PLUGIN_API_VERSION, WEACPX_PLUGIN_API_SUPPORTED_VERSIONS, WEACPX_PLUGIN_MIN_CORE_VERSION, };
 export interface WeacpxPlugin {
     apiVersion: 1;
     name?: string;

package/dist/state/types.d.ts

@@ -1,6 +1,6 @@
 import { type OrchestrationState } from "../orchestration/orchestration-types";
 import type { ScheduledTaskRecord } from "../scheduled/scheduled-types";
-export type LogicalSessionSource = "weacpx" | "agent-side";
+export type LogicalSessionSource = "xacpx" | "agent-side";
 export interface NativeSessionCacheEntry {
     session_id: string;
     cwd?: string;

package/dist/transport/types.d.ts

@@ -24,7 +24,7 @@ export interface ResolvedSession {
     agentCommand?: string;
     workspace: string;
     transportSession: string;
-    source?: "weacpx" | "agent-side";
+    source?: "xacpx" | "agent-side";
     agentSessionId?: string;
     agentSessionTitle?: string;
     agentSessionUpdatedAt?: string;
@@ -124,6 +124,14 @@ export interface SessionTransport {
     listAgentSessions?(query: AgentSessionListQuery): Promise<AgentSessionListResult | undefined>;
     resumeAgentSession?(session: ResolvedSession, agentSessionId: string): Promise<void>;
     removeSession?(session: ResolvedSession): Promise<void>;
+    /**
+     * Read the underlying agent-native session id for an existing transport
+     * session. Used by `/clear` to keep a native session native: the fresh
+     * post-clear session is itself backed by a new agent rollout, and this
+     * returns that rollout's resumable id. Returns undefined when the agent did
+     * not advertise one. Optional: transports that can't resolve it omit it.
+     */
+    getAgentSessionId?(session: ResolvedSession): Promise<string | undefined>;
     updatePermissionPolicy?(policy: PermissionPolicy): Promise<void>;
     dispose?(): Promise<void>;
 }

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 export declare function readVersion(moduleUrl?: string): string;
-/** weacpx 核心版本，派生自 package.json（经 readVersion 动态读取，无硬编码漂移）。 */
-export declare const WEACPX_CORE_VERSION: string;
+/** xacpx 核心版本，派生自 package.json（经 readVersion 动态读取，无硬编码漂移）。 */
+export declare const XACPX_CORE_VERSION: string;

package/dist/weixin/agent/interface.d.ts

@@ -62,7 +62,7 @@ export interface ChatRequestMetadata {
     senderName?: string;
     groupId?: string;
     isOwner?: boolean;
-    /** Internal weacpx session alias to use for non-interactive scheduled prompts. */
+    /** Internal xacpx session alias to use for non-interactive scheduled prompts. */
     scheduledSessionAlias?: string;
     /** Transient session descriptor for temp-mode scheduled prompts (no persisted alias). */
     scheduledSessionDescriptor?: ScheduledSessionDescriptor;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganglion/xacpx",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "随时随地通过聊天频道（微信 / 飞书 / 元宝等）远程控制 `acpx` 上的 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",