aec-agent 1.0.3 → 1.0.4

package/dist/components/channel-platform-hub/types.d.ts

@@ -0,0 +1,290 @@
+/**
+ * Who may talk to the agent in direct messages.
+ * "pairing" — an unknown sender gets a one-time code; the owner approves it (default).
+ * "allowlist" — only senders in allowFrom; others are told their id.
+ * "open" — anyone who finds the bot.
+ * "disabled" — direct messages are ignored.
+ */
+export type ChannelDmPolicy = "pairing" | "allowlist" | "open" | "disabled";
+/**
+ * Which group chats the bot answers in (phase 2).
+ * "disabled" — groups are ignored (default).
+ * "allowlist" — only the group chats in `groups`.
+ * "open" — any group the bot is added to.
+ */
+export type ChannelGroupPolicy = "disabled" | "allowlist" | "open";
+export interface ChannelAccess {
+    dmPolicy: ChannelDmPolicy;
+    /**
+     * Sender ids (as the platform reports them) allowed to talk to the agent. Approving a pairing adds one.
+     * In group chats they are the only members who may approve tools.
+     */
+    allowFrom: string[];
+    /** Default "disabled". */
+    groupPolicy: ChannelGroupPolicy;
+    /** Group chat ids allowed when groupPolicy is "allowlist" (/whoami in the group shows it). */
+    groups: string[];
+    /** In groups, answer only messages that @-mention the bot or reply to it (default true). */
+    requireMention: boolean;
+}
+/** How replies are shown in the chat (phase 2). */
+export interface ChannelSettings {
+    /**
+     * Show the reply while it is written by editing one message in place (default true).
+     * Needs an adapter with edit(); otherwise the reply is sent when it is done.
+     */
+    streaming: boolean;
+    /** Keep one message listing the tools the agent runs, edited as they finish (default true). */
+    toolProgress: boolean;
+}
+/** The bot account a channel is connected as, read from the platform when it connects. */
+export interface ChannelAccountInfo {
+    id: string;
+    /** Handle without "@", e.g. "my_aec_bot". */
+    username?: string;
+    displayName?: string;
+}
+/**
+ * The chat a channel sends scheduled-job results to when a job's delivery target
+ * is "home" (phase 3). Set by /sethome in a chat, or by the owner through the host.
+ */
+export interface ChannelHome {
+    chatId: string;
+    /** Forum topic / thread inside the chat, when there is one. */
+    threadId?: string;
+    /** The chat's title, or the sender's name in a direct message — shown to users. */
+    title?: string;
+    /** Sender id of who ran /sethome; absent when set through the host. */
+    setBy?: string;
+    /** ISO time it was set. */
+    setAt: string;
+}
+export interface Channel {
+    id: string;
+    /** Owning agent. Every read path is filtered by it. */
+    agentId: string;
+    /** Registered ChannelPlatform name, e.g. "telegram". */
+    platform: string;
+    /** Label shown to users. */
+    name: string;
+    /**
+     * Platform secrets, e.g. { botToken } for Telegram. Hosts must never return
+     * them from their APIs and should encrypt them at rest.
+     */
+    credentials: Record<string, string>;
+    access: ChannelAccess;
+    settings: ChannelSettings;
+    enabled: boolean;
+    /** Set on the first successful connect. */
+    account?: ChannelAccountInfo;
+    /** Where scheduled-job results go when a job delivers to "home" (phase 3). */
+    home?: ChannelHome;
+    /** ISO timestamps. */
+    createdAt: string;
+    updatedAt: string;
+}
+/** Fields a caller may set when connecting a channel. */
+export interface CreateChannelInput {
+    platform: string;
+    /** Default: the bot's display name, else the platform name. */
+    name?: string;
+    credentials: Record<string, string>;
+    /** Default { dmPolicy: "pairing", allowFrom: [], groupPolicy: "disabled", groups: [], requireMention: true }. */
+    access?: Partial<ChannelAccess>;
+    /** Default { streaming: true, toolProgress: true }. */
+    settings?: Partial<ChannelSettings>;
+    /** Default true. */
+    enabled?: boolean;
+}
+/** Fields a caller may change. `credentials` are merged into the stored ones; a change reconnects. */
+export interface UpdateChannelInput {
+    name?: string;
+    credentials?: Record<string, string>;
+    access?: Partial<ChannelAccess>;
+    settings?: Partial<ChannelSettings>;
+    enabled?: boolean;
+    /** Set the home chat (phase 3); null clears it. */
+    home?: {
+        chatId: string;
+        threadId?: string;
+        title?: string;
+    } | null;
+}
+/** Live connection state — kept in memory, not stored. */
+export interface ChannelState {
+    status: "stopped" | "connecting" | "running" | "retrying" | "failed";
+    /** Why it is retrying or failed. */
+    error?: string;
+    /** ISO time the status last changed. */
+    since: string;
+}
+/** A sender waiting for the owner to approve them (dmPolicy "pairing"). Kept in memory; codes expire. */
+export interface ChannelPairing {
+    code: string;
+    channelId: string;
+    senderId: string;
+    senderName?: string;
+    /** The chat to tell the sender in once approved. */
+    chatId: string;
+    /** ISO timestamps. */
+    requestedAt: string;
+    expiresAt: string;
+}
+export type ChannelChatType = "dm" | "group" | "channel";
+export interface ChannelChat {
+    id: string;
+    type: ChannelChatType;
+    /** Forum topic / thread inside the chat, when the platform has them. */
+    threadId?: string;
+    title?: string;
+}
+export interface ChannelSender {
+    id: string;
+    name?: string;
+    username?: string;
+    isBot?: boolean;
+}
+/** One message from the platform, normalised by the adapter. */
+export interface InboundMessage {
+    /** Platform message id — unique within the chat; used to drop duplicates. */
+    messageId: string;
+    chat: ChannelChat;
+    sender: ChannelSender;
+    /** Message text (or a media caption). Empty when the message carried no text. */
+    text: string;
+    /** The message @-mentions the bot. */
+    mentionsBot?: boolean;
+    /** The message replies to one of the bot's messages. */
+    replyToBot?: boolean;
+}
+/** Where to send: a chat, optionally a thread in it and a message to reply to. */
+export interface ChannelTarget {
+    chatId: string;
+    threadId?: string;
+    replyToMessageId?: string;
+}
+/** A button under a message (approve / deny, clarify choices). */
+export interface ChannelButton {
+    label: string;
+    /** Handed back in ChannelButtonPress.data. At most 64 bytes (Telegram's limit). */
+    data: string;
+}
+export interface OutboundMessage {
+    /** Already within capabilities.maxMessageLength. */
+    text: string;
+    /**
+     * "markdown": the agent's Markdown, which the adapter renders in its platform's
+     * format (and sends as plain text when that fails). Default "plain".
+     */
+    format?: "plain" | "markdown";
+    /** Rows of buttons. Only sent when capabilities.buttons is true. */
+    buttons?: ChannelButton[][];
+}
+/** Someone pressed one of the bot's buttons. */
+export interface ChannelButtonPress {
+    chat: ChannelChat;
+    sender: ChannelSender;
+    /** The message the button is on. */
+    messageId: string;
+    /** ChannelButton.data. */
+    data: string;
+}
+export interface ChannelMessageRef {
+    chatId: string;
+    messageId: string;
+}
+export interface ChannelCapabilities {
+    /** Longest text one message may carry; longer replies are split. */
+    maxMessageLength: number;
+    /** send() renders OutboundMessage.format "markdown". Otherwise Markdown is sent as it is. */
+    markdown?: boolean;
+    /** send() and edit() show OutboundMessage.buttons, and presses reach ChannelSink.button. */
+    buttons?: boolean;
+}
+/** How an adapter reports to its ChannelManager. */
+export interface ChannelSink {
+    message(message: InboundMessage): void;
+    /** A button press (capabilities.buttons). The adapter acknowledges it on the platform itself. */
+    button(press: ChannelButtonPress): void;
+    /**
+     * "running" once (re)connected, "retrying" while a transient error is being
+     * retried, "failed" when the adapter gave up (it is stopped then).
+     */
+    status(status: "running" | "retrying" | "failed", error?: string): void;
+}
+/**
+ * One live connection to a platform account. Built by a ChannelPlatform for a
+ * stored Channel. Implement it to connect your own app's chat.
+ */
+export interface ChannelAdapter {
+    readonly capabilities: ChannelCapabilities;
+    /**
+     * Connect and start delivering messages to `sink`. Resolves once connected
+     * with the bot account; rejects when the credentials are wrong or the
+     * platform cannot be reached — nothing keeps running then.
+     */
+    start(sink: ChannelSink): Promise<ChannelAccountInfo>;
+    /** Disconnect. No messages reach the sink after it resolves. Safe to call twice. */
+    stop(): Promise<void>;
+    send(target: ChannelTarget, message: OutboundMessage): Promise<ChannelMessageRef>;
+    /**
+     * Replace the text (and buttons; none given = removed) of a message the bot sent.
+     * Optional — streamed previews, the tool-progress message and settled approval
+     * prompts need it. Editing to the same text must not throw.
+     */
+    edit?(ref: ChannelMessageRef, message: OutboundMessage): Promise<void>;
+    /** Show "typing…" in the chat for a few seconds. Optional. */
+    sendTyping?(target: ChannelTarget): Promise<void>;
+    /**
+     * Publish the chat commands the bot answers, so the platform can suggest them
+     * (Telegram's "/" menu). Optional. The ChannelManager calls it once connected;
+     * a failure is logged and the channel keeps running.
+     */
+    setCommands?(commands: ChannelBotCommand[]): Promise<void>;
+    /**
+     * Phase 3: an inbound HTTP request for this channel, for platforms that push
+     * messages to the host (Microsoft Teams' Bot Framework) instead of being polled
+     * or connected to. The host routes POST /webhooks/channels/:id here
+     * (AgentCore.handleChannelWebhook). The adapter checks the request is genuine
+     * (signature / token) and hands messages to the sink it got in start().
+     */
+    handleWebhook?(request: ChannelWebhookRequest): Promise<ChannelWebhookResponse>;
+}
+/** A chat command the bot answers, e.g. { name: "new", description: "Start a new conversation" }. */
+export interface ChannelBotCommand {
+    /** Without the "/": lower case letters, digits and "_". */
+    name: string;
+    description: string;
+}
+/** An inbound HTTP request for a channel's webhook (phase 3). */
+export interface ChannelWebhookRequest {
+    method: string;
+    /** Header names in lower case. */
+    headers: Record<string, string>;
+    /** The raw body. */
+    body: string;
+}
+export interface ChannelWebhookResponse {
+    status: number;
+    /** JSON-encoded by the host when it is not a string. */
+    body?: unknown;
+}
+/** Builds adapters for one platform. Register it with AgentCore.useChannelPlatform. */
+export interface ChannelPlatform {
+    /** Stored on Channel.platform, e.g. "telegram". */
+    readonly name: string;
+    /** e.g. "Telegram". Default: name. */
+    readonly displayName?: string;
+    /** Credential keys a channel must have, e.g. ["botToken"] — checked on create. */
+    readonly credentialKeys: string[];
+    /** Credential keys a channel may have, e.g. ["tenantId"] (phase 3). Shown as optional fields. */
+    readonly optionalCredentialKeys?: string[];
+    /**
+     * How the platform reaches the host (phase 3). "webhook" platforms need the host's
+     * POST /webhooks/channels/:id to be reachable from the internet. Default "connect"
+     * (the adapter polls or holds a connection; no public URL needed).
+     */
+    readonly ingress?: "connect" | "webhook";
+    create(channel: Channel): ChannelAdapter;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/channel-platform-hub/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/channel-platform-hub/types.ts"],"names":[],"mappings":"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"}

package/dist/components/channel-platform-hub/types.js

@@ -0,0 +1,23 @@
+// ---------------------------------------------------------------------------
+// Channels (A-100) — chat apps (Telegram, Slack, Discord, your own app...) the
+// agent talks through, like the OpenClaw / Hermes Agent gateways.
+//
+// A Channel is data: one connected bot account, owned by one agent, kept in
+// PersistenceHub.channels so it survives a restart. A ChannelPlatform builds a
+// live ChannelAdapter for it; the adapter normalises the platform's messages
+// into InboundMessage and sends text back. Everything between the two —
+// who may talk to the agent, which session a chat maps to, chat commands,
+// splitting long replies — belongs to the agent's ChannelManager, so a new
+// platform only has to implement the small ChannelAdapter contract below.
+//
+// The ChannelManager decides WHAT to run; the host decides HOW through a
+// ChannelTurnRunner (same split as prompt jobs), so a channel turn takes the
+// host's per-session lock, stop registry, traces and usage like a web chat.
+//
+// These are the contracts shared by the ChannelPlatformHub, the platform adapters,
+// PersistenceHub.channels and each agent's ChannelManager. The turn runner and
+// the agent API (AgentChannels) are the ChannelManager's, in
+// multi-agent-orchestration/agent/channel-manager/types.ts.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/channel-platform-hub/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/channel-platform-hub/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,4EAA4E;AAC5E,EAAE;AACF,mFAAmF;AACnF,+EAA+E;AAC/E,6DAA6D;AAC7D,4DAA4D;AAC5D,8EAA8E"}

package/dist/components/event-handler/event-dispatcher.d.ts

@@ -1,5 +1,6 @@
 import type { Event } from "../../kernel/types.js";
-import type { EventBus, EventHandler, Unsubscribe } from "./types.js";
+import type { SDKEventPayloadMap } from "./events.js";
+import type { EventBus, EventHandler, SDKEventInput, Unsubscribe } from "./types.js";
 /**
  * Pub-sub event to decouple between services (like MediatR in .Net)
  */
@@ -7,11 +8,35 @@ export declare class EventDispatcher implements EventBus {
     readonly name = "event-dispatcher";
     readonly version = "1.0.0";
     private handlers;
+    private anyHandlers;
     private log;
-    constructor(backing?: Event[]);
+    private readonly capacity;
+    /**
+     * @param backing  optional array to store events in; it is used as-is (not copied), so it can be shared.
+     * @param options.capacity  most events kept; the oldest are trimmed in place. 0 keeps none, Infinity is unbounded.
+     */
+    constructor(backing?: Event[], options?: {
+        capacity?: number;
+    });
     initialize(): Promise<void>;
-    emit<T>(partial: Omit<Event<T>, "id" | "timestamp">): Event<T>;
+    emit<K extends keyof SDKEventPayloadMap>(event: SDKEventInput<K>): Event<SDKEventPayloadMap[K]>;
+    emit<T>(event: Omit<Event<T>, "id" | "timestamp">): Event<T>;
+    publish<K extends keyof SDKEventPayloadMap>(event: SDKEventInput<K>): Promise<Event<SDKEventPayloadMap[K]>>;
+    publish<T>(event: Omit<Event<T>, "id" | "timestamp">): Promise<Event<T>>;
+    on<K extends keyof SDKEventPayloadMap>(type: K, handler: EventHandler<SDKEventPayloadMap[K]>): Unsubscribe;
     on<T>(type: string, handler: EventHandler<T>): Unsubscribe;
+    onAny(handler: EventHandler): Unsubscribe;
+    /** Drops every subscriber. The log is kept: a shared backing array must stay replayable. */
+    dispose(): Promise<void>;
     replay(sessionId: string, fromTimestamp?: number): AsyncIterable<Event>;
+    private store;
+    /**
+     * Calls every subscriber on a snapshot (type handlers first, then onAny handlers).
+     * A subscriber removed during delivery before its turn is skipped. Each call is
+     * isolated; the returned promises never reject.
+     */
+    private deliver;
+    /** Logs the event type and the error only; never the event or its payload. */
+    private report;
 }
 //# sourceMappingURL=event-dispatcher.d.ts.map

package/dist/components/event-handler/event-dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/components/event-handler/event-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtE;;GAEG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,GAAG,CAAU;IAErB,YAAY,OAAO,CAAC,EAAE,KAAK,EAAE,EAE5B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAEpC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAe7D;IAED,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAQzD;IAEM,MAAM,CACX,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,aAAa,CAAC,KAAK,CAAC,CAMtB;CACF"}
+{"version":3,"file":"event-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/components/event-handler/event-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAKrF;;GAEG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;;OAGG;IACH,YAAY,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,EAOjE;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAEpC,IAAI,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAO7D,OAAO,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5G,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAOzE,EAAE,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAC3G,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAW3D,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAGxC;IAED,4FAA4F;IACtF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAG7B;IAEM,MAAM,CACX,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,aAAa,CAAC,KAAK,CAAC,CAMtB;IAED,OAAO,CAAC,KAAK;IAab;;;;OAIG;IACH,OAAO,CAAC,OAAO;IA0Bf,8EAA8E;IAC9E,OAAO,CAAC,MAAM;CAIf"}

package/dist/components/event-handler/event-dispatcher.js

@@ -1,3 +1,5 @@
+/** Events kept in memory unless the constructor is given { capacity }. */
+const DEFAULT_EVENT_LOG_CAPACITY = 10_000;
 /**
  * Pub-sub event to decouple between services (like MediatR in .Net)
  */
@@ -5,24 +7,30 @@ export class EventDispatcher {
     name = "event-dispatcher";
     version = "1.0.0";
     handlers = new Map();
+    anyHandlers = new Set();
     log;
-    constructor(backing) {
+    capacity;
+    /**
+     * @param backing  optional array to store events in; it is used as-is (not copied), so it can be shared.
+     * @param options.capacity  most events kept; the oldest are trimmed in place. 0 keeps none, Infinity is unbounded.
+     */
+    constructor(backing, options = {}) {
+        const capacity = options.capacity ?? DEFAULT_EVENT_LOG_CAPACITY;
+        if (capacity !== Infinity && !(Number.isInteger(capacity) && capacity >= 0)) {
+            throw new RangeError(`EventDispatcher capacity must be a non-negative integer or Infinity, got ${String(capacity)}`);
+        }
+        this.capacity = capacity;
         this.log = backing ?? [];
     }
     async initialize() { }
     emit(partial) {
-        const event = {
-            ...partial,
-            id: crypto.randomUUID(),
-            timestamp: Date.now(),
-        };
-        this.log.push(event);
-        const set = this.handlers.get(event.type);
-        if (set) {
-            for (const handler of set) {
-                handler(event);
-            }
-        }
+        const event = this.store(partial);
+        this.deliver(event);
+        return event;
+    }
+    async publish(partial) {
+        const event = this.store(partial);
+        await Promise.allSettled(this.deliver(event));
         return event;
     }
     on(type, handler) {
@@ -34,6 +42,15 @@ export class EventDispatcher {
         set.add(handler);
         return () => set.delete(handler);
     }
+    onAny(handler) {
+        this.anyHandlers.add(handler);
+        return () => this.anyHandlers.delete(handler);
+    }
+    /** Drops every subscriber. The log is kept: a shared backing array must stay replayable. */
+    async dispose() {
+        this.handlers.clear();
+        this.anyHandlers.clear();
+    }
     async *replay(sessionId, fromTimestamp) {
         for (const event of this.log) {
             if (event.sessionId !== sessionId)
@@ -43,5 +60,52 @@ export class EventDispatcher {
             yield event;
         }
     }
+    store(partial) {
+        const event = {
+            ...partial,
+            id: crypto.randomUUID(),
+            timestamp: Date.now(),
+        };
+        this.log.push(event);
+        // Trim in place (never reassign this.log) so a shared backing array stays shared.
+        const excess = this.log.length - this.capacity;
+        if (excess > 0)
+            this.log.splice(0, excess);
+        return event;
+    }
+    /**
+     * Calls every subscriber on a snapshot (type handlers first, then onAny handlers).
+     * A subscriber removed during delivery before its turn is skipped. Each call is
+     * isolated; the returned promises never reject.
+     */
+    deliver(event) {
+        const typed = this.handlers.get(event.type);
+        const snapshot = [];
+        if (typed)
+            for (const h of [...typed])
+                snapshot.push([h, typed]);
+        for (const h of [...this.anyHandlers])
+            snapshot.push([h, this.anyHandlers]);
+        const pending = [];
+        for (const [handler, live] of snapshot) {
+            if (!live.has(handler))
+                continue;
+            try {
+                const result = handler(event);
+                if (result && typeof result.then === "function") {
+                    pending.push(Promise.resolve(result).then(() => undefined, (err) => this.report(event.type, err)));
+                }
+            }
+            catch (err) {
+                this.report(event.type, err);
+            }
+        }
+        return pending;
+    }
+    /** Logs the event type and the error only; never the event or its payload. */
+    report(type, err) {
+        const what = err instanceof Error ? `${err.name}: ${err.message}` : typeof err;
+        console.warn(`[events] subscriber failed for "${type}":`, what);
+    }
 }
 //# sourceMappingURL=event-dispatcher.js.map

package/dist/components/event-handler/event-dispatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-dispatcher.js","sourceRoot":"","sources":["../../../src/components/event-handler/event-dispatcher.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,kBAAkB,CAAC;IAC1B,OAAO,GAAG,OAAO,CAAC;IAEnB,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAChD,GAAG,CAAU;IAErB,YAAY,OAAiB;QAC3B,IAAI,CAAC,GAAG,GAAG,OAAO,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,UAAU,KAAmB,CAAC;IAEpC,IAAI,CAAI,OAA2C;QACjD,MAAM,KAAK,GAAa;YACtB,GAAG,OAAO;YACV,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAc,CAAC,CAAC;QAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,EAAE,CAAI,IAAY,EAAE,OAAwB;QAC1C,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAuB,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CACX,SAAiB,EACjB,aAAsB;QAEtB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;gBAAE,SAAS;YAC5C,IAAI,aAAa,IAAI,KAAK,CAAC,SAAS,GAAG,aAAa;gBAAE,SAAS;YAC/D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"event-dispatcher.js","sourceRoot":"","sources":["../../../src/components/event-handler/event-dispatcher.ts"],"names":[],"mappings":"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"}