agent-web-interface 4.0.0

package/dist/src/query/types/query.types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Query Engine Types
+ *
+ * Request/Response schemas for semantic element queries.
+ * Supports filtering by kind, label, region, state, and structural attributes.
+ */
+import type { NodeKind, SemanticRegion, ReadableNode } from '../../snapshot/snapshot.types.js';
+/**
+ * Text matching mode for label queries.
+ */
+export type TextMatchMode = 'exact' | 'contains' | 'fuzzy';
+/**
+ * Options for fuzzy matching behavior
+ */
+export interface FuzzyMatchOptions {
+    /** Minimum token overlap ratio (0-1) for a match. Default: 0.5 */
+    minTokenOverlap?: number;
+    /** Enable prefix matching for tokens. Default: true */
+    prefixMatch?: boolean;
+    /** Minimum edit distance similarity (0-1) for similar tokens. Default: 0.8 */
+    minSimilarity?: number;
+}
+/**
+ * Label filter configuration
+ */
+export interface LabelFilter {
+    /** Text to match against node labels */
+    text: string;
+    /** Matching mode (default: 'contains') */
+    mode?: TextMatchMode;
+    /** Case sensitivity (default: false) */
+    caseSensitive?: boolean;
+    /** Options for fuzzy matching (only used when mode is 'fuzzy') */
+    fuzzyOptions?: FuzzyMatchOptions;
+}
+/**
+ * State constraint for filtering nodes by their interactive state
+ */
+export interface StateConstraint {
+    /** Node must be visible */
+    visible?: boolean;
+    /** Node must be enabled */
+    enabled?: boolean;
+    /** Node must be checked (checkboxes/radios/switches) */
+    checked?: boolean;
+    /** Node must be expanded (accordions/dropdowns) */
+    expanded?: boolean;
+    /** Node must be selected (tabs/options) */
+    selected?: boolean;
+    /** Node must be focused */
+    focused?: boolean;
+    /** Node must be required */
+    required?: boolean;
+    /** Node must be invalid */
+    invalid?: boolean;
+    /** Node must be readonly */
+    readonly?: boolean;
+}
+/**
+ * Request to find elements in a snapshot
+ */
+export interface FindElementsRequest {
+    /** Filter by NodeKind (single or array) */
+    kind?: NodeKind | NodeKind[];
+    /** Filter by label text (string for contains, or LabelFilter for options) */
+    label?: string | LabelFilter;
+    /** Filter by semantic region (single or array) */
+    region?: SemanticRegion | SemanticRegion[];
+    /** Filter by state constraints */
+    state?: StateConstraint;
+    /** Filter by group identifier (exact match) */
+    group_id?: string;
+    /** Filter by heading context (exact match) */
+    heading_context?: string;
+    /** Maximum number of results (default: 10) */
+    limit?: number;
+    /** Minimum relevance score (0-1) to include in results */
+    min_score?: number;
+    /** Sort results by relevance (default: false, maintains document order) */
+    sort_by_relevance?: boolean;
+    /** Include disambiguation suggestions when results are ambiguous */
+    include_suggestions?: boolean;
+}
+/**
+ * Reason why a node matched the query
+ */
+export interface MatchReason {
+    /** Type of match criterion */
+    type: 'kind' | 'label' | 'region' | 'state' | 'group' | 'heading';
+    /** Human-readable description */
+    description: string;
+    /** How much this criterion contributed to relevance (0-1) */
+    score_contribution: number;
+}
+/**
+ * A matched node from the query
+ */
+export interface MatchedNode {
+    /** The matched node */
+    node: ReadableNode;
+    /** Relevance score (0-1, 1 = perfect match) */
+    relevance?: number;
+    /** Explanations for why this node matched */
+    match_reasons?: MatchReason[];
+}
+/**
+ * Query execution statistics
+ */
+export interface QueryStats {
+    /** Total nodes that passed all filters (before limit) */
+    total_matched: number;
+    /** Query execution time in milliseconds */
+    query_time_ms: number;
+    /** Number of nodes evaluated */
+    nodes_evaluated: number;
+}
+/**
+ * Disambiguation suggestion when query is ambiguous
+ */
+export interface DisambiguationSuggestion {
+    /** Type of refinement suggested */
+    type: 'refine_kind' | 'refine_region' | 'refine_label' | 'add_state' | 'refine_group';
+    /** Human-readable suggestion message */
+    message: string;
+    /** Query refinement to apply */
+    refinement: Partial<FindElementsRequest>;
+    /** How many matches this refinement would reduce to */
+    expected_matches: number;
+}
+/**
+ * Response from find elements query
+ */
+export interface FindElementsResponse {
+    /** Matched nodes (limited by request.limit) */
+    matches: MatchedNode[];
+    /** Query execution statistics */
+    stats: QueryStats;
+    /** Disambiguation suggestions when query matches multiple similar elements */
+    suggestions?: DisambiguationSuggestion[];
+}
+//# sourceMappingURL=query.types.d.ts.map

package/dist/src/query/types/query.types.d.ts.map

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

package/dist/src/query/types/query.types.js

@@ -0,0 +1,19 @@
+/**
+ * Query Engine Types
+ *
+ * Request/Response schemas for semantic element queries.
+ * Supports filtering by kind, label, region, state, and structural attributes.
+ */
+export {};
+// ============================================================================
+// Future Types (Placeholders)
+// ============================================================================
+// /**
+//  * Spatial constraint for position-based queries
+//  */
+// export interface SpatialConstraint {
+//   nearNodeId?: string;
+//   nearBbox?: BBox;
+//   maxDistance?: number;
+// }
+//# sourceMappingURL=query.types.js.map

package/dist/src/query/types/query.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.types.js","sourceRoot":"","sources":["../../../../src/query/types/query.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;AA+KH,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,MAAM;AACN,mDAAmD;AACnD,MAAM;AACN,uCAAuC;AACvC,yBAAyB;AACzB,qBAAqB;AACrB,0BAA0B;AAC1B,IAAI"}

package/dist/src/renderer/budget-manager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Budget Manager
+ *
+ * Manages token budget and applies truncation when needed.
+ */
+import type { TokenBudget, RenderedSection } from './types.js';
+/**
+ * Result of budget application.
+ */
+export interface BudgetResult {
+    /** Final content after budget application */
+    content: string;
+    /** Estimated token count */
+    tokens: number;
+    /** Was truncation applied? */
+    was_truncated: boolean;
+    /** Original token count before truncation */
+    original_tokens: number;
+    /** Which sections were truncated */
+    truncated_sections: string[];
+}
+/**
+ * Apply token budget to rendered sections.
+ *
+ * Strategy:
+ * 1. If under target, return as-is
+ * 2. If over target but under cap, progressively truncate by priority
+ * 3. If still over cap, hard truncate with marker
+ *
+ * @param sections - Rendered sections sorted by document order
+ * @param budget - Token budget tier
+ * @returns Budget result with final content
+ */
+export declare function applyBudget(sections: RenderedSection[], budget: TokenBudget): BudgetResult;
+/**
+ * Check if content is within budget.
+ */
+export declare function isWithinBudget(content: string, budget: TokenBudget): boolean;
+/**
+ * Get budget limits for a tier.
+ */
+export declare function getBudgetLimits(budget: TokenBudget): {
+    target: number;
+    cap: number;
+};
+//# sourceMappingURL=budget-manager.d.ts.map

package/dist/src/renderer/budget-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-manager.d.ts","sourceRoot":"","sources":["../../../src/renderer/budget-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAEhB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,8BAA8B;IAC9B,aAAa,EAAE,OAAO,CAAC;IAEvB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IAExB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY,CAiF1F;AA0CD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAG5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAEpF"}

package/dist/src/renderer/budget-manager.js

@@ -0,0 +1,133 @@
+/**
+ * Budget Manager
+ *
+ * Manages token budget and applies truncation when needed.
+ */
+import { TOKEN_BUDGETS } from './constants.js';
+import { estimateTokens } from './token-counter.js';
+/**
+ * Apply token budget to rendered sections.
+ *
+ * Strategy:
+ * 1. If under target, return as-is
+ * 2. If over target but under cap, progressively truncate by priority
+ * 3. If still over cap, hard truncate with marker
+ *
+ * @param sections - Rendered sections sorted by document order
+ * @param budget - Token budget tier
+ * @returns Budget result with final content
+ */
+export function applyBudget(sections, budget) {
+    const limits = TOKEN_BUDGETS[budget];
+    // Join sections with newlines
+    let content = joinSections(sections);
+    const originalTokens = estimateTokens(content);
+    // Under target? Return as-is
+    if (originalTokens <= limits.target) {
+        return {
+            content: wrapInPageContext(content),
+            tokens: estimateTokens(wrapInPageContext(content)),
+            was_truncated: false,
+            original_tokens: originalTokens,
+            truncated_sections: [],
+        };
+    }
+    // Over target - need to truncate
+    const truncatedSections = [];
+    // Sort sections by truncation priority (lower = truncate first)
+    const sortedSections = [...sections].sort((a, b) => a.truncation_priority - b.truncation_priority);
+    // Progressive truncation
+    const workingSections = [...sections];
+    for (const section of sortedSections) {
+        // Check if we're under cap now
+        content = joinSections(workingSections);
+        const currentTokens = estimateTokens(content);
+        if (currentTokens <= limits.cap) {
+            break;
+        }
+        // Try to truncate this section
+        if (section.can_truncate) {
+            const sectionIndex = workingSections.findIndex((s) => s.name === section.name);
+            if (sectionIndex !== -1) {
+                const truncatedSection = {
+                    ...workingSections[sectionIndex],
+                    content: workingSections[sectionIndex].truncated_content ??
+                        workingSections[sectionIndex].content,
+                };
+                // If truncated_content is empty, remove the section entirely
+                if (truncatedSection.content === '') {
+                    workingSections.splice(sectionIndex, 1);
+                }
+                else {
+                    workingSections[sectionIndex] = truncatedSection;
+                }
+                truncatedSections.push(section.name);
+            }
+        }
+    }
+    // Final content
+    content = joinSections(workingSections);
+    let tokens = estimateTokens(content);
+    // If still over cap, hard truncate
+    if (tokens > limits.cap) {
+        content = hardTruncate(content, limits.cap);
+        tokens = estimateTokens(content);
+        if (!truncatedSections.includes('hard-truncate')) {
+            truncatedSections.push('hard-truncate');
+        }
+    }
+    return {
+        content: wrapInPageContext(content),
+        tokens: estimateTokens(wrapInPageContext(content)),
+        was_truncated: true,
+        original_tokens: originalTokens,
+        truncated_sections: truncatedSections,
+    };
+}
+/**
+ * Join sections with double newlines.
+ */
+function joinSections(sections) {
+    return sections.map((s) => s.content).join('\n\n');
+}
+/**
+ * Wrap content in <page_context> root element.
+ */
+function wrapInPageContext(content) {
+    return `<page_context>\n${content}\n</page_context>`;
+}
+/**
+ * Hard truncate content to fit within token limit.
+ * Adds a truncation marker.
+ */
+function hardTruncate(content, maxTokens) {
+    const marker = '\n[...truncated]';
+    const markerTokens = estimateTokens(marker);
+    const targetContentTokens = maxTokens - markerTokens - 10; // Buffer for wrapper
+    // Estimate characters for target tokens
+    const targetChars = targetContentTokens * 4;
+    if (content.length <= targetChars) {
+        return content;
+    }
+    // Find a good break point (end of line)
+    let breakPoint = content.lastIndexOf('\n', targetChars);
+    if (breakPoint === -1 || breakPoint < targetChars * 0.7) {
+        // No good line break, just truncate
+        breakPoint = targetChars;
+    }
+    return content.slice(0, breakPoint) + marker;
+}
+/**
+ * Check if content is within budget.
+ */
+export function isWithinBudget(content, budget) {
+    const limits = TOKEN_BUDGETS[budget];
+    return estimateTokens(content) <= limits.cap;
+}
+/**
+ * Get budget limits for a tier.
+ */
+export function getBudgetLimits(budget) {
+    return TOKEN_BUDGETS[budget];
+}
+//# sourceMappingURL=budget-manager.js.map

package/dist/src/renderer/budget-manager.js.map

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

package/dist/src/renderer/constants.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Renderer Constants
+ *
+ * Token budget configuration for page_brief rendering.
+ */
+/**
+ * Token budget tiers for different use cases.
+ * - target: Ideal token count to stay under
+ * - cap: Hard limit, will truncate to meet this
+ */
+export declare const TOKEN_BUDGETS: {
+    /** Compact: For embedding in large prompts */
+    readonly compact: {
+        readonly target: 400;
+        readonly cap: 800;
+    };
+    /** Standard: Default for all page loads */
+    readonly standard: {
+        readonly target: 1000;
+        readonly cap: 2000;
+    };
+    /** Detailed: Full context when explicitly requested */
+    readonly detailed: {
+        readonly target: 2500;
+        readonly cap: 5000;
+    };
+};
+/** Default budget tier */
+export declare const DEFAULT_BUDGET: "standard";
+/** Maximum token cap across all tiers */
+export declare const MAX_TOKEN_CAP = 5000;
+/** Default number of actions to include */
+export declare const DEFAULT_MAX_ACTIONS = 12;
+/** Minimum actions to keep during truncation */
+export declare const MIN_ACTIONS_ON_TRUNCATE = 5;
+/** Characters per token (rough estimate for truncation) */
+export declare const CHARS_PER_TOKEN = 4;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/renderer/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/renderer/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB,8CAA8C;;;;;IAG9C,2CAA2C;;;;;IAG3C,uDAAuD;;;;;CAE/C,CAAC;AAEX,0BAA0B;AAC1B,eAAO,MAAM,cAAc,EAAG,UAAmB,CAAC;AAElD,yCAAyC;AACzC,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,2DAA2D;AAC3D,eAAO,MAAM,eAAe,IAAI,CAAC"}

package/dist/src/renderer/constants.js

@@ -0,0 +1,29 @@
+/**
+ * Renderer Constants
+ *
+ * Token budget configuration for page_brief rendering.
+ */
+/**
+ * Token budget tiers for different use cases.
+ * - target: Ideal token count to stay under
+ * - cap: Hard limit, will truncate to meet this
+ */
+export const TOKEN_BUDGETS = {
+    /** Compact: For embedding in large prompts */
+    compact: { target: 400, cap: 800 },
+    /** Standard: Default for all page loads */
+    standard: { target: 1000, cap: 2000 },
+    /** Detailed: Full context when explicitly requested */
+    detailed: { target: 2500, cap: 5000 },
+};
+/** Default budget tier */
+export const DEFAULT_BUDGET = 'standard';
+/** Maximum token cap across all tiers */
+export const MAX_TOKEN_CAP = 5000;
+/** Default number of actions to include */
+export const DEFAULT_MAX_ACTIONS = 12;
+/** Minimum actions to keep during truncation */
+export const MIN_ACTIONS_ON_TRUNCATE = 5;
+/** Characters per token (rough estimate for truncation) */
+export const CHARS_PER_TOKEN = 4;
+//# sourceMappingURL=constants.js.map

package/dist/src/renderer/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/renderer/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAElC,2CAA2C;IAC3C,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;IAErC,uDAAuD;IACvD,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;CAC7B,CAAC;AAEX,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG,UAAmB,CAAC;AAElD,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,gDAAgD;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC"}

package/dist/src/renderer/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Renderer Module
+ *
+ * Exports for FactPack rendering to XML format.
+ */
+export { renderFactPackXml, renderFactPackXmlRaw, generatePageBrief, estimateFactPackTokens, } from './xml-renderer.js';
+export { applyBudget, isWithinBudget, getBudgetLimits } from './budget-manager.js';
+export { estimateTokens, tokensOverBudget, isWithinBudget as isWithinTokenBudget, estimateTokenSavings, } from './token-counter.js';
+export { TOKEN_BUDGETS, DEFAULT_BUDGET, MAX_TOKEN_CAP, DEFAULT_MAX_ACTIONS, MIN_ACTIONS_ON_TRUNCATE, CHARS_PER_TOKEN, } from './constants.js';
+export type { TokenBudget, OutputFormat, RenderOptions, PageBriefResult, RenderedSection, TruncationContext, } from './types.js';
+export { renderPageSection, renderDialogsSection, renderFormsSection, renderActionsSection, renderStateSection, TRUNCATION_PRIORITY, } from './section-renderers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/renderer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGnF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,IAAI,mBAAmB,EACrC,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/dist/src/renderer/index.js

@@ -0,0 +1,16 @@
+/**
+ * Renderer Module
+ *
+ * Exports for FactPack rendering to XML format.
+ */
+// XML renderer
+export { renderFactPackXml, renderFactPackXmlRaw, generatePageBrief, estimateFactPackTokens, } from './xml-renderer.js';
+// Budget management
+export { applyBudget, isWithinBudget, getBudgetLimits } from './budget-manager.js';
+// Token counting
+export { estimateTokens, tokensOverBudget, isWithinBudget as isWithinTokenBudget, estimateTokenSavings, } from './token-counter.js';
+// Constants
+export { TOKEN_BUDGETS, DEFAULT_BUDGET, MAX_TOKEN_CAP, DEFAULT_MAX_ACTIONS, MIN_ACTIONS_ON_TRUNCATE, CHARS_PER_TOKEN, } from './constants.js';
+// Section renderers (for testing/customization)
+export { renderPageSection, renderDialogsSection, renderFormsSection, renderActionsSection, renderStateSection, TRUNCATION_PRIORITY, } from './section-renderers.js';
+//# sourceMappingURL=index.js.map

package/dist/src/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEnF,iBAAiB;AACjB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,IAAI,mBAAmB,EACrC,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAYxB,gDAAgD;AAChD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/dist/src/renderer/section-renderers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Section Renderers
+ *
+ * Individual renderers for each FactPack section.
+ * Each renderer produces XML-compact output.
+ */
+import type { PageClassificationResult, DialogDetectionResult, FormDetectionResult, ActionSelectionResult, FactPack } from '../factpack/types.js';
+import type { RenderOptions, RenderedSection } from './types.js';
+/**
+ * Truncation priority constants (lower = cut first).
+ */
+export declare const TRUNCATION_PRIORITY: {
+    readonly STATE: 1;
+    readonly ACTIONS_EXTRA: 2;
+    readonly FORM_DETAILS: 3;
+    readonly DIALOG_SECONDARY: 4;
+    readonly FORMS: 5;
+    readonly DIALOGS: 6;
+    readonly ACTIONS_CORE: 7;
+    readonly PAGE: 8;
+};
+/**
+ * Render the <page> section.
+ */
+export declare function renderPageSection(pageResult: PageClassificationResult): RenderedSection;
+/**
+ * Render the <dialogs> section.
+ */
+export declare function renderDialogsSection(dialogResult: DialogDetectionResult): RenderedSection;
+/**
+ * Render the <forms> section.
+ */
+export declare function renderFormsSection(formResult: FormDetectionResult, _options: RenderOptions): RenderedSection;
+/**
+ * Render the <actions> section.
+ */
+export declare function renderActionsSection(actionResult: ActionSelectionResult, options: RenderOptions): RenderedSection;
+/**
+ * Render the <state> section.
+ */
+export declare function renderStateSection(factpack: FactPack, options: RenderOptions): RenderedSection;
+//# sourceMappingURL=section-renderers.d.ts.map

package/dist/src/renderer/section-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-renderers.d.ts","sourceRoot":"","sources":["../../../src/renderer/section-renderers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EAKrB,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGjE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;CAStB,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,wBAAwB,GAAG,eAAe,CAuBvF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,qBAAqB,GAAG,eAAe,CAmCzF;AAmBD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,mBAAmB,EAC/B,QAAQ,EAAE,aAAa,GACtB,eAAe,CA0CjB;AAyDD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,aAAa,GACrB,eAAe,CAsCjB;AASD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,eAAe,CAyB9F"}