conatus 0.1.0

package/dist/strategy/strategy-manager.d.ts

@@ -0,0 +1,65 @@
+import type { Strategy } from "../types/strategy.js";
+import { StrategyManagerBase } from "./strategy-manager-base.js";
+export { VALID_TRANSITIONS, StrategyArraySchema, buildGenerationPrompt, redistributeAllocation, detectStrategyGap } from "./strategy-helpers.js";
+export { StrategyManagerBase } from "./strategy-manager-base.js";
+/**
+ * StrategyManager manages strategy lifecycle for a goal:
+ * - LLM-driven candidate generation
+ * - State transitions (candidate → active → completed/terminated/evaluating)
+ * - Stall-driven pivots
+ * - Phase 2: parallel multi-strategy execution (activateMultiple, terminateStrategy,
+ *   createWaitStrategy, suspendStrategy, resumeStrategy, getAllActiveStrategies, updateAllocation)
+ *
+ * Persistence paths (relative to StateManager base):
+ *   strategies/<goal_id>/portfolio.json
+ *   strategies/<goal_id>/strategy-history.json
+ *
+ * In-memory index: strategyId → goalId for fast lookups without directory scanning.
+ */
+export declare class StrategyManager extends StrategyManagerBase {
+    /**
+     * Activate multiple candidate strategies simultaneously (Phase 2 parallel execution).
+     * Allocates resources equally, respecting min=0.1 and max=0.7 per strategy.
+     * Single strategy receives allocation=1.0.
+     */
+    activateMultiple(goalId: string, strategyIds: string[]): Promise<Strategy[]>;
+    /**
+     * Terminate a strategy and redistribute its allocation to remaining active strategies
+     * proportionally. If no remaining active strategies, allocation is not redistributed.
+     */
+    terminateStrategy(goalId: string, strategyId: string, _reason: string): Promise<Strategy>;
+    /**
+     * Create a WaitStrategy for a goal.
+     * Sets state="candidate" initially; caller activates when ready.
+     */
+    createWaitStrategy(goalId: string, params: {
+        hypothesis: string;
+        wait_reason: string;
+        wait_until: string;
+        measurement_plan: string;
+        fallback_strategy_id: string | null;
+        target_dimensions: string[];
+        primary_dimension: string;
+    }): Promise<Strategy>;
+    /**
+     * Suspend an active strategy, redistributing its allocation to remaining active strategies.
+     */
+    suspendStrategy(goalId: string, strategyId: string): Promise<Strategy>;
+    /**
+     * Resume a suspended strategy at the given allocation.
+     * Adjusts other active strategies proportionally to maintain sum=1.0.
+     */
+    resumeStrategy(goalId: string, strategyId: string, allocation: number): Promise<Strategy>;
+    /**
+     * Return all strategies with state "active" or "evaluating" for a goal.
+     * Unlike getActiveStrategy, returns all concurrent active strategies.
+     */
+    getAllActiveStrategies(goalId: string): Promise<Strategy[]>;
+    /**
+     * Update a single strategy's allocation directly.
+     * Does NOT validate that the sum of all allocations equals 1.0;
+     * the caller (e.g., PortfolioManager) is responsible for maintaining that invariant.
+     */
+    updateAllocation(goalId: string, strategyId: string, newAllocation: number): Promise<void>;
+}
+//# sourceMappingURL=strategy-manager.d.ts.map

package/dist/strategy/strategy-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-manager.d.ts","sourceRoot":"","sources":["../../src/strategy/strategy-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACjJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,SAAQ,mBAAmB;IAGtD;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA0DlF;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8B/F;;;OAGG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,GACA,OAAO,CAAC,QAAQ,CAAC;IAuCpB;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA+B5E;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8C/F;;;OAGG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOjE;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBjG"}

package/dist/strategy/strategy-manager.js

@@ -0,0 +1,226 @@
+import { randomUUID } from "node:crypto";
+import { StrategySchema, WaitStrategySchema } from "../types/strategy.js";
+import { redistributeAllocation } from "./strategy-helpers.js";
+import { StrategyManagerBase } from "./strategy-manager-base.js";
+export { VALID_TRANSITIONS, StrategyArraySchema, buildGenerationPrompt, redistributeAllocation, detectStrategyGap } from "./strategy-helpers.js";
+export { StrategyManagerBase } from "./strategy-manager-base.js";
+/**
+ * StrategyManager manages strategy lifecycle for a goal:
+ * - LLM-driven candidate generation
+ * - State transitions (candidate → active → completed/terminated/evaluating)
+ * - Stall-driven pivots
+ * - Phase 2: parallel multi-strategy execution (activateMultiple, terminateStrategy,
+ *   createWaitStrategy, suspendStrategy, resumeStrategy, getAllActiveStrategies, updateAllocation)
+ *
+ * Persistence paths (relative to StateManager base):
+ *   strategies/<goal_id>/portfolio.json
+ *   strategies/<goal_id>/strategy-history.json
+ *
+ * In-memory index: strategyId → goalId for fast lookups without directory scanning.
+ */
+export class StrategyManager extends StrategyManagerBase {
+    // ─── Phase 2 Portfolio Methods ───
+    /**
+     * Activate multiple candidate strategies simultaneously (Phase 2 parallel execution).
+     * Allocates resources equally, respecting min=0.1 and max=0.7 per strategy.
+     * Single strategy receives allocation=1.0.
+     */
+    async activateMultiple(goalId, strategyIds) {
+        if (strategyIds.length === 0) {
+            throw new Error(`activateMultiple: strategyIds must not be empty`);
+        }
+        const portfolio = await this.loadOrCreatePortfolio(goalId);
+        const now = new Date().toISOString();
+        const count = strategyIds.length;
+        // Compute equal-split allocation within [min, max] bounds
+        const MIN = 0.1;
+        const MAX = 0.7;
+        let alloc;
+        if (count === 1) {
+            alloc = 1.0;
+        }
+        else {
+            // Equal split, clamped to [MIN, MAX]
+            const raw = 1.0 / count;
+            alloc = Math.min(Math.max(raw, MIN), MAX);
+        }
+        // Validate all strategies before mutating to avoid partial state
+        for (const id of strategyIds) {
+            const s = portfolio.strategies.find((s) => s.id === id);
+            if (!s) {
+                throw new Error(`activateMultiple: strategy "${id}" not found in portfolio for goal "${goalId}"`);
+            }
+            if (s.state !== "candidate") {
+                throw new Error(`activateMultiple: strategy "${s.id}" is not in candidate state (current: ${s.state})`);
+            }
+        }
+        const activated = [];
+        const updatedStrategies = portfolio.strategies.map((s) => {
+            if (!strategyIds.includes(s.id))
+                return s;
+            const updated = StrategySchema.parse({
+                ...s,
+                state: "active",
+                started_at: now,
+                allocation: alloc,
+                gap_snapshot_at_start: s.gap_snapshot_at_start,
+            });
+            activated.push(updated);
+            return updated;
+        });
+        portfolio.strategies = updatedStrategies;
+        await this.savePortfolio(goalId, portfolio);
+        return activated;
+    }
+    /**
+     * Terminate a strategy and redistribute its allocation to remaining active strategies
+     * proportionally. If no remaining active strategies, allocation is not redistributed.
+     */
+    async terminateStrategy(goalId, strategyId, _reason) {
+        const portfolio = await this.loadOrCreatePortfolio(goalId);
+        const strategy = portfolio.strategies.find((s) => s.id === strategyId);
+        if (!strategy) {
+            throw new Error(`terminateStrategy: strategy "${strategyId}" not found in portfolio for goal "${goalId}"`);
+        }
+        const now = new Date().toISOString();
+        const freedAllocation = strategy.allocation;
+        const terminated = StrategySchema.parse({
+            ...strategy,
+            state: "terminated",
+            completed_at: now,
+            allocation: 0,
+        });
+        // Redistribute freed allocation proportionally
+        const withTerminated = portfolio.strategies.map((s) => s.id === strategyId ? terminated : s);
+        portfolio.strategies = redistributeAllocation(withTerminated, strategyId, freedAllocation);
+        await this.savePortfolio(goalId, portfolio);
+        await this.appendToHistory(goalId, terminated);
+        return terminated;
+    }
+    /**
+     * Create a WaitStrategy for a goal.
+     * Sets state="candidate" initially; caller activates when ready.
+     */
+    async createWaitStrategy(goalId, params) {
+        const now = new Date().toISOString();
+        const waitStrategy = WaitStrategySchema.parse({
+            id: randomUUID(),
+            goal_id: goalId,
+            target_dimensions: params.target_dimensions,
+            primary_dimension: params.primary_dimension,
+            hypothesis: params.hypothesis,
+            expected_effect: [],
+            resource_estimate: {
+                sessions: 0,
+                duration: { value: 0, unit: "hours" },
+                llm_calls: null,
+            },
+            state: "candidate",
+            allocation: 0,
+            created_at: now,
+            started_at: null,
+            completed_at: null,
+            gap_snapshot_at_start: null,
+            tasks_generated: [],
+            effectiveness_score: null,
+            consecutive_stall_count: 0,
+            wait_reason: params.wait_reason,
+            wait_until: params.wait_until,
+            measurement_plan: params.measurement_plan,
+            fallback_strategy_id: params.fallback_strategy_id,
+        });
+        const portfolio = await this.loadOrCreatePortfolio(goalId);
+        // WaitStrategy is a superset of Strategy; store as Strategy (base fields) in portfolio
+        portfolio.strategies.push(StrategySchema.parse(waitStrategy));
+        await this.savePortfolio(goalId, portfolio);
+        this.strategyIndex.set(waitStrategy.id, goalId);
+        return StrategySchema.parse(waitStrategy);
+    }
+    /**
+     * Suspend an active strategy, redistributing its allocation to remaining active strategies.
+     */
+    async suspendStrategy(goalId, strategyId) {
+        const portfolio = await this.loadOrCreatePortfolio(goalId);
+        const strategy = portfolio.strategies.find((s) => s.id === strategyId);
+        if (!strategy) {
+            throw new Error(`suspendStrategy: strategy "${strategyId}" not found in portfolio for goal "${goalId}"`);
+        }
+        if (strategy.state !== "active" && strategy.state !== "evaluating") {
+            throw new Error(`suspendStrategy: strategy "${strategyId}" must be active or evaluating (current: ${strategy.state})`);
+        }
+        const freedAllocation = strategy.allocation;
+        const suspended = StrategySchema.parse({
+            ...strategy,
+            state: "suspended",
+            allocation: 0,
+        });
+        const withSuspended = portfolio.strategies.map((s) => s.id === strategyId ? suspended : s);
+        portfolio.strategies = redistributeAllocation(withSuspended, strategyId, freedAllocation);
+        await this.savePortfolio(goalId, portfolio);
+        return suspended;
+    }
+    /**
+     * Resume a suspended strategy at the given allocation.
+     * Adjusts other active strategies proportionally to maintain sum=1.0.
+     */
+    async resumeStrategy(goalId, strategyId, allocation) {
+        if (allocation < 0 || allocation > 1) {
+            throw new Error(`resumeStrategy: allocation must be in [0, 1], got ${allocation}`);
+        }
+        const portfolio = await this.loadOrCreatePortfolio(goalId);
+        const strategy = portfolio.strategies.find((s) => s.id === strategyId);
+        if (!strategy) {
+            throw new Error(`resumeStrategy: strategy "${strategyId}" not found in portfolio for goal "${goalId}"`);
+        }
+        if (strategy.state !== "suspended") {
+            throw new Error(`resumeStrategy: strategy "${strategyId}" must be suspended (current: ${strategy.state})`);
+        }
+        const resumed = StrategySchema.parse({
+            ...strategy,
+            state: "active",
+            allocation,
+        });
+        // Shrink other active strategies proportionally to make room
+        const others = portfolio.strategies.filter((s) => s.id !== strategyId && (s.state === "active" || s.state === "evaluating"));
+        const totalOtherAlloc = others.reduce((sum, s) => sum + s.allocation, 0);
+        const remaining = 1.0 - allocation;
+        portfolio.strategies = portfolio.strategies.map((s) => {
+            if (s.id === strategyId)
+                return resumed;
+            if (!others.some((o) => o.id === s.id))
+                return s;
+            const newAlloc = totalOtherAlloc > 0
+                ? (s.allocation / totalOtherAlloc) * remaining
+                : remaining / others.length;
+            return StrategySchema.parse({ ...s, allocation: newAlloc });
+        });
+        await this.savePortfolio(goalId, portfolio);
+        return resumed;
+    }
+    /**
+     * Return all strategies with state "active" or "evaluating" for a goal.
+     * Unlike getActiveStrategy, returns all concurrent active strategies.
+     */
+    async getAllActiveStrategies(goalId) {
+        const portfolio = await this.loadOrCreatePortfolio(goalId);
+        return portfolio.strategies.filter((s) => s.state === "active" || s.state === "evaluating");
+    }
+    /**
+     * Update a single strategy's allocation directly.
+     * Does NOT validate that the sum of all allocations equals 1.0;
+     * the caller (e.g., PortfolioManager) is responsible for maintaining that invariant.
+     */
+    async updateAllocation(goalId, strategyId, newAllocation) {
+        if (newAllocation < 0 || newAllocation > 1) {
+            throw new Error(`updateAllocation: allocation must be in [0, 1], got ${newAllocation}`);
+        }
+        const portfolio = await this.loadOrCreatePortfolio(goalId);
+        const strategy = portfolio.strategies.find((s) => s.id === strategyId);
+        if (!strategy) {
+            throw new Error(`updateAllocation: strategy "${strategyId}" not found in portfolio for goal "${goalId}"`);
+        }
+        portfolio.strategies = portfolio.strategies.map((s) => s.id === strategyId ? StrategySchema.parse({ ...s, allocation: newAllocation }) : s);
+        await this.savePortfolio(goalId, portfolio);
+    }
+}
+//# sourceMappingURL=strategy-manager.js.map

package/dist/strategy/strategy-manager.js.map

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

package/dist/strategy/strategy-template-registry.d.ts

@@ -0,0 +1,84 @@
+import type { ILLMClient } from "../llm/llm-client.js";
+import type { Logger } from "../runtime/logger.js";
+import type { IEmbeddingClient } from "../knowledge/embedding-client.js";
+import type { IPromptGateway } from "../prompt/gateway.js";
+import { VectorIndex } from "../knowledge/vector-index.js";
+import type { StrategyTemplate, EmbeddingRecommendation, HybridRecommendation } from "../types/cross-portfolio.js";
+import type { Strategy } from "../types/strategy.js";
+/**
+ * StrategyTemplateRegistry manages successful strategy templates for cross-goal reuse.
+ *
+ * It stores templates derived from completed strategies, generates semantic embeddings
+ * for semantic search, and can adapt templates to new goal contexts.
+ *
+ * Persistence: {basePath}/strategy-templates.json
+ */
+export declare class StrategyTemplateRegistry {
+    private readonly llmClient;
+    private readonly vectorIndex;
+    private readonly embeddingClient;
+    private readonly basePath;
+    private readonly promptGateway?;
+    private readonly templates;
+    private readonly persistPath;
+    private readonly logger?;
+    constructor(llmClient: ILLMClient, vectorIndex: VectorIndex, embeddingClient: IEmbeddingClient, basePath: string, logger?: Logger, promptGateway?: IPromptGateway | undefined);
+    /**
+     * Register a completed, effective strategy as a reusable template.
+     * Preconditions: strategy.state === "completed" AND effectiveness_score >= 0.5
+     */
+    registerTemplate(strategy: Strategy, goalId: string): Promise<StrategyTemplate>;
+    /**
+     * Search templates by semantic similarity.
+     * Optionally filter by domain tags (at least one tag must overlap).
+     */
+    searchTemplates(query: string, limit?: number, domainTags?: string[]): Promise<StrategyTemplate[]>;
+    /**
+     * Adapt a template to a new goal context, generating a concrete Strategy.
+     * The caller is responsible for persisting the returned Strategy.
+     */
+    applyTemplate(templateId: string, goalId: string, goalContext: string): Promise<Strategy>;
+    /**
+     * Index all registered templates into a VectorIndex using the provided embedding client.
+     * Each template's hypothesis_pattern is embedded and stored with its template_id as metadata.
+     * Call this once after loading templates to enable recommendByEmbedding() / recommendHybrid().
+     */
+    indexTemplates(embeddingClient: IEmbeddingClient, vectorIndex: VectorIndex): Promise<void>;
+    /**
+     * Recommend templates for a goal description using semantic embedding similarity.
+     * Searches the provided VectorIndex for the top-K closest templates.
+     * Returns EmbeddingRecommendation[] sorted by similarity descending.
+     */
+    recommendByEmbedding(goalDescription: string, embeddingClient: IEmbeddingClient, vectorIndex: VectorIndex, topK?: number): Promise<EmbeddingRecommendation[]>;
+    /**
+     * Hybrid recommendation combining tag-based matching with embedding similarity.
+     * tagScore: fraction of goal tags that overlap with template domain_tags (0 if no tags supplied).
+     * embeddingScore: cosine similarity from VectorIndex.
+     * combinedScore: tagWeight * tagScore + embeddingWeight * embeddingScore (default 0.4 / 0.6).
+     * Returns HybridRecommendation[] sorted by combinedScore descending.
+     */
+    recommendHybrid(goalDescription: string, goalTags: string[], embeddingClient: IEmbeddingClient, vectorIndex: VectorIndex, options?: {
+        tagWeight?: number;
+        embeddingWeight?: number;
+        topK?: number;
+    }): Promise<HybridRecommendation[]>;
+    /**
+     * Persist all templates to JSON file (atomic write).
+     */
+    save(): Promise<void>;
+    /**
+     * Load templates from JSON file.
+     * Silently succeeds if the file does not exist.
+     */
+    load(): Promise<void>;
+    /**
+     * Return the number of templates currently in the registry.
+     */
+    get size(): number;
+    /**
+     * Retrieve a template by ID. Returns undefined if not found.
+     */
+    getTemplate(templateId: string): StrategyTemplate | undefined;
+    private _findTemplateByEmbeddingId;
+}
+//# sourceMappingURL=strategy-template-registry.d.ts.map

package/dist/strategy/strategy-template-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-template-registry.d.ts","sourceRoot":"","sources":["../../src/strategy/strategy-template-registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAwBrD;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IAMjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAVjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAGd,SAAS,EAAE,UAAU,EACrB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,gBAAgB,EACjC,QAAQ,EAAE,MAAM,EACjC,MAAM,CAAC,EAAE,MAAM,EACE,aAAa,CAAC,EAAE,cAAc,YAAA;IAMjD;;;OAGG;IACG,gBAAgB,CACpB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IA0E5B;;;OAGG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAU,EACjB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAuC9B;;;OAGG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,CAAC;IAkEpB;;;;OAIG;IACG,cAAc,CAClB,eAAe,EAAE,gBAAgB,EACjC,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;OAIG;IACG,oBAAoB,CACxB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,gBAAgB,EACjC,WAAW,EAAE,WAAW,EACxB,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,uBAAuB,EAAE,CAAC;IA4BrC;;;;;;OAMG;IACG,eAAe,CACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAAE,EAClB,eAAe,EAAE,gBAAgB,EACjC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5E,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAsDlC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAM7D,OAAO,CAAC,0BAA0B;CAUnC"}