@moltzap/client 2026.407.0 → 2026.413.0

package/dist/channel-core.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Shared message-enrichment helper for MoltZap channel adapters.
+ */
+import type { Message } from "@moltzap/protocol";
+import type { CrossConversationEntry } from "./service.js";
+import type { WsClientLogger } from "./ws-client.js";
+export interface EnrichedSender {
+    type: "agent" | "user";
+    id: string;
+    name: string;
+}
+export interface EnrichedConversationMeta {
+    type: "dm" | "group";
+    name?: string;
+    /** "type:id" strings (e.g. "agent:uuid"). */
+    participants: string[];
+}
+export interface ContextBlocks {
+    groupMetadata?: EnrichedConversationMeta;
+    crossConversation?: CrossConversationEntry[];
+}
+export interface EnrichedInboundMessage {
+    id: string;
+    conversationId: string;
+    sender: EnrichedSender;
+    /** Text parts joined with newlines. Non-text parts dropped. */
+    text: string;
+    isFromMe: boolean;
+    createdAt: string;
+    replyToId?: string;
+    conversationMeta?: EnrichedConversationMeta;
+    contextBlocks: ContextBlocks;
+}
+/** The subset of MoltZapService that MoltZapChannelCore needs. */
+export interface ChannelService {
+    readonly ownAgentId: string | undefined;
+    on(event: "message", handler: (msg: Message) => void): void;
+    on(event: "disconnect", handler: () => void): void;
+    on(event: "reconnect", handler: () => void): void;
+    connect(): Promise<unknown>;
+    close(): void;
+    send(conversationId: string, text: string): Promise<void>;
+    getConversation(convId: string): {
+        type: string;
+        name?: string;
+        participants: string[];
+    } | undefined;
+    getAgentName(agentId: string): string | undefined;
+    resolveAgentName(agentId: string): Promise<string>;
+    peekContextEntries(currentConvId: string, opts?: {
+        maxConversations?: number;
+        maxMessagesPerConv?: number;
+    }): {
+        entries: CrossConversationEntry[];
+        commit: () => void;
+    };
+}
+export interface ChannelCoreOptions {
+    service: ChannelService;
+    logger?: WsClientLogger;
+}
+export type InboundHandler = (msg: EnrichedInboundMessage) => Promise<void> | void;
+/**
+ * Wraps a MoltZapService with message enrichment, dispatch-chain ordering,
+ * and a send helper.
+ *
+ * Do NOT construct multiple cores over the same service — getContextEntries()
+ * is side-effectful (advances per-conversation markers), so a second core
+ * would consume entries the first expected.
+ */
+export declare class MoltZapChannelCore {
+    private readonly service;
+    private readonly logger;
+    private connected;
+    private inboundHandler;
+    private dispatchChain;
+    private disconnectHandlers;
+    private reconnectHandlers;
+    constructor(opts: ChannelCoreOptions);
+    /** Replaces any previous handler. */
+    onInbound(handler: InboundHandler): void;
+    onDisconnect(handler: () => void): void;
+    onReconnect(handler: () => void): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    sendReply(conversationId: string, text: string): Promise<void>;
+    /**
+     * Stateless enrichment helper. Falls back to `sender.id` if
+     * `resolveAgentName` throws (e.g. service not yet connected).
+     */
+    static enrichMessage(service: ChannelService, message: Message): Promise<{
+        enriched: EnrichedInboundMessage;
+        commitContext?: () => void;
+    }>;
+    private handleInbound;
+}
+//# sourceMappingURL=channel-core.d.ts.map

package/dist/channel-core.d.ts.map

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

package/dist/channel-core.js

@@ -0,0 +1,131 @@
+/**
+ * Shared message-enrichment helper for MoltZap channel adapters.
+ */
+const noopLogger = {
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+function extractTextContent(parts) {
+    return parts
+        .filter((p) => p.type === "text")
+        .map((p) => p.text)
+        .join("\n");
+}
+/**
+ * Wraps a MoltZapService with message enrichment, dispatch-chain ordering,
+ * and a send helper.
+ *
+ * Do NOT construct multiple cores over the same service — getContextEntries()
+ * is side-effectful (advances per-conversation markers), so a second core
+ * would consume entries the first expected.
+ */
+export class MoltZapChannelCore {
+    service;
+    logger;
+    connected = false;
+    inboundHandler = null;
+    dispatchChain = Promise.resolve();
+    disconnectHandlers = [];
+    reconnectHandlers = [];
+    constructor(opts) {
+        this.service = opts.service;
+        this.logger = opts.logger ?? noopLogger;
+        this.service.on("message", (message) => {
+            this.dispatchChain = this.dispatchChain
+                .then(() => this.handleInbound(message))
+                .catch((err) => {
+                this.logger.error({ messageId: message.id, err }, "MoltZapChannelCore: inbound handler threw");
+            });
+        });
+        this.service.on("disconnect", () => {
+            this.connected = false;
+            for (const h of this.disconnectHandlers)
+                h();
+        });
+        this.service.on("reconnect", () => {
+            this.connected = true;
+            for (const h of this.reconnectHandlers)
+                h();
+        });
+    }
+    /** Replaces any previous handler. */
+    onInbound(handler) {
+        this.inboundHandler = handler;
+    }
+    onDisconnect(handler) {
+        this.disconnectHandlers.push(handler);
+    }
+    onReconnect(handler) {
+        this.reconnectHandlers.push(handler);
+    }
+    async connect() {
+        await this.service.connect();
+        this.connected = true;
+    }
+    async disconnect() {
+        this.service.close();
+        this.connected = false;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    async sendReply(conversationId, text) {
+        await this.service.send(conversationId, text);
+    }
+    /**
+     * Stateless enrichment helper. Falls back to `sender.id` if
+     * `resolveAgentName` throws (e.g. service not yet connected).
+     */
+    static async enrichMessage(service, message) {
+        const convMeta = service.getConversation(message.conversationId);
+        const senderName = service.getAgentName(message.sender.id) ??
+            (await service
+                .resolveAgentName(message.sender.id)
+                .catch(() => message.sender.id));
+        const text = extractTextContent(message.parts);
+        const isFromMe = service.ownAgentId !== undefined &&
+            message.sender.id === service.ownAgentId;
+        const conversationMeta = convMeta
+            ? {
+                type: convMeta.type === "group" ? "group" : "dm",
+                name: convMeta.name,
+                participants: convMeta.participants,
+            }
+            : undefined;
+        const contextBlocks = {};
+        if (conversationMeta?.type === "group") {
+            contextBlocks.groupMetadata = conversationMeta;
+        }
+        const { entries, commit } = service.peekContextEntries(message.conversationId);
+        if (entries.length > 0) {
+            contextBlocks.crossConversation = entries;
+        }
+        return {
+            enriched: {
+                id: message.id,
+                conversationId: message.conversationId,
+                sender: {
+                    type: message.sender.type === "user" ? "user" : "agent",
+                    id: message.sender.id,
+                    name: senderName,
+                },
+                text,
+                isFromMe,
+                createdAt: message.createdAt,
+                replyToId: message.replyToId,
+                conversationMeta,
+                contextBlocks,
+            },
+            commitContext: entries.length > 0 ? commit : undefined,
+        };
+    }
+    async handleInbound(message) {
+        if (!this.inboundHandler)
+            return;
+        const { enriched, commitContext } = await MoltZapChannelCore.enrichMessage(this.service, message);
+        await this.inboundHandler(enriched);
+        commitContext?.();
+    }
+}
+//# sourceMappingURL=channel-core.js.map

package/dist/channel-core.js.map

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

package/dist/channel-core.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channel-core.test.d.ts.map

package/dist/channel-core.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-core.test.d.ts","sourceRoot":"","sources":["../src/channel-core.test.ts"],"names":[],"mappings":""}

package/dist/channel-core.test.js

@@ -0,0 +1,425 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { MoltZapChannelCore, } from "./index.js";
+import { createFakeChannelService, buildMessage, flushDispatchChain, } from "./test-utils/index.js";
+function customSetup() {
+    const fake = createFakeChannelService({ ownAgentId: "agent-self" });
+    const received = [];
+    const errorSpy = vi.fn();
+    const core = new MoltZapChannelCore({
+        service: fake.service,
+        logger: { info: () => { }, warn: () => { }, error: errorSpy },
+    });
+    core.onInbound((m) => {
+        received.push(m);
+    });
+    return { fake, core, received, errorSpy };
+}
+/** Stub out getAgentName on the fixture's service so resolveAgentName is the only path. */
+function forceResolveAgentNamePath(fake) {
+    fake.service.getAgentName = () => undefined;
+}
+describe("MoltZapChannelCore", () => {
+    let fake;
+    let service;
+    let core;
+    let inbound;
+    beforeEach(() => {
+        fake = createFakeChannelService({ ownAgentId: "agent-self" });
+        service = fake.service;
+        core = new MoltZapChannelCore({ service });
+        inbound = [];
+        core.onInbound((msg) => {
+            inbound.push(msg);
+        });
+    });
+    describe("lifecycle", () => {
+        it("connect() delegates to service and sets connected", async () => {
+            expect(core.isConnected()).toBe(false);
+            await core.connect();
+            expect(fake.state.connectCalls.count).toBe(1);
+            expect(core.isConnected()).toBe(true);
+        });
+        it("disconnect() closes the service and clears the connected flag", async () => {
+            await core.connect();
+            await core.disconnect();
+            expect(fake.state.closeCalls.count).toBe(1);
+            expect(core.isConnected()).toBe(false);
+        });
+        it("disconnect event from the service clears the connected flag", async () => {
+            await core.connect();
+            fake.emit.disconnect();
+            expect(core.isConnected()).toBe(false);
+        });
+        it("reconnect event from the service sets the connected flag", () => {
+            fake.emit.reconnect();
+            expect(core.isConnected()).toBe(true);
+        });
+        it("onDisconnect handlers fire on disconnect event", async () => {
+            const spy = vi.fn();
+            core.onDisconnect(spy);
+            await core.connect();
+            fake.emit.disconnect();
+            expect(spy).toHaveBeenCalledOnce();
+        });
+        it("onReconnect handlers fire on reconnect event", () => {
+            const spy = vi.fn();
+            core.onReconnect(spy);
+            fake.emit.reconnect();
+            expect(spy).toHaveBeenCalledOnce();
+        });
+    });
+    describe("inbound message enrichment", () => {
+        it("maps a MoltZap Message to EnrichedInboundMessage", async () => {
+            fake.state.setConversation("conv-1", {
+                type: "dm",
+                name: "alice-dm",
+                participants: ["agent:agent-alice", "agent:agent-self"],
+            });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.emit.message(buildMessage({
+                id: "msg-abc",
+                conversationId: "conv-1",
+                sender: { type: "agent", id: "agent-alice" },
+                parts: [{ type: "text", text: "hi there" }],
+                createdAt: "2026-04-10T13:00:00.000Z",
+            }));
+            await flushDispatchChain();
+            expect(inbound).toHaveLength(1);
+            const enriched = inbound[0];
+            expect(enriched).toMatchObject({
+                id: "msg-abc",
+                conversationId: "conv-1",
+                sender: { type: "agent", id: "agent-alice", name: "Alice" },
+                text: "hi there",
+                isFromMe: false,
+                createdAt: "2026-04-10T13:00:00.000Z",
+            });
+            expect(enriched.conversationMeta).toMatchObject({
+                type: "dm",
+                name: "alice-dm",
+            });
+        });
+        it("resolves sender name from getAgentName cache when present", async () => {
+            fake.state.setAgentName("agent-alice", "Alice (cached)");
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            expect(inbound[0].sender.name).toBe("Alice (cached)");
+            expect(fake.state.resolveAgentNameCallCount("agent-alice")).toBe(0);
+        });
+        it("falls back to resolveAgentName when getAgentName returns undefined", async () => {
+            const { fake, received } = customSetup();
+            forceResolveAgentNamePath(fake);
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice (via resolve)");
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            expect(received[0].sender.name).toBe("Alice (via resolve)");
+            expect(fake.state.resolveAgentNameCallCount("agent-alice")).toBe(1);
+        });
+        it("falls back to sender.id when both name lookups fail", async () => {
+            const { fake, received } = customSetup();
+            forceResolveAgentNamePath(fake);
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.emit.message(buildMessage({ sender: { type: "agent", id: "agent-unknown" } }));
+            await flushDispatchChain();
+            expect(received[0].sender.name).toBe("agent-unknown");
+        });
+        it("swallows resolveAgentName errors and falls back to sender.id", async () => {
+            const { fake, received } = customSetup();
+            forceResolveAgentNamePath(fake);
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setResolveAgentNameFailure("agent-broken", new Error("network down"));
+            fake.emit.message(buildMessage({ sender: { type: "agent", id: "agent-broken" } }));
+            await flushDispatchChain();
+            expect(received[0].sender.name).toBe("agent-broken");
+        });
+        it("concatenates multi-text-part messages with newlines", async () => {
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.emit.message(buildMessage({
+                parts: [
+                    { type: "text", text: "line one" },
+                    { type: "text", text: "line two" },
+                ],
+            }));
+            await flushDispatchChain();
+            expect(inbound[0].text).toBe("line one\nline two");
+        });
+        it("ignores non-text parts when building text", async () => {
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.emit.message(buildMessage({
+                parts: [
+                    { type: "text", text: "caption" },
+                    { type: "image", url: "https://example.com/pic.png" },
+                ],
+            }));
+            await flushDispatchChain();
+            expect(inbound[0].text).toBe("caption");
+        });
+        it("sets isFromMe=true when sender matches ownAgentId", async () => {
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.emit.message(buildMessage({ sender: { type: "agent", id: "agent-self" } }));
+            await flushDispatchChain();
+            expect(inbound[0].isFromMe).toBe(true);
+        });
+        it("forwards replyToId from the message frame", async () => {
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.emit.message(buildMessage({ replyToId: "msg-parent-123" }));
+            await flushDispatchChain();
+            expect(inbound[0].replyToId).toBe("msg-parent-123");
+        });
+        it("logs and swallows errors from the inbound handler", async () => {
+            const { fake, errorSpy, core } = customSetup();
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            let handlerShouldThrow = true;
+            const received = [];
+            // Replace the setup's default capture handler with one that can throw.
+            core.onInbound((m) => {
+                if (handlerShouldThrow) {
+                    throw new Error("handler boom");
+                }
+                received.push(m);
+            });
+            fake.emit.message(buildMessage({ id: "msg-1" }));
+            await flushDispatchChain();
+            expect(received).toHaveLength(0);
+            expect(errorSpy).toHaveBeenCalledOnce();
+            // Recovery: subsequent message lands cleanly.
+            handlerShouldThrow = false;
+            fake.emit.message(buildMessage({ id: "msg-2" }));
+            await flushDispatchChain();
+            expect(received).toHaveLength(1);
+            expect(received[0].id).toBe("msg-2");
+        });
+    });
+    describe("dispatch chain ordering", () => {
+        it("serializes handlers so message order is preserved across async resolution", async () => {
+            const { fake, received } = customSetup();
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            forceResolveAgentNamePath(fake);
+            // Hold the resolveAgentName promises so we can control timing.
+            const resolvers = [];
+            fake.service.resolveAgentName = (id) => new Promise((resolve) => {
+                resolvers.push(() => resolve(id));
+            });
+            fake.emit.message(buildMessage({ id: "msg-1" }));
+            fake.emit.message(buildMessage({ id: "msg-2" }));
+            // Neither has been delivered to the handler yet — first message is
+            // still awaiting resolveAgentName; second is queued behind it.
+            await flushDispatchChain();
+            expect(received).toHaveLength(0);
+            expect(resolvers).toHaveLength(1);
+            // Resolve the first, chain advances.
+            resolvers[0]("agent-alice");
+            await flushDispatchChain();
+            expect(received.map((r) => r.id)).toEqual(["msg-1"]);
+            expect(resolvers).toHaveLength(2);
+            // Resolve the second.
+            resolvers[1]("agent-bob");
+            await flushDispatchChain();
+            expect(received.map((r) => r.id)).toEqual(["msg-1", "msg-2"]);
+        });
+        it("awaits async handler fully before processing the next message", async () => {
+            const { fake, core } = customSetup();
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            const handlerBarriers = [];
+            const order = [];
+            core.onInbound(async (m) => {
+                order.push(`enter:${m.id}`);
+                await new Promise((resolve) => handlerBarriers.push(resolve));
+                order.push(`exit:${m.id}`);
+            });
+            fake.emit.message(buildMessage({ id: "msg-1" }));
+            fake.emit.message(buildMessage({ id: "msg-2" }));
+            await flushDispatchChain();
+            // Handler started for msg-1, hasn't returned yet. msg-2 has NOT entered.
+            expect(order).toEqual(["enter:msg-1"]);
+            handlerBarriers[0]();
+            await flushDispatchChain();
+            // msg-1 fully processed; msg-2 has entered.
+            expect(order).toEqual(["enter:msg-1", "exit:msg-1", "enter:msg-2"]);
+            handlerBarriers[1]();
+            await flushDispatchChain();
+            expect(order).toEqual([
+                "enter:msg-1",
+                "exit:msg-1",
+                "enter:msg-2",
+                "exit:msg-2",
+            ]);
+        });
+        it("onInbound replaces the previous handler instead of adding", async () => {
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            const firstHandler = vi.fn();
+            const secondHandler = vi.fn();
+            core.onInbound(firstHandler);
+            core.onInbound(secondHandler);
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            expect(firstHandler).not.toHaveBeenCalled();
+            expect(secondHandler).toHaveBeenCalledOnce();
+        });
+    });
+    describe("context blocks enrichment", () => {
+        it("attaches groupMetadata when conversation is a group", async () => {
+            fake.state.setConversation("conv-1", {
+                type: "group",
+                name: "devs",
+                participants: [
+                    "agent:agent-alice",
+                    "agent:agent-bob",
+                    "agent:agent-self",
+                ],
+            });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            const msg = inbound[0];
+            expect(msg.contextBlocks.groupMetadata).toEqual({
+                type: "group",
+                name: "devs",
+                participants: [
+                    "agent:agent-alice",
+                    "agent:agent-bob",
+                    "agent:agent-self",
+                ],
+            });
+        });
+        it("does NOT attach groupMetadata for DM conversations", async () => {
+            fake.state.setConversation("conv-1", {
+                type: "dm",
+                name: "alice-dm",
+                participants: ["agent:agent-alice", "agent:agent-self"],
+            });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            expect(inbound[0].contextBlocks.groupMetadata).toBeUndefined();
+        });
+        it("attaches crossConversation entries when getContextEntries returns non-empty", async () => {
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            const entries = [
+                {
+                    conversationId: "conv-other",
+                    conversationName: "other-dm",
+                    senderName: "Bob",
+                    text: "hello from the other side",
+                    minutesAgo: 3,
+                    count: 1,
+                },
+            ];
+            fake.state.setContextEntries("conv-1", entries);
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            expect(inbound[0].contextBlocks.crossConversation).toEqual(entries);
+        });
+        it("does NOT attach crossConversation when getContextEntries returns empty", async () => {
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            // Fixture default: returns [] for unknown convs
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            expect(inbound[0].contextBlocks.crossConversation).toBeUndefined();
+        });
+        it("handles groups with zero participants gracefully", async () => {
+            fake.state.setConversation("conv-1", {
+                type: "group",
+                name: "empty-group",
+                participants: [],
+            });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            const meta = inbound[0].contextBlocks.groupMetadata;
+            expect(meta).toBeDefined();
+            expect(meta.participants).toEqual([]);
+        });
+        it("commits context markers after enrichment so a second inbound message does not re-see the same entries", async () => {
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.state.setContextEntries("conv-1", [
+                {
+                    conversationId: "conv-other",
+                    senderName: "Bob",
+                    text: "first visit",
+                    minutesAgo: 1,
+                    count: 1,
+                },
+            ]);
+            fake.emit.message(buildMessage({ id: "msg-1" }));
+            await flushDispatchChain();
+            expect(inbound[0].contextBlocks.crossConversation).toHaveLength(1);
+            fake.emit.message(buildMessage({ id: "msg-2" }));
+            await flushDispatchChain();
+            expect(inbound[1].contextBlocks.crossConversation).toBeUndefined();
+        });
+        it("does not commit when there are no context entries", async () => {
+            const commitSpy = vi.fn();
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            fake.state.setAgentName("agent-alice", "Alice");
+            // Install a peekContextEntries that records commit calls.
+            fake.service.peekContextEntries = () => ({ entries: [], commit: commitSpy });
+            fake.emit.message(buildMessage());
+            await flushDispatchChain();
+            expect(commitSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe("sendReply", () => {
+        it("delegates to service.send with conversationId and text", async () => {
+            await core.sendReply("conv-42", "hello there");
+            expect(fake.state.sent).toEqual([
+                { convId: "conv-42", text: "hello there" },
+            ]);
+        });
+    });
+    describe("static enrichMessage", () => {
+        it("returns the same shape as the instance handler path", async () => {
+            fake.state.setConversation("conv-1", {
+                type: "group",
+                name: "devs",
+                participants: ["agent:agent-alice", "agent:agent-self"],
+            });
+            fake.state.setAgentName("agent-alice", "Alice");
+            fake.state.setContextEntries("conv-1", [
+                {
+                    conversationId: "conv-other",
+                    senderName: "Bob",
+                    text: "bonjour",
+                    minutesAgo: 1,
+                    count: 1,
+                },
+            ]);
+            const msg = buildMessage({
+                id: "msg-static",
+                conversationId: "conv-1",
+                parts: [{ type: "text", text: "static enrichment" }],
+            });
+            const { enriched: staticResult, commitContext } = await MoltZapChannelCore.enrichMessage(service, msg);
+            expect(staticResult).toMatchObject({
+                id: "msg-static",
+                conversationId: "conv-1",
+                sender: { type: "agent", id: "agent-alice", name: "Alice" },
+                text: "static enrichment",
+                isFromMe: false,
+            });
+            expect(staticResult.contextBlocks.groupMetadata?.name).toBe("devs");
+            expect(staticResult.contextBlocks.crossConversation).toHaveLength(1);
+            expect(commitContext).toBeTypeOf("function");
+        });
+        it("static helper tolerates resolveAgentName throwing (disconnected service)", async () => {
+            const { fake } = customSetup();
+            fake.state.setConversation("conv-1", { type: "dm", participants: [] });
+            forceResolveAgentNamePath(fake);
+            fake.state.setResolveAgentNameFailure("agent-unknown", new Error("Not connected"));
+            const { enriched: result } = await MoltZapChannelCore.enrichMessage(fake.service, buildMessage({ sender: { type: "agent", id: "agent-unknown" } }));
+            expect(result.sender.name).toBe("agent-unknown");
+        });
+    });
+});
+//# sourceMappingURL=channel-core.test.js.map