import { beforeEach, describe, expect, it, vi } from "vitest"; import type { MsgContext } from "../templating.js"; const mocks = vi.hoisted(() => ({ applyMediaUnderstanding: vi.fn(async (..._args: unknown[]) => undefined), applyLinkUnderstanding: vi.fn(async (..._args: unknown[]) => undefined), createInternalHookEvent: vi.fn(), triggerInternalHook: vi.fn(async (..._args: unknown[]) => undefined), resolveReplyDirectives: vi.fn(), initSessionState: vi.fn(), })); vi.mock("../../agents/agent-scope.js", () => ({ resolveAgentDir: vi.fn(() => "/tmp/agent"), resolveAgentWorkspaceDir: vi.fn(() => "/tmp/workspace"), resolveSessionAgentId: vi.fn(() => "main"), resolveAgentSkillsFilter: vi.fn(() => undefined), })); vi.mock("../../agents/model-selection.js", () => ({ resolveModelRefFromString: vi.fn(() => null), })); vi.mock("../../agents/timeout.js", () => ({ resolveAgentTimeoutMs: vi.fn(() => 60000), })); vi.mock("../../agents/workspace.js", () => ({ DEFAULT_AGENT_WORKSPACE_DIR: "/tmp/workspace", ensureAgentWorkspace: vi.fn(async () => ({ dir: "/tmp/workspace" })), })); vi.mock("../../channels/model-overrides.js", () => ({ resolveChannelModelOverride: vi.fn(() => undefined), })); vi.mock("../../config/config.js", () => ({ loadConfig: vi.fn(() => ({})), })); vi.mock("../../globals.js", () => ({ logVerbose: vi.fn(), })); vi.mock("../../hooks/internal-hooks.js", () => ({ createInternalHookEvent: mocks.createInternalHookEvent, triggerInternalHook: mocks.triggerInternalHook, })); vi.mock("../../link-understanding/apply.js", () => ({ applyLinkUnderstanding: mocks.applyLinkUnderstanding, })); vi.mock("../../media-understanding/apply.js", () => ({ applyMediaUnderstanding: mocks.applyMediaUnderstanding, })); vi.mock("../../runtime.js", () => ({ defaultRuntime: { log: vi.fn() }, })); vi.mock("../command-auth.js", () => ({ resolveCommandAuthorization: vi.fn(() => ({ isAuthorizedSender: true })), })); vi.mock("./commands-core.js", () => ({ emitResetCommandHooks: vi.fn(async () => undefined), })); vi.mock("./directive-handling.js", () => ({ resolveDefaultModel: vi.fn(() => ({ defaultProvider: "openai", defaultModel: "gpt-4o-mini", aliasIndex: new Map(), })), })); vi.mock("./get-reply-directives.js", () => ({ resolveReplyDirectives: mocks.resolveReplyDirectives, })); vi.mock("./get-reply-inline-actions.js", () => ({ handleInlineActions: vi.fn(async () => ({ kind: "reply", reply: { text: "ok" } })), })); vi.mock("./get-reply-run.js", () => ({ runPreparedReply: vi.fn(async () => undefined), })); vi.mock("./inbound-context.js", () => ({ finalizeInboundContext: vi.fn((ctx: unknown) => ctx), })); vi.mock("./session-reset-model.js", () => ({ applyResetModelOverride: vi.fn(async () => undefined), })); vi.mock("./session.js", () => ({ initSessionState: mocks.initSessionState, })); vi.mock("./stage-sandbox-media.js", () => ({ stageSandboxMedia: vi.fn(async () => undefined), })); vi.mock("./typing.js", () => ({ createTypingController: vi.fn(() => ({ onReplyStart: async () => undefined, startTypingLoop: async () => undefined, startTypingOnText: async () => undefined, refreshTypingTtl: () => undefined, isActive: () => false, markRunComplete: () => undefined, markDispatchIdle: () => undefined, cleanup: () => undefined, })), })); const { getReplyFromConfig } = await import("./get-reply.js"); function buildCtx(overrides: Partial = {}): MsgContext { return { Provider: "telegram", Surface: "telegram", OriginatingChannel: "telegram", OriginatingTo: "telegram:-100123", ChatType: "group", Body: "", BodyForAgent: "", RawBody: "", CommandBody: "", SessionKey: "agent:main:telegram:-100123", From: "telegram:user:42", To: "telegram:-100123", GroupChannel: "ops", Timestamp: 1710000000000, ...overrides, }; } describe("getReplyFromConfig message hooks", () => { beforeEach(() => { delete process.env.OPENCLAW_TEST_FAST; mocks.applyMediaUnderstanding.mockReset(); mocks.applyLinkUnderstanding.mockReset(); mocks.createInternalHookEvent.mockReset(); mocks.triggerInternalHook.mockReset(); mocks.resolveReplyDirectives.mockReset(); mocks.initSessionState.mockReset(); mocks.applyMediaUnderstanding.mockImplementation(async (...args: unknown[]) => { const { ctx } = args[0] as { ctx: MsgContext }; ctx.Transcript = "voice transcript"; ctx.Body = "[Audio]\nTranscript:\nvoice transcript"; ctx.BodyForAgent = "[Audio]\nTranscript:\nvoice transcript"; }); mocks.applyLinkUnderstanding.mockResolvedValue(undefined); mocks.createInternalHookEvent.mockImplementation( (type: string, action: string, sessionKey: string, context: Record) => ({ type, action, sessionKey, context, timestamp: new Date(), messages: [], }), ); mocks.triggerInternalHook.mockResolvedValue(undefined); mocks.resolveReplyDirectives.mockResolvedValue({ kind: "reply", reply: { text: "ok" } }); mocks.initSessionState.mockResolvedValue({ sessionCtx: {}, sessionEntry: {}, previousSessionEntry: {}, sessionStore: {}, sessionKey: "agent:main:telegram:-100123", sessionId: "session-1", isNewSession: false, resetTriggered: false, systemSent: false, abortedLastRun: false, storePath: "/tmp/sessions.json", sessionScope: "per-chat", groupResolution: undefined, isGroup: true, triggerBodyNormalized: "", bodyStripped: "", }); }); it("emits transcribed + preprocessed hooks with enriched context", async () => { const ctx = buildCtx(); await getReplyFromConfig(ctx, undefined, {}); expect(mocks.createInternalHookEvent).toHaveBeenCalledTimes(2); expect(mocks.createInternalHookEvent).toHaveBeenNthCalledWith( 1, "message", "transcribed", "agent:main:telegram:-100123", expect.objectContaining({ transcript: "voice transcript", channelId: "telegram", conversationId: "telegram:-100123", }), ); expect(mocks.createInternalHookEvent).toHaveBeenNthCalledWith( 2, "message", "preprocessed", "agent:main:telegram:-100123", expect.objectContaining({ transcript: "voice transcript", isGroup: true, groupId: "telegram:-100123", }), ); expect(mocks.triggerInternalHook).toHaveBeenCalledTimes(2); }); it("emits only preprocessed when no transcript is produced", async () => { mocks.applyMediaUnderstanding.mockImplementationOnce(async (...args: unknown[]) => { const { ctx } = args[0] as { ctx: MsgContext }; ctx.Transcript = undefined; ctx.Body = ""; ctx.BodyForAgent = ""; }); await getReplyFromConfig(buildCtx(), undefined, {}); expect(mocks.createInternalHookEvent).toHaveBeenCalledTimes(1); expect(mocks.createInternalHookEvent).toHaveBeenCalledWith( "message", "preprocessed", "agent:main:telegram:-100123", expect.any(Object), ); }); it("skips message hooks in fast test mode", async () => { process.env.OPENCLAW_TEST_FAST = "1"; await getReplyFromConfig(buildCtx(), undefined, {}); expect(mocks.applyMediaUnderstanding).not.toHaveBeenCalled(); expect(mocks.applyLinkUnderstanding).not.toHaveBeenCalled(); expect(mocks.createInternalHookEvent).not.toHaveBeenCalled(); expect(mocks.triggerInternalHook).not.toHaveBeenCalled(); }); it("skips message hooks when SessionKey is unavailable", async () => { await getReplyFromConfig(buildCtx({ SessionKey: undefined }), undefined, {}); expect(mocks.createInternalHookEvent).not.toHaveBeenCalled(); expect(mocks.triggerInternalHook).not.toHaveBeenCalled(); }); });