@ganglion/xacpx 0.10.0 → 0.11.0

package/dist/transport/types.d.ts

@@ -1,6 +1,6 @@
 import type { NonInteractivePermissions, PermissionMode } from "../config/types";
 import type { QuotaManager } from "../weixin/messaging/quota-manager.js";
-import type { ToolUseEvent } from "../channels/types.js";
+import type { PlanEntry, ToolUseEvent } from "../channels/types.js";
 import type { ToolEventMode } from "./tool-event-mode.js";
 export type { ToolEventMode } from "./tool-event-mode.js";
 export interface ReplyQuotaContext {
@@ -22,6 +22,12 @@ export interface ResolvedSession {
     alias: string;
     agent: string;
     agentCommand?: string;
+    /**
+     * LLM model id to run this session under (e.g. `gpt-5.2[high]`). Resolved from
+     * the session's own override first, then the agent config default. When unset,
+     * no `--model` is passed and acpx uses the agent adapter's default.
+     */
+    model?: string;
     workspace: string;
     transportSession: string;
     source?: "xacpx" | "agent-side";
@@ -33,6 +39,14 @@ export interface ResolvedSession {
     mcpSourceHandle?: string;
     modeId?: string;
     replyMode?: "stream" | "final" | "verbose";
+    /**
+     * Channel-resolved effective reply mode. The relay/control channel defaults to
+     * "stream" (its dashboard is a streaming UI) so multi-line markdown isn't shredded
+     * by batched paragraph reconstruction. Consumers prefer this over `replyMode`;
+     * it's undefined for channels with no channel-level default (preserving their
+     * existing `replyMode ?? "verbose"` behavior).
+     */
+    effectiveReplyMode?: "stream" | "final" | "verbose";
     cwd: string;
     /**
      * True for a non-persisted, single-use session (e.g. a `/later` temp-mode
@@ -95,6 +109,11 @@ export interface PromptOptions {
      * error observed rejects the prompt.
      */
     onThought?: (chunk: string) => void | Promise<void>;
+    /**
+     * Structured plan/todo side-channel: the agent's full ACP `plan` entry list,
+     * re-sent on every update (REPLACE, not append). Optional — text channels omit it.
+     */
+    onPlan?: (entries: PlanEntry[]) => void | Promise<void>;
     /**
      * How tool_call / tool_call_update events are surfaced for this prompt.
      *
@@ -116,6 +135,13 @@ export interface SessionTransport {
         text: string;
     }>;
     setMode(session: ResolvedSession, modeId: string): Promise<void>;
+    /** Switch the running session's model. Optional: transports that can't omit it. */
+    setModel?(session: ResolvedSession, modelId: string): Promise<void>;
+    /** Read the current model and the agent-advertised available model ids. Optional. */
+    getSessionModel?(session: ResolvedSession): Promise<{
+        current?: string;
+        available: string[];
+    }>;
     cancel(session: ResolvedSession): Promise<{
         cancelled: boolean;
         message: string;

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

@@ -1,5 +1,5 @@
 import type { ChannelMediaAttachment, OutboundChannelMedia } from "../../channels/media-types.js";
-import type { ScheduledSessionDescriptor, ToolUseEvent } from "../../channels/types.js";
+import type { PlanEntry, ScheduledSessionDescriptor, ToolUseEvent } from "../../channels/types.js";
 import type { PerfSpan } from "../../perf/perf-tracer.js";
 /**
  * Agent interface — any AI backend that can handle a chat message.
@@ -48,6 +48,8 @@ export interface ChatRequest {
     onToolEvent?: (event: ToolUseEvent) => void | Promise<void>;
     /** Structured thinking side-channel; see PromptOptions.onThought. */
     onThought?: (chunk: string) => void | Promise<void>;
+    /** Structured plan/todo side-channel; see PromptOptions.onPlan. */
+    onPlan?: (entries: PlanEntry[]) => void | Promise<void>;
     /**
      * Optional per-turn performance tracing span. When `logging.perf.enabled` is
      * true, the channel handler attaches a `PerfSpan` so downstream layers can

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganglion/xacpx",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "随时随地通过聊天频道（微信 / 飞书 / 元宝等）远程控制 `acpx` 上的 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",
@@ -46,13 +46,28 @@
     "build:plugin-api": "tsc -p tsconfig.plugin-api.json",
     "build:channel-yuanbao": "bun run build:plugin-api && bun run clean:channel-yuanbao && bun build ./packages/channel-yuanbao/src/index.ts --outdir ./packages/channel-yuanbao/dist --target node --external xacpx && tsc -p packages/channel-yuanbao/tsconfig.json",
     "build:channel-feishu": "bun run build:plugin-api && bun run clean:channel-feishu && bun build ./packages/channel-feishu/src/index.ts --outdir ./packages/channel-feishu/dist --target node --external xacpx && tsc -p packages/channel-feishu/tsconfig.json",
-    "build:packages": "bun run build && bun run build:channel-yuanbao && bun run build:channel-feishu",
+    "clean:relay-protocol": "node -e \"require('node:fs').rmSync('packages/relay-protocol/dist',{recursive:true,force:true})\"",
+    "assert:relay-protocol": "node -e \"const m=require('./packages/relay-protocol/dist/index.js');if(!m.MSG||!m.MSG.sessionsCreate||typeof m.encodeEnvelope!=='function'){console.error('FATAL: relay-protocol dist is missing runtime exports — the barrel (export *) was likely tree-shaken to empty. Do NOT ship this build.');process.exit(1)}console.log('relay-protocol dist exports OK')\"",
+    "build:relay-protocol": "bun run clean:relay-protocol && bun build ./packages/relay-protocol/src/index.ts --outdir ./packages/relay-protocol/dist --target node && tsc -p packages/relay-protocol/tsconfig.json && bun run assert:relay-protocol",
+    "clean:relay": "node -e \"require('node:fs').rmSync('packages/relay/dist',{recursive:true,force:true})\"",
+    "bundle:relay-web": "node -e \"const f=require('node:fs');const s='packages/relay-web/dist',d='packages/relay/dist/relay-web';if(!f.existsSync(s+'/index.html')){console.error('FATAL: '+s+'/index.html missing — build:relay-web must run before bundling');process.exit(1)}f.rmSync(d,{recursive:true,force:true});f.cpSync(s,d,{recursive:true});console.log('bundled relay-web dashboard -> '+d)\"",
+    "build:relay": "bun run build:relay-web && bun run clean:relay && bun build ./packages/relay/src/cli.ts --outdir ./packages/relay/dist --target node --external ws --external hono --external @hono/node-server --external @ganglion/xacpx-relay-protocol && tsc -p packages/relay/tsconfig.json && bun run bundle:relay-web",
+    "clean:channel-relay": "node -e \"require('node:fs').rmSync('packages/channel-relay/dist', { recursive: true, force: true })\"",
+    "build:channel-relay": "bun run build:plugin-api && bun run build:relay-protocol && bun run clean:channel-relay && bun build ./packages/channel-relay/src/index.ts --outdir ./packages/channel-relay/dist --target node --external xacpx --external ws --external @ganglion/xacpx-relay-protocol && tsc -p packages/channel-relay/tsconfig.json",
+    "clean:relay-web": "node -e \"require('node:fs').rmSync('packages/relay-web/dist',{recursive:true,force:true})\"",
+    "build:relay-web": "bun run build:relay-protocol && bun run clean:relay-web && bun run --cwd packages/relay-web build",
+    "test:web": "bun run --cwd packages/relay-web test",
+    "build:packages": "bun run build && bun run build:channel-yuanbao && bun run build:channel-feishu && bun run build:relay-protocol && bun run build:relay && bun run build:channel-relay",
     "verify:publish": "bun run build:packages && node ./scripts/verify-publish.mjs",
     "publish:xacpx": "bun publish --cwd .",
     "publish:weacpx-compat": "bun publish --cwd weacpx-compat --access public",
     "publish:channel-feishu": "bun publish --cwd packages/channel-feishu --access public",
     "publish:channel-yuanbao": "bun publish --cwd packages/channel-yuanbao --access public",
     "publish:plugins": "bun run publish:channel-yuanbao && bun run publish:channel-feishu",
+    "publish:relay-protocol": "bun publish --cwd packages/relay-protocol --access public",
+    "publish:relay": "bun publish --cwd packages/relay --access public",
+    "publish:channel-relay": "bun publish --cwd packages/channel-relay --access public",
+    "publish:relay-stack": "bun run publish:relay-protocol && bun run publish:relay && bun run publish:channel-relay",
     "docs:dev": "bun run --cwd packages/docs dev",
     "docs:build": "bun run --cwd packages/docs build",
     "docs:preview": "bun run --cwd packages/docs preview",