@telora/factory 0.4.5

package/dist/pipeline-traversal.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Pipeline Traversal
+ *
+ * Manages advancing through pipeline nodes when the current node
+ * completes execution. Evaluates outgoing edge conditions to
+ * determine the next node.
+ */
+import type { FactoryInstanceState, PipelineGraph } from './types.js';
+import type { PipelineExecutionMetrics } from './pipeline-metrics.js';
+/** Result of a pipeline advance attempt. */
+export interface PipelineAdvanceResult {
+    /** What happened during the advance. */
+    outcome: 'advanced' | 'completed' | 'no_match' | 'no_pipeline';
+    /** The next node ID (if advanced). */
+    nextNodeId?: string;
+    /** The completed node ID. */
+    completedNodeId?: string;
+    /** Human-readable message. */
+    message: string;
+}
+/**
+ * Attempt to advance the pipeline to the next node.
+ *
+ * Called when the current pipeline node's execution completes.
+ * Evaluates outgoing edge conditions and determines the next step.
+ *
+ * Does NOT mutate state - returns the result for the caller to apply.
+ *
+ * @param state - Current factory instance state
+ * @param metrics - Current execution metrics for condition evaluation
+ * @returns The advance result
+ */
+export declare function advancePipeline(state: FactoryInstanceState, metrics: PipelineExecutionMetrics): PipelineAdvanceResult;
+/**
+ * Get the label of a pipeline node by ID.
+ * Returns the ID itself if the node is not found.
+ */
+export declare function getNodeLabel(graph: PipelineGraph, nodeId: string): string;
+/**
+ * Check if an instance uses pipeline traversal (has a pipeline graph).
+ */
+export declare function usesPipeline(state: FactoryInstanceState): boolean;
+//# sourceMappingURL=pipeline-traversal.d.ts.map

package/dist/pipeline-traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-traversal.d.ts","sourceRoot":"","sources":["../src/pipeline-traversal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,OAAO,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;IAC/D,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,wBAAwB,GAChC,qBAAqB,CAyCvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,GACb,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAEjE"}

package/dist/pipeline-traversal.js

@@ -0,0 +1,68 @@
+/**
+ * Pipeline Traversal
+ *
+ * Manages advancing through pipeline nodes when the current node
+ * completes execution. Evaluates outgoing edge conditions to
+ * determine the next node.
+ */
+import { findNextNode, isTerminalNode } from './pipeline-evaluator.js';
+/**
+ * Attempt to advance the pipeline to the next node.
+ *
+ * Called when the current pipeline node's execution completes.
+ * Evaluates outgoing edge conditions and determines the next step.
+ *
+ * Does NOT mutate state - returns the result for the caller to apply.
+ *
+ * @param state - Current factory instance state
+ * @param metrics - Current execution metrics for condition evaluation
+ * @returns The advance result
+ */
+export function advancePipeline(state, metrics) {
+    const { pipelineGraph, currentPipelineNodeId } = state;
+    // No pipeline graph = legacy mode, nothing to do
+    if (!pipelineGraph || !currentPipelineNodeId) {
+        return {
+            outcome: 'no_pipeline',
+            message: 'No pipeline graph configured (legacy mode).',
+        };
+    }
+    // Check if current node is terminal (no outgoing edges)
+    if (isTerminalNode(currentPipelineNodeId, pipelineGraph.edges)) {
+        return {
+            outcome: 'completed',
+            completedNodeId: currentPipelineNodeId,
+            message: `Pipeline completed at terminal node "${currentPipelineNodeId}".`,
+        };
+    }
+    // Find the next node by evaluating outgoing edge conditions
+    const nextNodeId = findNextNode(currentPipelineNodeId, pipelineGraph.edges, metrics);
+    if (!nextNodeId) {
+        return {
+            outcome: 'no_match',
+            completedNodeId: currentPipelineNodeId,
+            message: `No outgoing edge condition matched for node "${currentPipelineNodeId}". Escalation needed.`,
+        };
+    }
+    return {
+        outcome: 'advanced',
+        nextNodeId,
+        completedNodeId: currentPipelineNodeId,
+        message: `Pipeline advanced from "${currentPipelineNodeId}" to "${nextNodeId}".`,
+    };
+}
+/**
+ * Get the label of a pipeline node by ID.
+ * Returns the ID itself if the node is not found.
+ */
+export function getNodeLabel(graph, nodeId) {
+    const node = graph.nodes.find((n) => n.id === nodeId);
+    return node?.label ?? nodeId;
+}
+/**
+ * Check if an instance uses pipeline traversal (has a pipeline graph).
+ */
+export function usesPipeline(state) {
+    return state.pipelineGraph !== null && state.currentPipelineNodeId !== null;
+}
+//# sourceMappingURL=pipeline-traversal.js.map

package/dist/pipeline-traversal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-traversal.js","sourceRoot":"","sources":["../src/pipeline-traversal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAevE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,KAA2B,EAC3B,OAAiC;IAEjC,MAAM,EAAE,aAAa,EAAE,qBAAqB,EAAE,GAAG,KAAK,CAAC;IAEvD,iDAAiD;IACjD,IAAI,CAAC,aAAa,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,6CAA6C;SACvD,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,IAAI,cAAc,CAAC,qBAAqB,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,eAAe,EAAE,qBAAqB;YACtC,OAAO,EAAE,wCAAwC,qBAAqB,IAAI;SAC3E,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,MAAM,UAAU,GAAG,YAAY,CAC7B,qBAAqB,EACrB,aAAa,CAAC,KAAK,EACnB,OAAO,CACR,CAAC;IAEF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,eAAe,EAAE,qBAAqB;YACtC,OAAO,EAAE,gDAAgD,qBAAqB,uBAAuB;SACtG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,UAAU;QACV,eAAe,EAAE,qBAAqB;QACtC,OAAO,EAAE,2BAA2B,qBAAqB,SAAS,UAAU,IAAI;KACjF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAoB,EACpB,MAAc;IAEd,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACtD,OAAO,IAAI,EAAE,KAAK,IAAI,MAAM,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAA2B;IACtD,OAAO,KAAK,CAAC,aAAa,KAAK,IAAI,IAAI,KAAK,CAAC,qBAAqB,KAAK,IAAI,CAAC;AAC9E,CAAC"}

package/dist/plan-parser.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Work plan parsing, validation, and tempId-to-UUID mapping.
+ *
+ * Contains the Zod schemas for AI-generated work plans, JSON extraction
+ * from Claude Code output, dependency validation, and tempId mapping.
+ * Split from planning.ts for maintainability.
+ */
+import { z } from 'zod';
+import type { WorkPlanUnit } from './types.js';
+export declare const WorkPlanSchema: z.ZodObject<{
+    workUnits: z.ZodArray<z.ZodObject<{
+        tempId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        sortOrder: z.ZodNumber;
+        blockedBy: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        tempId: string;
+        title: string;
+        sortOrder: number;
+        blockedBy: string[];
+    }, {
+        description: string;
+        tempId: string;
+        title: string;
+        sortOrder: number;
+        blockedBy: string[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    workUnits: {
+        description: string;
+        tempId: string;
+        title: string;
+        sortOrder: number;
+        blockedBy: string[];
+    }[];
+}, {
+    workUnits: {
+        description: string;
+        tempId: string;
+        title: string;
+        sortOrder: number;
+        blockedBy: string[];
+    }[];
+}>;
+/**
+ * Claude Code --print --output-format json returns a JSON array of content blocks.
+ * Each block has { type, text } for text content. We need to extract the work plan
+ * JSON from the text content.
+ *
+ * The response format is:
+ * [{ "type": "text", "text": "..." }, ...]
+ *
+ * We concatenate all text blocks and extract the JSON work plan.
+ */
+export declare function extractWorkPlanJson(rawOutput: string): string;
+/**
+ * Validate that all blockedBy references point to valid tempIds within the plan.
+ * Returns an error message if validation fails, null if valid.
+ */
+export declare function validateDependencies(units: WorkPlanUnit[]): string | null;
+/**
+ * Map tempId references to real UUIDs.
+ *
+ * Generates a UUID for each work unit, then replaces tempId references
+ * in blockedBy arrays with the corresponding real UUIDs.
+ */
+export declare function mapTempIdsToUuids(units: WorkPlanUnit[]): Array<{
+    id: string;
+    title: string;
+    description: string;
+    sortOrder: number;
+    blockedBy: string[];
+}>;
+//# sourceMappingURL=plan-parser.d.ts.map

package/dist/plan-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-parser.d.ts","sourceRoot":"","sources":["../src/plan-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzB,CAAC;AAMH;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAsI7D;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EAAE,GACpB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAyBnG"}

package/dist/plan-parser.js

@@ -0,0 +1,223 @@
+/**
+ * Work plan parsing, validation, and tempId-to-UUID mapping.
+ *
+ * Contains the Zod schemas for AI-generated work plans, JSON extraction
+ * from Claude Code output, dependency validation, and tempId mapping.
+ * Split from planning.ts for maintainability.
+ */
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+// ============================================================================
+// Zod schema for AI-generated work plan
+// ============================================================================
+const WorkPlanUnitSchema = z.object({
+    tempId: z.string().min(1),
+    title: z.string().min(1),
+    description: z.string().min(1),
+    sortOrder: z.number().int().min(0),
+    blockedBy: z.array(z.string()),
+});
+export const WorkPlanSchema = z.object({
+    workUnits: z.array(WorkPlanUnitSchema).min(1),
+});
+// ============================================================================
+// JSON extraction from Claude Code output
+// ============================================================================
+/**
+ * Claude Code --print --output-format json returns a JSON array of content blocks.
+ * Each block has { type, text } for text content. We need to extract the work plan
+ * JSON from the text content.
+ *
+ * The response format is:
+ * [{ "type": "text", "text": "..." }, ...]
+ *
+ * We concatenate all text blocks and extract the JSON work plan.
+ */
+export function extractWorkPlanJson(rawOutput) {
+    // Extract AI text content from Claude Code --print --output-format json output.
+    //
+    // The output is a single JSON line: {"type":"result","result":"<text>","usage":{...}}
+    // But stdout may also contain non-JSON lines (git output, tool output leaking to stdout).
+    // Strategy: find the result JSON line, extract the result string, then parse the AI's text.
+    let textContent = null;
+    // Scan each line for the Claude Code result envelope
+    for (const line of rawOutput.split('\n')) {
+        const trimmedLine = line.trim();
+        if (!trimmedLine || !trimmedLine.startsWith('{'))
+            continue;
+        try {
+            const parsed = JSON.parse(trimmedLine);
+            if (parsed.type === 'result' && typeof parsed.result === 'string') {
+                textContent = parsed.result;
+                break;
+            }
+            // Also handle array-of-content-blocks format (older Claude Code versions)
+            if (parsed.type === 'result' && Array.isArray(parsed.result)) {
+                const texts = [];
+                for (const block of parsed.result) {
+                    if (typeof block === 'object' && block !== null && block.type === 'text') {
+                        const text = block.text;
+                        if (typeof text === 'string')
+                            texts.push(text);
+                    }
+                }
+                if (texts.length > 0) {
+                    textContent = texts.join('');
+                    break;
+                }
+            }
+        }
+        catch {
+            // Not valid JSON -- skip this line
+        }
+    }
+    // Fallback: try parsing the whole output as a single JSON value.
+    // --output-format json --verbose returns a JSON array of streaming events,
+    // not NDJSON lines. Find the {type: "result"} event within the array.
+    if (textContent === null) {
+        try {
+            const parsed = JSON.parse(rawOutput);
+            if (Array.isArray(parsed)) {
+                // Look for {type: "result"} event first (verbose JSON array format)
+                for (const event of parsed) {
+                    if (typeof event !== 'object' || event === null)
+                        continue;
+                    const ev = event;
+                    if (ev.type === 'result' && typeof ev.result === 'string') {
+                        textContent = ev.result;
+                        break;
+                    }
+                    if (ev.type === 'result' && Array.isArray(ev.result)) {
+                        const texts = [];
+                        for (const block of ev.result) {
+                            if (typeof block === 'object' && block !== null && block.type === 'text') {
+                                const text = block.text;
+                                if (typeof text === 'string')
+                                    texts.push(text);
+                            }
+                        }
+                        if (texts.length > 0) {
+                            textContent = texts.join('');
+                            break;
+                        }
+                    }
+                }
+                // Fallback: look for {type: "text"} content blocks (older format)
+                if (textContent === null) {
+                    const textBlocks = parsed.filter((block) => typeof block === 'object' &&
+                        block !== null &&
+                        'type' in block &&
+                        'text' in block &&
+                        block.type === 'text' &&
+                        typeof block.text === 'string');
+                    if (textBlocks.length > 0) {
+                        textContent = textBlocks.map((b) => b.text).join('');
+                    }
+                }
+            }
+        }
+        catch {
+            // Not a single JSON value either
+        }
+    }
+    // Last resort: use raw output as-is
+    if (textContent === null) {
+        textContent = rawOutput;
+    }
+    // Extract the JSON object from the text content.
+    // The AI might wrap it in markdown code fences or include preamble text.
+    const trimmed = textContent.trim();
+    // Try direct parse first (ideal case: pure JSON)
+    try {
+        JSON.parse(trimmed);
+        return trimmed;
+    }
+    catch {
+        // Not clean JSON -- extract below
+    }
+    // Look for a JSON object within markdown code fences
+    const fencedMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fencedMatch?.[1]) {
+        const fenced = fencedMatch[1].trim();
+        try {
+            JSON.parse(fenced);
+            return fenced;
+        }
+        catch {
+            // Fenced content isn't valid JSON either -- fall through
+        }
+    }
+    // Find the first valid JSON object by scanning for } from the end.
+    // More robust than manual brace counting -- lets JSON.parse validate.
+    const braceStart = trimmed.indexOf('{');
+    if (braceStart !== -1) {
+        let pos = trimmed.length;
+        while (pos > braceStart) {
+            pos = trimmed.lastIndexOf('}', pos - 1);
+            if (pos === -1)
+                break;
+            try {
+                JSON.parse(trimmed.slice(braceStart, pos + 1));
+                return trimmed.slice(braceStart, pos + 1);
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    throw new Error('Could not extract JSON work plan from Claude Code output');
+}
+// ============================================================================
+// Dependency mapping: tempId -> real UUID
+// ============================================================================
+/**
+ * Validate that all blockedBy references point to valid tempIds within the plan.
+ * Returns an error message if validation fails, null if valid.
+ */
+export function validateDependencies(units) {
+    const validTempIds = new Set(units.map((u) => u.tempId));
+    for (const unit of units) {
+        for (const dep of unit.blockedBy) {
+            if (!validTempIds.has(dep)) {
+                return `Work unit "${unit.tempId}" references unknown dependency "${dep}"`;
+            }
+        }
+        // A unit cannot depend on itself
+        if (unit.blockedBy.includes(unit.tempId)) {
+            return `Work unit "${unit.tempId}" has a self-dependency`;
+        }
+    }
+    return null;
+}
+/**
+ * Map tempId references to real UUIDs.
+ *
+ * Generates a UUID for each work unit, then replaces tempId references
+ * in blockedBy arrays with the corresponding real UUIDs.
+ */
+export function mapTempIdsToUuids(units) {
+    // Build tempId -> UUID mapping
+    const idMap = new Map();
+    for (const unit of units) {
+        idMap.set(unit.tempId, randomUUID());
+    }
+    // Map units with real UUIDs as id and in blockedBy.
+    // The id field MUST be sent to the server so that blockedBy references
+    // resolve to actual work unit row IDs. Without this, the DB generates
+    // its own IDs and blockedBy points to phantom UUIDs.
+    return units.map((unit) => ({
+        id: idMap.get(unit.tempId),
+        title: unit.title,
+        description: unit.description,
+        sortOrder: unit.sortOrder,
+        blockedBy: unit.blockedBy.map((tempId) => {
+            const realId = idMap.get(tempId);
+            if (!realId) {
+                // This should not happen if validateDependencies passed
+                throw new Error(`BUG: tempId "${tempId}" not found in idMap`);
+            }
+            return realId;
+        }),
+    }));
+}
+//# sourceMappingURL=plan-parser.js.map

package/dist/plan-parser.js.map

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

package/dist/planning-phase.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Planning phase orchestration and retry logic.
+ *
+ * Contains the main planning entry points that coordinate the planning flow:
+ * spawning Claude Code, validating results, retrying on failure, and
+ * managing flat vs per-strategy planning flows.
+ * Split from planning.ts for maintainability.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import type { FactoryBlueprint, FactoryConfig, FactoryInstanceState, WorkPlan } from './types.js';
+import { type ParsedTokenUsage } from './queries/shared.js';
+/** Result of a single plan generation attempt. */
+export type PlanGenerationResult = {
+    success: true;
+    workPlan: WorkPlan;
+    tokenUsage: ParsedTokenUsage | null;
+} | {
+    success: false;
+    error: string;
+    tokenUsage: ParsedTokenUsage | null;
+};
+/**
+ * Spawn Claude Code and validate the resulting work plan.
+ *
+ * This function encapsulates steps 2-4 of the planning phase:
+ * - Spawns Claude Code in --print mode with the given prompt
+ * - Extracts and parses the JSON work plan from the output
+ * - Validates schema, dependencies, and resource limits
+ *
+ * Extracted as a standalone function so it can be called in a retry loop
+ * when the AI produces an invalid plan.
+ */
+export declare function generateAndValidateWorkPlan(prompt: string, config: FactoryConfig, worktreePath: string, blueprint: FactoryBlueprint): Promise<PlanGenerationResult>;
+/**
+ * Run the planning phase for a factory instance.
+ *
+ * This function is called by the instance lifecycle manager when an instance
+ * transitions to 'planning'. It:
+ * 1. Creates a git worktree and branch
+ * 2. Checks if the instance has generated strategies (from designing phase)
+ * 3a. If strategies exist: runs per-strategy scoped planning in dependency order
+ * 3b. If no strategies: runs flat planning (legacy behavior)
+ * 4. Transitions the instance to 'building'
+ *
+ * @returns An object indicating success or failure with an optional error message.
+ */
+export declare function runPlanningPhase(state: FactoryInstanceState, config: FactoryConfig, governor?: ResourceGovernor | null): Promise<{
+    success: boolean;
+    error?: string;
+    tokenUsage?: ParsedTokenUsage | null;
+}>;
+//# sourceMappingURL=planning-phase.d.ts.map

package/dist/planning-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-phase.d.ts","sourceRoot":"","sources":["../src/planning-phase.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGlG,OAAO,EAA4C,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA0BtG,kDAAkD;AAClD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,GAC1E;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CA4G/B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,CAAC,CA+FrF"}