weacpx 0.6.1 → 0.8.0

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

@@ -1,17 +0,0 @@
-export declare function registerKnownChannelId(channelId: string): void;
-export declare function listKnownChannelIds(): string[];
-export declare function getChannelIdFromChatKey(chatKey: string): string;
-export declare function isLegacyWeixinChatKey(chatKey: string): boolean;
-export declare function toInternalSessionAlias(channelId: string, displayAlias: string): string;
-export declare function toDisplaySessionAlias(internalAlias: string): string;
-export declare function isSessionAliasVisibleInChannel(alias: string, channelId: string): boolean;
-export declare function resolveSessionAliasForInput(channelId: string, displayAlias: string, existingAliases: Iterable<string>): string;
-/**
- * Internal alias for a display alias entered in `channelId`. The default
- * channel (weixin) stays unprefixed for backwards compatibility; every other
- * channel is namespaced as `channelId:alias`. Idempotent — an already-scoped
- * alias is not double-prefixed. This is the single home for the rule that
- * handlers must not re-implement inline.
- */
-export declare function scopeDisplayAliasToInternal(channelId: string, displayAlias: string): string;
-export declare function buildDefaultTransportSession(channelId: string, displayAlias: string): string;

package/dist/channels/cli/provider.d.ts

@@ -1,73 +0,0 @@
-import type { ChannelRuntimeConfig } from "../../config/types";
-export type ChannelCliInput = Record<string, string | boolean | undefined>;
-export type ChannelCliParseResult = {
-    ok: true;
-    input: ChannelCliInput;
-} | {
-    ok: false;
-    message: string;
-};
-export type ChannelCliValidationIssue = {
-    kind: "missing-required-field";
-    flag: string;
-    message: string;
-} | {
-    kind: "invalid-config";
-    message: string;
-};
-export interface ChannelCliIo {
-    print: (line: string) => void;
-    stderr: (text: string) => void;
-    isInteractive: () => boolean;
-    promptText: (message: string) => Promise<string>;
-    promptSecret: (message: string) => Promise<string>;
-}
-export interface ChannelCliProvider {
-    type: string;
-    displayName: string;
-    supportsLogin: boolean;
-    parseAddArgs(args: string[]): ChannelCliParseResult;
-    buildDefaultConfig(input: ChannelCliInput): ChannelRuntimeConfig;
-    validateConfig(config: ChannelRuntimeConfig): ChannelCliValidationIssue[];
-    renderSummary(config: ChannelRuntimeConfig): string[];
-    promptForMissingFields(input: ChannelCliInput, io: ChannelCliIo): Promise<ChannelCliInput>;
-    /**
-     * Optional: declares this plugin supports the `weacpx channel ... --account <id>`
-     * multi-bot CLI surface. Plugins that opt in must also implement
-     * {@link buildAccountOverride} and {@link channelLevelOptionKeys}.
-     */
-    supportsMultipleAccounts?: boolean;
-    /**
-     * Optional: builds the per-account override object that core nests under
-     * `options.accounts.<accountId>`. Should NOT include channel-level fields
-     * (those live on top-level `options`).
-     */
-    buildAccountOverride?(input: ChannelCliInput): Record<string, unknown>;
-    /**
-     * Optional: option keys that stay on top-level `options` (not duplicated into
-     * each account). Used to migrate a legacy flat single-bot config into the
-     * accounts shape on first `--account` add.
-     */
-    channelLevelOptionKeys?: readonly string[];
-    /**
-     * Optional: renders summary lines for a single account inside a multi-bot
-     * channel. Falls back to {@link renderSummary} on the whole channel when
-     * unspecified.
-     */
-    renderAccountSummary?(config: ChannelRuntimeConfig, accountId: string): string[] | null;
-}
-export declare function parseBooleanFlag(value: string, flagName: string): {
-    ok: true;
-    value: boolean;
-} | {
-    ok: false;
-    message: string;
-};
-export declare function takeFlagValue(args: string[], index: number, flagName: string): {
-    ok: true;
-    value: string;
-    nextIndex: number;
-} | {
-    ok: false;
-    message: string;
-};

package/dist/channels/cli/registry.d.ts

@@ -1,7 +0,0 @@
-import type { ChannelCliProvider } from "./provider";
-export declare function registerChannelCliProvider(provider: ChannelCliProvider): void;
-export declare function hasChannelCliProvider(type: string): boolean;
-export declare function getRegisteredChannelCliProviderTypes(): string[];
-export declare function bootstrapBuiltinChannelCliProviders(): void;
-export declare function listChannelCliProviders(): ChannelCliProvider[];
-export declare function getChannelCliProvider(type: string): ChannelCliProvider | null;

package/dist/channels/cli/weixin-provider.d.ts

@@ -1,2 +0,0 @@
-import type { ChannelCliProvider } from "./provider";
-export declare const weixinCliProvider: ChannelCliProvider;

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

@@ -1,16 +0,0 @@
-import type { ChannelConfig, ChannelRuntimeConfig } from "../config/types.js";
-import type { MessageChannelRuntime } from "./types.js";
-import type { RuntimeMediaStore } from "./media-store.js";
-export declare function getMovedChannelInstallHint(type: string): string | null;
-export interface CreateChannelDeps {
-    mediaStore?: RuntimeMediaStore;
-    allowedMediaRoots?: string[];
-}
-export type ChannelFactory = (options: Record<string, unknown> | undefined, deps?: CreateChannelDeps) => MessageChannelRuntime;
-export declare function registerChannelFactory(type: string, factory: ChannelFactory): void;
-export declare function hasChannelFactory(type: string): boolean;
-export declare function getRegisteredChannelTypes(): string[];
-export declare function bootstrapBuiltinChannelFactories(): void;
-export declare function createMessageChannel(type: string, config?: Partial<ChannelConfig>, deps?: CreateChannelDeps): MessageChannelRuntime;
-export declare function createMessageChannelFromRuntimeConfig(config: ChannelRuntimeConfig, deps?: CreateChannelDeps): MessageChannelRuntime;
-export declare function createMessageChannels(configs: ChannelRuntimeConfig[], deps?: CreateChannelDeps): MessageChannelRuntime[];

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

@@ -1,29 +0,0 @@
-import type { ChannelId, ChannelMediaAttachment, ChannelMediaKind } from "./media-types";
-export declare const DEFAULT_IMAGE_MAX_BYTES: number;
-export declare const DEFAULT_ATTACHMENT_MAX_BYTES: number;
-export declare const DEFAULT_MAX_ATTACHMENTS_PER_MESSAGE = 10;
-export declare const DEFAULT_MEDIA_RETENTION_MS: number;
-export interface RuntimeMediaStoreOptions {
-    rootDir: string;
-    retentionMs?: number;
-}
-export interface SaveMediaBufferInput {
-    channelId: ChannelId;
-    accountId: string;
-    chatKey: string;
-    messageId: string;
-    fileName?: string;
-    mimeType: string;
-    kind: ChannelMediaKind;
-    buffer: Buffer;
-    sourceResourceId?: string;
-    maxBytes: number;
-}
-export declare class RuntimeMediaStore {
-    readonly rootDir: string;
-    readonly retentionMs: number;
-    constructor(options: RuntimeMediaStoreOptions);
-    saveMediaBuffer(input: SaveMediaBufferInput): Promise<ChannelMediaAttachment>;
-    cleanupExpired(now?: Date): Promise<void>;
-}
-export declare function sanitizeMediaFileName(fileName: string, mimeType: string): string;

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

@@ -1,28 +0,0 @@
-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

@@ -1,7 +0,0 @@
-/**
- * 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

@@ -1,9 +0,0 @@
-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

@@ -1,115 +0,0 @@
-import type { Agent as ChatAgent } from "../weixin/agent/interface.js";
-import type { CommandHint } from "../commands/command-hints.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";
-import type { PerfTracer } from "../perf/perf-tracer.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 ScheduledSessionDescriptor {
-    alias: string;
-    agent: string;
-    workspace: string;
-    transportSession: string;
-}
-export interface ScheduledChannelMessageInput {
-    chatKey: string;
-    taskId?: string;
-    sessionAlias: string;
-    /**
-     * When present, the scheduled prompt runs in a transient session described
-     * here (temp mode) instead of the persisted logical session named by
-     * `sessionAlias`. `sessionAlias` still records the origin session for display.
-     */
-    sessionDescriptor?: ScheduledSessionDescriptor;
-    accountId?: string;
-    replyContextToken?: string;
-    noticeText: string;
-    promptText: string;
-    abortSignal?: AbortSignal;
-}
-export interface ChannelStartInput {
-    agent: ChatAgent;
-    abortSignal: AbortSignal;
-    quota: OutboundQuota;
-    logger: AppLogger;
-    perfTracer?: PerfTracer;
-    /** weacpx 内置命令目录，供支持输入框命令提示的频道使用。 */
-    commandHints?: CommandHint[];
-    /** weacpx 核心版本字符串，供需要它的频道（如命令同步元数据）使用。 */
-    coreVersion?: string;
-}
-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>;
-    sendScheduledMessage?(input: ScheduledChannelMessageInput): Promise<void>;
-    /**
-     * Preferred render format for `/ssn` native session lists. weixin renders
-     * markdown tables poorly and declares "cards"; channels that omit this are
-     * treated as "table".
-     */
-    nativeSessionListFormat?: "cards" | "table";
-}
-export type ToolUseStatus = "running" | "success" | "error";
-export type ToolUseKind = "read" | "search" | "execute" | "edit" | "think" | "other";
-export interface ToolUseEvent {
-    toolCallId: string;
-    /** Free-form tool name from the agent (e.g. "Read File", "Bash"). */
-    toolName: string;
-    /** Coarse classifier produced by the transport from the agent's tool kind; channels use it to pick an icon. */
-    kind: ToolUseKind;
-    /** Best-effort one-line summary derived from `rawInput`. */
-    summary?: string;
-    rawInput?: unknown;
-    content?: unknown;
-    rawOutput?: unknown;
-    locations?: unknown;
-    status: ToolUseStatus;
-    /** Set when status transitions out of "running". */
-    durationMs?: number;
-}

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

@@ -1,25 +0,0 @@
-import type { MessageChannelRuntime, ChannelStartInput, CoordinatorMessageInput, OrchestrationDeliveryCallbacks, ConsumerLock, ConsumerLockOptions, ScheduledChannelMessageInput } 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";
-    readonly nativeSessionListFormat: "cards" | "table";
-    private agent;
-    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>;
-    sendScheduledMessage(input: ScheduledChannelMessageInput): Promise<void>;
-}