@agentick/core 0.0.1

package/dist/testing/mock-app.js

@@ -0,0 +1,393 @@
+/**
+ * Mock App, Session, and ExecutionHandle factories.
+ *
+ * Three layered factories for testing code that depends on App/Session/Handle
+ * without requiring real reconciler, model, or engine infrastructure.
+ *
+ * Uses framework-agnostic spy tracking (matching createMockCom's `_recompileRequests` pattern)
+ * — works with any test runner.
+ *
+ * @example
+ * ```tsx
+ * import { createMockApp, createMockSession, createMockExecutionHandle } from '@agentick/core/testing';
+ *
+ * // Full app mock
+ * const app = createMockApp();
+ * const session = await app.session("test");
+ * const handle = await session.send({ messages: [{ role: "user", content: "hi" }] });
+ * await handle.result; // SendResult
+ *
+ * // Session-level mock
+ * const session = createMockSession();
+ * const handle = await session.send({ messages: [] });
+ * expect(session._sendCalls).toHaveLength(1);
+ *
+ * // Handle-level mock
+ * const handle = createMockExecutionHandle({ response: "Hello!" });
+ * const result = await handle.result;
+ * expect(result.response).toBe("Hello!");
+ * ```
+ *
+ * @module @agentick/core/testing
+ */
+import { EventEmitter } from "node:events";
+import { EventBuffer, ExecutionHandleBrand, Channel } from "@agentick/kernel";
+import { createTestProcedure } from "@agentick/kernel/testing";
+/**
+ * Create a mock SessionExecutionHandle for testing.
+ *
+ * Uses a real EventBuffer for streaming. Supports delay, error, abort tracking.
+ *
+ * @example
+ * ```tsx
+ * const handle = createMockExecutionHandle({ response: "Hello!" });
+ * const result = await handle.result;
+ * expect(result.response).toBe("Hello!");
+ *
+ * // Stream events
+ * for await (const event of handle) {
+ *   console.log(event);
+ * }
+ * ```
+ */
+export function createMockExecutionHandle(options = {}) {
+    const { sessionId = "mock-session", currentTick = 1, response = "Mock response", streamDeltas, toolCalls, error, delay = 0, usage = { inputTokens: 10, outputTokens: 20, totalTokens: 30 }, } = options;
+    const eventBuffer = new EventBuffer();
+    const queuedMessages = [];
+    const toolResults = [];
+    let aborted = false;
+    let abortReason;
+    let status = "running";
+    const sendResult = {
+        response,
+        outputs: {},
+        usage,
+        raw: {
+            timeline: [],
+            system: [],
+            sections: {},
+            tools: [],
+            metadata: {},
+            ephemeral: [],
+        },
+    };
+    // Push events and resolve asynchronously
+    const init = async () => {
+        if (delay > 0)
+            await new Promise((r) => setTimeout(r, delay));
+        if (error) {
+            status = "error";
+            eventBuffer.error(error);
+            return;
+        }
+        // Content deltas
+        const deltas = streamDeltas ?? [response];
+        for (const delta of deltas) {
+            eventBuffer.push({ type: "content_delta", delta });
+        }
+        // Tool calls
+        if (toolCalls) {
+            for (const call of toolCalls) {
+                eventBuffer.push({ type: "tool_call_start", name: call.name, input: call.input });
+                eventBuffer.push({ type: "tool_result", name: call.name, result: call.result });
+            }
+        }
+        eventBuffer.push({ type: "message_end" });
+        status = "completed";
+        eventBuffer.close();
+    };
+    const initPromise = init();
+    const resultPromise = initPromise.then(() => {
+        if (error)
+            throw error;
+        return sendResult;
+    });
+    const handle = {
+        [ExecutionHandleBrand]: true,
+        sessionId,
+        currentTick,
+        traceId: "mock-trace",
+        get status() {
+            return status;
+        },
+        events: eventBuffer,
+        result: resultPromise,
+        queueMessage(message) {
+            queuedMessages.push(message);
+        },
+        submitToolResult(toolUseId, response) {
+            toolResults.push({ toolUseId, response });
+        },
+        abort(reason) {
+            aborted = true;
+            abortReason = reason;
+            status = "aborted";
+            eventBuffer.close();
+        },
+        [Symbol.asyncIterator]() {
+            return eventBuffer[Symbol.asyncIterator]();
+        },
+        // Spy arrays
+        _queuedMessages: queuedMessages,
+        _toolResults: toolResults,
+        get _aborted() {
+            return aborted;
+        },
+        get _abortReason() {
+            return abortReason;
+        },
+    };
+    return handle;
+}
+/**
+ * Create a mock Session for testing.
+ *
+ * All procedures (send, render, queue, spawn) are test procedures with spy tracking.
+ * Extends EventEmitter directly — no manual delegation needed.
+ *
+ * @example
+ * ```tsx
+ * const session = createMockSession();
+ * const handle = await session.send({ messages: [] });
+ * expect(session._sendCalls).toHaveLength(1);
+ * expect(session._lastHandle).toBeDefined();
+ *
+ * // Override next response
+ * session.respondWith({ response: "Custom!" });
+ * const handle2 = await session.send({ messages: [] });
+ * const result = await handle2.result;
+ * expect(result.response).toBe("Custom!");
+ * ```
+ */
+export function createMockSession(options = {}) {
+    const { id = "mock-session", status: initialStatus = "idle", executionOptions = {}, parent = null, children = [], } = options;
+    let currentStatus = initialStatus;
+    let nextOptions = null;
+    const sendCalls = [];
+    const renderCalls = [];
+    const queueCalls = [];
+    const spawnCalls = [];
+    let lastHandle = null;
+    function getEffectiveOptions() {
+        const opts = nextOptions ?? executionOptions;
+        nextOptions = null;
+        return { ...opts, sessionId: opts.sessionId ?? id };
+    }
+    class MockSessionImpl extends EventEmitter {
+        id = id;
+        currentTick = 0;
+        isAborted = false;
+        parent = parent;
+        children = children;
+        queuedMessages = [];
+        schedulerState = null;
+        get status() {
+            return currentStatus;
+        }
+        // Procedures
+        queue = createTestProcedure({
+            handler: async (message) => {
+                queueCalls.push(message);
+            },
+        });
+        send = createTestProcedure({
+            handler: (input) => {
+                sendCalls.push({ input });
+                const handle = createMockExecutionHandle(getEffectiveOptions());
+                lastHandle = handle;
+                return handle;
+            },
+        });
+        render = createTestProcedure({
+            handler: (props, opts) => {
+                renderCalls.push({ props, options: opts });
+                const handle = createMockExecutionHandle(getEffectiveOptions());
+                lastHandle = handle;
+                return handle;
+            },
+        });
+        spawn = createTestProcedure({
+            handler: (component, input) => {
+                spawnCalls.push({ component, input });
+                const handle = createMockExecutionHandle(getEffectiveOptions());
+                lastHandle = handle;
+                return handle;
+            },
+        });
+        interrupt() { }
+        clearAbort() { }
+        events() {
+            return (async function* () { })();
+        }
+        snapshot() {
+            return {
+                version: "1.0",
+                sessionId: id,
+                tick: 0,
+                timeline: [],
+                componentState: {},
+                timestamp: Date.now(),
+            };
+        }
+        async hibernate() {
+            return null;
+        }
+        inspect() {
+            return {
+                id,
+                status: currentStatus,
+                currentTick: 0,
+                queuedMessages: [],
+                isAborted: false,
+                lastOutput: null,
+                lastModelOutput: null,
+                lastToolCalls: [],
+                lastToolResults: [],
+                totalUsage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
+                tickCount: 0,
+                components: { count: 0, names: [] },
+                hooks: { count: 0, byType: {} },
+            };
+        }
+        startRecording(_mode) { }
+        stopRecording() { }
+        getRecording() {
+            return null;
+        }
+        getSnapshotAt(_tick) {
+            return null;
+        }
+        channel(name) {
+            return new Channel(name);
+        }
+        submitToolResult() { }
+        close() {
+            currentStatus = "closed";
+        }
+        // Spy arrays
+        get _sendCalls() {
+            return sendCalls;
+        }
+        get _renderCalls() {
+            return renderCalls;
+        }
+        get _queueCalls() {
+            return queueCalls;
+        }
+        get _spawnCalls() {
+            return spawnCalls;
+        }
+        get _lastHandle() {
+            return lastHandle;
+        }
+        respondWith(opts) {
+            nextOptions = opts;
+        }
+    }
+    return new MockSessionImpl();
+}
+/**
+ * Create a mock App for testing.
+ *
+ * Sessions are created lazily and cached. Lifecycle handlers are tracked.
+ *
+ * @example
+ * ```tsx
+ * const app = createMockApp();
+ * const session = await app.session("test");
+ * expect(app.has("test")).toBe(true);
+ * expect(app.sessions).toContain("test");
+ *
+ * await app.close("test");
+ * expect(app._closedSessions).toContain("test");
+ * ```
+ */
+export function createMockApp(options = {}) {
+    const { executionOptions = {}, sessions: initialSessions = {} } = options;
+    const sessionMap = new Map(Object.entries(initialSessions));
+    const closedSessions = [];
+    const sessionCreateHandlers = [];
+    const sessionCloseHandlers = [];
+    let sessionCounter = 0;
+    function getOrCreateSession(id) {
+        let session = sessionMap.get(id);
+        if (!session) {
+            session = createMockSession({ id, executionOptions });
+            sessionMap.set(id, session);
+            for (const handler of sessionCreateHandlers) {
+                handler(session);
+            }
+        }
+        return session;
+    }
+    const app = {
+        run: createTestProcedure({
+            handler: (_input) => {
+                const id = `ephemeral-${++sessionCounter}`;
+                getOrCreateSession(id);
+                return createMockExecutionHandle({ ...executionOptions, sessionId: id });
+            },
+        }),
+        async send(input, options) {
+            const id = options?.sessionId ?? `ephemeral-${++sessionCounter}`;
+            getOrCreateSession(id);
+            const session = sessionMap.get(id);
+            return await session.send(input);
+        },
+        session: (async (idOrOptions) => {
+            const id = typeof idOrOptions === "string"
+                ? idOrOptions
+                : (idOrOptions?.sessionId ?? `session-${++sessionCounter}`);
+            return getOrCreateSession(id);
+        }),
+        async close(sessionId) {
+            const session = sessionMap.get(sessionId);
+            if (session) {
+                session.close();
+                sessionMap.delete(sessionId);
+                closedSessions.push(sessionId);
+                for (const handler of sessionCloseHandlers) {
+                    handler(sessionId);
+                }
+            }
+        },
+        get sessions() {
+            return Array.from(sessionMap.keys());
+        },
+        has(sessionId) {
+            return sessionMap.has(sessionId);
+        },
+        async isHibernated() {
+            return false;
+        },
+        async hibernate() {
+            return null;
+        },
+        async hibernatedSessions() {
+            return [];
+        },
+        onSessionCreate(handler) {
+            sessionCreateHandlers.push(handler);
+            return () => {
+                const idx = sessionCreateHandlers.indexOf(handler);
+                if (idx >= 0)
+                    sessionCreateHandlers.splice(idx, 1);
+            };
+        },
+        onSessionClose(handler) {
+            sessionCloseHandlers.push(handler);
+            return () => {
+                const idx = sessionCloseHandlers.indexOf(handler);
+                if (idx >= 0)
+                    sessionCloseHandlers.splice(idx, 1);
+            };
+        },
+        // Spy state
+        _sessions: sessionMap,
+        _closedSessions: closedSessions,
+        _sessionCreateHandlers: sessionCreateHandlers,
+        _sessionCloseHandlers: sessionCloseHandlers,
+    };
+    return app;
+}
+//# sourceMappingURL=mock-app.js.map

package/dist/testing/mock-app.js.map

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

package/dist/testing/mocks.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Test Mocks
+ *
+ * Type-safe mock factories for COM, TickState, and TickResult.
+ * Use these in tests instead of creating ad-hoc mocks.
+ *
+ * @example
+ * ```tsx
+ * import { createMockCom, createMockTickState, createMockTickResult } from '@agentick/core/testing';
+ *
+ * const ctx = createMockCom();
+ * const tickState = createMockTickState({ tick: 2 });
+ * const result = createMockTickResult({ text: "Hello world" });
+ * ```
+ */
+import type { TickState } from "../component/component";
+import type { TickResult } from "../hooks/types";
+import type { ContentBlock, ToolCall, ToolResult } from "@agentick/shared";
+import type { COMTimelineEntry, COMInput, TokenEstimator } from "../com/types";
+export interface MockComOptions {
+    id?: string;
+    timeline?: COMTimelineEntry[];
+    initialState?: Record<string, unknown>;
+}
+export interface MockCom {
+    id: string;
+    timeline: COMTimelineEntry[];
+    state: Map<string, unknown>;
+    getState<T>(key: string): T | undefined;
+    setState<T>(key: string, value: T): void;
+    requestRecompile: () => void;
+    getTokenEstimator(): TokenEstimator;
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler: (...args: any[]) => void): void;
+    _recompileRequests: string[];
+}
+/**
+ * Create a mock COM for testing.
+ *
+ * @example
+ * ```tsx
+ * const ctx = createMockCom();
+ * ctx.setState("counter", 0);
+ * expect(ctx.getState("counter")).toBe(0);
+ * ```
+ */
+export declare function createMockCom(options?: MockComOptions): MockCom;
+export interface MockTickStateOptions {
+    tick?: number;
+    previous?: TickState["previous"];
+    current?: TickState["current"];
+    queuedMessages?: TickState["queuedMessages"];
+}
+export interface MockTickState extends TickState {
+    _stopCalls: string[];
+}
+/**
+ * Create a mock TickState for testing.
+ *
+ * @example
+ * ```tsx
+ * // Shorthand: just tick number
+ * const tickState = createMockTickState(2);
+ *
+ * // Full options
+ * const tickState = createMockTickState({ tick: 2, queuedMessages: [...] });
+ *
+ * tickState.stop("done");
+ * expect(tickState._stopCalls).toContain("done");
+ * ```
+ */
+export declare function createMockTickState(optionsOrTick?: MockTickStateOptions | number): MockTickState;
+export interface MockTickResultOptions {
+    tick?: number;
+    text?: string;
+    content?: ContentBlock[];
+    toolCalls?: ToolCall[];
+    toolResults?: ToolResult[];
+    stopReason?: string;
+    usage?: TickResult["usage"];
+    timeline?: COMTimelineEntry[];
+}
+export interface MockTickResult extends TickResult {
+    _stopCalls: Array<{
+        reason?: string;
+    }>;
+    _continueCalls: Array<{
+        reason?: string;
+    }>;
+}
+/**
+ * Create a mock TickResult for testing.
+ *
+ * @example
+ * ```tsx
+ * const result = createMockTickResult({
+ *   text: "Task complete <DONE>",
+ *   toolCalls: [{ id: "1", name: "search", input: { q: "test" } }],
+ * });
+ *
+ * result.stop("complete");
+ * expect(result._stopCalls).toHaveLength(1);
+ * ```
+ */
+export declare function createMockTickResult(options?: MockTickResultOptions): MockTickResult;
+/**
+ * Create a COMTimelineEntry for testing.
+ *
+ * @param role - Message role
+ * @param text - Text content
+ * @param tokens - Optional token count (for budget testing)
+ *
+ * @example
+ * ```tsx
+ * import { makeTimelineEntry } from '@agentick/core/testing';
+ *
+ * const entry = makeTimelineEntry("user", "Hello!", 10);
+ * const entries = [
+ *   makeTimelineEntry("user", "First message", 30),
+ *   makeTimelineEntry("assistant", "Response", 50),
+ * ];
+ * ```
+ */
+export declare function makeTimelineEntry(role: "user" | "assistant" | "tool" | "system", text: string, tokens?: number): COMTimelineEntry;
+/**
+ * Create a minimal COMInput with timeline entries for testing.
+ *
+ * @param entries - Timeline entries (or use makeTimelineEntry to create them)
+ *
+ * @example
+ * ```tsx
+ * import { makeTimelineEntry, makeCOMInput } from '@agentick/core/testing';
+ *
+ * const previous = makeCOMInput([
+ *   makeTimelineEntry("user", "Hello", 10),
+ *   makeTimelineEntry("assistant", "Hi there", 15),
+ * ]);
+ * const tickState = createMockTickState({ previous });
+ * ```
+ */
+export declare function makeCOMInput(entries: COMTimelineEntry[]): COMInput;
+//# sourceMappingURL=mocks.d.ts.map

package/dist/testing/mocks.d.ts.map

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