@agentick/core 0.0.1

package/dist/reconciler/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * V2 Reconciler Types
+ *
+ * Core types for the react-reconciler based implementation.
+ */
+import type { Renderer } from "../renderers/types";
+/**
+ * A node in the Agentick tree built by react-reconciler.
+ * This is the "host instance" in React terminology.
+ */
+export interface AgentickNode {
+    /** Component type (function, class, string for intrinsics, symbol for Fragment) */
+    type: AgentickNodeType;
+    /** Props passed to the component */
+    props: Record<string, unknown>;
+    /** Child nodes */
+    children: AgentickNode[];
+    /** Parent node (for traversal) */
+    parent: AgentickNode | null;
+    /** Renderer context inherited from ancestors */
+    renderer: Renderer | null;
+    /** Unique key for reconciliation */
+    key: string | number | null;
+    /** Index among siblings */
+    index: number;
+}
+/**
+ * Valid node types in the tree.
+ */
+export type AgentickNodeType = string | ((...args: unknown[]) => unknown) | {
+    new (...args: unknown[]): unknown;
+} | symbol;
+/**
+ * The container (root) of the Agentick tree.
+ */
+export interface AgentickContainer {
+    /** Root children */
+    children: AgentickNode[];
+    /** Default renderer for the tree */
+    renderer: Renderer;
+}
+/**
+ * Host context passed through the tree.
+ * Used for nested renderer inheritance.
+ */
+export interface HostContext {
+    /** Current renderer in scope */
+    renderer: Renderer;
+}
+/**
+ * Props type (generic record).
+ */
+export type Props = Record<string, unknown>;
+/**
+ * Update payload for commitUpdate.
+ */
+export interface UpdatePayload {
+    props: Props;
+}
+/**
+ * Create a new AgentickNode.
+ */
+export declare function createNode(type: AgentickNodeType, props: Props, renderer: Renderer | null, key?: string | number | null): AgentickNode;
+/**
+ * A text node in the Agentick tree.
+ * Represents raw text content.
+ */
+export interface AgentickTextNode {
+    /** Text content */
+    text: string;
+    /** Parent node */
+    parent: AgentickNode | null;
+    /** Index among siblings */
+    index: number;
+    /** Marker to distinguish from regular nodes */
+    isTextNode: true;
+}
+/**
+ * Create a text node.
+ */
+export declare function createTextNode(text: string): AgentickTextNode;
+/**
+ * Check if a node is a text node.
+ */
+export declare function isTextNode(node: AgentickNode | AgentickTextNode): node is AgentickTextNode;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reconciler/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,IAAI,EAAE,gBAAgB,CAAC;IAEvB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,kBAAkB;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,kCAAkC;IAClC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B,gDAAgD;IAChD,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE1B,oCAAoC;IACpC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GACjC;IAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;CAAE,GACrC,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,oCAAoC;IACpC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,GAAG,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,GACjC,YAAY,CAUd;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,UAAU,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAO7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI,IAAI,gBAAgB,CAE1F"}

package/dist/reconciler/types.js

@@ -0,0 +1,37 @@
+/**
+ * V2 Reconciler Types
+ *
+ * Core types for the react-reconciler based implementation.
+ */
+/**
+ * Create a new AgentickNode.
+ */
+export function createNode(type, props, renderer, key = null) {
+    return {
+        type,
+        props,
+        children: [],
+        parent: null,
+        renderer,
+        key,
+        index: 0,
+    };
+}
+/**
+ * Create a text node.
+ */
+export function createTextNode(text) {
+    return {
+        text,
+        parent: null,
+        index: 0,
+        isTextNode: true,
+    };
+}
+/**
+ * Check if a node is a text node.
+ */
+export function isTextNode(node) {
+    return "isTextNode" in node && node.isTextNode === true;
+}
+//# sourceMappingURL=types.js.map

package/dist/reconciler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reconciler/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwEH;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAsB,EACtB,KAAY,EACZ,QAAyB,EACzB,MAA8B,IAAI;IAElC,OAAO;QACL,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,IAAI;QACZ,QAAQ;QACR,GAAG;QACH,KAAK,EAAE,CAAC;KACT,CAAC;AACJ,CAAC;AAoBD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAqC;IAC9D,OAAO,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC;AAC1D,CAAC"}

package/dist/renderers/base.d.ts

@@ -0,0 +1,98 @@
+import type { ContentBlock } from "@agentick/shared";
+/**
+ * Formatter function type.
+ * Transforms semantic content blocks into formatted content blocks.
+ * This is the public API for formatting - ContentRenderer is an internal implementation detail.
+ */
+export type Formatter = (blocks: SemanticContentBlock[]) => ContentBlock[];
+/**
+ * Semantic node representing structured content with formatting information.
+ * This is a tree structure where each node can have text, semantic type, and children.
+ *
+ * Design principle:
+ * - Capitalized components (<Image>, <Audio>) create native ContentBlocks (structural)
+ * - Lowercase HTML elements (<img>, <audio>) become semantic nodes with props
+ *   and the formatter converts them to inline representations (e.g., markdown ![alt](url))
+ *
+ * Example:
+ * ```typescript
+ * {
+ *   children: [
+ *     { text: 'Hello ' },
+ *     {
+ *       semantic: 'strong',
+ *       children: [{ text: 'world' }]
+ *     },
+ *     { text: ' with ' },
+ *     {
+ *       semantic: 'image',
+ *       props: { src: 'photo.jpg', alt: 'A photo' }
+ *     }
+ *   ]
+ * }
+ * ```
+ */
+export type SemanticNode = {
+    /** Plain text content (leaf nodes) */
+    text?: string;
+    /** Semantic type for formatting (strong, em, code, etc.) */
+    semantic?: SemanticType;
+    /** Props for semantic nodes (e.g., src/alt for images, href for links) */
+    props?: Record<string, any>;
+    /** Child nodes (for nested formatting) */
+    children?: SemanticNode[];
+    /** Formatter to use for this subtree (enables nested formatter switching) */
+    formatter?: Formatter;
+};
+/**
+ * Semantic types for inline and block formatting.
+ *
+ * Note: Media types (image, audio, video) are for semantic usage only (from <img>, <audio>, <video>).
+ * The capitalized components (<Image>, <Audio>, <Video>) create native ContentBlocks, not semantic nodes.
+ */
+export type SemanticType = "strong" | "em" | "mark" | "underline" | "strikethrough" | "subscript" | "superscript" | "small" | "code" | "heading" | "list" | "table" | "paragraph" | "blockquote" | "line-break" | "horizontal-rule" | "image" | "audio" | "video" | "link" | "quote" | "citation" | "keyboard" | "variable" | "list-item" | "custom" | "preformatted";
+/**
+ * Extended ContentBlock with semantic information for renderers.
+ * Semantic metadata helps renderers format content appropriately.
+ *
+ * Note: This is a type alias that extends ContentBlock with optional semantic metadata.
+ * All SemanticContentBlocks are valid ContentBlocks.
+ */
+export type SemanticContentBlock = ContentBlock & {
+    /** Semantic node tree representing structured content with formatting hints */
+    semanticNode?: SemanticNode;
+    /** Legacy semantic metadata (kept for backward compatibility) */
+    semantic?: {
+        type: SemanticType;
+        level?: number;
+        structure?: any;
+        href?: string;
+        rendererTag?: string;
+        rendererAttrs?: Record<string, any>;
+        preformatted?: boolean;
+    };
+};
+/**
+ * Abstract base class for content renderers.
+ * Renderers transform SemanticContentBlocks into formatted ContentBlocks.
+ *
+ * Renderers can:
+ * - Format semantic primitives (H1, List, Table, etc.)
+ * - Handle custom renderer-specific tags
+ * - Format standard ContentBlocks
+ */
+export declare abstract class Renderer {
+    /**
+     * Optional: Define custom primitives this renderer understands.
+     * These are custom tags that can be used inside this renderer's scope.
+     *
+     * Example: XMLRenderer might return ['timestamp', 'custom-tag']
+     */
+    getCustomPrimitives?(): string[];
+    format(blocks: SemanticContentBlock[]): ContentBlock[];
+    abstract formatNode(node: SemanticNode): string;
+    abstract formatSemantic(block: SemanticContentBlock): ContentBlock | null;
+    abstract formatStandard(block: SemanticContentBlock): ContentBlock[];
+    protected abstract applyBlockLevelFormatting(block: SemanticContentBlock, formattedText: string): string;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/renderers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/renderers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,kBAAkB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAEpB,QAAQ,GACR,IAAI,GACJ,MAAM,GACN,WAAW,GACX,eAAe,GACf,WAAW,GACX,aAAa,GACb,OAAO,GACP,MAAM,GAEN,SAAS,GACT,MAAM,GACN,OAAO,GACP,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,iBAAiB,GAEjB,OAAO,GACP,OAAO,GACP,OAAO,GAEP,MAAM,GACN,OAAO,GACP,UAAU,GACV,UAAU,GACV,UAAU,GACV,WAAW,GAEX,QAAQ,GACR,cAAc,CAAC;AAEnB;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG;IAChD,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,YAAY,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,GAAG,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAGpC,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF;;;;;;;;GAQG;AACH,8BAAsB,QAAQ;IAC5B;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,MAAM,EAAE;IAIhC,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,YAAY,EAAE;IAuEtD,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAC/C,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,GAAG,IAAI;IACzE,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,EAAE;IACpE,SAAS,CAAC,QAAQ,CAAC,yBAAyB,CAC1C,KAAK,EAAE,oBAAoB,EAC3B,aAAa,EAAE,MAAM,GACpB,MAAM;CACV"}

package/dist/renderers/base.js

@@ -0,0 +1,82 @@
+/**
+ * Abstract base class for content renderers.
+ * Renderers transform SemanticContentBlocks into formatted ContentBlocks.
+ *
+ * Renderers can:
+ * - Format semantic primitives (H1, List, Table, etc.)
+ * - Handle custom renderer-specific tags
+ * - Format standard ContentBlocks
+ */
+export class Renderer {
+    /**
+     * Optional: Define custom primitives this renderer understands.
+     * These are custom tags that can be used inside this renderer's scope.
+     *
+     * Example: XMLRenderer might return ['timestamp', 'custom-tag']
+     */
+    getCustomPrimitives() {
+        return [];
+    }
+    format(blocks) {
+        const formatted = [];
+        for (const block of blocks) {
+            // Handle pre-formatted blocks (from model output)
+            // By default, pass through pre-formatted blocks unchanged
+            // Renderer can choose to re-format if desired
+            if (block.semantic?.type === "preformatted" || block.semantic?.preformatted) {
+                // Pass through as-is (already formatted)
+                formatted.push(block);
+                continue;
+            }
+            // Handle semantic node tree (new semantic-first approach)
+            if (block.semanticNode) {
+                const node = block.semanticNode;
+                // If this node has a formatter, delegate to it
+                if (node.formatter) {
+                    // IMPORTANT: Clear the formatter before calling to prevent infinite recursion
+                    // The formatter may call renderer.format() internally, which would see the
+                    // formatter and call it again, causing infinite recursion.
+                    const formatterFn = node.formatter;
+                    node.formatter = undefined;
+                    // Call the formatter with this block - it handles everything
+                    const formattedBlocks = formatterFn([block]);
+                    formatted.push(...formattedBlocks);
+                    continue;
+                }
+                let formattedText = this.formatNode(node);
+                // Apply block-level formatting if needed (e.g., headings)
+                formattedText = this.applyBlockLevelFormatting(block, formattedText);
+                formatted.push({
+                    type: "text",
+                    text: formattedText,
+                });
+                continue;
+            }
+            // Handle legacy semantic primitives
+            if (block.semantic) {
+                const formattedBlock = this.formatSemantic(block);
+                if (formattedBlock) {
+                    formatted.push(formattedBlock);
+                    continue;
+                }
+            }
+            // Handle standard ContentBlocks
+            // Format if block has semantic metadata OR if it's an event block
+            // Code/json blocks are passed through as-is (they'll be formatted to markdown later in fromEngineState/adapter)
+            // Native content blocks without semantic metadata should be passed through as-is
+            // This preserves native code/json/image/audio/video blocks from structural components
+            const isEventBlock = block.type === "user_action" ||
+                block.type === "system_event" ||
+                block.type === "state_change";
+            if (block.semanticNode || block.semantic || isEventBlock) {
+                formatted.push(...this.formatStandard(block));
+            }
+            else {
+                // Pass through native content blocks as-is (e.g., code, json, image, audio, video from capitalized components)
+                formatted.push(block);
+            }
+        }
+        return formatted;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/renderers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/renderers/base.ts"],"names":[],"mappings":"AAmHA;;;;;;;;GAQG;AACH,MAAM,OAAgB,QAAQ;IAC5B;;;;;OAKG;IACH,mBAAmB;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,MAA8B;QACnC,MAAM,SAAS,GAAmB,EAAE,CAAC;QAErC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,kDAAkD;YAClD,0DAA0D;YAC1D,8CAA8C;YAC9C,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;gBAC5E,yCAAyC;gBACzC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtB,SAAS;YACX,CAAC;YAED,0DAA0D;YAC1D,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC;gBAChC,+CAA+C;gBAC/C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,8EAA8E;oBAC9E,2EAA2E;oBAC3E,2DAA2D;oBAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;oBACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;oBAC3B,6DAA6D;oBAC7D,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC7C,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;oBACnC,SAAS;gBACX,CAAC;gBAED,IAAI,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAE1C,0DAA0D;gBAC1D,aAAa,GAAG,IAAI,CAAC,yBAAyB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;gBAErE,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa;iBACP,CAAC,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,oCAAoC;YACpC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBAClD,IAAI,cAAc,EAAE,CAAC;oBACnB,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBAC/B,SAAS;gBACX,CAAC;YACH,CAAC;YAED,gCAAgC;YAChC,kEAAkE;YAClE,gHAAgH;YAChH,iFAAiF;YACjF,sFAAsF;YACtF,MAAM,YAAY,GAChB,KAAK,CAAC,IAAI,KAAK,aAAa;gBAC5B,KAAK,CAAC,IAAI,KAAK,cAAc;gBAC7B,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC;YAEhC,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,QAAQ,IAAI,YAAY,EAAE,CAAC;gBACzD,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,+GAA+G;gBAC/G,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CASF"}

package/dist/renderers/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * # Agentick Renderers
+ *
+ * Content renderers for transforming semantic content blocks into various
+ * output formats (Markdown, XML, etc.).
+ *
+ * ## Available Renderers
+ *
+ * - **MarkdownRenderer** - Render to GitHub-flavored Markdown
+ * - **XMLRenderer** - Render to XML format
+ * - **ContentRenderer** - Base class for custom renderers
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { MarkdownRenderer } from 'agentick/renderers';
+ *
+ * const renderer = new MarkdownRenderer();
+ * const markdown = renderer.render(contentBlocks);
+ * ```
+ *
+ * @see {@link ContentRenderer} - Base renderer class
+ * @see {@link MarkdownRenderer} - Markdown output
+ * @see {@link XMLRenderer} - XML output
+ *
+ * @module agentick/renderers
+ */
+export { Renderer as ContentRenderer, Renderer, type Formatter, type SemanticContentBlock, type SemanticNode, type SemanticType, } from "./base";
+export { MarkdownRenderer, markdownRenderer } from "./markdown";
+export { XMLRenderer } from "./xml";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACL,QAAQ,IAAI,eAAe,EAC3B,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC"}

package/dist/renderers/index.js

@@ -0,0 +1,31 @@
+/**
+ * # Agentick Renderers
+ *
+ * Content renderers for transforming semantic content blocks into various
+ * output formats (Markdown, XML, etc.).
+ *
+ * ## Available Renderers
+ *
+ * - **MarkdownRenderer** - Render to GitHub-flavored Markdown
+ * - **XMLRenderer** - Render to XML format
+ * - **ContentRenderer** - Base class for custom renderers
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { MarkdownRenderer } from 'agentick/renderers';
+ *
+ * const renderer = new MarkdownRenderer();
+ * const markdown = renderer.render(contentBlocks);
+ * ```
+ *
+ * @see {@link ContentRenderer} - Base renderer class
+ * @see {@link MarkdownRenderer} - Markdown output
+ * @see {@link XMLRenderer} - XML output
+ *
+ * @module agentick/renderers
+ */
+export { Renderer as ContentRenderer, Renderer, } from "./base";
+export { MarkdownRenderer, markdownRenderer } from "./markdown";
+export { XMLRenderer } from "./xml";
+//# sourceMappingURL=index.js.map

package/dist/renderers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/renderers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACL,QAAQ,IAAI,eAAe,EAC3B,QAAQ,GAKT,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC"}

package/dist/renderers/markdown.d.ts

@@ -0,0 +1,48 @@
+import { Renderer, type SemanticContentBlock, type SemanticNode } from "./base";
+import type { ContentBlock } from "@agentick/shared";
+/**
+ * Markdown renderer.
+ * Formats semantic ContentBlocks into markdown-formatted text.
+ *
+ * Supports:
+ * - Semantic primitives: H1-H6, List, Table, etc.
+ * - Standard ContentBlocks: Text, Code, Image, etc.
+ *
+ * Usage:
+ * ```jsx
+ * <Markdown>
+ *   <H1>Title</H1>
+ *   <Text>Content</Text>
+ * </Markdown>
+ * ```
+ */
+export declare class MarkdownRenderer extends Renderer {
+    private flavor?;
+    constructor(flavor?: "github" | "commonmark" | "gfm" | undefined);
+    /**
+     * Formats a semantic node tree into markdown text.
+     * Recursively processes nested semantic nodes.
+     * Supports nested formatter switching when node.formatter is present.
+     */
+    formatNode(node: SemanticNode): string;
+    formatSemantic(block: SemanticContentBlock): ContentBlock | null;
+    /**
+     * Formats a table structure into markdown table syntax.
+     */
+    private formatTable;
+    /**
+     * Formats a list structure into markdown list syntax.
+     *
+     * Supports:
+     * - Ordered lists (1. 2. 3.)
+     * - Unordered lists (-)
+     * - Task lists with checkboxes
+     * - Nested lists
+     */
+    private formatList;
+    protected applyBlockLevelFormatting(block: SemanticContentBlock, formattedText: string): string;
+    formatStandard(block: SemanticContentBlock): ContentBlock[];
+}
+/** Default markdown renderer instance */
+export declare const markdownRenderer: MarkdownRenderer;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/renderers/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/renderers/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,kBAAkB,CAAC;AAG3E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAChC,OAAO,CAAC,MAAM,CAAC;gBAAP,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,KAAK,YAAA;IAI5D;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IA6GtC,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,GAAG,IAAI;IA4IhE;;OAEG;IACH,OAAO,CAAC,WAAW;IAyDnB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAkDlB,SAAS,CAAC,yBAAyB,CAAC,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAS/F,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,EAAE;CA4F5D;AAED,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}