@ganglion/xacpx 0.9.1 → 0.9.3

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/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;
@@ -632,7 +635,6 @@ export interface CliUpdateMessages {
     updateFailed: (name: string, error: string) => string;
     targetNotFound: (name: string) => string;
     targetVersionUnknown: (name: string) => string;
-    targetNotPinned: (name: string) => string;
     multiTargetNonInteractive: string;
     selectionPrompt: string;
     selectionInvalid: (part: string) => string;
@@ -658,6 +660,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/orchestration/coordinator-identity.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The orchestration coordinator identity is derived from a session's transport
+ * name. `/clear` rotates that name from `workspace:alias` to
+ * `workspace:alias:reset-<timestamp>` (see session-reset-handler), which would
+ * otherwise orphan every task delegated before the reset. Stripping the
+ * volatile `:reset-<digits>` suffix yields the stable `workspace:alias` identity
+ * so ownership survives `/clear`.
+ *
+ * Pure leaf module: do not add imports, so it can be used from sessions/,
+ * commands/, and orchestration/ without risking an import cycle.
+ *
+ * No-op on any value lacking a trailing `:reset-<digits>` segment, so external
+ * coordinators (`external_*`) and normal sessions pass through unchanged.
+ */
+export declare function stableCoordinatorSession(transportSession: string): string;
+/**
+ * The single chokepoint for asking "do these two transport names refer to the
+ * same coordinator?". Both sides are reduced to their stable identity before
+ * comparison, so it is robust to either side carrying a volatile
+ * `:reset-<digits>` suffix (a live post-`/clear` session, or a legacy
+ * state.json record persisted before the identity was normalized at write).
+ *
+ * Every coordinator-ownership comparison must go through this rather than a raw
+ * `===`, so the normalization rule lives in one place instead of being
+ * re-derived (and inconsistently forgotten) at each call site.
+ */
+export declare function sameCoordinatorSession(a: string, b: string): boolean;

package/dist/orchestration/orchestration-service.d.ts

@@ -206,23 +206,6 @@ export interface CleanTasksResult {
     removedTasks: number;
     removedBindings: number;
 }
-export type ResetGcTrigger = "startup" | "interval";
-export interface PurgeExpiredResetCoordinatorsInput {
-    cutoffDays: number;
-    trigger: ResetGcTrigger;
-}
-export interface PurgeExpiredResetCoordinatorsResult {
-    candidates: number;
-    purgedCoordinators: number;
-    removed: {
-        tasks: number;
-        workerBindings: number;
-        groups: number;
-        coordinatorRoutes: number;
-        humanQuestionPackages: number;
-        coordinatorQuestionState: number;
-    };
-}
 export interface OrchestrationTaskFilter {
     sourceHandle?: string;
     coordinatorSession?: string;
@@ -361,7 +344,6 @@ export declare class OrchestrationService {
     cleanTasks(coordinatorSession: string): Promise<CleanTasksResult>;
     listSessionBlockingTasks(transportSession: string): Promise<OrchestrationTaskRecord[]>;
     purgeSessionReferences(transportSession: string): Promise<CleanTasksResult>;
-    purgeExpiredResetCoordinators(input: PurgeExpiredResetCoordinatorsInput): Promise<PurgeExpiredResetCoordinatorsResult>;
     listPendingCoordinatorResults(coordinatorSession: string): Promise<OrchestrationTaskRecord[]>;
     listPendingCoordinatorBlockers(coordinatorSession: string): Promise<OrchestrationTaskRecord[]>;
     listContestedCoordinatorResults(coordinatorSession: string): Promise<OrchestrationTaskRecord[]>;
@@ -439,11 +421,6 @@ export declare class OrchestrationService {
     private ensureGroups;
     private removeEmptyGroupsForCoordinator;
     private removeCoordinatorMetadataIfUnused;
-    private isResetCoordinatorSession;
-    private collectResetCoordinatorCandidates;
-    private parseDateMs;
-    private resolveResetCoordinatorActivityAtMs;
-    private cascadeRemoveCoordinatorRecords;
     private bumpGroupUpdated;
     private getLatestDeliveredPackageMessage;
     private snapshotCoordinatorDeliveryRoute;

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.`,
@@ -823,7 +826,6 @@ var init_cli_update = __esm(() => {
     updateFailed: (name, error) => `${name} update failed: ${error}`,
     targetNotFound: (name) => `Update target not found: ${name}`,
     targetVersionUnknown: (name) => `${name}: cannot check latest version; skipped.`,
-    targetNotPinned: (name) => `${name} has no recorded version; use \`xacpx plugin update ${name}\` or specify a version explicitly.`,
     multiTargetNonInteractive: "Installed plugins detected; in non-interactive mode use `xacpx update --all` or `xacpx update <name>`.",
     selectionPrompt: "Select items to update (numbers, comma-separated; a=all; Enter to cancel): ",
     selectionInvalid: (part) => `Invalid selection: ${part}`,
@@ -854,6 +856,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 +1158,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 +1705,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}」不存在，请先创建。`,
@@ -1889,7 +1896,6 @@ var init_cli_update2 = __esm(() => {
     updateFailed: (name, error) => `${name} 更新失败：${error}`,
     targetNotFound: (name) => `没有找到更新项：${name}`,
     targetVersionUnknown: (name) => `${name} 无法检查最新版本，已跳过。`,
-    targetNotPinned: (name) => `${name} 未记录当前版本；请先使用 \`xacpx plugin update ${name}\` 或显式选择版本。`,
     multiTargetNonInteractive: "检测到已安装插件；非交互模式请使用 `xacpx update --all` 或 `xacpx update <name>`。",
     selectionPrompt: "请选择要更新的项目（数字，逗号分隔，a=全部，回车取消）：",
     selectionInvalid: (part) => `无效选择：${part}`,
@@ -1920,6 +1926,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 状态，已自动启用。`,
@@ -2295,19 +2303,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) {
@@ -2322,7 +2330,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;
@@ -2339,14 +2347,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+)$/;
 });
 
@@ -2517,6 +2528,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.1",
+  "version": "0.9.3",
   "description": "随时随地通过聊天频道（微信 / 飞书 / 元宝等）远程控制 `acpx` 上的 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",