aec-agent 1.0.1 → 1.0.4

package/dist/components/multi-agent-orchestration/agent/channel-manager/channel-manager.d.ts

@@ -1,6 +1,250 @@
+import type { ApprovalMode, Message } from "../../../../kernel/types.js";
+import type { EventBus } from "../../../event-handler/types.js";
+import type { ChannelStore } from "../../../persistence-hub/types/channel-store.js";
+import type { SessionStore } from "../../../persistence-hub/types/session-store.js";
+import type { InteractionHandler } from "../../../tool-hub/types.js";
+import type { ChannelPlatformHub } from "../../../channel-platform-hub/channel-platform-hub.js";
+import type { AgentChannels, ChannelTurnRunner } from "./types.js";
+import type { JobDeliveryOptions } from "../job-manager/types.js";
+import type { AgentCommands } from "../command-manager/types.js";
+import type { Channel, ChannelMessageRef, ChannelPairing, ChannelState, ChannelTarget, ChannelWebhookRequest, ChannelWebhookResponse, CreateChannelInput, UpdateChannelInput } from "../../../channel-platform-hub/types.js";
+/** Most channels one agent may have. */
+export declare const MAX_CHANNELS_PER_AGENT = 10;
+export declare const MAX_CHANNEL_NAME_LENGTH = 80;
+/** How long a pairing code stays valid. */
+export declare const PAIRING_TTL_MS: number;
+/** Most senders waiting for approval per channel; more are asked to try later. */
+export declare const MAX_PENDING_PAIRINGS = 3;
+export interface ChannelManagerDeps {
+    agentId: string;
+    eventBus: EventBus;
+    /** Resolved on every call so a later persistence swap (AgentCore.usePersistence) is picked up. */
+    getStore: () => ChannelStore;
+    getSessions: () => SessionStore;
+    /** The host's channel platform hub: its platforms (AgentCore.useChannelPlatform) and bot claims; absent = none registered. */
+    getPlatformHub: () => ChannelPlatformHub | undefined;
+    /** Resolved on every turn — the host's runner, or the agent's default one. */
+    getRunner: () => ChannelTurnRunner;
+    /** Used in replies such as /status. */
+    getAgentName: () => string;
+    /** The models /model offers; undefined when the provider has no catalog (any name is accepted then). */
+    listModels?: () => Promise<string[] | undefined>;
+    /** The agent's own model, used by sessions that set none. */
+    getDefaultModel?: () => string | undefined;
+    /**
+     * Phase 3: adds a message to a session between its turns (the conversation manager's).
+     * A scheduled job's result posted in a chat is added to that chat's session with it, so
+     * a reply in the chat ("tell me more") has it. Absent = results are only sent.
+     */
+    appendMessage?: (sessionId: string, message: Message) => Promise<void>;
+    /**
+     * A-135: a session's approval mode and its setter (the conversation manager's), for /yolo
+     * and /status. Absent = /yolo answers that it is not available.
+     */
+    getApprovalMode?: (sessionId: string) => Promise<ApprovalMode>;
+    setApprovalMode?: (sessionId: string, mode: ApprovalMode) => Promise<unknown>;
+    /**
+     * A-136: the agent's slash commands, for every command the chat does not answer itself.
+     * Absent = only the chat's own commands (and the /model, /yolo and /status below).
+     */
+    getCommands?: () => AgentCommands | undefined;
+    /** How long an approval or question waits in the chat (default 5 min). */
+    promptTimeoutMs?: number;
+    /** Clock — injectable for tests. */
+    now?: () => number;
+}
 /**
  * communication gateway: slack, teams, telegram, ...
+ *
+ * One agent's chat-app channels (A-100), like the OpenClaw / Hermes Agent
+ * gateways: it connects each enabled channel through its platform's adapter
+ * and turns inbound messages into agent turns.
+ *
+ *  - Access: direct messages only (groups come later). dmPolicy "pairing"
+ *    gives an unknown sender a one-time code for the owner to approve.
+ *    -> Phase 2: group chats too, by groupPolicy ("disabled" by default), and
+ *    only when the bot is mentioned or replied to (requireMention).
+ *  - Sessions: one per chat, found again through the session's metadata
+ *    ({ source: "channel", channelId, chatKey }) after a restart. /new starts
+ *    a fresh one; the old one stays in the history.
+ *  - Turns of one chat run one after another; different chats run in parallel
+ *    (the agent's TurnGate and maxConcurrentTurns still apply).
+ *  - Commands: /start, /help, /new, /reset, /stop, /status, /whoami. Any other
+ *    "/..." text goes to the agent.
+ *    -> A-135: /yolo on|off switches the conversation's approval mode (owners only).
+ *  - Replies are plain text, split to the platform's message length.
+ *    -> Phase 2: Markdown rendered by the adapter when it can, streamed by
+ *    editing one message, with a tool-progress message (TurnView).
+ *  - Phase 2: approvals and clarify questions of a channel turn are asked in its
+ *    chat (ChannelPrompts) — interactionFor() is the channel side of the
+ *    agent's interaction router. /approve, /deny and /model are added.
  */
-export declare class ChannelManager {
+export declare class ChannelManager implements AgentChannels {
+    private deps;
+    private live;
+    private states;
+    /** channelId -> senders waiting for approval. */
+    private pairings;
+    /** chat key -> the chat's current session. */
+    private chatSessions;
+    /** chat key -> the last queued message of that chat. */
+    private chatQueues;
+    /** chat key -> the running turn, for /stop. */
+    private chatRuns;
+    /** channelId -> serialized connect/disconnect operations. */
+    private ops;
+    private seen;
+    /** sessionId -> the chat of the channel turn running in it (interaction routing). */
+    private activeTurns;
+    private prompts;
+    /** Scheduled-job results being sent (phase 3) — dispose() waits for them. */
+    private deliveries;
+    private unsubscribe;
+    private generation;
+    private started;
+    private disposed;
+    private readonly now;
+    constructor(deps: ChannelManagerDeps);
+    /**
+     * The InteractionHandler for a session while a channel turn runs in it: its
+     * approvals and questions are asked in the chat. Undefined for any other
+     * session (a web chat of the same session included) — the host's handler applies.
+     */
+    interactionFor(sessionId: string): InteractionHandler | undefined;
+    /**
+     * A-100 phase 3: the delivery of a job scheduled from a session while a channel turn runs
+     * in it — back to that chat, as "home" when it is the channel's home chat (so a later
+     * /sethome moves it along). Undefined for any other session: a web chat schedules jobs
+     * that keep their results in their conversation.
+     * Update (A-127): deliveryOptions — that chat (here) and every running channel with a
+     * home chat (homes), so a job made outside the chat app (a web chat) still reports to
+     * the home chats, and one made in a chat can go to them all.
+     */
+    deliveryOptions(sessionId: string): JobDeliveryOptions;
+    /** The chat of the channel turn running in the session; undefined when none does. */
+    private deliveryHere;
+    /** The running channels that have a home chat, by name. */
+    private homes;
+    /**
+     * Connect this agent's stored, enabled channels. A channel that cannot connect
+     * shows "failed" in state(); it does not stop the others. Idempotent.
+     */
+    start(): Promise<void>;
+    /** Disconnect every channel and stop the turns in progress. No new turns start after this. */
+    dispose(): Promise<void>;
+    list(): Promise<Channel[]>;
+    get(id: string): Promise<Channel | null>;
+    create(input: CreateChannelInput): Promise<Channel>;
+    update(id: string, patch: UpdateChannelInput): Promise<Channel>;
+    delete(id: string): Promise<void>;
+    state(id: string): ChannelState;
+    listPairings(id: string): Promise<ChannelPairing[]>;
+    approvePairing(id: string, code: string): Promise<Channel>;
+    rejectPairing(id: string, code: string): Promise<void>;
+    send(id: string, target: ChannelTarget, text: string): Promise<ChannelMessageRef[]>;
+    handleWebhook(id: string, request: ChannelWebhookRequest): Promise<ChannelWebhookResponse>;
+    /**
+     * Build the channel's adapter and connect it. Returns the bot account, or null
+     * when it failed (the reason is in state()). Runs inside serial(channel.id).
+     */
+    private connect;
+    /** Publish the chat commands to the platform, when the adapter can. A failure is logged, not thrown. */
+    private publishCommands;
+    /** Stop the channel's adapter and its chats' turns. Runs inside serial(id). */
+    private disconnect;
+    /** Connect and disconnect calls of one channel run one at a time, in call order. */
+    private serial;
+    private setState;
+    private onInbound;
+    private handleInbound;
+    private runTurn;
+    /** Shows "typing…" until the returned function is called. */
+    private keepTyping;
+    /** The chat's current session: cached, else the newest one stored for it, else a new one. */
+    private resolveSession;
+    /** A-136: the chat's current session when it has one (cached, else stored) — never a new one. */
+    private existingSession;
+    /**
+     * Phase 3: the current session of a chat the agent posts to unprompted (a job's result):
+     * the one its messages use, else a new one, so the chat's next message continues it.
+     */
+    private chatSession;
+    private findSession;
+    private createSession;
+    private requestPairing;
+    /** The channel's unexpired pairings (expired ones are dropped). */
+    private pendingPairings;
+    private takePairing;
+    /**
+     * /sethome — make this chat the channel's home, where jobs delivering to "home" post.
+     * Only the bot's owners (allowFrom) may: in an open DM or group anyone can talk, and
+     * the home chat receives what the agent produces unattended.
+     */
+    private setHome;
+    /**
+     * A prompt job of this agent ended; send its result when its delivery asks for it.
+     * A-70: a trigger run of this agent ended; send its result when the trigger's delivery asks
+     * for it. Sent with the run's session, so a delivery failure (channel:error) carries the
+     * run's depth and can't wake another trigger by default.
+     * Update (A-126): one handler for every job run (schedule, event or webhook).
+     */
+    private onJobRunFinished;
+    /** Start one delivery; dispose waits for the ones still sending. */
+    private track;
+    /** Send one job (or trigger run) result. Failures are logged and published as channel:error, never thrown. */
+    private deliver;
+    /**
+     * Add a delivered result to the chat's conversation as the agent's message, so the
+     * chat's next turn knows what was posted. The job's own session keeps the run as before.
+     * A failure is logged: the result was delivered either way.
+     */
+    private recordResult;
+    /** The job's result as chat messages: Markdown when the adapter renders it, split to its length. */
+    private sendResult;
+    private sendText;
+    /** Send a short notice; a failure is logged, not thrown. */
+    private reply;
+    private helpText;
+    /** A-136: the agent's commands a chat can run (not the chat's own, none needing a client capability). */
+    private agentCommands;
+    /** The commands published to the platform: the chat's own, then the agent's (the names a platform takes). */
+    private botCommands;
+    /**
+     * A-136: run one of the agent's commands in the chat. Privileged ones that change something
+     * (/permissions yolo) are for the bot's owners only — they typed it, which counts as the
+     * confirmation the web app asks for. The result's action is carried out here: a session
+     * picked by /resume becomes the chat's, a prompt (/plan <prompt>, /init, /review) runs as a turn.
+     */
+    private runAgentCommand;
+    /** A button press: an approval or a question's choice. */
+    private onButton;
+    /**
+     * Whether the sender may talk to the agent in this chat: in a direct message by
+     * dmPolicy and allowFrom; in a group, any member once the group is allowed.
+     */
+    private mayTalk;
+    private groupAllowed;
+    /**
+     * The message as the agent reads it: the bot's @-mention removed, and in a group
+     * (`withSender`) prefixed with who wrote it, since several people share the session.
+     */
+    private agentText;
+    /** /model — show the conversation's model, or switch it ("/model default" goes back to the agent's). */
+    private modelCommand;
+    /**
+     * A-135: /yolo [on|off] — show or switch the conversation's approval mode. In YOLO mode
+     * the agent runs tools that need approval without asking here. Only the bot's owners
+     * (allowFrom) may switch it: in an open DM or group anyone can talk.
+     */
+    private yoloCommand;
+    private warn;
+    private statusText;
+    private abortChats;
+    private isDuplicate;
+    private requirePlatform;
+    private require;
+    private emit;
+    private store;
+    private iso;
 }
 //# sourceMappingURL=channel-manager.d.ts.map

package/dist/components/multi-agent-orchestration/agent/channel-manager/channel-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/channel-manager/channel-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAc;CAE1B"}
+{"version":3,"file":"channel-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/channel-manager/channel-manager.ts"],"names":[],"mappings":"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"}