weacpx 0.4.3 → 0.4.5

package/dist/config/types.d.ts

@@ -20,11 +20,18 @@ export interface TransportConfig {
     nonInteractivePermissions: NonInteractivePermissions;
 }
 export type LoggingLevel = "error" | "info" | "debug";
+export interface PerfLogConfig {
+    enabled: boolean;
+    maxSizeBytes: number;
+    maxFiles: number;
+    retentionDays: number;
+}
 export interface LoggingConfig {
     level: LoggingLevel;
     maxSizeBytes: number;
     maxFiles: number;
     retentionDays: number;
+    perf: PerfLogConfig;
 }
 export interface AgentConfig {
     driver: string;

package/dist/logging/rotating-file-writer.d.ts

@@ -0,0 +1,2 @@
+export declare function rotateIfNeeded(filePath: string, incomingSize: number, maxSizeBytes: number, maxFiles: number): Promise<void>;
+export declare function cleanupExpiredRotatedLogs(filePath: string, retentionDays: number, now: () => Date): Promise<void>;

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

@@ -56,10 +56,22 @@ export interface OrchestrationTaskRecord {
     injectionAppliedAt?: string;
     lastInjectionError?: string;
     lastProgressAt?: string;
+    lastProgressSummary?: string;
     groupId?: string;
     openQuestion?: OrchestrationOpenQuestionRecord;
     reviewPending?: OrchestrationReviewPendingRecord;
     correctionPending?: OrchestrationCorrectionPendingRecord;
+    eventSeq?: number;
+    events?: OrchestrationTaskEventRecord[];
+}
+export type OrchestrationTaskEventType = "created" | "progress" | "status_changed" | "attention_required" | "cancel_requested";
+export interface OrchestrationTaskEventRecord {
+    seq: number;
+    at: string;
+    type: OrchestrationTaskEventType;
+    status?: OrchestrationTaskStatus;
+    summary?: string;
+    message?: string;
 }
 export interface OrchestrationGroupRecord {
     groupId: string;

package/dist/perf/perf-log-writer.d.ts

@@ -0,0 +1,25 @@
+export interface PerfPermanentFailure {
+    perfLogPath: string;
+    failureCount: number;
+    lastError: string;
+}
+export interface CreatePerfLogWriterOptions {
+    filePath: string;
+    maxSizeBytes: number;
+    maxFiles: number;
+    retentionDays?: number;
+    onPermanentFailure: (info: PerfPermanentFailure) => void;
+    failureThreshold?: number;
+    appendImpl?: (path: string, data: string) => Promise<void>;
+    mkdirImpl?: (path: string, opts: {
+        recursive: true;
+    }) => Promise<void>;
+    now?: () => Date;
+}
+export interface PerfLogWriter {
+    enqueue(line: string): void;
+    flush(): Promise<void>;
+    cleanup(): Promise<void>;
+    isDisabled(): boolean;
+}
+export declare function createPerfLogWriter(options: CreatePerfLogWriterOptions): PerfLogWriter;

package/dist/perf/perf-tracer.d.ts

@@ -0,0 +1,54 @@
+import type { AppLogger } from "../logging/app-logger";
+export type SpanOutcome = "ok" | "error" | "aborted";
+export type PerfContext = Record<string, string | number | boolean | null | undefined>;
+export interface PerfSpan {
+    readonly traceId: string;
+    mark(event: string, context?: PerfContext): void;
+    setOutcome(outcome: SpanOutcome, context?: PerfContext): void;
+}
+export interface PerfTracer {
+    wrapTurn<T>(seed: {
+        chatKey: string;
+        kind: "command" | "prompt";
+    }, run: (span: PerfSpan) => Promise<T>): Promise<T>;
+    flush(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+export interface FormatLineArgs {
+    isoNow: Date;
+    event: string;
+    traceId: string;
+    chatKey: string;
+    sinceStartMs: number;
+    sinceLastMs: number;
+    context?: PerfContext;
+}
+export interface FormatSummaryArgs {
+    isoNow: Date;
+    traceId: string;
+    chatKey: string;
+    kind: "command" | "prompt";
+    outcome: SpanOutcome;
+    totalMs: number;
+    marks: Array<{
+        e: string;
+        t: number;
+    }>;
+    outcomeContext?: PerfContext;
+}
+export interface CreatePerfTracerOptions {
+    filePath: string;
+    maxSizeBytes: number;
+    maxFiles: number;
+    retentionDays: number;
+    appLogger: AppLogger;
+    now?: () => number;
+    isoNow?: () => Date;
+    randomId?: () => string;
+    formatLine?: (args: FormatLineArgs) => string;
+    formatSummaryLine?: (args: FormatSummaryArgs) => string;
+}
+export declare function createNoopPerfTracer(): PerfTracer;
+export declare function createPerfTracer(options: CreatePerfTracerOptions): PerfTracer;
+export declare function defaultFormatLine(args: FormatLineArgs): string;
+export declare function defaultFormatSummaryLine(args: FormatSummaryArgs): string;

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

@@ -1,5 +1,6 @@
 import type { ChannelMediaAttachment, OutboundChannelMedia } from "../../channels/media-types.js";
 import type { ToolUseEvent } from "../../channels/types.js";
+import type { PerfSpan } from "../../perf/perf-tracer.js";
 /**
  * Agent interface — any AI backend that can handle a chat message.
  *
@@ -45,6 +46,12 @@ export interface ChatRequest {
     abortSignal?: AbortSignal;
     /** Structured tool-use side-channel; see PromptOptions.onToolEvent. */
     onToolEvent?: (event: ToolUseEvent) => 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
+     * inline `request.perfSpan?.mark(event, ctx)` without further plumbing.
+     */
+    perfSpan?: PerfSpan;
 }
 export interface ChatRequestMetadata {
     channel?: string;

package/dist/weixin/bot.d.ts

@@ -1,6 +1,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";
 export type LoginOptions = {
     /** Override the API base URL. */
     baseUrl?: string;
@@ -29,6 +30,7 @@ export type StartOptions = {
     enqueuePendingFinal?: (chatKey: string, chunks: PendingFinalChunk[]) => void;
     dropPendingFinal?: (chatKey: string) => void;
     mediaStore?: RuntimeMediaStore;
+    perfTracer?: PerfTracer;
 };
 /**
  * Interactive QR-code login. Prints the QR code to the terminal and waits

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

@@ -3,6 +3,7 @@ import type { WeixinMessage } from "../api/types.js";
 import { RuntimeMediaStore } from "../../channels/media-store.js";
 import { downloadMediaFromItem } from "../media/media-download.js";
 import type { PendingFinalChunk } from "./quota-manager.js";
+import { type PerfTracer } from "../../perf/perf-tracer.js";
 export declare function chunkFinalText(text: string, maxBytes: number): string[];
 export declare function resolveMediaTempDir(customRoot?: string): string;
 export type HandleWeixinMessageTurnDeps = {
@@ -25,6 +26,7 @@ export type HandleWeixinMessageTurnDeps = {
     mediaStore?: RuntimeMediaStore;
     downloadMediaFromItemFn?: typeof downloadMediaFromItem;
     allowedMediaRoots?: string[];
+    perfTracer?: PerfTracer;
 };
 export declare function getWeixinMessageTurnLane(full: WeixinMessage): "normal" | "control";
 export declare function handleWeixinMessageTurn(full: WeixinMessage, deps: HandleWeixinMessageTurnDeps): Promise<void>;

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

@@ -1,6 +1,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";
 export type MonitorWeixinOpts = {
     baseUrl: string;
     cdnBaseUrl: string;
@@ -20,6 +21,7 @@ export type MonitorWeixinOpts = {
     dropPendingFinal?: (chatKey: string) => void;
     mediaStore?: RuntimeMediaStore;
     allowedMediaRoots?: string[];
+    perfTracer?: PerfTracer;
 };
 /**
  * Long-poll loop: getUpdates → process message → call agent → send reply.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weacpx",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "使用微信 ClawBot 随时随地通过 `acpx` 控制 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",
@@ -64,7 +64,7 @@
     "smoke:local-install": "node ./scripts/smoke-local-install.mjs"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.19.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "acpx": "^0.6.1",
     "node-pty": "^1.1.0",
     "proper-lockfile": "^4.1.2",