@agentick/core 0.0.1

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

@@ -0,0 +1,203 @@
+/**
+ * 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";
+import type { CompiledStructure, CompileResult } from "./types";
+import { type RuntimeStore, type SerializableCacheEntry, type ContextInfoStore } from "../hooks";
+import type { ExecutionMessage } from "../engine/execution-types";
+import type { Renderer } from "../renderers/types";
+import type { COM } from "../com/object-model";
+import type { TickState } from "../component/component";
+import type { TickResult } from "../hooks/types";
+export interface FiberCompilerConfig {
+    dev?: boolean;
+    maxCompileIterations?: number;
+}
+export interface ReconcileOptions {
+    tickState?: TickState;
+}
+/**
+ * Serialized hook state for devtools.
+ */
+export interface SerializedHook {
+    index: number;
+    type: string;
+    value: unknown;
+    deps?: unknown[];
+    status?: string;
+}
+/**
+ * Serialized fiber node for debugging/devtools.
+ * Matches the FiberNode interface expected by devtools UI.
+ */
+export interface SerializedFiberNode {
+    id: string;
+    type: string;
+    key: string | number | null;
+    props: Record<string, unknown>;
+    hooks: SerializedHook[];
+    children: SerializedFiberNode[];
+    _summary?: string;
+}
+/**
+ * Serialized hook state for hibernation.
+ */
+export interface SerializedHookState {
+    index: number;
+    type: string;
+    value: unknown;
+}
+/**
+ * Hook type for serialization.
+ */
+export type HookType = "state" | "reducer" | "ref" | "memo" | "callback" | "effect" | "context";
+/**
+ * Summary of the fiber tree for debugging.
+ */
+export interface FiberSummary {
+    componentCount: number;
+    hookCount: number;
+    effectCount: number;
+    depth: number;
+    /** Hook count by type (empty in v2 since React manages hooks internally) */
+    hooksByType: Partial<Record<HookType, number>>;
+}
+/**
+ * V2 FiberCompiler - uses react-reconciler internally.
+ *
+ * This maintains API compatibility with v1 FiberCompiler so Session
+ * can use it as a drop-in replacement.
+ */
+export declare class FiberCompiler {
+    private container;
+    private root;
+    private runtimeStore;
+    private messageStore;
+    private _contextInfoStore;
+    private ctx;
+    private tickState;
+    private rootElement;
+    private config;
+    private currentPhase;
+    private isRendering;
+    private recompileRequested;
+    private recompileReasons;
+    private onScheduleReconcile?;
+    constructor(ctx: COM, _hookRegistry?: unknown, // ComponentHookRegistry - not used in v2
+    config?: FiberCompilerConfig);
+    /**
+     * Get the context info store for this compiler.
+     * Used by session to update context utilization info after each tick.
+     */
+    get contextInfoStore(): ContextInfoStore;
+    /**
+     * Set the root element for this compiler.
+     */
+    setRoot(element: React.ReactNode): void;
+    /**
+     * Set the reconciliation schedule callback.
+     */
+    setReconcileCallback(callback: (reason?: string) => void): void;
+    /**
+     * Reconcile the tree (render phase only, no collection).
+     * Used by reactive model for incremental updates.
+     */
+    reconcile(element?: React.ReactNode, options?: ReconcileOptions): Promise<void>;
+    /**
+     * Collect the compiled structure from the current tree.
+     * Uses COM's token estimator to annotate all entries with token estimates.
+     */
+    collect(): CompiledStructure;
+    /**
+     * Compile element to CompiledStructure.
+     * Single pass: reconcile + collect.
+     */
+    compile(element: React.ReactNode, state: TickState): Promise<CompiledStructure>;
+    /**
+     * Compile until stable (no more recompile requests).
+     */
+    compileUntilStable(element: React.ReactNode, state: TickState, options?: {
+        maxIterations?: number;
+    }): Promise<CompileResult>;
+    notifyStart(): Promise<void>;
+    notifyTickStart(state: TickState): Promise<void>;
+    notifyTickEnd(state: TickState, result: TickResult): Promise<void>;
+    notifyAfterCompile(compiled: CompiledStructure, _state: TickState, _ctx: unknown): Promise<void>;
+    notifyComplete(_finalState: unknown): Promise<void>;
+    notifyError(_state: TickState): Promise<unknown>;
+    notifyOnMessage(message: ExecutionMessage, state: TickState): Promise<void>;
+    unmount(): Promise<void>;
+    isRenderingNow(): boolean;
+    isInTickStart(): boolean;
+    isInTickEnd(): boolean;
+    shouldSkipRecompile(): boolean;
+    setRenderer(renderer: Renderer): void;
+    /**
+     * Get the runtime store for hibernation.
+     */
+    getRuntimeStore(): RuntimeStore;
+    /**
+     * Get the data cache as a serializable object.
+     */
+    getSerializableDataCache(): Record<string, SerializableCacheEntry>;
+    /**
+     * Restore the data cache from a serializable object.
+     */
+    setDataCache(data: Record<string, SerializableCacheEntry>): void;
+    private _hydrationData;
+    private _isHydrating;
+    /**
+     * Set hydration data for restoring session state.
+     */
+    setHydrationData(data: unknown): void;
+    /**
+     * Complete the hydration process.
+     */
+    completeHydration(): void;
+    /**
+     * Check if currently hydrating.
+     */
+    isHydratingNow(): boolean;
+    /**
+     * Serialize the fiber tree for debugging/devtools.
+     * In v2, we serialize the AgentickNode tree from the container.
+     */
+    serializeFiberTree(): SerializedFiberNode | null;
+    /**
+     * Get a summary of the fiber tree for debugging.
+     */
+    getFiberSummary(): FiberSummary;
+}
+/**
+ * Create a V2 FiberCompiler.
+ */
+export declare function createFiberCompiler(ctx: COM, hookRegistry?: unknown, config?: FiberCompilerConfig): FiberCompiler;
+/**
+ * Set the active compiler (used internally during render).
+ * @internal
+ */
+export declare function setActiveCompiler(compiler: FiberCompiler | null): void;
+/**
+ * Get the currently active compiler, if any.
+ * Used by signals to request recompilation.
+ */
+export declare function getActiveCompiler(): FiberCompiler | null;
+/**
+ * Check if we're currently inside a compiler render phase.
+ * Used by signals to detect state changes during render.
+ */
+export declare function isCompilerRendering(): boolean;
+/**
+ * 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 declare function shouldSkipRecompile(): boolean;
+//# sourceMappingURL=fiber-compiler.d.ts.map

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

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