@telora/daemon 0.22.245 → 0.22.290

package/dist/completion/event-entry-phases.js

@@ -1,261 +0,0 @@
-// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: none -- no test imports this module directly (baselined; see lint:pinned-by)
-// PINNED-BY-END
-import { DELIVERY_STATUS } from '@telora/daemon-core';
-import { isStatusCascadable, isStatusAgentActionable } from '../workflow/stage-classifier.js';
-import { isInReviewWindow } from './advanceability.js';
-import { escalatePlanningFailure } from './event-escalations.js';
-import { resolveFocusAuditPhase } from './event-phases.js';
-import { markFocusIdleComplete } from './team-phase.js';
-import { resolveTeamActionableWork, deliveriesWithTeamWork, focusHasTeamWork } from '../focus/team-actionable-work.js';
-import { armFactsFromTeamState, deliveriesVisibleToArm } from '../focus/recorded-new-intent.js';
-import { isWorktreeUnderVerify as defaultIsWorktreeUnderVerify } from '../worktree/verify-interlock.js';
-import { createLogger } from '../shell/log.js';
-const log = createLogger({ module: 'focus-executor' });
-// ── Phase 1: planning refresh ───────────────────────────────────────────
-/**
- * Wake-cycle refresh (Option A): planning teams spawn with knownDeliveryIds
- * empty. The MCP-driven planning turn writes deliveries to the DB, so we
- * re-snapshot them here before any downstream merge/completion logic looks
- * at the set. WHY Option A: keeps the refresh on the existing wake path
- * instead of polling, so it runs exactly when new deliveries become visible.
- *
- * Returns true when the team was terminated (planning produced nothing).
- */
-export async function applyPlanningRefresh(ctx, deps, currentDeliveries) {
-    const { focusId, focusName, teamState } = ctx;
-    if (!teamState.planningPhase)
-        return false;
-    if (currentDeliveries.length === 0) {
-        log.warn(`Planning team for "${focusName}" produced no deliveries ` +
-            `-- escalating and terminating`);
-        await escalatePlanningFailure({
-            organizationId: teamState.organizationId,
-            sessionId: teamState.leadSessionId ?? '',
-            focusId,
-            focusName,
-            agentRoleId: teamState.roleId,
-        }, deps);
-        teamState.shutdownReason = 'work_complete';
-        deps.terminateTeam(focusId);
-        return true;
-    }
-    for (const d of currentDeliveries) {
-        teamState.knownDeliveryIds.add(d.id);
-        teamState.deliveryStageIds.set(d.id, d.currentWorkflowStageId);
-    }
-    teamState.planningPhase = false;
-    log.info(`Planning refresh for "${focusName}": ` +
-        `${currentDeliveries.length} delivery(ies) discovered`);
-    return false;
-}
-/**
- * Review-window handling. Resolves review_requested_at FRESH because it can
- * be set/cleared between spawn and this event.
- *
- * - A completing REVIEW pass routes verify deliveries deterministically
- *   (runReviewExitHandler) and terminates -> 'terminated'.
- * - A completing CODING pass that returned NO agent-actionable work is torn
- *   down so the queued review pass can spawn -> 'terminated'.
- * - A completing CODING pass that still has agent-actionable work is left
- *   alive -> 'leave_running' (the iterator records a bounded
- *   review_window_keep_alive session hold for it).
- * - Otherwise -> 'not_in_review' and the pipeline continues.
- */
-export async function routeReviewWindowCompletion(ctx, deps, currentDeliveries, currentIssues) {
-    let reviewRequestedAt = null;
-    if (deps.getReviewRequestedAt) {
-        try {
-            reviewRequestedAt = await deps.getReviewRequestedAt(ctx.config, ctx.focusId);
-        }
-        catch (err) {
-            log.warn(`getReviewRequestedAt failed for "${ctx.focusName}": ${err.message}`);
-            // Fail open: a read failure must not block the existing teardown logic.
-        }
-    }
-    if (!isInReviewWindow(reviewRequestedAt, currentDeliveries))
-        return 'not_in_review';
-    const verifyCount = currentDeliveries.filter(d => d.executionStatus === DELIVERY_STATUS.VERIFY).length;
-    if (ctx.teamState.sessionType === 'review') {
-        await routeCompletedReviewPass(ctx, deps, verifyCount);
-        return 'terminated';
-    }
-    return routeCodingPassInReviewWindow(ctx, deps, currentDeliveries, currentIssues, verifyCount);
-}
-/**
- * A REVIEW pass just completed -- it emitted its result, which IS the "a review
- * cycle ran" signal. Close the focus DETERMINISTICALLY now, keyed on THIS
- * completion event rather than on process exit. A review resumes its prior
- * session to preserve context (INJ-D) and runs as an interactive stream-json
- * process that emits a result but never exits; the old exit-keyed close
- * therefore waited forever (the review-resume deadlock). runReviewExitHandler
- * routes verify deliveries by the deterministic signal -- a pass that filed zero
- * new issues and has no open work closes verify->done; open work routes
- * verify->verify_failed to re-iterate -- and clears review_requested_at. The
- * review team is then torn down: closure has ALREADY happened, so it no longer
- * matters whether the process exits cleanly or is SIGTERM'd, and the next review
- * cycle resumes the same session id to review only the new delta.
- *
- * succeeded is the ACTUAL result of the review turn (!isError), NOT a hardcoded
- * true. A review that erred (e.g. the CLI failed to start, or a model/engine
- * mismatch) emits a result event with isError=true and files no defects -- the
- * old `succeeded: true` made that indistinguishable from a genuinely clean
- * review, so an errored/no-op review auto-approved verify->done WITHOUT a real
- * review. With the real flag, an errored review leaves the delivery in verify;
- * the next auto-review poll re-triggers, and a persistently failing review is
- * bounded by the review_window_stalled escalation.
- */
-async function routeCompletedReviewPass(ctx, deps, verifyCount) {
-    const { focusId, focusName, teamState } = ctx;
-    const reviewSucceeded = !ctx.completionInfo.result.isError;
-    log.info(`Review pass completed for "${focusName}" (${verifyCount} ` +
-        `delivery(ies) in verify, succeeded=${reviewSucceeded}) -- routing deterministically ` +
-        `by filed issues, then terminating.`);
-    // Coverage evidence: spawn-tip (what the review saw, carried on the team
-    // state) is stamped as the watermark; exit-tip (HEAD now) is compared to it
-    // to detect mid-review drift. Exit-tip best-effort via injected git deps.
-    const reviewSpawnTip = teamState.reviewSpawnTip;
-    let currentBranchTip = null;
-    try {
-        const wt = deps.getFocusWorktree?.(focusId);
-        if (wt?.worktreePath) {
-            currentBranchTip = deps.readWorktreeHeadSha?.(wt.worktreePath) ?? null;
-        }
-    }
-    catch (err) {
-        log.warn(`Could not resolve exit-tip for "${focusName}" coverage gate: ${err.message}`);
-    }
-    try {
-        await deps.runReviewExitHandler({
-            focusId,
-            focusName,
-            organizationId: teamState.organizationId,
-            productId: teamState.productId,
-            sessionId: teamState.leadSessionId ?? '',
-            sessionType: 'review',
-            succeeded: reviewSucceeded,
-            reviewSpawnTip,
-            currentBranchTip,
-            reviewPriorWatermark: teamState.reviewPriorWatermark,
-        });
-    }
-    catch (err) {
-        log.warn(`Deterministic review routing failed for "${focusName}": ${err.message}`);
-    }
-    teamState.shutdownReason = 'work_complete';
-    deps.terminateTeam(focusId);
-}
-/**
- * Does the completing coding pass still own work it could act on? The same two
- * kinds of work computeCompletionFacts counts -- a planning delivery to scope
- * (not on an audit-phase focus, where planning awaits ratification) or an open
- * issue on an agent-actionable delivery -- folded through the ONE shared
- * actionable-work predicate, so a verify hold withholds only the verified
- * delivery and an outstanding merge-conflict resolution counts as work.
- */
-async function codingPassHasTeamActionableWork(ctx, deps, deliveries, issues) {
-    // The ONE team-work predicate (focus/team-actionable-work.ts). A delivery
-    // RECORDED as new intent under this focus's live arm is not work this pass
-    // owes: the record/queue rule refuses to queue it, so counting it here
-    // re-presents work the team is structurally unable to satisfy.
-    const workDeliveries = deliveriesWithTeamWork(deliveries, issues, {
-        armFacts: armFactsFromTeamState(ctx.teamState),
-        planningIsWork: true,
-    });
-    const hasOpenWork = workDeliveries.some(d => d.executionStatus !== DELIVERY_STATUS.PLANNING);
-    const hasPlanningDelivery = workDeliveries.some(d => d.executionStatus === DELIVERY_STATUS.PLANNING);
-    const hasPlanning = hasPlanningDelivery && !(await resolveFocusAuditPhase(ctx, deps));
-    return resolveTeamActionableWork({
-        focusWorktreePath: deps.getFocusWorktree?.(ctx.focusId)?.worktreePath ?? null,
-        hasUnheldActionableWork: hasOpenWork || hasPlanning,
-        isWorktreeUnderVerify: deps.isWorktreeUnderVerify ?? defaultIsWorktreeUnderVerify,
-        outsideHold: { deliveries, issues, verifyHeldDeliveryIds: deps.verifyHeldDeliveryIds },
-        mergeResolutionOutstanding: ctx.teamState.resolvingMergeConflict,
-    }).teamHasActionableWork;
-}
-/**
- * A non-review (coding) team completed a cycle while a review is in flight.
- *
- * With agent-actionable work left it is KEPT ('leave_running'): the all-terminal
- * / no-actionable-work branches below would otherwise SIGTERM it mid-work,
- * because `verify` is cascadable. The keep is bounded by the
- * review_window_keep_alive session hold the iterator records.
- *
- * With NO agent-actionable work it is torn down. Keeping it was the 2026-09-15
- * deadlock: the idle lead waited for the review pass, and the queued review
- * directive waited for the lead to exit, until an operator killed the lead. The
- * shutdown reason mirrors teardownNoActionableWork: 'work_complete' when every
- * delivery is terminal-for-the-team (a clean completion records NO spawn
- * cooldown, so the queued review directive spawns on the next poll), otherwise
- * the honest 'no_actionable_work' (a controlled stop that accrues the
- * respawn-cycle streak, so a hold that never clears is bounded by it).
- */
-async function routeCodingPassInReviewWindow(ctx, deps, deliveries, issues, verifyCount) {
-    const { focusId, focusName, teamState } = ctx;
-    if (await codingPassHasTeamActionableWork(ctx, deps, deliveries, issues)) {
-        log.info(`"${focusName}" is in a review window (review_requested_at set, ` +
-            `${verifyCount} delivery(ies) in verify) and the completing ${teamState.sessionType} pass still has ` +
-            `agent-actionable work -- not tearing down (bounded by a review_window_keep_alive session hold); ` +
-            `the review pass completion routes the verify deliveries.`);
-        return 'leave_running';
-    }
-    const nonTerminal = deliveries.filter(d => !isStatusCascadable(d.executionStatus ?? ''));
-    log.info(`Completing ${teamState.sessionType} pass for "${focusName}" returned no agent-actionable work in a ` +
-        `review window (${verifyCount} delivery(ies) in verify, ${nonTerminal.length} non-terminal) -- ` +
-        `tearing down so the queued review pass can spawn`);
-    if (nonTerminal.length === 0)
-        markFocusIdleComplete(focusId);
-    teamState.shutdownReason = nonTerminal.length === 0 ? 'work_complete' : 'no_actionable_work';
-    deps.terminateTeam(focusId);
-    return 'terminated';
-}
-// ── Phase 3: wake-cycle self-heal advance ───────────────────────────────
-/**
- * Self-heal BEFORE the no-progress guard. When actionable deliveries exist
- * but none carry open issues, the team has nothing left to code. The common
- * cause is a review that bounced a delivery to verify_failed while all its
- * issues are already Done. The daemon's transparent
- * verify_failed -> coding -> verify stepping (advanceDeliveryStatuses) clears
- * that. Running it here -- before snapshotting -- means a benign "no work to
- * do" cycle either terminates the team cleanly (all deliveries now terminal)
- * or shows up as real progress (the delivery status moved), instead of being
- * counted as coder no-progress. Either way it can no longer accrue toward a
- * spurious team_failure escalation. (Previously this advance ran only AFTER
- * the guard, so the counter could reach the limit and escalate first.)
- */
-export async function runWakeCycleSelfHeal(ctx, deps, currentDeliveries, currentIssues) {
-    const { focusId, focusName, teamState } = ctx;
-    const actionableDeliveryIds = new Set(currentDeliveries
-        .filter(d => isStatusAgentActionable(d.executionStatus ?? ''))
-        .map(d => d.id));
-    const hasActionableWithOpenIssues = focusHasTeamWork(currentDeliveries, currentIssues, { planningIsWork: false });
-    let effectiveDeliveries = currentDeliveries;
-    if (actionableDeliveryIds.size > 0 && !hasActionableWithOpenIssues) {
-        try {
-            await deps.advanceDeliveryStatuses(ctx.config, teamState, teamState.leadSessionId ?? '');
-        }
-        catch (err) {
-            log.warn(`Wake-cycle advanceDeliveryStatuses failed for "${focusName}": ${err.message}`);
-        }
-        // Re-fetch and re-check termination after the advance -- if every delivery
-        // is now terminal-for-the-team, exit cleanly and hand off to review
-        // routing / verification instead of sending a stale re-engagement.
-        try {
-            effectiveDeliveries = await deps.getFocusDeliveries(focusId);
-            // A recorded delivery must not keep the team from terminating cleanly:
-            // it is not work under this arm, so it cannot be "still non-terminal".
-            const stillNonTerminal = deliveriesVisibleToArm(effectiveDeliveries, armFactsFromTeamState(teamState)).filter(d => !isStatusCascadable(d.executionStatus ?? ''));
-            if (stillNonTerminal.length === 0) {
-                log.info(`All deliveries terminal after wake-cycle advance for "${focusName}" -- terminating team`);
-                teamState.shutdownReason = 'work_complete';
-                deps.terminateTeam(focusId);
-                return { terminated: true, effectiveDeliveries };
-            }
-        }
-        catch (err) {
-            log.warn(`Failed to re-fetch deliveries after wake-cycle advance for "${focusName}": ${err.message}`);
-        }
-    }
-    return { terminated: false, effectiveDeliveries };
-}
-//# sourceMappingURL=event-entry-phases.js.map

package/dist/completion/event-entry-phases.js.map

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

package/dist/completion/event-escalations.d.ts

@@ -1,159 +0,0 @@
-/**
- * Escalation builders for the completion event handler.
- *
- * The three human-signal paths handleCompletionEvent (event.ts) can take
- * when a team cannot make progress: a planning team that scoped nothing, a
- * team re-engaged past the no-progress limit, and a structurally
- * non-advanceable delivery (the respawn-thrash guard). Extracted from
- * completion/event.ts; bodies verbatim; event.ts re-exports the surface.
- */
-import type { FocusDeliveryInfo } from '../types/index.js';
-import { type CreateEscalationParams } from '../queries/escalations.js';
-/**
- * Pure: is this gate_state a LIVE block -- a failing guard verdict, or a hold
- * (operatorHold / externalHold / undisposed shortfallProposalIds)? A HISTORY-ONLY
- * gate_state (verification history carried beside an empty `blocking` by
- * queries/delivery-gate-state.ts carryVerificationHistory) is not a block, so it
- * never classifies a delivery as gate-stuck. Exported for test.
- */
-export declare function hasLiveGateBlock(gateState: unknown): boolean;
-/** Reason string emitted when a planning team produces no deliveries. */
-export declare const PLANNING_NO_DELIVERIES_REASON = "planning produced no deliveries";
-/** Reason string emitted when re-engagement is bounded by no-progress limit. */
-export declare const NO_PROGRESS_ESCALATION_REASON = "team unable to make progress on remaining deliveries";
-/**
- * Reason string emitted when the team has no actionable work AND a remaining
- * non-terminal delivery cannot be advanced by the daemon either -- a structural
- * dead end (missing workflow stage / no automatic transition out). Filed once,
- * never re-fired, so the focus stops thrashing spawn->idle-exit->respawn.
- */
-export declare const NON_ADVANCEABLE_ESCALATION_REASON = "delivery cannot be advanced and the team has no actionable work";
-/**
- * Cause discriminator stamped on the escalation metadata. The escalation_kind
- * stays 'team_failure' (a value the agent_escalations CHECK constraint already
- * accepts AND that the existing respawn guard -- hasOpenTeamFailureEscalation /
- * applyRespawnGuard -- already suppresses), so no migration is required and
- * respawn suppression composes for free. metadata.cause distinguishes this
- * structural dead-end from a genuine effort-based no-progress failure during
- * triage.
- */
-export declare const NON_ADVANCEABLE_CAUSE = "non_advanceable_delivery";
-export declare const DELIVERY_ADVANCEMENT_STALLED_REASON = "successful focus-team cycles made zero delivery advancement";
-export declare const DELIVERY_ADVANCEMENT_STALLED_CAUSE = "delivery_advancement_stalled";
-/** The single dependency these builders need; structurally matches CompletionEventDeps. */
-export interface EscalationDeps {
-    createEscalation: (params: CreateEscalationParams) => Promise<{
-        escalationId: string | null;
-    } | void>;
-}
-/**
- * Escalate when a planning team finishes its initial turn without writing
- * any deliveries via MCP. The team is then terminated -- no respawn.
- *
- * Exported so tests and sister deliveries can verify the contract.
- */
-export declare function escalatePlanningFailure(params: {
-    organizationId: string;
-    sessionId: string;
-    focusId: string;
-    focusName: string;
-    agentRoleId: string;
-}, deps?: EscalationDeps): Promise<void>;
-/**
- * Whether the stalled lead's STATED cause names a genuine human decision -- a
- * change to WHAT gets built (scope / requirement / priority / product
- * direction) -- as opposed to a machine-remediable blocker (a missing
- * capability the incoming team can supply). Absent a stated cause it returns
- * false, so a no-progress stall DEFAULTS to machine ownership: the human inbox
- * receives it only on positive evidence, never as the reflexive default.
- *
- * This is the CATEGORY-3 (intent judgment) facet of the broader
- * `namesHumanOnlyAct` filing-boundary classifier; it delegates to
- * `namesIntentJudgment` so the two share one regex and cannot drift.
- */
-export declare function statedCauseNeedsIntent(statedCause: string | undefined): boolean;
-/**
- * Gate a DAEMON-generated filing's human-owning disposition on the human-only-act
- * test -- the SAME evidence gate the MCP filing boundary applies to hand-filed
- * escalations (humanOwningWithoutHumanActRefusal), now carried to the daemon's own
- * filings. A needs_operator / needs_intent / needs_clarification / external_wait
- * disposition is admissible only when the filing's own text (its helpNeeded -- what
- * it asks the human to do) names an act only a human/operator can supply: authority,
- * information, an intent judgment, a physical act, or operation of the running
- * daemon / verify gate / workflow wiring the sandboxed worktree cannot reach. A
- * daemon filing that names none is returned to the machine lane (agent_resolvable)
- * rather than reaching an operator inbox that can only wait on it; a non-human-owning
- * disposition passes through unchanged.
- *
- * This closes "every escalation reaching the operator inbox names something the
- * operator alone can supply" for the daemon-generated source, not just the
- * hand-filed one. In steady state every structural daemon filing already names its
- * operator/intent act (planning + non-advanceable name intent/scope; a gate-stuck or
- * advancement-stalled filing names the gate/daemon-loop), so this is a defense-in-depth
- * invariant rather than a behavior change -- it exists so a FUTURE daemon filing cannot
- * silently PROPOSE a human owner without naming what only a human can do. What it
- * returns is a proposal: the createEscalation chokepoint still sends any human-owning
- * disposition to the machine lane as an observation, and only the routing decider
- * agent (or a coding team, via MCP escalate) makes a filing human-facing. Exported for test.
- */
-export declare function gateDaemonHumanOwningDisposition(disposition: string, evidenceText: string | undefined): string;
-/**
- * Escalate when the team has been re-engaged repeatedly without making
- * any measurable progress on the remaining non-terminal deliveries.
- *
- * Exported so tests can verify the contract.
- */
-export declare function escalateNoProgress(params: {
-    organizationId: string;
-    sessionId: string;
-    focusId: string;
-    focusName: string;
-    agentRoleId: string;
-    cycles: number;
-    remaining: FocusDeliveryInfo[];
-    /**
-     * The stalled lead's own stated cause (its exit summary), when available.
-     * Read to decide whether a NON-gate-stuck stall genuinely needs the intent
-     * owner; absent, the stall defaults to machine ownership (agent_resolvable).
-     */
-    statedCause?: string;
-}, deps?: EscalationDeps): Promise<void>;
-/**
- * Escalate when the team has no actionable work AND a remaining non-terminal
- * delivery is structurally non-advanceable (NULL workflow stage, or no
- * automatic transition out of its current stage). This is the thrash-guard:
- * without it the focus respawns a team every poll that immediately idle-exits,
- * burning budget unbounded.
- *
- * Filed as escalation_kind 'team_failure' so the existing respawn guard
- * (hasOpenTeamFailureEscalation / applyRespawnGuard) suppresses respawn until a
- * human resolves it. metadata.cause = NON_ADVANCEABLE_CAUSE distinguishes it
- * from an effort-based no-progress failure during triage.
- *
- * Exported so tests and sister deliveries can verify the contract.
- */
-export declare function escalateNonAdvanceable(params: {
-    organizationId: string;
-    sessionId: string;
-    focusId: string;
-    focusName: string;
-    agentRoleId: string;
-    stuck: FocusDeliveryInfo;
-    remaining: FocusDeliveryInfo[];
-}, deps?: EscalationDeps): Promise<void>;
-/**
- * Escalate when successful team cycles keep completing without any delivery
- * execution_status movement. Filed as team_failure so the existing respawn
- * guard suppresses further spawns, but routed needs_operator because this is a
- * daemon-loop failure signal rather than a scoping decision for the intent owner.
- */
-export declare function escalateDeliveryAdvancementStalled(params: {
-    organizationId: string;
-    sessionId: string;
-    focusId: string;
-    focusName: string;
-    agentRoleId: string;
-    cycles: number;
-    deliveries: FocusDeliveryInfo[];
-}, deps?: EscalationDeps): Promise<void>;
-//# sourceMappingURL=event-escalations.d.ts.map

package/dist/completion/event-escalations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-escalations.d.ts","sourceRoot":"","sources":["../../src/completion/event-escalations.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAA+C,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAQrH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAM5D;AAGD,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,oCAAoC,CAAC;AAE/E,gFAAgF;AAChF,eAAO,MAAM,6BAA6B,yDACc,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,oEACqB,CAAC;AAEpE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAEhE,eAAO,MAAM,mCAAmC,gEACe,CAAC;AAEhE,eAAO,MAAM,kCAAkC,iCAAiC,CAAC;AAEjF,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACvG;AAMD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,EACD,IAAI,GAAE,cAAsC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE/E;AAUD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,IAAI,GAAE,cAAsC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAqIf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC,EACD,IAAI,GAAE,cAAsC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAmFf;AAED;;;;;GAKG;AACH,wBAAsB,kCAAkC,CACtD,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC,EACD,IAAI,GAAE,cAAsC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAmEf"}