weacpx 0.3.1 → 0.4.0-beta.0

package/dist/channels/media-types.d.ts

@@ -0,0 +1,28 @@
+export type ChannelId = string;
+export type ChannelMediaKind = "image" | "file" | "audio" | "video";
+export interface ChannelMediaAttachment {
+    kind: ChannelMediaKind;
+    /** @deprecated Legacy field — prefer `kind`. Kept for backward compat during migration. */
+    type?: string;
+    filePath: string;
+    mimeType: string;
+    fileName?: string;
+    sizeBytes: number;
+    source: {
+        channelId: ChannelId;
+        accountId: string;
+        chatKey: string;
+        messageId: string;
+        resourceId?: string;
+    };
+}
+export interface OutboundChannelMedia {
+    kind: ChannelMediaKind;
+    filePath: string;
+    mimeType?: string;
+    fileName?: string;
+    caption?: string;
+}
+export type MaybeArray<T> = T | T[] | undefined;
+export declare function normalizeMediaArray<T>(media: MaybeArray<T>): T[];
+export declare function firstMediaOrUndefined<T>(media: T[]): T | undefined;

package/dist/channels/outbound-media-safety.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolve an outbound media file path to a safe absolute realpath.
+ * Rejects remote URLs, non-existent paths, symlinks that escape allowed roots,
+ * and paths outside all allowed root directories.
+ * Returns the resolved realpath on success, or null on rejection.
+ */
+export declare function resolveSafeOutboundMediaPath(mediaPath: string, allowedRoots: string[]): Promise<string | null>;

package/dist/channels/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { ChannelFactory } from "./create-channel.js";
+import type { ChannelCliProvider } from "./cli/provider.js";
+export interface ChannelPluginDefinition {
+    /** Stable channel type used in channels[].type and chatKey prefix. */
+    type: string;
+    factory: ChannelFactory;
+    cliProvider?: ChannelCliProvider;
+}
+export declare function registerChannelPlugin(plugin: ChannelPluginDefinition): void;

package/dist/channels/types.d.ts

@@ -0,0 +1,61 @@
+import type { Agent as ChatAgent } from "../weixin/agent/interface.js";
+import type { OrchestrationTaskRecord } from "../orchestration/orchestration-types.js";
+import type { AppLogger } from "../logging/app-logger.js";
+import type { PendingFinalChunk } from "../weixin/messaging/quota-manager.js";
+export type { ChatAgent };
+export interface OutboundQuota {
+    onInbound(chatKey: string): void;
+    reserveMidSegment(chatKey: string): boolean;
+    reserveFinal(chatKey: string): boolean;
+    finalRemaining(chatKey: string): number;
+    hasPendingFinal(chatKey: string): boolean;
+    drainPendingFinalUpToBudget(chatKey: string, available: number): PendingFinalChunk[];
+    prependPendingFinal(chatKey: string, chunks: PendingFinalChunk[]): void;
+    enqueuePendingFinal(chatKey: string, chunks: PendingFinalChunk[]): void;
+    clearPendingFinal(chatKey: string): void;
+}
+export interface CoordinatorMessageInput {
+    coordinatorSession: string;
+    chatKey: string;
+    accountId?: string;
+    replyContextToken?: string;
+    text: string;
+}
+export interface ChannelStartInput {
+    agent: ChatAgent;
+    abortSignal: AbortSignal;
+    quota: OutboundQuota;
+    logger: AppLogger;
+}
+export interface OrchestrationDeliveryCallbacks {
+    markTaskNoticeDelivered: (taskId: string, accountId: string) => Promise<void>;
+    markTaskNoticeFailed: (taskId: string, errorMessage: string) => Promise<void>;
+}
+export interface ConsumerLockMetadata {
+    pid: number;
+    mode: "foreground" | "daemon";
+    startedAt: string;
+    configPath: string;
+    statePath: string;
+    hostname?: string;
+}
+export interface ConsumerLock {
+    acquire(meta: ConsumerLockMetadata): Promise<void>;
+    release(): Promise<void>;
+}
+export interface ConsumerLockOptions {
+    lockFilePath?: string;
+    onDiagnostic?: (event: string, context: Record<string, string | number | boolean | undefined>) => void | Promise<void>;
+}
+export interface MessageChannelRuntime {
+    id: string;
+    isLoggedIn(): boolean;
+    login(): Promise<string>;
+    logout(): void;
+    start(input: ChannelStartInput): Promise<void>;
+    createConsumerLock?(options?: ConsumerLockOptions): ConsumerLock;
+    configureOrchestration?(callbacks: OrchestrationDeliveryCallbacks): void;
+    notifyTaskCompletion(task: OrchestrationTaskRecord): Promise<void>;
+    notifyTaskProgress(task: OrchestrationTaskRecord, text: string): Promise<void>;
+    sendCoordinatorMessage(input: CoordinatorMessageInput): Promise<void>;
+}

package/dist/channels/weixin-channel.d.ts

@@ -0,0 +1,22 @@
+import type { MessageChannelRuntime, ChannelStartInput, CoordinatorMessageInput, OrchestrationDeliveryCallbacks, ConsumerLock, ConsumerLockOptions } from "./types.js";
+import type { RuntimeMediaStore } from "./media-store.js";
+import type { OrchestrationTaskRecord } from "../orchestration/orchestration-types.js";
+export declare class WeixinChannel implements MessageChannelRuntime {
+    readonly id = "weixin";
+    private quota;
+    private logger;
+    private markDelivered;
+    private markFailed;
+    private mediaStore;
+    private allowedMediaRoots;
+    constructor(mediaStore?: RuntimeMediaStore, allowedMediaRoots?: string[]);
+    isLoggedIn(): boolean;
+    login(): Promise<string>;
+    logout(): void;
+    createConsumerLock(options?: ConsumerLockOptions): ConsumerLock;
+    configureOrchestration(callbacks: OrchestrationDeliveryCallbacks): void;
+    start(input: ChannelStartInput): Promise<void>;
+    notifyTaskCompletion(task: OrchestrationTaskRecord): Promise<void>;
+    notifyTaskProgress(task: OrchestrationTaskRecord, text: string): Promise<void>;
+    sendCoordinatorMessage(input: CoordinatorMessageInput): Promise<void>;
+}