@sendbird/actionbook-core 0.10.11 → 0.10.12

package/dist/index.d.ts

@@ -433,4 +433,67 @@ declare function actionbookToAST(manual: {
     logic: LogicV2;
 }): DocumentNode;
 
-export { ActionbookConversionError, type ActionbookJSON, AstNode, BlockNode, BlockquoteNode, BoldMark, type BranchDecision, BulletListNode, CodeMark, type ConditionToken, type ConditionValidationResult, type DecisionTree, type DeleteOp, DeserializationError, DocumentNode, type DocumentTreeNode, type DocumentTreeNodeType, type EnumeratePathsIterOptions, type GotoEdge, type GotoEntryResolution, HardBreakNode, HeadingNode, type HighlightCategory, HorizontalRuleNode, InlineNode, type InsertOp, ItalicMark, type JinjaBlock, JinjaIfBlockNode, JinjaIfBranch, JinjaIfInlineNode, type JinjaIfStructure, type JinjaVisualBranch, type JinjaVisualStructure, JumpPointNode, LinkMark, type LintAsyncOptions, LintContext, LintResult, LintRule, LintSection, ListItemNode, LlmCompletionEndpoint, LlmLintRule, Mark, NodePath, NoteBlockNode, type Operation, OperationError, OrderedListNode, ParagraphNode, type ParseMarkdownOptions, type ReplaceOp, ResourceTagNode, ResourceTagType, StrikethroughMark, TableCellNode, TableNode, TableRowNode, TextNode, type Transaction, type TreeNode, type TreeNodeClassification, type TreeNodeLine, type TreeNodeType, type TreePath, type TreeSection, UnderlineMark, type ValidationError, type Variable, type VariableValue, type VisitOptions, actionbookToAST, analyzeJinjaBlocks, applyOperation, applyTransaction, blockquote, bold, buildDocumentTree, bulletList, chunkByHeading, code, collectAllVariables, comparePaths, defaultLlmRules, defaultRules, deserializeFromJSON, doc, enumeratePaths, enumeratePathsBySection, enumeratePathsIter, evaluateCondition, evaluateJinjaNodes, extractResourceTags, extractVariables, findAll, findDuplicateJumpPoints, fromMdast, generateDecisionTree, hardBreak, heading, horizontalRule, invertOperation, isBlock, isDocument, isInline, isTextNode, italic, jinjaBranch, jinjaIfBlock, jinjaIfInline, jumpPoint, link, lint, lintAsync, listItem, map, nodeAtPath, noteBlock, orderedList, paragraph, parentPath, parseFragment, parseMarkdown, pathFromString, pathToString, resolveGotoEntryPath, resourceTag, scanJinjaBlocks, serializeFragment, serializeToJSON, serializeToMarkdown, strikethrough, structureJinjaBlocks, table, tableCell, tableRow, text, textContent, toMdast, todoItem, tokenizeCondition, underline, validate, validateCondition, visit };
+/**
+ * Visualization graph types for Actionbook flow diagrams.
+ *
+ * VizGraph is the output of buildVizGraph() — a display-ready,
+ * collapsed graph derived from the analysis-focused DecisionTree.
+ * Layout and rendering are handled by the consumer (D3, React, etc.).
+ */
+type VizNodeType = 'START' | 'CONTENT' | 'BRANCH' | 'TOOL_CALL' | 'HANDOFF' | 'END_CONVERSATION';
+interface VizNodeAnnotation {
+    readonly kind: 'tool' | 'handoff' | 'end_call' | 'jump_point';
+    readonly label: string;
+    readonly resourceId?: string;
+}
+interface VizNode {
+    readonly id: string;
+    readonly type: VizNodeType;
+    readonly label: string;
+    readonly lines: readonly string[];
+    readonly section: string;
+    readonly annotations: readonly VizNodeAnnotation[];
+    readonly sourceBlockRange: {
+        readonly start: number;
+        readonly end: number;
+    };
+    readonly branchType?: 'if' | 'elif' | 'else';
+    readonly conditionText?: string;
+    readonly isJinja?: boolean;
+    readonly gotoTarget?: string;
+}
+type VizEdgeType = 'SEQUENTIAL' | 'BRANCH_TRUE' | 'GOTO' | 'FALLBACK' | 'BROKEN_REF';
+interface VizEdge {
+    readonly id: string;
+    readonly from: string;
+    readonly to: string;
+    readonly type: VizEdgeType;
+    readonly label?: string;
+    readonly branchIndex?: number;
+}
+interface VizSection {
+    readonly name: string;
+    readonly headingBlockIndex: number;
+    readonly nodeIds: readonly string[];
+}
+interface VizGraph {
+    readonly nodes: readonly VizNode[];
+    readonly edges: readonly VizEdge[];
+    readonly sections: readonly VizSection[];
+    readonly anchorMap: Readonly<Record<string, string>>;
+}
+
+/**
+ * VizGraph builder — converts DocumentNode AST directly into a visualization graph.
+ *
+ * Works from the AST rather than DecisionTree to faithfully implement v1 rules:
+ * - ALL bullet lists → BRANCH (unless pure text with no actions)
+ * - Ordered lists → sequential CONTENT
+ * - Jinja if blocks → BRANCH
+ * - Headings → section boundaries
+ * - Resource tags → TOOL_CALL / HANDOFF / END_CONVERSATION
+ */
+
+declare function buildVizGraph(doc: DocumentNode): VizGraph;
+
+export { ActionbookConversionError, type ActionbookJSON, AstNode, BlockNode, BlockquoteNode, BoldMark, type BranchDecision, BulletListNode, CodeMark, type ConditionToken, type ConditionValidationResult, type DecisionTree, type DeleteOp, DeserializationError, DocumentNode, type DocumentTreeNode, type DocumentTreeNodeType, type EnumeratePathsIterOptions, type GotoEdge, type GotoEntryResolution, HardBreakNode, HeadingNode, type HighlightCategory, HorizontalRuleNode, InlineNode, type InsertOp, ItalicMark, type JinjaBlock, JinjaIfBlockNode, JinjaIfBranch, JinjaIfInlineNode, type JinjaIfStructure, type JinjaVisualBranch, type JinjaVisualStructure, JumpPointNode, LinkMark, type LintAsyncOptions, LintContext, LintResult, LintRule, LintSection, ListItemNode, LlmCompletionEndpoint, LlmLintRule, Mark, NodePath, NoteBlockNode, type Operation, OperationError, OrderedListNode, ParagraphNode, type ParseMarkdownOptions, type ReplaceOp, ResourceTagNode, ResourceTagType, StrikethroughMark, TableCellNode, TableNode, TableRowNode, TextNode, type Transaction, type TreeNode, type TreeNodeClassification, type TreeNodeLine, type TreeNodeType, type TreePath, type TreeSection, UnderlineMark, type ValidationError, type Variable, type VariableValue, type VisitOptions, type VizEdge, type VizEdgeType, type VizGraph, type VizNode, type VizNodeAnnotation, type VizNodeType, type VizSection, actionbookToAST, analyzeJinjaBlocks, applyOperation, applyTransaction, blockquote, bold, buildDocumentTree, buildVizGraph, bulletList, chunkByHeading, code, collectAllVariables, comparePaths, defaultLlmRules, defaultRules, deserializeFromJSON, doc, enumeratePaths, enumeratePathsBySection, enumeratePathsIter, evaluateCondition, evaluateJinjaNodes, extractResourceTags, extractVariables, findAll, findDuplicateJumpPoints, fromMdast, generateDecisionTree, hardBreak, heading, horizontalRule, invertOperation, isBlock, isDocument, isInline, isTextNode, italic, jinjaBranch, jinjaIfBlock, jinjaIfInline, jumpPoint, link, lint, lintAsync, listItem, map, nodeAtPath, noteBlock, orderedList, paragraph, parentPath, parseFragment, parseMarkdown, pathFromString, pathToString, resolveGotoEntryPath, resourceTag, scanJinjaBlocks, serializeFragment, serializeToJSON, serializeToMarkdown, strikethrough, structureJinjaBlocks, table, tableCell, tableRow, text, textContent, toMdast, todoItem, tokenizeCondition, underline, validate, validateCondition, visit };