@agentick/core 0.0.1

package/dist/testing/mocks.js

@@ -0,0 +1,191 @@
+/**
+ * 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" });
+ * ```
+ */
+/**
+ * Create a mock COM for testing.
+ *
+ * @example
+ * ```tsx
+ * const ctx = createMockCom();
+ * ctx.setState("counter", 0);
+ * expect(ctx.getState("counter")).toBe(0);
+ * ```
+ */
+export function createMockCom(options = {}) {
+    const state = new Map(Object.entries(options.initialState ?? {}));
+    const recompileRequests = [];
+    const listeners = new Map();
+    return {
+        id: options.id ?? "test-session",
+        timeline: options.timeline ?? [],
+        state,
+        getState(key) {
+            return state.get(key);
+        },
+        setState(key, value) {
+            const previousValue = state.get(key);
+            state.set(key, value);
+            // Emit state:changed like real COM
+            const handlers = listeners.get("state:changed");
+            if (handlers) {
+                for (const handler of handlers) {
+                    handler(key, value, previousValue);
+                }
+            }
+        },
+        requestRecompile(reason) {
+            recompileRequests.push(reason ?? "unspecified");
+        },
+        getTokenEstimator() {
+            return (text) => Math.ceil(text.length / 4) + 4;
+        },
+        on(event, handler) {
+            if (!listeners.has(event))
+                listeners.set(event, new Set());
+            listeners.get(event).add(handler);
+        },
+        off(event, handler) {
+            listeners.get(event)?.delete(handler);
+        },
+        _recompileRequests: recompileRequests,
+    };
+}
+/**
+ * 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 function createMockTickState(optionsOrTick = {}) {
+    const options = typeof optionsOrTick === "number" ? { tick: optionsOrTick } : optionsOrTick;
+    const stopCalls = [];
+    return {
+        tick: options.tick ?? 1,
+        previous: options.previous,
+        current: options.current,
+        queuedMessages: options.queuedMessages ?? [],
+        stop(reason) {
+            stopCalls.push(reason);
+        },
+        _stopCalls: stopCalls,
+    };
+}
+/**
+ * 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 function createMockTickResult(options = {}) {
+    const stopCalls = [];
+    const continueCalls = [];
+    const text = options.text ?? "Test response";
+    const content = options.content ?? [{ type: "text", text }];
+    return {
+        tick: options.tick ?? 1,
+        text,
+        content,
+        toolCalls: options.toolCalls ?? [],
+        toolResults: options.toolResults ?? [],
+        stopReason: options.stopReason ?? "stop",
+        usage: options.usage ?? { inputTokens: 10, outputTokens: 5, totalTokens: 15 },
+        timeline: options.timeline ?? [],
+        stop(reasonOrOptions) {
+            const reason = typeof reasonOrOptions === "string" ? reasonOrOptions : reasonOrOptions?.reason;
+            stopCalls.push({ reason });
+        },
+        continue(reasonOrOptions) {
+            const reason = typeof reasonOrOptions === "string" ? reasonOrOptions : reasonOrOptions?.reason;
+            continueCalls.push({ reason });
+        },
+        _stopCalls: stopCalls,
+        _continueCalls: continueCalls,
+    };
+}
+// ============================================================================
+// Timeline Entry Helpers
+// ============================================================================
+/**
+ * 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 function makeTimelineEntry(role, text, tokens) {
+    return {
+        kind: "message",
+        message: {
+            role,
+            content: [{ type: "text", text }],
+        },
+        tokens,
+    };
+}
+/**
+ * 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 function makeCOMInput(entries) {
+    return {
+        timeline: entries,
+        system: [],
+        sections: {},
+        tools: [],
+        metadata: {},
+        ephemeral: [],
+    };
+}
+//# sourceMappingURL=mocks.js.map

package/dist/testing/mocks.js.map

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

package/dist/testing/render-agent.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Agent Testing Utilities
+ *
+ * Provides a React Testing Library-like API for testing Agentick agents.
+ */
+import type { AppOptions, SessionOptions, SendResult, ComponentFunction } from "../app/types";
+import type { Session } from "../app/types";
+import type { Message } from "@agentick/shared";
+import type { TestAdapterInstance } from "./test-adapter";
+import { createTestAdapter } from "./test-adapter";
+export interface RenderAgentOptions<P extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * Initial props for the agent component.
+     */
+    props?: P;
+    /**
+     * Model to use. If not provided, creates a default test adapter.
+     */
+    model?: TestAdapterInstance | ReturnType<typeof createTestAdapter>;
+    /**
+     * App options (maxTicks, etc.)
+     */
+    appOptions?: Omit<AppOptions, "model">;
+    /**
+     * Session options.
+     */
+    sessionOptions?: SessionOptions;
+    /**
+     * Whether to auto-run the first tick.
+     * @default false
+     */
+    autoTick?: boolean;
+}
+export interface RenderAgentResult<P extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * The session instance.
+     */
+    session: Session<P>;
+    /**
+     * The test adapter (for assertions).
+     */
+    model: TestAdapterInstance;
+    /**
+     * Send a user message and wait for completion.
+     */
+    send: (message: string | Message) => Promise<SendResult>;
+    /**
+     * Run a tick with optional new props.
+     */
+    tick: (props?: P) => Promise<SendResult>;
+    /**
+     * Current result state (updated after each tick/send).
+     */
+    result: {
+        current: AgentTestResult;
+    };
+    /**
+     * Cleanup the session. Called automatically if using `cleanup()`.
+     */
+    unmount: () => void;
+    /**
+     * Rerender with new props.
+     */
+    rerender: (props: P) => Promise<SendResult>;
+}
+export interface AgentTestResult {
+    /**
+     * All messages in the timeline.
+     */
+    timeline: Message[];
+    /**
+     * The last assistant message text.
+     */
+    lastAssistantMessage: string | null;
+    /**
+     * The last user message text.
+     */
+    lastUserMessage: string | null;
+    /**
+     * Total number of ticks executed.
+     */
+    tickCount: number;
+    /**
+     * Current session status.
+     */
+    status: "idle" | "running" | "completed" | "error";
+    /**
+     * Any error that occurred.
+     */
+    error: Error | null;
+    /**
+     * Raw send results from all ticks.
+     */
+    sendResults: SendResult[];
+}
+/**
+ * Cleanup all rendered agents.
+ * Call this in afterEach() to ensure sessions are closed.
+ *
+ * @example
+ * ```tsx
+ * import { cleanup } from '@agentick/core/testing';
+ *
+ * afterEach(() => {
+ *   cleanup();
+ * });
+ * ```
+ */
+export declare function cleanup(): void;
+/**
+ * Render an agent for testing.
+ *
+ * Similar to React Testing Library's `render()`, but for Agentick agents.
+ *
+ * @example
+ * ```tsx
+ * import { renderAgent, cleanup, act } from '@agentick/core/testing';
+ *
+ * afterEach(() => cleanup());
+ *
+ * test('agent responds to user messages', async () => {
+ *   const { send, result, model } = renderAgent(MyAgent, {
+ *     props: { systemPrompt: "You are helpful" },
+ *   });
+ *
+ *   await act(async () => {
+ *     await send("Hello!");
+ *   });
+ *
+ *   expect(result.current.lastAssistantMessage).toBe("Test response");
+ *   expect(model.getCapturedInputs()).toHaveLength(1);
+ * });
+ * ```
+ *
+ * @example With custom model
+ * ```tsx
+ * const { send, result } = renderAgent(MyAgent, {
+ *   model: createTestAdapter({
+ *     defaultResponse: "Custom response",
+ *     delay: 10,
+ *   }),
+ * });
+ * ```
+ */
+export declare function renderAgent<P extends Record<string, unknown> = Record<string, unknown>>(Agent: ComponentFunction<P>, options?: RenderAgentOptions<P>): Promise<RenderAgentResult<P>>;
+//# sourceMappingURL=render-agent.d.ts.map

package/dist/testing/render-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-agent.d.ts","sourceRoot":"","sources":["../../src/testing/render-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAOnD,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7F;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,KAAK,CAAC,EAAE,mBAAmB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAEnE;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5F;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,mBAAmB,CAAC;IAE3B;;OAEG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzD;;OAEG;IACH,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzC;;OAEG;IACH,MAAM,EAAE;QACN,OAAO,EAAE,eAAe,CAAC;KAC1B,CAAC;IAEF;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB;;OAEG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAEnD;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAS9B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3F,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAwI/B"}

package/dist/testing/render-agent.js

@@ -0,0 +1,200 @@
+/**
+ * Agent Testing Utilities
+ *
+ * Provides a React Testing Library-like API for testing Agentick agents.
+ */
+import { createApp } from "../app";
+import { createTestAdapter } from "./test-adapter";
+import { flushMicrotasks } from "./act";
+// ============================================================================
+// Cleanup Registry
+// ============================================================================
+const sessionsToCleanup = new Set();
+/**
+ * Cleanup all rendered agents.
+ * Call this in afterEach() to ensure sessions are closed.
+ *
+ * @example
+ * ```tsx
+ * import { cleanup } from '@agentick/core/testing';
+ *
+ * afterEach(() => {
+ *   cleanup();
+ * });
+ * ```
+ */
+export function cleanup() {
+    for (const session of sessionsToCleanup) {
+        try {
+            session.close();
+        }
+        catch {
+            // Ignore errors during cleanup
+        }
+    }
+    sessionsToCleanup.clear();
+}
+// ============================================================================
+// Main API
+// ============================================================================
+/**
+ * Render an agent for testing.
+ *
+ * Similar to React Testing Library's `render()`, but for Agentick agents.
+ *
+ * @example
+ * ```tsx
+ * import { renderAgent, cleanup, act } from '@agentick/core/testing';
+ *
+ * afterEach(() => cleanup());
+ *
+ * test('agent responds to user messages', async () => {
+ *   const { send, result, model } = renderAgent(MyAgent, {
+ *     props: { systemPrompt: "You are helpful" },
+ *   });
+ *
+ *   await act(async () => {
+ *     await send("Hello!");
+ *   });
+ *
+ *   expect(result.current.lastAssistantMessage).toBe("Test response");
+ *   expect(model.getCapturedInputs()).toHaveLength(1);
+ * });
+ * ```
+ *
+ * @example With custom model
+ * ```tsx
+ * const { send, result } = renderAgent(MyAgent, {
+ *   model: createTestAdapter({
+ *     defaultResponse: "Custom response",
+ *     delay: 10,
+ *   }),
+ * });
+ * ```
+ */
+export async function renderAgent(Agent, options = {}) {
+    const { props = {}, model = createTestAdapter(), appOptions = {}, sessionOptions, autoTick = false, } = options;
+    // Create app and session
+    const app = createApp(Agent, {
+        ...appOptions,
+        model: model,
+        maxTicks: appOptions.maxTicks ?? 1,
+    });
+    const session = sessionOptions ? await app.session(sessionOptions) : await app.session();
+    // Register for cleanup
+    sessionsToCleanup.add(session);
+    // Result state
+    const resultState = {
+        timeline: [],
+        lastAssistantMessage: null,
+        lastUserMessage: null,
+        tickCount: 0,
+        status: "idle",
+        error: null,
+        sendResults: [],
+    };
+    const result = {
+        current: resultState,
+    };
+    // Helper to update result state
+    const updateResult = (sendResult) => {
+        resultState.sendResults.push(sendResult);
+        resultState.tickCount++;
+        // Extract timeline messages from raw COMInput
+        if (sendResult.raw?.timeline) {
+            resultState.timeline = sendResult.raw.timeline
+                .map((entry) => entry.message)
+                .filter((m) => !!m);
+        }
+        // Find last assistant message
+        const assistantMessages = resultState.timeline.filter((m) => m.role === "assistant");
+        if (assistantMessages.length > 0) {
+            const last = assistantMessages[assistantMessages.length - 1];
+            resultState.lastAssistantMessage = extractText(last.content);
+        }
+        // Find last user message
+        const userMessages = resultState.timeline.filter((m) => m.role === "user");
+        if (userMessages.length > 0) {
+            const last = userMessages[userMessages.length - 1];
+            resultState.lastUserMessage = extractText(last.content);
+        }
+        resultState.status = "completed";
+    };
+    // Send function
+    const send = async (message) => {
+        resultState.status = "running";
+        resultState.error = null;
+        try {
+            const messageObj = typeof message === "string"
+                ? { role: "user", content: [{ type: "text", text: message }] }
+                : message;
+            const handle = await session.send({ messages: [messageObj] });
+            const sendResult = await handle.result;
+            updateResult(sendResult);
+            await flushMicrotasks();
+            return sendResult;
+        }
+        catch (error) {
+            resultState.status = "error";
+            resultState.error = error;
+            throw error;
+        }
+    };
+    // Tick function
+    const tick = async (newProps) => {
+        resultState.status = "running";
+        resultState.error = null;
+        try {
+            const handle = await session.render(newProps ?? props);
+            const sendResult = await handle.result;
+            updateResult(sendResult);
+            await flushMicrotasks();
+            return sendResult;
+        }
+        catch (error) {
+            resultState.status = "error";
+            resultState.error = error;
+            throw error;
+        }
+    };
+    // Rerender function
+    const rerender = async (newProps) => {
+        return tick(newProps);
+    };
+    // Unmount function
+    const unmount = () => {
+        session.close();
+        sessionsToCleanup.delete(session);
+    };
+    // Auto-tick if requested
+    if (autoTick) {
+        // This is sync but the tick happens async
+        // User should await or use act()
+        tick(props).catch((err) => {
+            resultState.error = err;
+            resultState.status = "error";
+        });
+    }
+    return {
+        session,
+        model: model,
+        send,
+        tick,
+        result,
+        unmount,
+        rerender,
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Extract text from content blocks.
+ */
+function extractText(content) {
+    return content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("");
+}
+//# sourceMappingURL=render-agent.js.map

package/dist/testing/render-agent.js.map

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