@agentick/core 0.0.1

package/dist/compiler/fiber.js

@@ -0,0 +1,244 @@
+/**
+ * Fiber Node Management
+ *
+ * Handles fiber creation, cloning, and tree manipulation.
+ */
+import { FiberFlags } from "./types";
+// ============================================================================
+// Fiber Creation
+// ============================================================================
+let _fiberIdCounter = 0;
+/**
+ * Create a new fiber node.
+ */
+export function createFiber(type, props, key = null) {
+    const fiber = {
+        // Identity
+        type,
+        key,
+        // Props
+        props,
+        pendingProps: null,
+        // State
+        stateNode: null,
+        memoizedState: null,
+        // Tree
+        parent: null,
+        child: null,
+        sibling: null,
+        index: 0,
+        // Refs
+        ref: typeof props.ref === "string" ? props.ref : null,
+        // Work tracking
+        flags: FiberFlags.NoFlags,
+        subtreeFlags: FiberFlags.NoFlags,
+        deletions: null,
+        // Double buffering
+        alternate: null,
+        // Rendering
+        renderer: null,
+        // Debug
+        debugName: getDebugName(type),
+    };
+    return fiber;
+}
+/**
+ * Create a work-in-progress fiber from an existing fiber.
+ * This enables double-buffering for safe updates.
+ */
+export function createWorkInProgress(current, pendingProps) {
+    let workInProgress = current.alternate;
+    if (workInProgress === null) {
+        // First update - create new WIP fiber
+        workInProgress = createFiber(current.type, pendingProps, current.key);
+        workInProgress.stateNode = current.stateNode;
+        workInProgress.alternate = current;
+        current.alternate = workInProgress;
+    }
+    else {
+        // Subsequent update - reuse WIP fiber
+        workInProgress.props = pendingProps;
+        workInProgress.pendingProps = null;
+        workInProgress.type = current.type;
+        // Reset flags
+        workInProgress.flags = FiberFlags.NoFlags;
+        workInProgress.subtreeFlags = FiberFlags.NoFlags;
+        workInProgress.deletions = null;
+    }
+    // Copy memoized state (hooks linked list)
+    workInProgress.memoizedState = current.memoizedState;
+    // Copy tree pointers (will be updated during reconciliation)
+    workInProgress.child = current.child;
+    workInProgress.index = current.index;
+    // Copy other properties
+    workInProgress.ref = current.ref;
+    workInProgress.renderer = current.renderer;
+    return workInProgress;
+}
+/**
+ * Clone a fiber for use in a different location.
+ */
+export function cloneFiber(fiber, overrides = {}) {
+    return {
+        ...fiber,
+        // Reset tree pointers
+        parent: null,
+        child: null,
+        sibling: null,
+        // Reset work flags
+        flags: FiberFlags.NoFlags,
+        subtreeFlags: FiberFlags.NoFlags,
+        deletions: null,
+        // No alternate for clones
+        alternate: null,
+        // Apply overrides
+        ...overrides,
+    };
+}
+// ============================================================================
+// Tree Traversal
+// ============================================================================
+/**
+ * Get all child fibers as an array.
+ */
+export function getChildFibers(fiber) {
+    const children = [];
+    let child = fiber?.child ?? null;
+    while (child !== null) {
+        children.push(child);
+        child = child.sibling;
+    }
+    return children;
+}
+/**
+ * Find a fiber by key among siblings.
+ */
+export function findFiberByKey(firstChild, key) {
+    let fiber = firstChild;
+    while (fiber !== null) {
+        if (fiber.key === key) {
+            return fiber;
+        }
+        fiber = fiber.sibling;
+    }
+    return null;
+}
+/**
+ * Traverse fiber tree depth-first, calling callback on each fiber.
+ */
+export async function traverseFiber(fiber, callback) {
+    if (fiber === null)
+        return;
+    await callback(fiber);
+    let child = fiber.child;
+    while (child !== null) {
+        await traverseFiber(child, callback);
+        child = child.sibling;
+    }
+}
+/**
+ * Traverse fiber tree bottom-up (children first, then parent).
+ */
+export async function traverseFiberBottomUp(fiber, callback) {
+    if (fiber === null)
+        return;
+    // Process children first
+    let child = fiber.child;
+    while (child !== null) {
+        await traverseFiberBottomUp(child, callback);
+        child = child.sibling;
+    }
+    // Then this fiber
+    await callback(fiber);
+}
+// ============================================================================
+// Hook State Helpers
+// ============================================================================
+/**
+ * Get the number of hooks on a fiber.
+ */
+export function getHookCount(fiber) {
+    let count = 0;
+    let hook = fiber.memoizedState;
+    while (hook !== null) {
+        count++;
+        hook = hook.next;
+    }
+    return count;
+}
+/**
+ * Get hook at a specific index.
+ */
+export function getHookAtIndex(fiber, index) {
+    let hook = fiber.memoizedState;
+    let i = 0;
+    while (hook !== null && i < index) {
+        hook = hook.next;
+        i++;
+    }
+    return hook;
+}
+// ============================================================================
+// Debugging
+// ============================================================================
+/**
+ * Get a debug name for a component type.
+ */
+function getDebugName(type) {
+    if (typeof type === "function") {
+        return type.name || "Anonymous";
+    }
+    if (typeof type === "string") {
+        return type;
+    }
+    if (typeof type === "symbol") {
+        return type.description || "Symbol";
+    }
+    return "Unknown";
+}
+/**
+ * Create a debug string representation of a fiber.
+ */
+export function fiberToDebugString(fiber) {
+    const key = fiber.key !== null ? ` key="${fiber.key}"` : "";
+    const flags = fiber.flags !== 0 ? ` flags=${fiber.flags}` : "";
+    return `<${fiber.debugName}${key}${flags}>`;
+}
+/**
+ * Create a debug tree representation.
+ */
+export function fiberTreeToDebugString(fiber, indent = 0) {
+    if (fiber === null)
+        return "";
+    const prefix = "  ".repeat(indent);
+    let result = prefix + fiberToDebugString(fiber) + "\n";
+    let child = fiber.child;
+    while (child !== null) {
+        result += fiberTreeToDebugString(child, indent + 1);
+        child = child.sibling;
+    }
+    return result;
+}
+// ============================================================================
+// Renderer Context
+// ============================================================================
+/**
+ * Find the nearest renderer in the fiber tree.
+ */
+export function findNearestRenderer(fiber) {
+    let current = fiber;
+    while (current !== null) {
+        if (current.renderer !== null) {
+            return current.renderer;
+        }
+        current = current.parent;
+    }
+    return null;
+}
+/**
+ * Set renderer on fiber and mark for propagation.
+ */
+export function setFiberRenderer(fiber, renderer) {
+    fiber.renderer = renderer;
+}
+//# sourceMappingURL=fiber.js.map

package/dist/compiler/fiber.js.map

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

package/dist/compiler/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Compiler
+ *
+ * The v2 fiber compiler using react-reconciler.
+ *
+ * @module agentick/compiler
+ */
+export { FiberCompiler, createFiberCompiler, type FiberCompilerConfig, type ReconcileOptions, type SerializedFiberNode, type SerializedHookState, type HookType, type FiberSummary, } from "./fiber-compiler";
+export { collect } from "./collector";
+export { StructureRenderer } from "./structure-renderer";
+export { ReconciliationScheduler, type ReconcileEvent, type ReconciliationSchedulerOptions, type SchedulerState, } from "./scheduler";
+export type { CompiledStructure, CompiledSection, CompiledTimelineEntry, CompiledTool, CompiledEphemeral, CompileResult, } from "./types";
+export { createEmptyCompiledStructure } from "./types";
+export { useCom, useTickState, AgentickProvider } from "../hooks";
+export { useOnMount, useOnUnmount, useOnTickStart, useOnTickEnd, useAfterCompile, useContinuation, } from "../hooks";
+export { useData, useInvalidateData } from "../hooks";
+export { useSignal, useComputed, createSignal, signal, computed, effect, batch, untracked, runWithSignalContext, runWithSignalContextAsync, } from "../hooks";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAMtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAMzD,OAAO,EACL,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,8BAA8B,EACnC,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAMrB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAOvD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGtD,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,UAAU,CAAC"}

package/dist/compiler/index.js

@@ -0,0 +1,38 @@
+/**
+ * Compiler
+ *
+ * The v2 fiber compiler using react-reconciler.
+ *
+ * @module agentick/compiler
+ */
+// ============================================================================
+// Compiler
+// ============================================================================
+export { FiberCompiler, createFiberCompiler, } from "./fiber-compiler";
+// ============================================================================
+// Collector
+// ============================================================================
+export { collect } from "./collector";
+// ============================================================================
+// Structure Renderer
+// ============================================================================
+export { StructureRenderer } from "./structure-renderer";
+// ============================================================================
+// Scheduler
+// ============================================================================
+export { ReconciliationScheduler, } from "./scheduler";
+export { createEmptyCompiledStructure } from "./types";
+// ============================================================================
+// Hooks (re-exported from hooks directory)
+// ============================================================================
+// Context hooks
+export { useCom, useTickState, AgentickProvider } from "../hooks";
+// Lifecycle hooks
+export { useOnMount, useOnUnmount, useOnTickStart, useOnTickEnd, useAfterCompile, useContinuation, } from "../hooks";
+// Data hook
+export { useData, useInvalidateData } from "../hooks";
+// Signal hooks and utilities
+export { useSignal, useComputed, createSignal, signal, computed, effect, batch, untracked, runWithSignalContext, runWithSignalContextAsync, } from "../hooks";
+// Standard React hooks are used directly from React
+// import { useState, useEffect, useMemo, useCallback, useRef, useReducer } from 'react';
+//# sourceMappingURL=index.js.map

package/dist/compiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,OAAO,EACL,aAAa,EACb,mBAAmB,GAOpB,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EACL,uBAAuB,GAIxB,MAAM,aAAa,CAAC;AAerB,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAElE,kBAAkB;AAClB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEtD,6BAA6B;AAC7B,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAElB,oDAAoD;AACpD,yFAAyF"}

package/dist/compiler/scheduler.d.ts

@@ -0,0 +1,95 @@
+/**
+ * V2 Reconciliation Scheduler
+ *
+ * Manages reconciliation timing and batching for the v2 fiber compiler.
+ *
+ * In v2 with react-reconciler:
+ * - The React tree stays mounted (persistent fiber root)
+ * - State changes trigger React's own reconciliation
+ * - This scheduler coordinates when to notify listeners about reconciliation
+ * - Batches multiple schedule() calls in the same microtask
+ */
+import type { FiberCompiler } from "./fiber-compiler";
+export interface ReconcileEvent {
+    /** Reason for reconciliation */
+    reason: string;
+    /** Timestamp of reconciliation */
+    timestamp: number;
+    /** Whether this was during a tick (deferred) or idle */
+    deferred: boolean;
+}
+/**
+ * Current state of the reconciliation scheduler.
+ * Used for DevTools and debugging.
+ */
+export interface SchedulerState {
+    /** Whether the scheduler is currently executing a tick */
+    isExecutingTick: boolean;
+    /** Whether a reconciliation is scheduled */
+    isScheduled: boolean;
+    /** Pending reconciliation reasons */
+    pendingReasons: string[];
+    /** Deferred reconciliation reasons (during tick) */
+    deferredReasons: string[];
+}
+export interface ReconciliationSchedulerOptions {
+    /** Callback when reconciliation completes */
+    onReconcile?: (event: ReconcileEvent) => void;
+    /** Delay before executing reconciliation (for debouncing) */
+    debounceMs?: number;
+}
+/**
+ * Coordinates reconciliation timing for the fiber compiler.
+ *
+ * Features:
+ * - Batches multiple schedule() calls in the same microtask
+ * - Defers reconciliation during tick execution
+ * - Emits events when reconciliation completes
+ */
+export declare class ReconciliationScheduler {
+    private compiler;
+    private options;
+    private pendingReasons;
+    private isScheduled;
+    private isExecutingTick;
+    private deferredReasons;
+    constructor(compiler: FiberCompiler, options?: ReconciliationSchedulerOptions);
+    /**
+     * Schedule a reconciliation.
+     *
+     * Multiple calls in the same microtask are batched.
+     * Calls during tick execution are deferred until the tick completes.
+     */
+    schedule(reason: string): void;
+    /**
+     * Mark that a tick is starting.
+     * Reconciliation requests during a tick will be deferred.
+     */
+    enterTick(): void;
+    /**
+     * Mark that a tick has completed.
+     * Flushes any deferred reconciliation requests.
+     */
+    exitTick(): void;
+    /**
+     * Flush pending reconciliation requests.
+     */
+    private flush;
+    /**
+     * Check if there are pending reconciliation requests.
+     */
+    hasPending(): boolean;
+    /**
+     * Clear all pending reconciliation requests.
+     */
+    clear(): void;
+    /**
+     * Dispose of the scheduler.
+     */
+    dispose(): void;
+    /**
+     * Get the current scheduler state.
+     */
+    getState(): SchedulerState;
+}
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/compiler/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMtD,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,eAAe,EAAE,OAAO,CAAC;IAEzB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IAErB,qCAAqC;IACrC,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,oDAAoD;IACpD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C,6CAA6C;IAC7C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAE9C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAiC;IAGhD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,eAAe,CAAgB;gBAE3B,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,8BAAmC;IAKjF;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgB9B;;;OAGG;IACH,SAAS,IAAI,IAAI;IAIjB;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAchB;;OAEG;IACH,OAAO,CAAC,KAAK;IAgCb;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,QAAQ,IAAI,cAAc;CAQ3B"}

package/dist/compiler/scheduler.js

@@ -0,0 +1,138 @@
+/**
+ * V2 Reconciliation Scheduler
+ *
+ * Manages reconciliation timing and batching for the v2 fiber compiler.
+ *
+ * In v2 with react-reconciler:
+ * - The React tree stays mounted (persistent fiber root)
+ * - State changes trigger React's own reconciliation
+ * - This scheduler coordinates when to notify listeners about reconciliation
+ * - Batches multiple schedule() calls in the same microtask
+ */
+// ============================================================================
+// ReconciliationScheduler
+// ============================================================================
+/**
+ * Coordinates reconciliation timing for the fiber compiler.
+ *
+ * Features:
+ * - Batches multiple schedule() calls in the same microtask
+ * - Defers reconciliation during tick execution
+ * - Emits events when reconciliation completes
+ */
+export class ReconciliationScheduler {
+    compiler;
+    options;
+    // Pending reconciliation state
+    pendingReasons = [];
+    isScheduled = false;
+    isExecutingTick = false;
+    deferredReasons = [];
+    constructor(compiler, options = {}) {
+        this.compiler = compiler;
+        this.options = options;
+    }
+    /**
+     * Schedule a reconciliation.
+     *
+     * Multiple calls in the same microtask are batched.
+     * Calls during tick execution are deferred until the tick completes.
+     */
+    schedule(reason) {
+        // If we're in the middle of a tick, defer until after
+        if (this.isExecutingTick) {
+            this.deferredReasons.push(reason);
+            return;
+        }
+        this.pendingReasons.push(reason);
+        // Batch multiple calls in the same microtask
+        if (!this.isScheduled) {
+            this.isScheduled = true;
+            queueMicrotask(() => this.flush());
+        }
+    }
+    /**
+     * Mark that a tick is starting.
+     * Reconciliation requests during a tick will be deferred.
+     */
+    enterTick() {
+        this.isExecutingTick = true;
+    }
+    /**
+     * Mark that a tick has completed.
+     * Flushes any deferred reconciliation requests.
+     */
+    exitTick() {
+        this.isExecutingTick = false;
+        // Flush any deferred reconciliation requests
+        if (this.deferredReasons.length > 0) {
+            const reasons = this.deferredReasons;
+            this.deferredReasons = [];
+            for (const reason of reasons) {
+                this.schedule(reason);
+            }
+        }
+    }
+    /**
+     * Flush pending reconciliation requests.
+     */
+    flush() {
+        this.isScheduled = false;
+        if (this.pendingReasons.length === 0) {
+            return;
+        }
+        const reasons = this.pendingReasons;
+        this.pendingReasons = [];
+        // Combine reasons for the event
+        const combinedReason = reasons.join("; ");
+        // Trigger reconciliation on the compiler
+        // In v2, the compiler will update the React tree
+        try {
+            // The compiler's reconcile method will be called by the session
+            // when the next tick starts. We just emit the event to notify listeners.
+            // Emit reconcile event
+            if (this.options.onReconcile) {
+                this.options.onReconcile({
+                    reason: combinedReason,
+                    timestamp: Date.now(),
+                    deferred: false,
+                });
+            }
+        }
+        catch (error) {
+            console.error("[ReconciliationScheduler] Error during reconciliation:", error);
+        }
+    }
+    /**
+     * Check if there are pending reconciliation requests.
+     */
+    hasPending() {
+        return this.pendingReasons.length > 0 || this.deferredReasons.length > 0;
+    }
+    /**
+     * Clear all pending reconciliation requests.
+     */
+    clear() {
+        this.pendingReasons = [];
+        this.deferredReasons = [];
+        this.isScheduled = false;
+    }
+    /**
+     * Dispose of the scheduler.
+     */
+    dispose() {
+        this.clear();
+    }
+    /**
+     * Get the current scheduler state.
+     */
+    getState() {
+        return {
+            isExecutingTick: this.isExecutingTick,
+            isScheduled: this.isScheduled,
+            pendingReasons: [...this.pendingReasons],
+            deferredReasons: [...this.deferredReasons],
+        };
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/compiler/scheduler.js.map

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

package/dist/compiler/structure-renderer.d.ts

@@ -0,0 +1,42 @@
+import type { COM } from "../com/object-model";
+import type { COMInput } from "../com/types";
+import type { ContentRenderer } from "../renderers";
+import type { CompiledStructure } from "./types";
+/**
+ * StructureRenderer: Applies CompiledStructure to COM and formats content.
+ *
+ * Responsibilities:
+ * - Application (CompiledStructure → COM)
+ * - Formatting (SemanticContentBlocks → ContentBlocks)
+ */
+export declare class StructureRenderer {
+    private ctx;
+    private defaultRenderer;
+    private _lastCompiled;
+    constructor(ctx: COM);
+    setDefaultRenderer(renderer: ContentRenderer): void;
+    /**
+     * Applies compiled structure to COM and formats content.
+     */
+    apply(compiled: CompiledStructure): Promise<void>;
+    /**
+     * Applies a section to COM.
+     */
+    private applySection;
+    /**
+     * Applies an ephemeral entry to COM.
+     */
+    private applyEphemeral;
+    /**
+     * Format semantic content blocks to content blocks.
+     */
+    private formatSemanticBlocks;
+    /**
+     * Formats COMInput for model input.
+     *
+     * The compiled structure IS the complete projection of what the model sees.
+     * Components render history via `<Message>`, which becomes compiled.timelineEntries.
+     */
+    formatInput(comInput: COMInput): Promise<COMInput>;
+}
+//# sourceMappingURL=structure-renderer.d.ts.map

package/dist/compiler/structure-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-renderer.d.ts","sourceRoot":"","sources":["../../src/compiler/structure-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAgC,MAAM,cAAc,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,KAAK,EAAE,iBAAiB,EAAsC,MAAM,SAAS,CAAC;AAgCrF;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAkC;gBAEnC,GAAG,EAAE,GAAG;IAI5B,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInD;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCvD;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;;;OAKG;IACG,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;CA8EzD"}