@ganglion/xacpx 0.20.3 → 0.22.0

package/dist/bridge/bridge-main.js

@@ -4889,6 +4889,7 @@ var init_channel_cli = __esm(() => {
     channelAdded: (type) => `Channel ${type} added`,
     cannotRemoveLastEnabled: "Cannot remove the last enabled channel.",
     channelRemoved: (id) => `Channel ${id} removed`,
+    channelRetirementFailed: (id, error) => `Channel ${id} retirement cleanup failed: ${error}`,
     channelCredentialsCleared: (id) => `Removed stored credentials for channel ${id}`,
     channelCredentialsClearFailed: (id, error) => `Channel ${id} removed, but clearing its stored credentials failed: ${error}`,
     channelCredentialsKept: (id) => `Kept stored credentials for channel ${id} (--keep-credentials)`,
@@ -6015,6 +6016,7 @@ var init_channel_cli2 = __esm(() => {
     channelAdded: (type) => `频道 ${type} 已添加`,
     cannotRemoveLastEnabled: "不能删除最后一个启用的频道。",
     channelRemoved: (id) => `频道 ${id} 已删除`,
+    channelRetirementFailed: (id, error) => `频道 ${id} 退役清理失败：${error}`,
     channelCredentialsCleared: (id) => `已移除频道 ${id} 的存储凭证`,
     channelCredentialsClearFailed: (id, error) => `频道 ${id} 已删除，但清除其存储凭证失败：${error}`,
     channelCredentialsKept: (id) => `已保留频道 ${id} 的存储凭证（--keep-credentials）`,
@@ -7295,7 +7297,9 @@ var LOCAL_AGENT_BINS;
 var init_local_agent_bin = __esm(() => {
   LOCAL_AGENT_BINS = {
     opencode: { bin: "opencode", args: ["acp"] },
-    kilocode: { bin: "kilocode", args: ["acp"] }
+    kilocode: { bin: "kilocode", args: ["acp"] },
+    reasonix: { bin: "reasonix", args: ["acp"] },
+    omp: { bin: "omp", args: ["acp"] }
   };
 });
 

package/dist/channels/cli/provider.d.ts

@@ -22,6 +22,18 @@ export interface ChannelCliIo {
     promptText: (message: string) => Promise<string>;
     promptSecret: (message: string) => Promise<string>;
 }
+/**
+ * Structured doctor finding from an optional channel/plugin diagnostic hook.
+ * Core renders these verbatim and must not interpret RMUX-specific codes.
+ */
+export type ChannelDoctorFindingLevel = "ok" | "warn" | "error" | "skip";
+export interface ChannelDoctorFinding {
+    level: ChannelDoctorFindingLevel;
+    code: string;
+    message: string;
+    suggestion?: string;
+    details?: Record<string, string | number | boolean | null>;
+}
 export interface ChannelCliProvider {
     type: string;
     displayName: string;
@@ -31,6 +43,11 @@ export interface ChannelCliProvider {
     validateConfig(config: ChannelRuntimeConfig): ChannelCliValidationIssue[];
     renderSummary(config: ChannelRuntimeConfig): string[];
     promptForMissingFields(input: ChannelCliInput, io: ChannelCliIo): Promise<ChannelCliInput>;
+    /**
+     * Optional read-only health probe for `xacpx doctor` / `xacpx plugin doctor`.
+     * Must not mutate registry, credentials, or kill resources.
+     */
+    diagnose?(config: ChannelRuntimeConfig): Promise<ChannelDoctorFinding[]> | ChannelDoctorFinding[];
     /**
      * Optional: declares this plugin supports the `xacpx channel ... --account <id>`
      * multi-bot CLI surface. Plugins that opt in must also implement

package/dist/channels/plugin.d.ts

@@ -1,9 +1,30 @@
 import type { ChannelFactory } from "./create-channel.js";
 import type { ChannelCliProvider } from "./cli/provider.js";
+import type { ChannelRuntimeConfig } from "../config/types.js";
+export type ChannelRetireDaemonState = "running" | "stopped" | "indeterminate";
+/** Context passed to a plugin `retireChannel` hook from `channel disable|rm`. */
+export interface ChannelRetireContext {
+    channel: ChannelRuntimeConfig;
+    reason: "disabled" | "removed";
+    print: (line: string) => void;
+    getDaemonStatus: () => Promise<{
+        state: ChannelRetireDaemonState;
+    }>;
+}
+export type ChannelRetireHook = (ctx: ChannelRetireContext) => Promise<void>;
 export interface ChannelPluginDefinition {
     /** Stable channel type used in channels[].type and chatKey prefix. */
     type: string;
     factory: ChannelFactory;
     cliProvider?: ChannelCliProvider;
+    /**
+     * Optional CLI lifecycle hook for `xacpx channel disable|rm`.
+     * Invoked after plugins are loaded, via the per-type registry — core must
+     * not import the plugin npm package to retire resources.
+     */
+    retireChannel?: ChannelRetireHook;
 }
 export declare function registerChannelPlugin(plugin: ChannelPluginDefinition): void;
+export declare function getChannelRetireHook(type: string): ChannelRetireHook | undefined;
+/** Dispatch `channel disable|rm` retirement to the loaded plugin for this type. */
+export declare function invokeChannelRetireHook(ctx: ChannelRetireContext): Promise<void>;

package/dist/channels/types.d.ts

@@ -5,6 +5,7 @@ import type { AppLogger } from "../logging/app-logger.js";
 import type { PendingFinalChunk } from "../weixin/messaging/quota-manager.js";
 import type { PerfTracer } from "../perf/perf-tracer.js";
 import type { SessionService } from "../sessions/session-service.js";
+import type { SessionResourceCatalog } from "../sessions/session-resource-catalog.js";
 import type { ActiveTurnRegistry } from "../sessions/active-turn-registry.js";
 import type { Locale } from "../i18n/index.js";
 import type { ControlService } from "../control/control-service.js";
@@ -79,6 +80,12 @@ export interface ChannelStartInput {
      * channels ignore it.
      */
     control?: ControlService;
+    /**
+     * Generic catalog of logical-session resources: immutable logical session
+     * IDs, internal/display aliases, authoritative workspace cwd, archived flag,
+     * and a lifecycle-event subscription. Optional: text-only channels ignore it.
+     */
+    sessionResources?: SessionResourceCatalog;
 }
 export interface OrchestrationDeliveryCallbacks {
     markTaskNoticeDelivered: (taskId: string, accountId: string) => Promise<void>;
@@ -114,6 +121,7 @@ export interface ConsumerLockOptions {
     lockFilePath?: string;
     onDiagnostic?: (event: string, context: Record<string, string | number | boolean | undefined>) => void | Promise<void>;
 }
+export type ChannelStopReason = "shutdown" | "disabled" | "removed" | "logout";
 export interface MessageChannelRuntime {
     id: string;
     isLoggedIn(): boolean;
@@ -122,15 +130,21 @@ export interface MessageChannelRuntime {
      * Destructive credential removal. Reached only via the explicit
      * `xacpx logout` CLI path — never as part of a normal shutdown.
      */
-    logout(): void;
+    logout(): void | Promise<void>;
     start(input: ChannelStartInput): Promise<void>;
     /**
      * Non-destructive shutdown: release runtime resources without touching
      * stored credentials. Optional for compatibility with already-published
      * plugin channels; when absent, the registry falls back to `logout()`
      * (which for those plugins is a benign client stop).
+     *
+     * @param reason - The reason for stopping:
+     *   - "shutdown": normal signal/startup-error cleanup
+     *   - "disabled": channel disabled via CLI
+     *   - "removed": channel removed via CLI
+     *   - "logout": explicit logout command
      */
-    stop?(): void | Promise<void>;
+    stop?(reason?: ChannelStopReason): void | Promise<void>;
     createConsumerLock?(options?: ConsumerLockOptions): ConsumerLock;
     configureOrchestration?(callbacks: OrchestrationDeliveryCallbacks): void;
     notifyTaskCompletion(task: OrchestrationTaskRecord): Promise<void>;