@ganglion/xacpx 0.8.0

package/dist/weixin/monitor/monitor.d.ts

@@ -0,0 +1,38 @@
+import type { Agent } from "../agent/interface.js";
+import type { PendingFinalChunk } from "../messaging/quota-manager.js";
+import type { ActiveTurnRegistry } from "../../sessions/active-turn-registry.js";
+import type { RuntimeMediaStore } from "../../channels/media-store.js";
+import type { PerfTracer } from "../../perf/perf-tracer.js";
+export type MonitorWeixinOpts = {
+    baseUrl: string;
+    cdnBaseUrl: string;
+    token?: string;
+    accountId: string;
+    agent: Agent;
+    abortSignal?: AbortSignal;
+    longPollTimeoutMs?: number;
+    log?: (msg: string) => void;
+    onInbound?: (chatKey: string) => void;
+    reserveFinal?: (chatKey: string) => boolean;
+    finalRemaining?: (chatKey: string) => number;
+    hasPendingFinal?: (chatKey: string) => boolean;
+    drainPendingFinal?: (chatKey: string, available: number) => PendingFinalChunk[];
+    prependPendingFinal?: (chatKey: string, chunks: PendingFinalChunk[]) => void;
+    enqueuePendingFinal?: (chatKey: string, chunks: PendingFinalChunk[]) => void;
+    dropPendingFinal?: (chatKey: string) => void;
+    mediaStore?: RuntimeMediaStore;
+    allowedMediaRoots?: string[];
+    perfTracer?: PerfTracer;
+    peekCurrentSessionAlias?: (chatKey: string) => string | undefined;
+    setBackgroundResult?: (chatKey: string, alias: string, result: {
+        text: string;
+        status: "done" | "error";
+        finished_at: string;
+    }) => Promise<void>;
+    activeTurns?: ActiveTurnRegistry;
+};
+/**
+ * Long-poll loop: getUpdates → process message → call agent → send reply.
+ * Runs until aborted.
+ */
+export declare function monitorWeixinProvider(opts: MonitorWeixinOpts): Promise<void>;

package/dist/weixin/storage/ensure-dir.d.ts

@@ -0,0 +1 @@
+export declare function ensureDirSync(dir: string): void;

package/dist/weixin/storage/state-dir.d.ts

@@ -0,0 +1,2 @@
+/** Resolve the OpenClaw state directory (mirrors core logic in src/infra). */
+export declare function resolveStateDir(): string;

package/dist/weixin/storage/sync-buf.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Path to the persistent get_updates_buf file for an account.
+ * Stored alongside account data: ~/.openclaw/openclaw-weixin/accounts/{accountId}.sync.json
+ */
+export declare function getSyncBufFilePath(accountId: string): string;
+export type SyncBufData = {
+    get_updates_buf: string;
+};
+/**
+ * Load persisted get_updates_buf.
+ * Falls back in order:
+ *   1. Primary path (normalized accountId, new installs)
+ *   2. Compat path (raw accountId derived from pattern, old installs)
+ *   3. Legacy single-account path (very old installs without multi-account support)
+ */
+export declare function loadGetUpdatesBuf(filePath: string): string | undefined;
+/**
+ * Persist get_updates_buf. Creates parent dir if needed.
+ */
+export declare function saveGetUpdatesBuf(filePath: string, getUpdatesBuf: string): void;

package/dist/weixin/util/logger.d.ts

@@ -0,0 +1,14 @@
+/** Dynamically change the minimum log level at runtime. */
+export declare function setLogLevel(level: string): void;
+export type Logger = {
+    info(message: string): void;
+    debug(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    /** Returns a child logger whose messages are prefixed with `[accountId]`. */
+    withAccount(accountId: string): Logger;
+    /** Returns the current main log file path. */
+    getLogFilePath(): string;
+    close(): void;
+};
+export declare const logger: Logger;

package/dist/weixin/util/random.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generate a prefixed unique ID using timestamp + crypto random bytes.
+ * Format: `{prefix}:{timestamp}-{8-char hex}`
+ */
+export declare function generateId(prefix: string): string;
+/**
+ * Generate a temporary file name with random suffix.
+ * Format: `{prefix}-{timestamp}-{8-char hex}{ext}`
+ */
+export declare function tempFileName(prefix: string, ext: string): string;

package/dist/weixin/util/redact.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Truncate a string, appending a length indicator when trimmed.
+ * Returns `""` for empty/undefined input.
+ */
+export declare function truncate(s: string | undefined, max: number): string;
+/**
+ * Redact a token/secret: show only the first few chars + total length.
+ * Returns `"(none)"` when absent.
+ */
+export declare function redactToken(token: string | undefined, prefixLen?: number): string;
+/**
+ * Redact a JSON body string for safe logging. JSON objects are structurally
+ * sanitized so secrets and user-authored message bodies are not written to
+ * disk. Non-JSON payloads fall back to length-bounded truncation.
+ */
+export declare function redactBody(body: string | undefined, maxLen?: number): string;
+/**
+ * Strip query string (which often contains signatures/tokens) from a URL,
+ * keeping only origin + pathname.
+ */
+export declare function redactUrl(rawUrl: string): string;

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@ganglion/xacpx",
+  "version": "0.8.0",
+  "description": "随时随地通过聊天频道（微信 / 飞书 / 元宝等）远程控制 `acpx` 上的 Claude Code、Codex 等 Agents。",
+  "keywords": [
+    "acpx",
+    "xacpx",
+    "weixin-agent-sdk",
+    "openclaw",
+    "weixin",
+    "yuanbao",
+    "feishu"
+  ],
+  "author": "gadzan",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/gadzan/weacpx/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gadzan/weacpx.git"
+  },
+  "type": "module",
+  "bin": {
+    "xacpx": "./dist/cli.js"
+  },
+  "exports": {
+    "./plugin-api": {
+      "types": "./dist/plugin-api.d.ts",
+      "default": "./dist/plugin-api.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "config.example.json"
+  ],
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "clean:dist": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "clean:channel-yuanbao": "node -e \"require('node:fs').rmSync('packages/channel-yuanbao/dist',{recursive:true,force:true})\"",
+    "clean:channel-feishu": "node -e \"require('node:fs').rmSync('packages/channel-feishu/dist',{recursive:true,force:true})\"",
+    "build": "bun run clean:dist && bun build ./src/cli.ts ./src/bridge/bridge-main.ts ./src/plugin-api.ts --outdir ./dist --target node --external node-pty && bun run build:plugin-api",
+    "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",
+    "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",
+    "dev": "bun run ./src/cli.ts run",
+    "dry-run": "bun run ./src/dry-run.ts",
+    "login": "bun run ./src/cli.ts login",
+    "start": "node ./dist/cli.js run",
+    "daemon:start": "bun run ./src/cli.ts start",
+    "daemon:status": "bun run ./src/cli.ts status",
+    "daemon:stop": "bun run ./src/cli.ts stop",
+    "test": "node ./scripts/run-tests.mjs",
+    "test:unit": "node ./scripts/run-tests.mjs tests/unit",
+    "test:smoke": "node ./scripts/run-tests.mjs tests/smoke",
+    "smoke:local-install": "node ./scripts/smoke-local-install.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "acpx": "^0.9.0",
+    "node-pty": "^1.1.0",
+    "proper-lockfile": "^4.1.2",
+    "protobufjs": "^7.5.6",
+    "qrcode-terminal": "^0.12.0",
+    "write-file-atomic": "^8.0.0",
+    "ws": "^8.20.0",
+    "zod": "^3",
+    "zod-to-json-schema": "^3"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/proper-lockfile": "^4.1.4",
+    "@types/write-file-atomic": "^4.0.3",
+    "@types/ws": "^8.18.1",
+    "bun-types": "^1.3.11",
+    "typescript": "^6.0.2"
+  }
+}