weacpx 0.6.0 → 0.7.0

package/dist/weixin/api/config-cache.d.ts

@@ -1,7 +1,15 @@
+import { getConfig } from "./api.js";
 /** Subset of getConfig fields that we actually need; add new fields here as needed. */
 export interface CachedConfig {
     typingTicket: string;
 }
+type GetConfigFn = typeof getConfig;
+export interface WeixinConfigManagerOptions {
+    maxEntries?: number;
+    entryTtlMs?: number;
+    now?: () => number;
+    getConfig?: GetConfigFn;
+}
 /**
  * Per-user getConfig cache with periodic random refresh (within 24h) and
  * exponential-backoff retry (up to 1h) on failure.
@@ -10,9 +18,18 @@ export declare class WeixinConfigManager {
     private apiOpts;
     private log;
     private cache;
+    private readonly maxEntries;
+    private readonly entryTtlMs;
+    private readonly now;
+    private readonly fetchConfig;
     constructor(apiOpts: {
         baseUrl: string;
         token?: string;
-    }, log: (msg: string) => void);
+    }, log: (msg: string) => void, options?: WeixinConfigManagerOptions);
     getForUser(userId: string, contextToken?: string): Promise<CachedConfig>;
+    cacheSizeForTests(): number;
+    hasCachedUserForTests(userId: string): boolean;
+    private prune;
+    private enforceMaxEntries;
 }
+export {};

package/dist/weixin/auth/accounts.d.ts

@@ -1,6 +1,5 @@
 export declare const DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
 export declare const CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
-/** Normalize an account ID to a filesystem-safe string. */
 export declare function normalizeAccountId(raw: string): string;
 /**
  * Pattern-based reverse of normalizeWeixinAccountId for known weixin ID suffixes.

package/dist/weixin/bot.d.ts

@@ -2,6 +2,7 @@ import type { Agent } from "./agent/interface.js";
 import type { PendingFinalChunk } from "./messaging/quota-manager.js";
 import type { RuntimeMediaStore } from "../channels/media-store.js";
 import type { PerfTracer } from "../perf/perf-tracer.js";
+import type { ActiveTurnRegistry } from "../sessions/active-turn-registry.js";
 export type LoginOptions = {
     /** Override the API base URL. */
     baseUrl?: string;
@@ -31,6 +32,16 @@ export type StartOptions = {
     dropPendingFinal?: (chatKey: string) => void;
     mediaStore?: RuntimeMediaStore;
     perfTracer?: PerfTracer;
+    /** Read the chat's current session synchronously for dispatch-time binding. */
+    peekCurrentSessionAlias?: (chatKey: string) => string | undefined;
+    /** Persist a background turn's final result for later replay. */
+    setBackgroundResult?: (chatKey: string, alias: string, result: {
+        text: string;
+        status: "done" | "error";
+        finished_at: string;
+    }) => Promise<void>;
+    /** Shared in-flight turn registry for dispatch-time foreground tracking. */
+    activeTurns?: ActiveTurnRegistry;
 };
 /**
  * Interactive QR-code login. Prints the QR code to the terminal and waits

package/dist/weixin/messaging/completion-notice.d.ts

@@ -0,0 +1,2 @@
+export declare function buildBackgroundCompletionNotice(internalAlias: string, status: "done" | "error"): string;
+export declare function shouldSendBackgroundNotice(reserve: (() => boolean) | undefined): boolean;

package/dist/weixin/messaging/foreground-gate.d.ts

@@ -0,0 +1,3 @@
+export declare function shouldDeliverSegment(isForeground: (() => boolean) | undefined): boolean;
+export type FinalDisposition = "send" | "store" | "drop";
+export declare function resolveFinalDisposition(isForeground: boolean, canStore: boolean): FinalDisposition;

package/dist/weixin/messaging/handle-weixin-message-turn.d.ts

@@ -27,6 +27,10 @@ export type HandleWeixinMessageTurnDeps = {
     downloadMediaFromItemFn?: typeof downloadMediaFromItem;
     allowedMediaRoots?: string[];
     perfTracer?: PerfTracer;
+    isForeground?: () => boolean;
+    boundSessionAlias?: string;
+    onBackgroundFinal?: (alias: string, text: string, status: "done" | "error") => Promise<void>;
 };
 export declare function getWeixinMessageTurnLane(full: WeixinMessage): "normal" | "control";
+export declare function buildWeixinChatKey(accountId: string, userId: string): string;
 export declare function handleWeixinMessageTurn(full: WeixinMessage, deps: HandleWeixinMessageTurnDeps): Promise<void>;

package/dist/weixin/messaging/inbound.d.ts

@@ -1,5 +1,11 @@
 import type { ChannelMediaKind } from "../../channels/media-types.js";
 import type { WeixinMessage, MessageItem } from "../api/types.js";
+interface ContextTokenRetentionOptions {
+    maxTokensPerAccount?: number;
+    tokenTtlMs?: number;
+    now?: () => number;
+}
+export declare function configureContextTokenRetentionForTests(options?: ContextTokenRetentionOptions): void;
 /**
  * Restore the per-account context-token cache from disk into memory.
  * Called at bot startup (after login). Missing/unreadable files are tolerated
@@ -78,3 +84,4 @@ export interface WeixinInboundMediaDescriptor {
     fileName?: string;
 }
 export declare function extractWeixinMediaDescriptors(itemList?: MessageItem[]): WeixinInboundMediaDescriptor[];
+export {};

package/dist/weixin/messaging/quota-manager.d.ts

@@ -24,11 +24,21 @@ export interface QuotaObserver {
     onFinalReserved?(chatKey: string, snapshot: QuotaSnapshot): void;
     onFinalRejected?(chatKey: string, snapshot: QuotaSnapshot): void;
 }
+export interface QuotaManagerOptions {
+    maxStates?: number;
+    stateTtlMs?: number;
+    maxPendingFinalChunksPerChat?: number;
+    now?: () => number;
+}
 export declare class QuotaManager {
     private readonly states;
     private readonly observer;
     private readonly normalizeKey;
-    constructor(observer?: QuotaObserver, normalizeKey?: (key: string) => string);
+    private readonly maxStates;
+    private readonly stateTtlMs;
+    private readonly maxPendingFinalChunksPerChat;
+    private readonly now;
+    constructor(observer?: QuotaObserver, normalizeKey?: (key: string) => string, options?: QuotaManagerOptions);
     onInbound(chatKey: string): void;
     reserveMidSegment(chatKey: string): boolean;
     reserveFinal(chatKey: string): boolean;
@@ -41,4 +51,8 @@ export declare class QuotaManager {
     clearPendingFinal(chatKey: string): void;
     snapshot(chatKey: string): QuotaSnapshot;
     private getOrCreate;
+    private prune;
+    private enforceMaxStates;
+    private trimPendingFinalChunks;
+    private deleteIfEmpty;
 }

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

@@ -1,5 +1,6 @@
 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 = {
@@ -22,6 +23,13 @@ export type MonitorWeixinOpts = {
     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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weacpx",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "使用微信 ClawBot 随时随地通过 `acpx` 控制 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",