@agentick/core 0.0.1

package/dist/compiler/fiber-compiler.js

@@ -0,0 +1,498 @@
+/**
+ * V2 Fiber Compiler
+ *
+ * Uses react-reconciler to build a AgentickNode tree from React elements.
+ * With React's native JSX runtime, elements are already React elements -
+ * no conversion needed.
+ */
+import React from "react";
+// Helper for createElement
+const h = React.createElement;
+import { createContainer, createRoot, updateContainer, flushSync, flushPassiveEffects, } from "../reconciler";
+import { collect } from "./collector";
+import { createEmptyCompiledStructure } from "./types";
+import { AgentickProvider, createRuntimeStore, storeHasPendingData, storeResolvePendingData, storeRunTickStartCallbacks, storeRunTickEndCallbacks, storeRunAfterCompileCallbacks, storeClearLifecycleCallbacks, storeClearDataCache, storeGetSerializableDataCache, storeSetDataCache, 
+// Message context
+createMessageStore, MessageProvider, 
+// Context info
+createContextInfoStore, } from "../hooks";
+import { markdownRenderer } from "../renderers";
+/**
+ * V2 FiberCompiler - uses react-reconciler internally.
+ *
+ * This maintains API compatibility with v1 FiberCompiler so Session
+ * can use it as a drop-in replacement.
+ */
+export class FiberCompiler {
+    // React reconciler state
+    container;
+    root;
+    // Per-session runtime store (isolated state)
+    runtimeStore;
+    // Message store for useOnMessage/useQueuedMessages
+    messageStore;
+    // Context info store for useContextInfo
+    _contextInfoStore;
+    // Context
+    ctx;
+    tickState = null;
+    rootElement = null;
+    // Config
+    config;
+    // Phase tracking
+    currentPhase = "idle";
+    isRendering = false;
+    // Recompile tracking
+    recompileRequested = false;
+    recompileReasons = [];
+    // Reconciliation callback (for reactive model)
+    onScheduleReconcile;
+    constructor(ctx, _hookRegistry, // ComponentHookRegistry - not used in v2
+    config = {}) {
+        this.ctx = ctx;
+        this.config = {
+            dev: config.dev ?? process.env.NODE_ENV === "development",
+            maxCompileIterations: config.maxCompileIterations ?? 10,
+        };
+        // Create isolated runtime store for this compiler/session
+        this.runtimeStore = createRuntimeStore();
+        // Create message store for useOnMessage/useQueuedMessages
+        this.messageStore = createMessageStore();
+        // Create context info store for useContextInfo
+        this._contextInfoStore = createContextInfoStore();
+        // Create the render container and root
+        this.container = createContainer(markdownRenderer);
+        this.root = createRoot(this.container);
+        // Wire up COM's requestRecompile to our tracking
+        const originalRequestRecompile = ctx.requestRecompile.bind(ctx);
+        ctx.requestRecompile = (reason) => {
+            this.recompileRequested = true;
+            if (reason) {
+                this.recompileReasons.push(reason);
+            }
+            originalRequestRecompile(reason);
+        };
+    }
+    // ============================================================
+    // Public API - Stores
+    // ============================================================
+    /**
+     * Get the context info store for this compiler.
+     * Used by session to update context utilization info after each tick.
+     */
+    get contextInfoStore() {
+        return this._contextInfoStore;
+    }
+    // ============================================================
+    // Public API - Compilation
+    // ============================================================
+    /**
+     * Set the root element for this compiler.
+     */
+    setRoot(element) {
+        this.rootElement = element;
+    }
+    /**
+     * Set the reconciliation schedule callback.
+     */
+    setReconcileCallback(callback) {
+        this.onScheduleReconcile = callback;
+    }
+    /**
+     * Reconcile the tree (render phase only, no collection).
+     * Used by reactive model for incremental updates.
+     */
+    async reconcile(element, options = {}) {
+        const el = element ?? this.rootElement;
+        if (!el) {
+            throw new Error("No element to reconcile. Call setRoot() or pass element.");
+        }
+        if (options.tickState) {
+            this.tickState = options.tickState;
+        }
+        this.isRendering = true;
+        this.currentPhase = "render";
+        setActiveCompiler(this);
+        try {
+            const maxAttempts = 10;
+            let attempts = 0;
+            // With React's native JSX runtime, el is already a React element
+            const reactElement = el;
+            while (attempts < maxAttempts) {
+                attempts++;
+                try {
+                    // Render with React
+                    // Wrap with MessageProvider for useOnMessage/useQueuedMessages
+                    try {
+                        flushSync(() => {
+                            updateContainer(h(MessageProvider, { store: this.messageStore }, h(AgentickProvider, {
+                                ctx: this.ctx,
+                                tickState: this.tickState, // Different TickState types are compatible
+                                runtimeStore: this.runtimeStore,
+                                contextInfoStore: this._contextInfoStore,
+                            }, reactElement)), this.root);
+                        });
+                    }
+                    catch (flushError) {
+                        console.error("[FiberCompiler.reconcile] flushSync error:", flushError);
+                        throw flushError;
+                    }
+                    // Flush passive effects (useEffect callbacks) immediately.
+                    // In non-DOM environments, these don't auto-flush.
+                    // This ensures lifecycle hooks are registered before we call them.
+                    flushPassiveEffects();
+                    // If we get here without throwing, check for any pending data
+                    // that was triggered during render
+                    if (!storeHasPendingData(this.runtimeStore)) {
+                        // No pending data, we're done
+                        break;
+                    }
+                    // Resolve pending data and loop to re-render
+                    await storeResolvePendingData(this.runtimeStore);
+                }
+                catch (error) {
+                    // useData throws promises when data isn't cached.
+                    // The promise is added to pendingFetches before throwing.
+                    // Check if we have pending data to resolve.
+                    if (storeHasPendingData(this.runtimeStore)) {
+                        await storeResolvePendingData(this.runtimeStore);
+                        // Continue loop to retry render
+                    }
+                    else {
+                        // Not a data fetch issue, rethrow
+                        throw error;
+                    }
+                }
+            }
+            if (attempts >= maxAttempts) {
+                console.warn(`Reconcile hit max attempts (${maxAttempts})`);
+            }
+        }
+        finally {
+            this.isRendering = false;
+            this.currentPhase = "idle";
+            setActiveCompiler(null);
+        }
+    }
+    /**
+     * Collect the compiled structure from the current tree.
+     * Uses COM's token estimator to annotate all entries with token estimates.
+     */
+    collect() {
+        return collect(this.container, this.ctx.getTokenEstimator());
+    }
+    /**
+     * Compile element to CompiledStructure.
+     * Single pass: reconcile + collect.
+     */
+    async compile(element, state) {
+        this.tickState = state;
+        this.currentPhase = "compile";
+        try {
+            await this.reconcile(element, { tickState: state });
+            return this.collect();
+        }
+        finally {
+            this.currentPhase = "idle";
+        }
+    }
+    /**
+     * Compile until stable (no more recompile requests).
+     */
+    async compileUntilStable(element, state, options = {}) {
+        const maxIterations = options.maxIterations ?? this.config.maxCompileIterations ?? 10;
+        this.tickState = state;
+        this.recompileReasons = [];
+        let compiled = createEmptyCompiledStructure();
+        let iterations = 0;
+        let stable = false;
+        while (!stable && iterations < maxIterations) {
+            iterations++;
+            this.recompileRequested = false;
+            // Compile
+            compiled = await this.compile(element, state);
+            // Run after-compile callbacks
+            await this.notifyAfterCompile(compiled, state, {});
+            // Check if stable
+            if (!this.recompileRequested && !storeHasPendingData(this.runtimeStore)) {
+                stable = true;
+            }
+        }
+        return {
+            compiled,
+            iterations,
+            forcedStable: !stable,
+            recompileReasons: this.recompileReasons,
+        };
+    }
+    // ============================================================
+    // Lifecycle Notifications
+    // ============================================================
+    async notifyStart() {
+        // Nothing special in v2 - components use useEffect for mount
+    }
+    async notifyTickStart(state) {
+        this.tickState = state;
+        this.currentPhase = "tickStart";
+        try {
+            if (this.ctx) {
+                await storeRunTickStartCallbacks(this.runtimeStore, state, this.ctx);
+            }
+        }
+        finally {
+            this.currentPhase = "idle";
+        }
+    }
+    async notifyTickEnd(state, result) {
+        this.tickState = state;
+        this.currentPhase = "tickEnd";
+        try {
+            if (this.ctx) {
+                await storeRunTickEndCallbacks(this.runtimeStore, result, this.ctx);
+            }
+        }
+        finally {
+            this.currentPhase = "idle";
+        }
+    }
+    async notifyAfterCompile(compiled, _state, _ctx) {
+        await storeRunAfterCompileCallbacks(this.runtimeStore, compiled, this.ctx);
+    }
+    async notifyComplete(_finalState) {
+        this.currentPhase = "complete";
+        // Nothing special in v2
+        this.currentPhase = "idle";
+    }
+    async notifyError(_state) {
+        // Return null = no recovery action
+        return null;
+    }
+    async notifyOnMessage(message, state) {
+        // Update store with current context before dispatching
+        this.messageStore.ctx = this.ctx;
+        this.messageStore.tickState = state;
+        this.messageStore.lastMessage = message;
+        // Dispatch message to all handlers registered via useOnMessage
+        const ctx = this.ctx;
+        for (const handler of this.messageStore.handlers) {
+            await handler(message, ctx, state);
+        }
+    }
+    // ============================================================
+    // Cleanup
+    // ============================================================
+    async unmount() {
+        this.currentPhase = "unmount";
+        try {
+            // Clear the tree
+            flushSync(() => {
+                updateContainer(null, this.root);
+            });
+            // Flush any pending cleanup effects
+            flushPassiveEffects();
+            // Clear any remaining state
+            storeClearLifecycleCallbacks(this.runtimeStore);
+            storeClearDataCache(this.runtimeStore);
+        }
+        finally {
+            this.currentPhase = "idle";
+        }
+    }
+    // ============================================================
+    // State Queries
+    // ============================================================
+    isRenderingNow() {
+        return this.isRendering;
+    }
+    isInTickStart() {
+        return this.currentPhase === "tickStart";
+    }
+    isInTickEnd() {
+        return this.currentPhase === "tickEnd";
+    }
+    shouldSkipRecompile() {
+        return (this.currentPhase === "tickStart" ||
+            this.currentPhase === "tickEnd" ||
+            this.currentPhase === "complete" ||
+            this.currentPhase === "unmount" ||
+            this.isRendering);
+    }
+    // ============================================================
+    // Renderer
+    // ============================================================
+    setRenderer(renderer) {
+        this.container.renderer = renderer;
+    }
+    // ============================================================
+    // Hibernation Support
+    // ============================================================
+    /**
+     * Get the runtime store for hibernation.
+     */
+    getRuntimeStore() {
+        return this.runtimeStore;
+    }
+    /**
+     * Get the data cache as a serializable object.
+     */
+    getSerializableDataCache() {
+        return storeGetSerializableDataCache(this.runtimeStore);
+    }
+    /**
+     * Restore the data cache from a serializable object.
+     */
+    setDataCache(data) {
+        storeSetDataCache(this.runtimeStore, data);
+    }
+    // ============================================================
+    // Hydration Support (session.ts compatibility)
+    // ============================================================
+    _hydrationData = null;
+    _isHydrating = false;
+    /**
+     * Set hydration data for restoring session state.
+     */
+    setHydrationData(data) {
+        this._hydrationData = data;
+        this._isHydrating = true;
+        // If data includes a serialized data cache, restore it
+        if (data && typeof data === "object" && "dataCache" in data) {
+            this.setDataCache(data.dataCache);
+        }
+    }
+    /**
+     * Complete the hydration process.
+     */
+    completeHydration() {
+        this._isHydrating = false;
+        this._hydrationData = null;
+    }
+    /**
+     * Check if currently hydrating.
+     */
+    isHydratingNow() {
+        return this._isHydrating;
+    }
+    // ============================================================
+    // Debug/DevTools Support (session.ts compatibility)
+    // ============================================================
+    /**
+     * Serialize the fiber tree for debugging/devtools.
+     * In v2, we serialize the AgentickNode tree from the container.
+     */
+    serializeFiberTree() {
+        if (this.container.children.length === 0) {
+            return null;
+        }
+        let idCounter = 0;
+        const serializeNode = (node, path) => {
+            const id = `node-${idCounter++}`;
+            const typeName = typeof node.type === "string"
+                ? node.type
+                : typeof node.type === "function"
+                    ? node.type.displayName || node.type.name || "Anonymous"
+                    : typeof node.type === "symbol"
+                        ? node.type.description || "Symbol"
+                        : node.type === null || node.type === undefined
+                            ? "text"
+                            : "Unknown";
+            // Generate a human-readable summary for the node
+            const summary = node.text != null
+                ? `"${String(node.text).slice(0, 50)}${String(node.text).length > 50 ? "..." : ""}"`
+                : undefined;
+            return {
+                id,
+                type: typeName,
+                key: node.key ?? null,
+                props: { ...node.props },
+                hooks: [], // React manages hooks internally; we don't have access to them
+                children: (node.children || []).map((child, i) => serializeNode(child, `${path}.${i}`)),
+                _summary: summary,
+            };
+        };
+        // Return root as a fragment containing all children
+        return {
+            id: "root",
+            type: "Fragment",
+            key: null,
+            props: {},
+            hooks: [],
+            children: this.container.children.map((child, i) => serializeNode(child, String(i))),
+        };
+    }
+    /**
+     * Get a summary of the fiber tree for debugging.
+     */
+    getFiberSummary() {
+        let componentCount = 0;
+        let _depth = 0;
+        let maxDepth = 0;
+        const countNodes = (nodes, currentDepth) => {
+            if (currentDepth > maxDepth)
+                maxDepth = currentDepth;
+            for (const node of nodes) {
+                componentCount++;
+                if (node.children && node.children.length > 0) {
+                    countNodes(node.children, currentDepth + 1);
+                }
+            }
+        };
+        countNodes(this.container.children, 1);
+        return {
+            componentCount,
+            hookCount: 0, // React manages hooks internally, we don't track
+            effectCount: 0, // React manages effects internally
+            depth: maxDepth,
+            hooksByType: {}, // React manages hooks internally, we don't track by type
+        };
+    }
+}
+/**
+ * Create a V2 FiberCompiler.
+ */
+export function createFiberCompiler(ctx, hookRegistry, config) {
+    return new FiberCompiler(ctx, hookRegistry, config);
+}
+// ============================================================
+// Compiler Bridge for Signals
+// ============================================================
+// These functions allow signals to detect render phase and
+// request recompilation when state changes during render.
+/**
+ * Currently active compiler instance.
+ * Set by FiberCompiler during render operations.
+ */
+let activeCompiler = null;
+/**
+ * Set the active compiler (used internally during render).
+ * @internal
+ */
+export function setActiveCompiler(compiler) {
+    activeCompiler = compiler;
+}
+/**
+ * Get the currently active compiler, if any.
+ * Used by signals to request recompilation.
+ */
+export function getActiveCompiler() {
+    return activeCompiler;
+}
+/**
+ * Check if we're currently inside a compiler render phase.
+ * Used by signals to detect state changes during render.
+ */
+export function isCompilerRendering() {
+    return activeCompiler?.isRenderingNow() ?? false;
+}
+/**
+ * Check if we should skip requesting recompilation.
+ * Returns true during phases where recompile is unnecessary:
+ * - tickStart: Render is about to happen anyway
+ * - tickEnd: Current tick is done, next tick will see the update
+ * - complete: Execution is complete, no more renders
+ * - unmount: Component is being removed
+ */
+export function shouldSkipRecompile() {
+    return activeCompiler?.shouldSkipRecompile() ?? true;
+}
+//# sourceMappingURL=fiber-compiler.js.map

package/dist/compiler/fiber-compiler.js.map

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

package/dist/compiler/fiber.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Fiber Node Management
+ *
+ * Handles fiber creation, cloning, and tree manipulation.
+ */
+import type { FiberNode, ComponentType, HookState } from "./types";
+import type { ContentRenderer } from "../renderers";
+/**
+ * Create a new fiber node.
+ */
+export declare function createFiber(type: ComponentType, props: Record<string, unknown>, key?: string | number | null): FiberNode;
+/**
+ * Create a work-in-progress fiber from an existing fiber.
+ * This enables double-buffering for safe updates.
+ */
+export declare function createWorkInProgress(current: FiberNode, pendingProps: Record<string, unknown>): FiberNode;
+/**
+ * Clone a fiber for use in a different location.
+ */
+export declare function cloneFiber(fiber: FiberNode, overrides?: Partial<FiberNode>): FiberNode;
+/**
+ * Get all child fibers as an array.
+ */
+export declare function getChildFibers(fiber: FiberNode | null): FiberNode[];
+/**
+ * Find a fiber by key among siblings.
+ */
+export declare function findFiberByKey(firstChild: FiberNode | null, key: string | number | null): FiberNode | null;
+/**
+ * Traverse fiber tree depth-first, calling callback on each fiber.
+ */
+export declare function traverseFiber(fiber: FiberNode | null, callback: (fiber: FiberNode) => void | Promise<void>): Promise<void>;
+/**
+ * Traverse fiber tree bottom-up (children first, then parent).
+ */
+export declare function traverseFiberBottomUp(fiber: FiberNode | null, callback: (fiber: FiberNode) => void | Promise<void>): Promise<void>;
+/**
+ * Get the number of hooks on a fiber.
+ */
+export declare function getHookCount(fiber: FiberNode): number;
+/**
+ * Get hook at a specific index.
+ */
+export declare function getHookAtIndex(fiber: FiberNode, index: number): HookState | null;
+/**
+ * Create a debug string representation of a fiber.
+ */
+export declare function fiberToDebugString(fiber: FiberNode): string;
+/**
+ * Create a debug tree representation.
+ */
+export declare function fiberTreeToDebugString(fiber: FiberNode | null, indent?: number): string;
+/**
+ * Find the nearest renderer in the fiber tree.
+ */
+export declare function findNearestRenderer(fiber: FiberNode): ContentRenderer | null;
+/**
+ * Set renderer on fiber and mark for propagation.
+ */
+export declare function setFiberRenderer(fiber: FiberNode, renderer: ContentRenderer): void;
+//# sourceMappingURL=fiber.d.ts.map

package/dist/compiler/fiber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiber.d.ts","sourceRoot":"","sources":["../../src/compiler/fiber.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAQpD;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,GACjC,SAAS,CAuCX;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,SAAS,CAiCX;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CAgB1F;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE,CAUnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,GAAG,IAAI,EAC5B,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAC1B,SAAS,GAAG,IAAI,CAWlB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,GAAG,IAAI,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,GAAG,IAAI,EACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC,CAYf;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAUrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUhF;AAsBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAI3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,MAAM,SAAI,GAAG,MAAM,CAalF;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,GAAG,IAAI,CAW5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAElF"}