@agentick/core 0.0.1

package/dist/compiler/structure-renderer.js

@@ -0,0 +1,189 @@
+import { MarkdownRenderer } from "../renderers";
+import { Logger } from "@agentick/kernel";
+const log = Logger.for("StructureRenderer");
+/**
+ * Consolidate contiguous text blocks into single text blocks.
+ * Non-text blocks act as boundaries.
+ */
+function consolidateTextBlocks(blocks) {
+    const result = [];
+    let textBuffer = [];
+    const flushTextBuffer = () => {
+        if (textBuffer.length > 0) {
+            result.push({ type: "text", text: textBuffer.join("\n\n") });
+            textBuffer = [];
+        }
+    };
+    for (const block of blocks) {
+        if (block.type === "text") {
+            textBuffer.push(block.text);
+        }
+        else {
+            flushTextBuffer();
+            result.push(block);
+        }
+    }
+    flushTextBuffer();
+    return result;
+}
+/**
+ * StructureRenderer: Applies CompiledStructure to COM and formats content.
+ *
+ * Responsibilities:
+ * - Application (CompiledStructure → COM)
+ * - Formatting (SemanticContentBlocks → ContentBlocks)
+ */
+export class StructureRenderer {
+    ctx;
+    defaultRenderer;
+    _lastCompiled = null;
+    constructor(ctx) {
+        this.ctx = ctx;
+        this.defaultRenderer = new MarkdownRenderer();
+    }
+    setDefaultRenderer(renderer) {
+        this.defaultRenderer = renderer;
+    }
+    /**
+     * Applies compiled structure to COM and formats content.
+     */
+    async apply(compiled) {
+        this._lastCompiled = compiled;
+        // 1. Apply sections
+        for (const section of compiled.sections.values()) {
+            this.applySection(section);
+        }
+        // 2. Apply tools (must await since addTool is async for schema conversion)
+        for (const tool of compiled.tools) {
+            // Convert CompiledTool to ExecutableTool format
+            // ExecutableTool expects { metadata: {...}, run?: Procedure }
+            await this.ctx.addTool({
+                metadata: {
+                    name: tool.name,
+                    description: tool.description ?? "",
+                    input: tool.schema,
+                },
+                run: tool.handler,
+            });
+        }
+        // 3. Apply ephemeral entries
+        for (const ephemeral of compiled.ephemeral) {
+            this.applyEphemeral(ephemeral);
+        }
+        // 4. Apply metadata
+        for (const [key, value] of Object.entries(compiled.metadata)) {
+            this.ctx.addMetadata(key, value);
+        }
+    }
+    /**
+     * Applies a section to COM.
+     */
+    applySection(compiled) {
+        // Format content using renderer or default
+        const formattedContent = this.formatSemanticBlocks(compiled.content);
+        const section = {
+            id: compiled.id,
+            title: compiled.title,
+            content: compiled.content,
+            formattedContent,
+            formattedWith: "MarkdownRenderer",
+            visibility: compiled.visibility,
+            audience: compiled.audience,
+            tags: compiled.tags,
+            metadata: compiled.metadata,
+            tokens: compiled.tokens,
+        };
+        this.ctx.addSection(section);
+    }
+    /**
+     * Applies an ephemeral entry to COM.
+     */
+    applyEphemeral(compiled) {
+        const formattedContent = this.formatSemanticBlocks(compiled.content);
+        const consolidatedContent = consolidateTextBlocks(formattedContent);
+        this.ctx.addEphemeral(consolidatedContent, compiled.position, compiled.order, compiled.metadata);
+    }
+    /**
+     * Format semantic content blocks to content blocks.
+     */
+    formatSemanticBlocks(blocks) {
+        return this.defaultRenderer.format(blocks);
+    }
+    /**
+     * 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.
+     */
+    async formatInput(comInput) {
+        const compiledEntries = this._lastCompiled?.timelineEntries ?? [];
+        // Format compiled timeline entries
+        const formattedTimeline = [];
+        for (const compiled of compiledEntries) {
+            const formattedContent = this.formatSemanticBlocks(compiled.content);
+            formattedTimeline.push({
+                kind: "message",
+                message: {
+                    role: compiled.role,
+                    content: formattedContent,
+                    id: compiled.id,
+                    metadata: compiled.metadata,
+                    createdAt: compiled.createdAt?.toISOString(),
+                },
+                metadata: compiled.metadata,
+                tokens: compiled.tokens,
+            });
+        }
+        log.debug({ compiledCount: compiledEntries.length }, "formatInput: processed compiled timeline entries");
+        // Format sections
+        const formattedSections = {};
+        for (const [id, section] of Object.entries(comInput.sections)) {
+            if (section.formattedContent) {
+                formattedSections[id] = {
+                    ...section,
+                    content: section.formattedContent,
+                    formattedContent: undefined,
+                    formattedWith: undefined,
+                };
+            }
+            else if (Array.isArray(section.content)) {
+                formattedSections[id] = {
+                    ...section,
+                    content: this.defaultRenderer.format(section.content),
+                };
+            }
+            else {
+                formattedSections[id] = section;
+            }
+        }
+        // Format compiled system entries (rebuilt each tick)
+        const compiledSystem = this._lastCompiled?.systemEntries ?? [];
+        const formattedSystem = compiledSystem.map((compiled) => {
+            const formattedContent = this.formatSemanticBlocks(compiled.content);
+            return {
+                kind: "message",
+                message: {
+                    role: compiled.role,
+                    content: formattedContent,
+                    id: compiled.id,
+                    metadata: compiled.metadata,
+                    createdAt: compiled.createdAt?.toISOString(),
+                },
+                metadata: compiled.metadata,
+                tokens: compiled.tokens,
+            };
+        });
+        return {
+            timeline: formattedTimeline,
+            sections: formattedSections,
+            tools: comInput.tools,
+            ephemeral: comInput.ephemeral,
+            // Use formatted system from compiled structure (rebuilt each tick)
+            system: formattedSystem.length > 0 ? formattedSystem : comInput.system,
+            metadata: comInput.metadata,
+            modelOptions: comInput.modelOptions,
+            totalTokens: this._lastCompiled?.totalTokens,
+        };
+    }
+}
+//# sourceMappingURL=structure-renderer.js.map

package/dist/compiler/structure-renderer.js.map

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

package/dist/compiler/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Compiler Types
+ *
+ * Types for the compiled output structure.
+ */
+import type { Renderer, SemanticContentBlock } from "../renderers/types";
+/**
+ * The compiled structure output from traversing the tree.
+ * This is what gets sent to the model.
+ */
+export interface CompiledStructure {
+    /** Named sections */
+    sections: Map<string, CompiledSection>;
+    /** Timeline entries (messages) - excludes system role */
+    timelineEntries: CompiledTimelineEntry[];
+    /** System entries (rebuilt fresh each tick). */
+    systemEntries: CompiledTimelineEntry[];
+    /** Available tools */
+    tools: CompiledTool[];
+    /** Ephemeral content */
+    ephemeral: CompiledEphemeral[];
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** Total estimated tokens across all compiled content */
+    totalTokens?: number;
+}
+/**
+ * A compiled section.
+ */
+export interface CompiledSection {
+    id: string;
+    title?: string;
+    content: SemanticContentBlock[];
+    renderer: Renderer | null;
+    visibility?: "model" | "observer" | "log";
+    audience?: "user" | "model" | "all";
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    /** Estimated token count (set by collector) */
+    tokens?: number;
+}
+/**
+ * A compiled timeline entry.
+ */
+export interface CompiledTimelineEntry {
+    id?: string;
+    role: "user" | "assistant" | "system" | "tool";
+    content: SemanticContentBlock[];
+    renderer: Renderer | null;
+    metadata?: Record<string, unknown>;
+    createdAt?: Date;
+    /** Estimated token count (set by collector) */
+    tokens?: number;
+}
+/**
+ * A compiled tool.
+ */
+export interface CompiledTool {
+    name: string;
+    description?: string;
+    schema?: unknown;
+    handler: (...args: unknown[]) => unknown;
+}
+/**
+ * Compiled ephemeral content position.
+ * Maps to COM EphemeralPosition values.
+ */
+export type CompiledEphemeralPosition = "start" | "end" | "before-user" | "after-system" | "flow";
+/**
+ * Compiled ephemeral content.
+ */
+export interface CompiledEphemeral {
+    content: SemanticContentBlock[];
+    position: CompiledEphemeralPosition;
+    order: number;
+    renderer: Renderer | null;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Create an empty compiled structure.
+ */
+export declare function createEmptyCompiledStructure(): CompiledStructure;
+/**
+ * Result from compileUntilStable.
+ */
+export interface CompileResult {
+    /** The compiled structure */
+    compiled: CompiledStructure;
+    /** Number of iterations taken */
+    iterations: number;
+    /** Whether we hit max iterations before stabilizing */
+    forcedStable: boolean;
+    /** Reasons for recompilation requests */
+    recompileReasons: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAEvC,yDAAyD;IACzD,eAAe,EAAE,qBAAqB,EAAE,CAAC;IAEzC,gDAAgD;IAChD,aAAa,EAAE,qBAAqB,EAAE,CAAC;IAEvC,sBAAsB;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IAEtB,wBAAwB;IACxB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAE/B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,KAAK,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,iBAAiB,CAShE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,YAAY,EAAE,OAAO,CAAC;IAEtB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/compiler/types.js

@@ -0,0 +1,19 @@
+/**
+ * Compiler Types
+ *
+ * Types for the compiled output structure.
+ */
+/**
+ * Create an empty compiled structure.
+ */
+export function createEmptyCompiledStructure() {
+    return {
+        sections: new Map(),
+        timelineEntries: [],
+        systemEntries: [],
+        tools: [],
+        ephemeral: [],
+        metadata: {},
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/compiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwFH;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,QAAQ,EAAE,IAAI,GAAG,EAAE;QACnB,eAAe,EAAE,EAAE;QACnB,aAAa,EAAE,EAAE;QACjB,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC"}

package/dist/component/component-hooks.d.ts

@@ -0,0 +1,68 @@
+import type { Middleware } from "@agentick/kernel";
+import type { EngineComponent, TickState, RecoveryAction, AfterCompileContext } from "./component";
+import type { COM } from "../com/object-model";
+import type { COMInput } from "../com/types";
+import type { JSX } from "../jsx/jsx-runtime";
+import { BaseHookRegistry } from "../hooks/base-hook-registry";
+import type { CompiledStructure } from "../compiler/types";
+import type { ExecutionMessage } from "../engine/execution-types";
+/**
+ * Component lifecycle method names.
+ */
+export type ComponentHookName = "onMount" | "onUnmount" | "onStart" | "onTickStart" | "render" | "onAfterCompile" | "onTickEnd" | "onMessage" | "onComplete" | "onError";
+/**
+ * Component selector for hook registration.
+ */
+export type ComponentSelector = string | {
+    name?: string;
+    tags?: string[];
+} | Function | undefined;
+/**
+ * Hook middleware type for component lifecycle methods.
+ * Note: Component lifecycle "hooks" are actually callbacks (side effects only), not transformation middleware.
+ */
+export type ComponentHookMiddleware<T extends ComponentHookName> = Middleware<ComponentHookArgs<T>>;
+/**
+ * Arguments for each component hook.
+ */
+export type ComponentHookArgs<T extends ComponentHookName> = T extends "onMount" ? [ctx: COM] : T extends "onUnmount" ? [ctx: COM] : T extends "onStart" ? [ctx: COM] : T extends "onTickStart" ? [state: TickState] : T extends "render" ? [ctx: COM, state: TickState] : T extends "onAfterCompile" ? [
+    ctx: COM,
+    compiled: CompiledStructure,
+    state: TickState,
+    afterCompileCtx: AfterCompileContext
+] : T extends "onTickEnd" ? [ctx: COM, state: TickState] : T extends "onMessage" ? [ctx: COM, message: ExecutionMessage, state: TickState] : T extends "onComplete" ? [ctx: COM, finalState: COMInput] : T extends "onError" ? [ctx: COM, state: TickState] : never;
+/**
+ * Return type for each component hook.
+ */
+export type ComponentHookReturn<T extends ComponentHookName> = T extends "onMount" ? void | Promise<void> : T extends "onUnmount" ? void | Promise<void> : T extends "onStart" ? void | Promise<void> : T extends "onTickStart" ? void | Promise<void> : T extends "render" ? JSX.Element | null | Promise<JSX.Element | null> : T extends "onAfterCompile" ? void | Promise<void> : T extends "onTickEnd" ? void | Promise<void> : T extends "onMessage" ? void | Promise<void> : T extends "onComplete" ? JSX.Element | null | Promise<JSX.Element | null> : T extends "onError" ? RecoveryAction | void | Promise<RecoveryAction | void> : never;
+/**
+ * Component-specific hook registry.
+ * Uses BaseHookRegistry to reduce code duplication while supporting component selectors.
+ */
+export declare class ComponentHookRegistry extends BaseHookRegistry<ComponentHookName, ComponentSelector, ComponentHookMiddleware<ComponentHookName>> {
+    protected getAllHookNames(): readonly ComponentHookName[];
+    /**
+     * Get all middleware for a component hook, ordered by specificity.
+     * Order: component-defined -> class-based -> tag-based -> name-based -> global
+     */
+    getMiddleware<T extends ComponentHookName>(hookName: T, componentClass: any, componentName: string, componentTags: string[]): ComponentHookMiddleware<T>[];
+    /**
+     * Get component-defined hooks from the component class/function.
+     * Component hooks are now actual middleware (aligned with kernel), not callbacks.
+     */
+    private getComponentDefinedHooks;
+}
+/**
+ * Auto-generate tags from component class/function name.
+ * Splits camelCase into lowercase tags.
+ */
+export declare function autoGenerateTags(componentClass: any): string[];
+/**
+ * Get component tags (explicit or auto-generated).
+ */
+export declare function getComponentTags(componentClass: any): string[];
+/**
+ * Get component name from instance or class.
+ */
+export declare function getComponentName(instance: EngineComponent, componentClass: any): string;
+//# sourceMappingURL=component-hooks.d.ts.map

package/dist/component/component-hooks.d.ts.map

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

package/dist/component/component-hooks.js

@@ -0,0 +1,112 @@
+import { BaseHookRegistry } from "../hooks/base-hook-registry";
+/**
+ * Component-specific hook registry.
+ * Uses BaseHookRegistry to reduce code duplication while supporting component selectors.
+ */
+export class ComponentHookRegistry extends BaseHookRegistry {
+    getAllHookNames() {
+        return [
+            "onMount",
+            "onUnmount",
+            "onStart",
+            "onTickStart",
+            "render",
+            "onAfterCompile",
+            "onTickEnd",
+            "onMessage",
+            "onComplete",
+            "onError",
+        ];
+    }
+    /**
+     * Get all middleware for a component hook, ordered by specificity.
+     * Order: component-defined -> class-based -> tag-based -> name-based -> global
+     */
+    getMiddleware(hookName, componentClass, componentName, componentTags) {
+        // 1. Get component-defined hooks (from ComponentClass.hooks or ComponentFunction.hooks)
+        const componentDefinedHooks = this.getComponentDefinedHooks(hookName, componentClass);
+        // 2. Get middleware from registry using component-specific resolution
+        const registryMiddleware = this.registry.getMiddleware(hookName, (hookMap) => {
+            const selectors = [];
+            // Class/Function reference-based hooks (most specific)
+            if (hookMap.has(componentClass)) {
+                selectors.push(componentClass);
+            }
+            // Tag-based hooks
+            for (const selector of hookMap.keys()) {
+                if (selector &&
+                    typeof selector === "object" &&
+                    !Array.isArray(selector) &&
+                    "tags" in selector &&
+                    selector.tags) {
+                    const requiredTags = selector.tags;
+                    if (requiredTags.some((tag) => componentTags.includes(tag))) {
+                        selectors.push(selector);
+                    }
+                }
+            }
+            // Name-based hooks
+            if (hookMap.has(componentName)) {
+                selectors.push(componentName);
+            }
+            return selectors;
+        });
+        // Combine: component-defined hooks first, then registry middleware
+        return [...componentDefinedHooks, ...registryMiddleware];
+    }
+    /**
+     * Get component-defined hooks from the component class/function.
+     * Component hooks are now actual middleware (aligned with kernel), not callbacks.
+     */
+    getComponentDefinedHooks(hookName, componentClass) {
+        // Check for static hooks (classes) or .hooks property (functions)
+        // These should be middleware, not callbacks
+        const hooks = componentClass.hooks?.[hookName];
+        if (!hooks || !Array.isArray(hooks)) {
+            return [];
+        }
+        // Hooks are already middleware - return them directly
+        // No conversion needed - they follow kernel middleware signature: (args, envelope, next)
+        return hooks;
+    }
+}
+/**
+ * Auto-generate tags from component class/function name.
+ * Splits camelCase into lowercase tags.
+ */
+export function autoGenerateTags(componentClass) {
+    const name = componentClass.name || "";
+    if (!name) {
+        return [];
+    }
+    // Split camelCase: TimelineManager -> ['timeline', 'manager']
+    return name
+        .split(/(?=[A-Z])/)
+        .map((s) => s.toLowerCase())
+        .filter((s) => s.length > 0);
+}
+/**
+ * Get component tags (explicit or auto-generated).
+ */
+export function getComponentTags(componentClass) {
+    // Check for explicit tags
+    // Classes: static tags
+    if (componentClass.tags && Array.isArray(componentClass.tags)) {
+        return componentClass.tags;
+    }
+    // Functions: .tags property
+    if (typeof componentClass === "function" &&
+        componentClass.tags &&
+        Array.isArray(componentClass.tags)) {
+        return componentClass.tags;
+    }
+    // Fallback: auto-generate from name
+    return autoGenerateTags(componentClass);
+}
+/**
+ * Get component name from instance or class.
+ */
+export function getComponentName(instance, componentClass) {
+    return instance.name || componentClass.name || "";
+}
+//# sourceMappingURL=component-hooks.js.map

package/dist/component/component-hooks.js.map

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