@telora/daemon 0.17.33 → 0.17.40

package/dist/directive/close-loop-stage.js

@@ -0,0 +1,196 @@
+/**
+ * Close-loop stage dispatcher.
+ *
+ * Drives the `close_loop` lifecycle stage for a focus: classify anchored
+ * injections by terminal state, then short-circuit to done, spawn the
+ * one-shot bookkeeper team, advance with an injection sweep, or hold.
+ * The pure decision logic lives in close-loop-dispatcher.ts; this module
+ * is the impure dispatch around it. Extracted from directive-executor.ts;
+ * the executor re-exports the public surface so existing importers are
+ * unaffected.
+ */
+import { getActiveTeams } from '../focus-team-state.js';
+import { ESCALATION_KINDS } from '@telora/daemon-core';
+import { CLOSE_LOOP_MODEL, advanceFocusToDoneWithSweep, buildCloseLoopDirective, decideCloseLoop, getAnchoringDeliveries, } from '../close-loop-dispatcher.js';
+import { verifyInjectionWithEvidence } from '../queries/verification.js';
+import { getFocusDeliveries, updateFocusStage } from '../queries/focuses.js';
+import { listPendingEscalations } from '../queries/issues.js';
+import { callApi } from '../queries/shared.js';
+import { terminateTeam, waitForTeamExit } from '../completion/index.js';
+import { pendingSpawnDirectives, computeDirectiveHash } from './directive-queue.js';
+import { assembleDirectiveContent } from './directive-assembly.js';
+/**
+ * Per-focus tracker for whether the close_loop bookkeeper has been spawned
+ * at least once. Used to avoid respawning the bookkeeper on every poll
+ * cycle while non-terminal injections are still being worked.
+ *
+ * Cleared when the focus leaves close_loop (advances to done or is
+ * manually reset). The set is in-process state -- on daemon restart it is
+ * empty, which is fine because the dispatcher's decideCloseLoop function
+ * will see the bookkeeper has not run, respawn it, and the new bookkeeper
+ * will sweep idempotently (already-verified injections stay verified;
+ * already-escalated ones still surface their open escalation).
+ */
+const closeLoopBookkeeperSpawned = new Set();
+/** Test helper: clear the bookkeeper-spawned set. */
+export function __resetCloseLoopStateForTesting() {
+    closeLoopBookkeeperSpawned.clear();
+}
+/**
+ * Inspect open escalations and return the set of injection ids that have
+ * an active `injection_unverified` escalation (status pending or
+ * in_review). Used by the close_loop dispatcher to classify "escalated"
+ * injections as terminal.
+ *
+ * The `metadata.injection_id` field is set by the bookkeeper persona when
+ * filing the escalation -- see the close_loop directive prompt.
+ */
+export async function getOpenInjectionUnverifiedEscalationIds() {
+    const escalations = await listPendingEscalations();
+    const ids = new Set();
+    for (const e of escalations) {
+        if (e.escalationKind !== ESCALATION_KINDS.INJECTION_UNVERIFIED)
+            continue;
+        const injectionId = e.metadata?.injection_id;
+        if (typeof injectionId === 'string' && injectionId.length > 0) {
+            ids.add(injectionId);
+        }
+    }
+    return ids;
+}
+/**
+ * Dispatch the close_loop stage for one focus.
+ *
+ * Reads the focus's anchored deliveries + injection statuses + open
+ * escalations, then runs the pure `decideCloseLoop` to determine whether
+ * to short-circuit, spawn a bookkeeper, advance to done, or hold.
+ *
+ * Returns the decision so the caller (or a test) can log/assert.
+ *
+ * Idempotent across poll cycles -- the `closeLoopBookkeeperSpawned` set
+ * ensures the bookkeeper is spawned at most once per focus visit to
+ * close_loop. Tests reset this via `__resetCloseLoopStateForTesting`.
+ */
+export async function dispatchCloseLoopStage(config, focus) {
+    const deliveries = await getFocusDeliveries(focus.focus_id);
+    const anchored = getAnchoringDeliveries(deliveries);
+    // Build the per-injection terminal-state snapshot.
+    //
+    // `statusById` is hoisted to function scope so the close_loop sweep (in
+    // the advance_to_done branch below) can reuse the snapshot without a
+    // second round-trip to reality_tree_focus_injections.
+    const states = [];
+    const statusById = new Map();
+    if (anchored.length > 0) {
+        let openEscalationIds;
+        try {
+            openEscalationIds = await getOpenInjectionUnverifiedEscalationIds();
+        }
+        catch (err) {
+            console.warn(`[close-loop-dispatcher] Failed to fetch open injection_unverified escalations ` +
+                `for focus ${focus.focus_id.slice(0, 8)}: ${err.message}`);
+            openEscalationIds = new Set();
+        }
+        let snapshots = [];
+        try {
+            const result = await callApi('reality_tree_focus_injections', { focusId: focus.focus_id });
+            snapshots = result.items ?? [];
+        }
+        catch (err) {
+            console.warn(`[close-loop-dispatcher] Failed to fetch focus injections for ${focus.focus_id.slice(0, 8)}: ` +
+                `${err.message}`);
+        }
+        for (const item of snapshots) {
+            statusById.set(item.injection.id, item.injection.injectionStatus);
+        }
+        for (const delivery of anchored) {
+            const injectionId = delivery.injectionId;
+            states.push({
+                injectionId,
+                injectionStatus: statusById.get(injectionId) ?? null,
+                hasOpenUnverifiedEscalation: openEscalationIds.has(injectionId),
+            });
+        }
+    }
+    const bookkeeperHasRun = closeLoopBookkeeperSpawned.has(focus.focus_id);
+    const decision = decideCloseLoop(deliveries, states, bookkeeperHasRun);
+    switch (decision.kind) {
+        case 'short_circuit_to_done': {
+            try {
+                await updateFocusStage(focus.focus_id, 'done');
+                console.log(`[close-loop-dispatcher] Focus "${focus.focus_name}" has no anchoring injections -- ` +
+                    `short-circuiting close_loop -> done`);
+            }
+            catch (err) {
+                console.warn(`[close-loop-dispatcher] Failed to short-circuit focus ${focus.focus_id.slice(0, 8)} to done: ` +
+                    `${err.message}`);
+            }
+            closeLoopBookkeeperSpawned.delete(focus.focus_id);
+            return decision;
+        }
+        case 'advance_to_done': {
+            // Focus-level injection sweep + stage advance. The helper realizes
+            // anchored injections whose anchoring deliveries closed successfully
+            // but whose status hasn't yet flipped to 'verified' (e.g. deliveries
+            // that exited via review instead of the per-delivery verify gate),
+            // then advances close_loop -> done. On sweep failure, the helper
+            // returns early WITHOUT calling updateFocusStage -- the focus stays
+            // at close_loop and the next poll cycle retries.
+            const outcome = await advanceFocusToDoneWithSweep(focus, anchored, statusById, { verify: verifyInjectionWithEvidence, updateFocusStage });
+            // Clear the bookkeeper-spawned flag only when the focus has
+            // terminally exited close_loop -- either advanced, or attempted to
+            // advance and the stage-update itself failed. A sweep failure leaves
+            // the flag in place so the same bookkeeper context is reused on the
+            // next poll cycle's retry.
+            if (outcome.advanced || outcome.advanceError) {
+                closeLoopBookkeeperSpawned.delete(focus.focus_id);
+            }
+            return decision;
+        }
+        case 'spawn_bookkeeper': {
+            const team = getActiveTeams().get(focus.focus_id);
+            const worktreePath = team?.worktreePath ?? null;
+            try {
+                const message = await assembleDirectiveContent(config, focus.focus_id, decision.directive, worktreePath);
+                const contentHash = computeDirectiveHash(decision.directive);
+                pendingSpawnDirectives.set(focus.focus_id, {
+                    message,
+                    model: decision.directive.model ?? CLOSE_LOOP_MODEL,
+                    sessionType: 'coding',
+                    // The close_loop bookkeeper is a distinct one-shot session: its own
+                    // lineage slot, always fresh -- it must not resume (or clobber) the
+                    // coder's context (INJ-B).
+                    lineage: 'close_loop',
+                    continuity: 'fresh',
+                    contentHash,
+                });
+                if (team) {
+                    terminateTeam(focus.focus_id, 'handoff');
+                    await waitForTeamExit(focus.focus_id, 30000);
+                }
+                closeLoopBookkeeperSpawned.add(focus.focus_id);
+                console.log(`[close-loop-dispatcher] Spawned bookkeeper team for focus "${focus.focus_name}" ` +
+                    `(${anchored.length} anchored injection(s), model: ${CLOSE_LOOP_MODEL})`);
+            }
+            catch (err) {
+                console.warn(`[close-loop-dispatcher] Failed to spawn bookkeeper for focus ${focus.focus_id.slice(0, 8)}: ` +
+                    `${err.message}`);
+            }
+            return decision;
+        }
+        case 'hold': {
+            console.log(`[close-loop-dispatcher] Focus "${focus.focus_name}" held at close_loop: ${decision.reason}`);
+            return decision;
+        }
+    }
+}
+/**
+ * Pure helper exported for tests: build the close_loop directive and verify
+ * it carries the expected assembly + model. The buildCloseLoopDirective
+ * function in close-loop-dispatcher.ts already does this; this is a
+ * dispatcher-side smoke export so the tests can grep through it.
+ */
+export function getCloseLoopDirectiveForTesting() {
+    return buildCloseLoopDirective();
+}
+//# sourceMappingURL=close-loop-stage.js.map

package/dist/directive/close-loop-stage.js.map

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

package/dist/directive/directive-assembly.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Directive assembly: compose a stage directive's deliverable content.
+ *
+ * Resolves the directive's assembly recipe (via assembly-engine + the
+ * registered source resolvers) and appends the static prompt + tool guidance.
+ * Shared by both inject and spawn dispatch modes, by the close-loop
+ * dispatcher, and by focus-executor for initial spawn with a stage directive.
+ * Extracted from directive-executor.ts; the executor re-exports the public
+ * surface so existing importers are unaffected.
+ */
+import type { DaemonConfig, StageDirective } from '../types.js';
+import { type AssemblyManifestEntry } from '../assembly-engine.js';
+import '../assembly-resolvers.js';
+/** Assembled directive content paired with its per-source attribution manifest. */
+export interface AssembledDirective {
+    content: string;
+    manifest: AssemblyManifestEntry[];
+}
+/**
+ * Assemble directive content from a StageDirective's recipe and prompt.
+ * Shared by both inject and spawn modes, and by focus-executor for
+ * initial spawn with a stage directive.
+ */
+export declare function assembleDirectiveContent(config: DaemonConfig, focusId: string, directive: StageDirective, worktreePath: string | null): Promise<string>;
+/**
+ * Assemble directive content AND return the assembly manifest (one entry per
+ * recipe source). The composed `content` is identical to
+ * assembleDirectiveContent; the manifest lets the spawn path persist what
+ * context was injected. The manifest covers ONLY the assembly recipe -- the
+ * static directive.prompt / tool guidance are not assembly sources.
+ */
+export declare function assembleDirectiveContentWithManifest(config: DaemonConfig, focusId: string, directive: StageDirective, worktreePath: string | null): Promise<AssembledDirective>;
+//# sourceMappingURL=directive-assembly.d.ts.map

package/dist/directive/directive-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-assembly.d.ts","sourceRoot":"","sources":["../../src/directive/directive-assembly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,0BAA0B,CAAC;AAGlC,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;GAMG;AACH,wBAAsB,oCAAoC,CACxD,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAiD7B"}

package/dist/directive/directive-assembly.js

@@ -0,0 +1,77 @@
+/**
+ * Directive assembly: compose a stage directive's deliverable content.
+ *
+ * Resolves the directive's assembly recipe (via assembly-engine + the
+ * registered source resolvers) and appends the static prompt + tool guidance.
+ * Shared by both inject and spawn dispatch modes, by the close-loop
+ * dispatcher, and by focus-executor for initial spawn with a stage directive.
+ * Extracted from directive-executor.ts; the executor re-exports the public
+ * surface so existing importers are unaffected.
+ */
+import { resolveAssemblyRecipeWithManifest, } from '../assembly-engine.js';
+// Side-effect import: registers assembly resolvers with assembly-engine at module load. Required - do not remove.
+import '../assembly-resolvers.js';
+import { getFocusDeliveries } from '../queries/focuses.js';
+/**
+ * Assemble directive content from a StageDirective's recipe and prompt.
+ * Shared by both inject and spawn modes, and by focus-executor for
+ * initial spawn with a stage directive.
+ */
+export async function assembleDirectiveContent(config, focusId, directive, worktreePath) {
+    const { content } = await assembleDirectiveContentWithManifest(config, focusId, directive, worktreePath);
+    return content;
+}
+/**
+ * Assemble directive content AND return the assembly manifest (one entry per
+ * recipe source). The composed `content` is identical to
+ * assembleDirectiveContent; the manifest lets the spawn path persist what
+ * context was injected. The manifest covers ONLY the assembly recipe -- the
+ * static directive.prompt / tool guidance are not assembly sources.
+ */
+export async function assembleDirectiveContentWithManifest(config, focusId, directive, worktreePath) {
+    const recipe = [...directive.assembly];
+    let assembledContext = '';
+    let manifest = [];
+    if (recipe.length > 0) {
+        try {
+            const deliveries = await getFocusDeliveries(focusId);
+            const assemblyContext = {
+                focusId,
+                deliveryIds: deliveries.map(d => d.id),
+                worktreePath,
+                config,
+                organizationId: config.organizationId,
+                productId: config.productId,
+            };
+            const resolved = await resolveAssemblyRecipeWithManifest(recipe, assemblyContext);
+            assembledContext = resolved.content;
+            manifest = resolved.manifest;
+        }
+        catch (err) {
+            console.warn(`[directive-executor] Assembly resolution failed for focus ${focusId.slice(0, 8)}: ${err.message}`);
+        }
+    }
+    const parts = [];
+    if (assembledContext.trim()) {
+        parts.push(assembledContext);
+    }
+    if (directive.prompt) {
+        parts.push(directive.prompt);
+    }
+    if (directive.tools) {
+        const toolLines = ['## Tool Guidance', ''];
+        if (directive.tools.include.length > 0) {
+            toolLines.push(`**Preferred tools:** ${directive.tools.include.join(', ')}`);
+        }
+        if (directive.tools.discouraged.length > 0) {
+            toolLines.push(`**Discouraged tools:** ${directive.tools.discouraged.join(', ')}`);
+        }
+        if (directive.tools.guidance) {
+            toolLines.push('');
+            toolLines.push(directive.tools.guidance);
+        }
+        parts.push(toolLines.join('\n'));
+    }
+    return { content: parts.join('\n\n'), manifest };
+}
+//# sourceMappingURL=directive-assembly.js.map

package/dist/directive/directive-assembly.js.map

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

package/dist/directive/directive-dispatch.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Directive dispatch: execute a stage directive against a focus.
+ *
+ * Resolves the directive's execution mode, then dispatches: inject mode
+ * writes /compact + assembled content to the live team's stdin; spawn mode
+ * terminates the current team and stashes a PendingSpawnDirective for the
+ * next spawn cycle. Also holds the bounded-retry runner + the escalation
+ * path for exhausted retries. Extracted from directive-executor.ts; the
+ * executor re-exports the public surface so existing importers are
+ * unaffected.
+ */
+import type { DaemonConfig, StageDirective, DirectiveExecutionMode } from '../types.js';
+import { type LineageSpec } from '../session-lineage.js';
+import { createEscalation } from '../queries/issues.js';
+/**
+ * Resolve the execution mode a directive should dispatch under.
+ *
+ * Pure + exported for testing. The rule:
+ *   - A valid mode ('inject' | 'spawn') passes through unchanged.
+ *   - A review-lineage directive whose execution is missing/invalid defaults
+ *     to 'spawn'. Review always spawns a fresh team, so 'spawn' is the only
+ *     sensible mode for that lineage; defaulting here self-heals malformed or
+ *     seed-drifted review directives (e.g. the focus 'review' stage whose
+ *     agent_directive lost its execution field -- see the backfill migration)
+ *     so the review-spawn path can no longer be silently stranded.
+ *   - Anything else is UNRESOLVABLE (returns null). The caller treats null as
+ *     a fail-loud condition (throw -> escalate + loop trigger) rather than a
+ *     silent no-op.
+ *
+ * Note: a review-lineage directive defaults to spawn even for a non-empty but
+ * unrecognized execution value -- review is always spawnable, so we self-heal
+ * rather than fail. Non-review lineages have no safe default and fail loud.
+ */
+export declare function resolveDirectiveExecutionMode(execution: string | null | undefined, lineage: string): DirectiveExecutionMode | null;
+/**
+ * Execute a stage directive for a focus.
+ *
+ * inject mode: sends /compact + assembled context + prompt to the active team's stdin.
+ * spawn mode: terminates the current team, assembles directive content, stores for respawn.
+ *
+ * When the directive's execution mode cannot be resolved to a valid mode
+ * (see resolveDirectiveExecutionMode), this THROWS instead of silently
+ * no-oping. The throw propagates through runDirectiveWithRetry in
+ * checkDirectives, which escalates and emits a loop trigger -- so a malformed
+ * directive surfaces a signal instead of stranding the focus.
+ *
+ * Exported for testing.
+ */
+export declare function executeDirective(config: DaemonConfig, focusId: string, directive: StageDirective, focusWorkflowStageId: string, stageName?: string): Promise<void>;
+/**
+ * Inject mode: send /compact + assembled context + prompt to the active team's stdin.
+ */
+export declare function executeInjectDirective(config: DaemonConfig, focusId: string, directive: StageDirective, sessionType?: 'coding' | 'review', spec?: LineageSpec): Promise<void>;
+/**
+ * Result of a bounded-retry attempt to run a directive. The retry is on
+ * ANY thrown error (assembly resolver throws, fetch failures, Supabase
+ * timeouts) -- broader than `withRetry` from daemon-core, which classifies
+ * by error type. Transient failures during directive execution are not
+ * always classified as network errors, but they're still worth retrying
+ * before treating as permanent.
+ */
+export interface DirectiveRunResult {
+    /** Whether the directive ran to completion within the retry bound. */
+    ok: boolean;
+    /** Number of attempts made (1 = first attempt succeeded). */
+    attempts: number;
+    /** Last error if the retry bound was exhausted, null on success. */
+    error: Error | null;
+}
+export interface RunDirectiveOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    label: string;
+    /** Sleep implementation -- override in tests to avoid real delays. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Called once per failed attempt before the backoff sleep. */
+    onAttemptFailed?: (attempt: number, error: Error) => void;
+}
+/**
+ * Run a directive function with bounded retry and exponential backoff.
+ * Returns a result tuple instead of throwing so the caller can decide
+ * whether to escalate or continue.
+ */
+export declare function runDirectiveWithRetry(fn: () => Promise<void>, options: RunDirectiveOptions): Promise<DirectiveRunResult>;
+/**
+ * Escalate when bounded retry of a stage directive is exhausted.
+ *
+ * Visible signal so operators can find which focus + stage failed and
+ * why, instead of a buried console.warn. Mirrors escalatePlanningFailure
+ * from focus-completion-event.ts.
+ */
+export declare function escalateDirectiveFailure(params: {
+    organizationId: string;
+    sessionId: string;
+    focusId: string;
+    focusName: string;
+    stageName: string | undefined;
+    error: Error;
+    attempts: number;
+}, deps?: {
+    createEscalation: typeof createEscalation;
+}): Promise<void>;
+//# sourceMappingURL=directive-dispatch.d.ts.map

package/dist/directive/directive-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-dispatch.d.ts","sourceRoot":"","sources":["../../src/directive/directive-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAWxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,GACd,sBAAsB,GAAG,IAAI,CAI/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,EACzB,oBAAoB,EAAE,MAAM,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,EACzB,WAAW,GAAE,QAAQ,GAAG,QAAmB,EAC3C,IAAI,GAAE,WAA+E,GACpF,OAAO,CAAC,IAAI,CAAC,CAyEf;AA8ED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,EAAE,EAAE,OAAO,CAAC;IACZ,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC3D;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAuB7B;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,EACD,IAAI,GAAE;IAAE,gBAAgB,EAAE,OAAO,gBAAgB,CAAA;CAAyB,GACzE,OAAO,CAAC,IAAI,CAAC,CAsCf"}