@agentick/core 0.0.1

package/dist/testing/compile-agent.js

@@ -0,0 +1,136 @@
+/**
+ * Compilation Testing Utilities
+ *
+ * Test agent compilation without running full ticks.
+ * Useful for unit testing component output.
+ */
+import React from "react";
+import { FiberCompiler } from "../compiler/fiber-compiler";
+// Use shared mocks
+import { createMockCom, createMockTickState } from "./mocks";
+// ============================================================================
+// Main API
+// ============================================================================
+/**
+ * Compile an agent component and return the result for assertions.
+ *
+ * This is a lightweight way to test what an agent component renders
+ * without executing a full tick (no model calls, no session management).
+ *
+ * @example
+ * ```tsx
+ * import { compileAgent } from '@agentick/core/testing';
+ *
+ * test('agent renders correct system prompt', async () => {
+ *   const { sections, tools } = await compileAgent(MyAgent, {
+ *     props: { mode: "helpful" },
+ *   });
+ *
+ *   expect(sections.get('system')).toContain('You are helpful');
+ *   expect(tools).toHaveLength(2);
+ * });
+ * ```
+ *
+ * @example Using helper methods
+ * ```tsx
+ * const result = await compileAgent(MyAgent);
+ *
+ * expect(result.sectionContains('instructions', 'Be concise')).toBe(true);
+ * expect(result.hasTool('search')).toBe(true);
+ * expect(result.getTool('calculator')?.description).toBe('Perform math');
+ * ```
+ */
+export async function compileAgent(Agent, options = {}) {
+    const { props = {}, tick = 1, maxIterations = 10 } = options;
+    // Create mock COM and compiler
+    const ctx = createMockCom();
+    const compiler = new FiberCompiler(ctx);
+    // Create tick state
+    const tickState = createMockTickState(tick);
+    // Create element with props
+    const element = React.createElement(Agent, props);
+    // Compile until stable
+    const { compiled, iterations, forcedStable, recompileReasons } = await compiler.compileUntilStable(element, tickState, { maxIterations });
+    // Extract sections as string map
+    const sections = new Map();
+    for (const [id, section] of compiled.sections) {
+        // Render section content blocks to string
+        const content = extractContentBlocksText(section.content);
+        sections.set(id, content);
+    }
+    // Extract tools
+    const tools = compiled.tools ?? [];
+    // Extract system messages
+    const systemMessages = (compiled.systemEntries ?? [])
+        .map((entry) => {
+        // CompiledTimelineEntry has content: SemanticContentBlock[]
+        if (entry.content) {
+            return extractContentBlocksText(entry.content);
+        }
+        return "";
+    })
+        .filter(Boolean);
+    // Helper methods
+    const getSection = (id) => sections.get(id);
+    const sectionContains = (id, text) => {
+        const content = sections.get(id);
+        return content ? content.includes(text) : false;
+    };
+    const getTool = (name) => tools.find((t) => t.name === name);
+    const hasTool = (name) => tools.some((t) => t.name === name);
+    return {
+        compiled,
+        sections,
+        tools,
+        systemMessages,
+        iterations,
+        forcedStable,
+        recompileReasons,
+        getSection,
+        sectionContains,
+        getTool,
+        hasTool,
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Extract text from content blocks.
+ */
+function extractContentBlocksText(content) {
+    if (!Array.isArray(content)) {
+        return String(content ?? "");
+    }
+    return content
+        .map((block) => {
+        // Handle text blocks
+        if (block.type === "text") {
+            return block.text;
+        }
+        // Handle semantic content blocks with semanticNode
+        const semanticBlock = block;
+        if (semanticBlock.semanticNode) {
+            return extractSemanticNodeText(semanticBlock.semanticNode);
+        }
+        // Fallback for other block types
+        if ("text" in block && typeof block.text === "string") {
+            return block.text;
+        }
+        return "";
+    })
+        .join("");
+}
+/**
+ * Extract text from a semantic node tree.
+ */
+function extractSemanticNodeText(node) {
+    if (node.text) {
+        return node.text;
+    }
+    if (node.children) {
+        return node.children.map(extractSemanticNodeText).join("");
+    }
+    return "";
+}
+//# sourceMappingURL=compile-agent.js.map

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

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

package/dist/testing/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Agentick Testing Utilities
+ *
+ * Provides a React Testing Library-like API for testing Agentick agents.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   renderAgent,
+ *   compileAgent,
+ *   createTestAdapter,
+ *   act,
+ *   cleanup,
+ * } from '@agentick/core/testing';
+ *
+ * afterEach(() => cleanup());
+ *
+ * test('agent responds to user', async () => {
+ *   const { send, result, model } = renderAgent(MyAgent, {
+ *     props: { mode: 'helpful' },
+ *   });
+ *
+ *   await act(async () => {
+ *     await send('Hello!');
+ *   });
+ *
+ *   expect(result.current.lastAssistantMessage).toBe('Test response');
+ *   expect(model.getCapturedInputs()).toHaveLength(1);
+ * });
+ *
+ * test('agent compiles correct structure', async () => {
+ *   const { sections, tools } = await compileAgent(MyAgent, {
+ *     props: { mode: 'helpful' },
+ *   });
+ *
+ *   expect(sections.get('system')).toContain('helpful');
+ *   expect(tools).toHaveLength(2);
+ * });
+ * ```
+ *
+ * @module @agentick/core/testing
+ */
+export { act, actSync, flushMicrotasks, flushAll } from "./act";
+export { sleep, waitFor, createDeferred, captureAsyncGenerator, arrayToAsyncGenerator, createControllableGenerator, } from "./async-helpers";
+export { createTestAdapter } from "./test-adapter";
+export type { TestAdapterOptions, TestAdapterInstance, StreamingOptions, ResponseItem, ToolCallInput, } from "./test-adapter";
+export { renderAgent, cleanup } from "./render-agent";
+export type { RenderAgentOptions, RenderAgentResult, AgentTestResult } from "./render-agent";
+export { compileAgent } from "./compile-agent";
+export type { CompileAgentOptions, CompileAgentResult } from "./compile-agent";
+export { createMockCom, createMockTickState, createMockTickResult, makeTimelineEntry, makeCOMInput, } from "./mocks";
+export type { MockComOptions, MockCom, MockTickStateOptions, MockTickState, MockTickResultOptions, MockTickResult, } from "./mocks";
+export { createMockExecutionHandle, createMockSession, createMockApp } from "./mock-app";
+export type { MockExecutionHandleOptions, MockSessionExecutionHandle, MockSessionOptions, MockSession, MockAppOptions, MockApp, } from "./mock-app";
+export { createTestProcedure } from "@agentick/kernel/testing";
+export type { TestProcedure, TestProcedureOptions } from "@agentick/kernel/testing";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGhE,OAAO,EACL,KAAK,EACL,OAAO,EACP,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,cAAc,EACd,OAAO,EACP,oBAAoB,EACpB,aAAa,EACb,qBAAqB,EACrB,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzF,YAAY,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,OAAO,GACR,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,59 @@
+/**
+ * Agentick Testing Utilities
+ *
+ * Provides a React Testing Library-like API for testing Agentick agents.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   renderAgent,
+ *   compileAgent,
+ *   createTestAdapter,
+ *   act,
+ *   cleanup,
+ * } from '@agentick/core/testing';
+ *
+ * afterEach(() => cleanup());
+ *
+ * test('agent responds to user', async () => {
+ *   const { send, result, model } = renderAgent(MyAgent, {
+ *     props: { mode: 'helpful' },
+ *   });
+ *
+ *   await act(async () => {
+ *     await send('Hello!');
+ *   });
+ *
+ *   expect(result.current.lastAssistantMessage).toBe('Test response');
+ *   expect(model.getCapturedInputs()).toHaveLength(1);
+ * });
+ *
+ * test('agent compiles correct structure', async () => {
+ *   const { sections, tools } = await compileAgent(MyAgent, {
+ *     props: { mode: 'helpful' },
+ *   });
+ *
+ *   expect(sections.get('system')).toContain('helpful');
+ *   expect(tools).toHaveLength(2);
+ * });
+ * ```
+ *
+ * @module @agentick/core/testing
+ */
+// Act wrapper
+export { act, actSync, flushMicrotasks, flushAll } from "./act";
+// Async helpers
+export { sleep, waitFor, createDeferred, captureAsyncGenerator, arrayToAsyncGenerator, createControllableGenerator, } from "./async-helpers";
+// Test adapter factory (uses createAdapter internally)
+export { createTestAdapter } from "./test-adapter";
+// Agent rendering
+export { renderAgent, cleanup } from "./render-agent";
+// Compilation testing
+export { compileAgent } from "./compile-agent";
+// Test mocks
+export { createMockCom, createMockTickState, createMockTickResult, makeTimelineEntry, makeCOMInput, } from "./mocks";
+// App/Session/Handle mocks
+export { createMockExecutionHandle, createMockSession, createMockApp } from "./mock-app";
+// Kernel testing primitives (re-exported for convenience)
+export { createTestProcedure } from "@agentick/kernel/testing";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,cAAc;AACd,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEhE,gBAAgB;AAChB,OAAO,EACL,KAAK,EACL,OAAO,EACP,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,uDAAuD;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AASnD,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGtD,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,aAAa;AACb,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GACb,MAAM,SAAS,CAAC;AAUjB,2BAA2B;AAC3B,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUzF,0DAA0D;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/testing/mock-app.d.ts

@@ -0,0 +1,163 @@
+/**
+ * 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 type { UsageStats, Message } from "@agentick/shared";
+import type { Session, SessionStatus, SessionExecutionHandle, App } from "../app/types";
+export interface MockExecutionHandleOptions {
+    /** Session ID (default: "mock-session") */
+    sessionId?: string;
+    /** Current tick number (default: 1) */
+    currentTick?: number;
+    /** Response text (default: "Mock response") */
+    response?: string;
+    /** Stream deltas (default: [response]) */
+    streamDeltas?: string[];
+    /** Tool calls to simulate */
+    toolCalls?: Array<{
+        name: string;
+        input: unknown;
+        result: unknown;
+    }>;
+    /** Error to throw */
+    error?: Error;
+    /** Delay before resolving in ms (default: 0) */
+    delay?: number;
+    /** Usage stats */
+    usage?: UsageStats;
+}
+export interface MockSessionExecutionHandle extends SessionExecutionHandle {
+    _queuedMessages: Message[];
+    _toolResults: Array<{
+        toolUseId: string;
+        response: any;
+    }>;
+    _aborted: boolean;
+    _abortReason?: string;
+}
+/**
+ * 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 declare function createMockExecutionHandle(options?: MockExecutionHandleOptions): MockSessionExecutionHandle;
+export interface MockSessionOptions {
+    /** Session ID (default: "mock-session") */
+    id?: string;
+    /** Initial status (default: "idle") */
+    status?: SessionStatus;
+    /** Default options for execution handles created by send/render/spawn */
+    executionOptions?: MockExecutionHandleOptions;
+    /** Parent session (default: null) */
+    parent?: Session | null;
+    /** Children sessions (default: []) */
+    children?: readonly Session[];
+}
+export interface MockSession extends Session {
+    _sendCalls: Array<{
+        input: any;
+    }>;
+    _renderCalls: Array<{
+        props: any;
+        options?: any;
+    }>;
+    _queueCalls: Message[];
+    _spawnCalls: Array<{
+        component: any;
+        input?: any;
+    }>;
+    _lastHandle: MockSessionExecutionHandle | null;
+    /** Override execution options for the next send/render/spawn call */
+    respondWith(options: MockExecutionHandleOptions): void;
+}
+/**
+ * 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 declare function createMockSession(options?: MockSessionOptions): MockSession;
+export interface MockAppOptions {
+    /** Default execution options for all sessions */
+    executionOptions?: MockExecutionHandleOptions;
+    /** Pre-created sessions keyed by ID */
+    sessions?: Record<string, MockSession>;
+}
+export interface MockApp extends App {
+    _sessions: Map<string, MockSession>;
+    _closedSessions: string[];
+    _sessionCreateHandlers: Array<(session: Session) => void>;
+    _sessionCloseHandlers: Array<(sessionId: string) => void>;
+}
+/**
+ * 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 declare function createMockApp(options?: MockAppOptions): MockApp;
+//# sourceMappingURL=mock-app.d.ts.map

package/dist/testing/mock-app.d.ts.map

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