@jaggerxtrm/specialists 3.9.0 → 3.10.0

package/dist/types/specialist/node-contract.d.ts

@@ -0,0 +1,343 @@
+import * as z from 'zod';
+export declare const BARRIER_TYPES: readonly ["all_members_terminal"];
+export declare const NODE_COMPLETION_STRATEGIES: readonly ["pr", "manual"];
+export declare const NODE_BASE_BRANCH_DEFAULT = "master";
+export declare const NODE_SUPERVISOR_MAX_RETRIES_DEFAULT = 3;
+export declare const phaseKindSchema: z.ZodEnum<["explore", "design", "impl", "review", "fix", "re_review", "custom"]>;
+export declare const PHASE_KINDS: z.Values<["explore", "design", "impl", "review", "fix", "re_review", "custom"]>;
+export declare const actionTypeSchema: z.ZodEnum<["spawn_member", "create_bead", "complete_node"]>;
+export declare const ACTION_TYPES: {
+    readonly SPAWN_MEMBER: "spawn_member";
+    readonly CREATE_BEAD: "create_bead";
+    readonly COMPLETE_NODE: "complete_node";
+};
+export declare const completionStrategySchema: z.ZodEnum<["pr", "manual"]>;
+export declare const memberSpawnSchema: z.ZodObject<{
+    member_key: z.ZodString;
+    role: z.ZodString;
+    bead_id: z.ZodString;
+    scope: z.ZodObject<{
+        paths: z.ZodArray<z.ZodString, "many">;
+        mutates: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        paths: string[];
+        mutates: boolean;
+    }, {
+        paths: string[];
+        mutates: boolean;
+    }>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    failure_policy: z.ZodEnum<["blocking", "non_blocking"]>;
+    isolated: z.ZodDefault<z.ZodBoolean>;
+    retry_of: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    scope: {
+        paths: string[];
+        mutates: boolean;
+    };
+    role: string;
+    bead_id: string;
+    member_key: string;
+    depends_on: string[];
+    failure_policy: "blocking" | "non_blocking";
+    isolated: boolean;
+    retry_of: string | null;
+}, {
+    scope: {
+        paths: string[];
+        mutates: boolean;
+    };
+    role: string;
+    bead_id: string;
+    member_key: string;
+    failure_policy: "blocking" | "non_blocking";
+    depends_on?: string[] | undefined;
+    isolated?: boolean | undefined;
+    retry_of?: string | null | undefined;
+}>;
+export declare const phaseSchema: z.ZodObject<{
+    phase_id: z.ZodString;
+    phase_kind: z.ZodEnum<["explore", "design", "impl", "review", "fix", "re_review", "custom"]>;
+    barrier: z.ZodLiteral<"all_members_terminal">;
+    members: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        member_key: z.ZodString;
+        role: z.ZodString;
+        bead_id: z.ZodString;
+        scope: z.ZodObject<{
+            paths: z.ZodArray<z.ZodString, "many">;
+            mutates: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            paths: string[];
+            mutates: boolean;
+        }, {
+            paths: string[];
+            mutates: boolean;
+        }>;
+        depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        failure_policy: z.ZodEnum<["blocking", "non_blocking"]>;
+        isolated: z.ZodDefault<z.ZodBoolean>;
+        retry_of: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        scope: {
+            paths: string[];
+            mutates: boolean;
+        };
+        role: string;
+        bead_id: string;
+        member_key: string;
+        depends_on: string[];
+        failure_policy: "blocking" | "non_blocking";
+        isolated: boolean;
+        retry_of: string | null;
+    }, {
+        scope: {
+            paths: string[];
+            mutates: boolean;
+        };
+        role: string;
+        bead_id: string;
+        member_key: string;
+        failure_policy: "blocking" | "non_blocking";
+        depends_on?: string[] | undefined;
+        isolated?: boolean | undefined;
+        retry_of?: string | null | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    phase_id: string;
+    phase_kind: "review" | "custom" | "explore" | "design" | "impl" | "fix" | "re_review";
+    barrier: "all_members_terminal";
+    members: {
+        scope: {
+            paths: string[];
+            mutates: boolean;
+        };
+        role: string;
+        bead_id: string;
+        member_key: string;
+        depends_on: string[];
+        failure_policy: "blocking" | "non_blocking";
+        isolated: boolean;
+        retry_of: string | null;
+    }[];
+}, {
+    phase_id: string;
+    phase_kind: "review" | "custom" | "explore" | "design" | "impl" | "fix" | "re_review";
+    barrier: "all_members_terminal";
+    members?: {
+        scope: {
+            paths: string[];
+            mutates: boolean;
+        };
+        role: string;
+        bead_id: string;
+        member_key: string;
+        failure_policy: "blocking" | "non_blocking";
+        depends_on?: string[] | undefined;
+        isolated?: boolean | undefined;
+        retry_of?: string | null | undefined;
+    }[] | undefined;
+}>;
+export declare const createBeadActionSchema: z.ZodObject<{
+    type: z.ZodEnum<["create_bead"]>;
+    title: z.ZodString;
+    description: z.ZodString;
+    bead_type: z.ZodEnum<["task", "bug", "feature", "epic", "chore", "decision"]>;
+    priority: z.ZodNumber;
+    parent_bead_id: z.ZodOptional<z.ZodString>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    type: "create_bead";
+    title: string;
+    priority: number;
+    depends_on: string[];
+    bead_type: "task" | "decision" | "epic" | "bug" | "feature" | "chore";
+    parent_bead_id?: string | undefined;
+}, {
+    description: string;
+    type: "create_bead";
+    title: string;
+    priority: number;
+    bead_type: "task" | "decision" | "epic" | "bug" | "feature" | "chore";
+    depends_on?: string[] | undefined;
+    parent_bead_id?: string | undefined;
+}>;
+export declare const completeNodeActionSchema: z.ZodObject<{
+    type: z.ZodEnum<["complete_node"]>;
+    gate_results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        gate: z.ZodString;
+        status: z.ZodEnum<["pass", "fail", "skip"]>;
+        details: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pass" | "fail" | "skip";
+        gate: string;
+        details?: string | undefined;
+    }, {
+        status: "pass" | "fail" | "skip";
+        gate: string;
+        details?: string | undefined;
+    }>, "many">>;
+    report_payload_ref: z.ZodString;
+    force_draft_pr: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "complete_node";
+    gate_results: {
+        status: "pass" | "fail" | "skip";
+        gate: string;
+        details?: string | undefined;
+    }[];
+    report_payload_ref: string;
+    force_draft_pr?: boolean | undefined;
+}, {
+    type: "complete_node";
+    report_payload_ref: string;
+    gate_results?: {
+        status: "pass" | "fail" | "skip";
+        gate: string;
+        details?: string | undefined;
+    }[] | undefined;
+    force_draft_pr?: boolean | undefined;
+}>;
+export declare const coordinatorActionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodEnum<["create_bead"]>;
+    title: z.ZodString;
+    description: z.ZodString;
+    bead_type: z.ZodEnum<["task", "bug", "feature", "epic", "chore", "decision"]>;
+    priority: z.ZodNumber;
+    parent_bead_id: z.ZodOptional<z.ZodString>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    type: "create_bead";
+    title: string;
+    priority: number;
+    depends_on: string[];
+    bead_type: "task" | "decision" | "epic" | "bug" | "feature" | "chore";
+    parent_bead_id?: string | undefined;
+}, {
+    description: string;
+    type: "create_bead";
+    title: string;
+    priority: number;
+    bead_type: "task" | "decision" | "epic" | "bug" | "feature" | "chore";
+    depends_on?: string[] | undefined;
+    parent_bead_id?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodEnum<["complete_node"]>;
+    gate_results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        gate: z.ZodString;
+        status: z.ZodEnum<["pass", "fail", "skip"]>;
+        details: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pass" | "fail" | "skip";
+        gate: string;
+        details?: string | undefined;
+    }, {
+        status: "pass" | "fail" | "skip";
+        gate: string;
+        details?: string | undefined;
+    }>, "many">>;
+    report_payload_ref: z.ZodString;
+    force_draft_pr: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "complete_node";
+    gate_results: {
+        status: "pass" | "fail" | "skip";
+        gate: string;
+        details?: string | undefined;
+    }[];
+    report_payload_ref: string;
+    force_draft_pr?: boolean | undefined;
+}, {
+    type: "complete_node";
+    report_payload_ref: string;
+    gate_results?: {
+        status: "pass" | "fail" | "skip";
+        gate: string;
+        details?: string | undefined;
+    }[] | undefined;
+    force_draft_pr?: boolean | undefined;
+}>]>;
+export declare const coordinatorMemoryPatchEntrySchema: z.ZodObject<{
+    entry_type: z.ZodEnum<["fact", "question", "decision"]>;
+    entry_id: z.ZodOptional<z.ZodString>;
+    summary: z.ZodString;
+    source_member_id: z.ZodString;
+    confidence: z.ZodNumber;
+    provenance: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    entry_type: "fact" | "question" | "decision";
+    source_member_id: string;
+    confidence: number;
+    entry_id?: string | undefined;
+    provenance?: Record<string, unknown> | undefined;
+}, {
+    summary: string;
+    entry_type: "fact" | "question" | "decision";
+    source_member_id: string;
+    confidence: number;
+    entry_id?: string | undefined;
+    provenance?: Record<string, unknown> | undefined;
+}>;
+export interface CoordinatorOutputContract {
+    summary: string;
+    node_status: 'in_progress' | 'complete' | 'blocked' | 'aborted';
+    phases: z.infer<typeof phaseSchema>[];
+    memory_patch: z.infer<typeof coordinatorMemoryPatchEntrySchema>[];
+    actions: z.infer<typeof coordinatorActionSchema>[];
+    validation: {
+        ok?: boolean;
+        issues?: string[];
+        notes?: string;
+        [key: string]: unknown;
+    };
+}
+export type CoordinatorAction = z.infer<typeof coordinatorActionSchema>;
+export type MemberSpawn = z.infer<typeof memberSpawnSchema>;
+export type NodeCompletionStrategy = z.infer<typeof completionStrategySchema>;
+export declare const NODE_STATES: readonly ["created", "starting", "running", "waiting", "degraded", "awaiting_merge", "fixing_after_review", "failed", "error", "done", "stopped"];
+export type NodeState = (typeof NODE_STATES)[number];
+export declare const VALID_STATE_TRANSITIONS: Record<NodeState, NodeState[]>;
+export interface FirstTurnContext {
+    nodeId: string;
+    nodeName: string;
+    sourceBeadId: string | null;
+    beadGoal: string;
+    memberRegistry: Array<{
+        memberId: string;
+        specialist: string;
+        role: string | null;
+        generation: number;
+        status: string;
+        enabled: boolean;
+        member_key?: string;
+        retry_of?: string | null;
+        worktree?: string | null;
+    }>;
+    availableSpecialists: string[];
+    qualityGates: string[];
+    nodeConfigSnapshot: Record<string, unknown>;
+    completionStrategy: NodeCompletionStrategy;
+    maxRetries: number;
+    baseBranch: string;
+    coordinatorGoal: string;
+}
+export interface ResumePayloadContext {
+    nodeId: string;
+    stateMachine: {
+        state: string;
+        allowed_next: string[];
+    };
+    memberUpdates: unknown[];
+    registrySnapshot: unknown[];
+    memoryPatchSummary: unknown[];
+    unresolvedDecisions: unknown[];
+    actionLedgerSummary: unknown[];
+    stateDigest: Record<string, unknown>;
+}
+export declare function renderForSystemPrompt(): string;
+export declare function renderForFirstTurnContext(ctx: FirstTurnContext): string;
+export declare function renderForResumePayload(update: ResumePayloadContext): string;
+export declare function renderForDocs(): string;
+//# sourceMappingURL=node-contract.d.ts.map

package/dist/types/specialist/node-contract.d.ts.map

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

package/dist/types/specialist/node-resolve.d.ts

@@ -0,0 +1,5 @@
+import { type ObservabilitySqliteClient } from './observability-sqlite.js';
+export declare function resolveNodeRefWithClient(partialRef: string, sqliteClient: ObservabilitySqliteClient): string;
+export declare function resolveNodeRef(partialRef: string): string;
+export declare function resolveSingleActiveNodeRef(sqliteClient?: ObservabilitySqliteClient): string;
+//# sourceMappingURL=node-resolve.d.ts.map

package/dist/types/specialist/node-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-resolve.d.ts","sourceRoot":"","sources":["../../../src/specialist/node-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuD,KAAK,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAwBhI,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,yBAAyB,GAAG,MAAM,CAQ5G;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED,wBAAgB,0BAA0B,CAAC,YAAY,CAAC,EAAE,yBAAyB,GAAG,MAAM,CAe3F"}

package/dist/types/specialist/node-supervisor.d.ts

@@ -0,0 +1,198 @@
+import type { RunOptions, SpecialistRunner } from './runner.js';
+import { type ObservabilitySqliteClient } from './observability-sqlite.js';
+import { type NodeCompletionStrategy, type NodeState } from './node-contract.js';
+export type NodeRunStatus = NodeState;
+export interface NodeMemberEntry {
+    memberId: string;
+    jobId: string | null;
+    specialist: string;
+    model?: string;
+    role?: string;
+    status: string;
+    enabled: boolean;
+    lastSeenOutputHash: string | null;
+    generation: number;
+    worktreePath?: string;
+    parentMemberId?: string;
+    replacedMemberId?: string;
+    phaseId?: string;
+}
+export interface NodeSupervisorOptions {
+    nodeId: string;
+    nodeName: string;
+    coordinatorSpecialist: string;
+    members: Array<{
+        memberId: string;
+        specialist: string;
+        model?: string;
+        role?: string;
+        worktree?: boolean | string;
+        worktreePath?: string;
+        parentMemberId?: string;
+        replacedMemberId?: string;
+        phaseId?: string;
+    }>;
+    memoryNamespace?: string;
+    sourceBeadId?: string;
+    sqliteClient: ObservabilitySqliteClient;
+    jobsDir?: string;
+    runner?: SpecialistRunner;
+    runOptions?: Omit<RunOptions, 'name' | 'prompt'>;
+    availableSpecialists?: string[];
+    qualityGates?: string[];
+    nodeConfigSnapshot?: Record<string, unknown>;
+    completionStrategy?: NodeCompletionStrategy;
+    maxRetries?: number;
+    baseBranch?: string;
+}
+export interface MemberStateChange {
+    memberId: string;
+    prevStatus: string;
+    newStatus: string;
+    output?: string;
+}
+export interface NodeDispatchAction {
+    type: 'resume' | 'steer' | 'stop';
+    memberId: string;
+    task?: string;
+    message?: string;
+    actionId?: string;
+    targetGeneration?: number;
+    dependsOnActionId?: string;
+}
+export interface NodeRunResult {
+    nodeId: string;
+    status: NodeRunStatus;
+    coordinatorJobId: string | null;
+    members: NodeMemberEntry[];
+}
+export interface SpawnDynamicMemberActionInput {
+    nodeId: string;
+    memberKey: string;
+    specialist: string;
+    beadId?: string;
+    phaseId?: string;
+    scopePaths?: string[];
+    jobsDir?: string;
+    runner: SpecialistRunner;
+    runOptions: Omit<RunOptions, 'name' | 'prompt'>;
+}
+export interface SpawnDynamicMemberActionResult {
+    memberKey: string;
+    jobId: string;
+    specialist: string;
+}
+export interface CreateBeadActionInput {
+    nodeId: string;
+    title: string;
+    description: string;
+    beadType: 'task' | 'bug' | 'feature' | 'epic' | 'chore' | 'decision';
+    priority: number;
+    dependsOn?: string[];
+}
+export interface CreateBeadActionResult {
+    beadId: string;
+    title: string;
+}
+export interface CompleteNodeActionInput {
+    nodeId: string;
+    strategy: 'pr' | 'manual';
+    forceDraftPr?: boolean;
+}
+export interface CompleteNodeActionResult {
+    strategy: 'pr' | 'manual';
+    prUrl?: string;
+}
+export declare function spawnDynamicMember(input: SpawnDynamicMemberActionInput): Promise<SpawnDynamicMemberActionResult>;
+export declare function executeCreateBeadAction(input: CreateBeadActionInput): CreateBeadActionResult;
+export declare function executeCompleteNodeAction(input: CompleteNodeActionInput): Promise<CompleteNodeActionResult>;
+export declare class NodeSupervisor {
+    private status;
+    private members;
+    private coordinatorJobId;
+    private dispatchQueue;
+    private readonly opts;
+    private readonly memberControllers;
+    private coordinatorController;
+    private readonly queuedActionKeys;
+    private readonly actionLifecycle;
+    private readonly completedActionIds;
+    private readonly memberPendingAction;
+    private readonly actionById;
+    private nextActionSequence;
+    private isDrainingDispatchQueue;
+    private resumePending;
+    private recoveredCoordinatorOutputHash;
+    private pollSequence;
+    private lastActivityAtMs;
+    private coordinatorResumesInFlight;
+    private degradedResumeCount;
+    private lastCoordinatorOutputAtMs;
+    private lastCompletedActionAtMs;
+    private lastMemberTransitionAtMs;
+    private coordinatorRestartCount;
+    constructor(opts: NodeSupervisorOptions);
+    private restoreActionFromEvent;
+    private restoreCoordinatorOutputHashFromEvent;
+    private restoreResumePendingFromEvent;
+    private getMemberPendingActionKey;
+    private getMemberPendingActionForGeneration;
+    private setMemberPendingActionForGeneration;
+    private clearMemberPendingActionForGeneration;
+    private clearMemberPendingActions;
+    private resetResumePendingFromLiveCoordinatorStatus;
+    private bootstrap;
+    private validateTransition;
+    private logPersistenceWarning;
+    private persistNodeEvent;
+    private transition;
+    private createBaseRunOptions;
+    private buildMemberIdleBootstrapPrompt;
+    private buildReplacementBootstrapPrompt;
+    private getBeadGoalSummary;
+    private buildCoordinatorFirstTurnContext;
+    private spawnMembers;
+    private spawnCoordinator;
+    private pollMemberStatuses;
+    private recomputeNodeHealth;
+    private maybeAcknowledgeMemberAction;
+    private buildStateDigest;
+    private buildActionLedgerSummary;
+    private buildResumePayload;
+    private getActionKey;
+    private nextActionId;
+    private appendActionLifecycleEvent;
+    private dispatchAction;
+    private drainDispatchQueue;
+    private appendNodeEvent;
+    private isRecoveryResumeAllowed;
+    private buildCompletionSummary;
+    private appendCompletionSummaryToBead;
+    private runCommand;
+    private extractCreatedBeadId;
+    private executeCreateBeadAction;
+    private spawnDynamicMember;
+    private runFinalQualityGates;
+    private executeCompleteNodeAction;
+    private getNextPollIntervalMs;
+    private getLastProgressAtMs;
+    private isCoordinatorInBlockingWaitPhase;
+    private maybeTriggerNoProgressWatchdog;
+    private buildCoordinatorRecoveryPrompt;
+    private restartCoordinator;
+    private cleanupJobs;
+    run(initialPrompt: string): Promise<NodeRunResult>;
+    getStatus(): NodeRunStatus;
+    getMembers(): NodeMemberEntry[];
+    getCoordinatorJobId(): string | null;
+    /**
+     * Enqueue a dispatch action (resume/steer/stop) for a member.
+     * Returns action ID on success, null on failure.
+     */
+    enqueueAction(action: NodeDispatchAction): Promise<string | null>;
+    /**
+     * Gracefully stop the node: stop coordinator and all members.
+     */
+    gracefulStop(): Promise<void>;
+}
+//# sourceMappingURL=node-supervisor.d.ts.map

package/dist/types/specialist/node-supervisor.d.ts.map

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

package/dist/types/specialist/observability-db.d.ts

@@ -0,0 +1,19 @@
+export declare const OBSERVABILITY_SCHEMA_VERSION = 11;
+export interface ObservabilityDbLocation {
+    gitRoot: string;
+    dbDirectory: string;
+    dbPath: string;
+    dbWalPath: string;
+    dbShmPath: string;
+    source: 'git-root' | 'xdg-data-home';
+}
+export declare function resolveObservabilityDbLocation(cwd?: string): ObservabilityDbLocation;
+export declare function ensureObservabilityDbFile(location: ObservabilityDbLocation): {
+    created: boolean;
+};
+export declare function ensureGitignoreHasObservabilityDbEntries(gitRoot: string): {
+    changed: boolean;
+};
+export declare function isObservabilityDbInitialized(location: ObservabilityDbLocation): boolean;
+export declare function isPathInsideJobsDirectory(pathToCheck: string, gitRoot: string): boolean;
+//# sourceMappingURL=observability-db.d.ts.map

package/dist/types/specialist/observability-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-db.d.ts","sourceRoot":"","sources":["../../../src/specialist/observability-db.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,eAAe,CAAC;CACtC;AAwCD,wBAAgB,8BAA8B,CAAC,GAAG,GAAE,MAAsB,GAAG,uBAAuB,CAanG;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,uBAAuB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAUjG;AAED,wBAAgB,wCAAwC,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CA0B9F;AAOD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CA8BvF;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvF"}