@a5c-ai/babysitter-sdk 0.0.16

package/dist/tasks/serializer.js

@@ -0,0 +1,193 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESULT_SCHEMA_VERSION = exports.TASK_SCHEMA_VERSION = void 0;
+exports.serializeAndWriteTaskDefinition = serializeAndWriteTaskDefinition;
+exports.serializeTaskDefinition = serializeTaskDefinition;
+exports.serializeAndWriteTaskResult = serializeAndWriteTaskResult;
+exports.serializeTaskResult = serializeTaskResult;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const crypto_1 = __importDefault(require("crypto"));
+const tasks_1 = require("../storage/tasks");
+const paths_1 = require("../storage/paths");
+const atomic_1 = require("../storage/atomic");
+exports.TASK_SCHEMA_VERSION = "2026.01.tasks-v1";
+exports.RESULT_SCHEMA_VERSION = "2026.01.results-v1";
+const BLOB_THRESHOLD_BYTES = 1024 * 1024; // 1 MiB
+async function serializeAndWriteTaskDefinition(options) {
+    const serialized = await serializeTaskDefinition(options);
+    const taskRef = await (0, tasks_1.writeTaskDefinition)(options.runDir, options.effectId, serialized);
+    return {
+        taskRef,
+        inputsRef: serialized.inputsRef,
+        serialized,
+    };
+}
+async function serializeTaskDefinition(options) {
+    const normalized = normalizeTaskDef(options.task);
+    const serialized = {
+        schemaVersion: exports.TASK_SCHEMA_VERSION,
+        effectId: options.effectId,
+        taskId: options.taskId,
+        invocationKey: options.invocationKey,
+        stepId: options.stepId,
+        kind: normalized.kind,
+        title: normalized.title,
+        description: normalized.description,
+        labels: normalized.labels,
+        io: normalized.io,
+        node: normalized.node,
+        breakpoint: normalized.breakpoint,
+        orchestratorTask: normalized.orchestratorTask,
+        sleep: normalized.sleep,
+        metadata: normalized.metadata,
+    };
+    if (options.inputs !== undefined) {
+        const spill = await maybeSpillLargeValue({
+            runDir: options.runDir,
+            effectId: options.effectId,
+            name: "inputs",
+            value: options.inputs,
+        });
+        serialized.inputs = spill.value;
+        serialized.inputsRef = spill.ref;
+    }
+    return serialized;
+}
+async function serializeAndWriteTaskResult(options) {
+    const serialized = await serializeTaskResult(options);
+    const { resultRef, stdoutRef, stderrRef } = await (0, tasks_1.writeTaskResult)({
+        runDir: options.runDir,
+        effectId: options.effectId,
+        result: serialized,
+        stdout: options.payload.stdout,
+        stderr: options.payload.stderr,
+    });
+    return {
+        resultRef,
+        stdoutRef,
+        stderrRef,
+        serialized,
+    };
+}
+async function serializeTaskResult(options) {
+    const serialized = {
+        schemaVersion: exports.RESULT_SCHEMA_VERSION,
+        effectId: options.effectId,
+        taskId: options.taskId,
+        invocationKey: options.invocationKey,
+        status: options.payload.status,
+        result: undefined,
+        resultRef: undefined,
+        error: normalizeError(options.payload.error),
+        stdoutRef: options.payload.stdoutRef,
+        stderrRef: options.payload.stderrRef,
+        startedAt: options.payload.startedAt,
+        finishedAt: options.payload.finishedAt,
+        metadata: options.payload.metadata ? stableClone(options.payload.metadata) : undefined,
+    };
+    if (options.payload.status === "ok") {
+        const spill = await maybeSpillLargeValue({
+            runDir: options.runDir,
+            effectId: options.effectId,
+            name: "result",
+            value: options.payload.result,
+        });
+        serialized.result = spill.value;
+        serialized.value = spill.value;
+        serialized.resultRef = spill.ref;
+    }
+    else {
+        serialized.error = normalizeError(options.payload.error);
+    }
+    return serialized;
+}
+function normalizeTaskDef(task) {
+    if (!task || typeof task !== "object") {
+        throw new Error("Task serializer requires a TaskDef object");
+    }
+    if (!task.kind || typeof task.kind !== "string") {
+        throw new Error("TaskDef.kind must be a non-empty string");
+    }
+    return {
+        kind: task.kind,
+        title: typeof task.title === "string" ? task.title : undefined,
+        description: typeof task.description === "string" ? task.description : undefined,
+        labels: normalizeLabels(task.labels),
+        io: normalizeJson(task.io),
+        node: normalizeJson(task.node),
+        breakpoint: normalizeJson(task.breakpoint),
+        orchestratorTask: normalizeJson(task.orchestratorTask),
+        sleep: normalizeJson(task.sleep),
+        metadata: normalizeJson(task.metadata),
+    };
+}
+function normalizeLabels(labels) {
+    if (!Array.isArray(labels) || labels.length === 0)
+        return undefined;
+    const trimmed = labels
+        .filter((value) => typeof value === "string")
+        .map((label) => label.trim())
+        .filter(Boolean);
+    if (!trimmed.length)
+        return undefined;
+    const unique = Array.from(new Set(trimmed));
+    unique.sort((a, b) => a.localeCompare(b));
+    return unique;
+}
+function normalizeJson(value) {
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        return undefined;
+    }
+    return stableClone(value);
+}
+async function maybeSpillLargeValue(options) {
+    if (options.value === undefined) {
+        return {};
+    }
+    const clone = stableClone(options.value);
+    const json = JSON.stringify(clone, null, 2) + "\n";
+    if (Buffer.byteLength(json, "utf8") <= BLOB_THRESHOLD_BYTES) {
+        return { value: clone };
+    }
+    const blobDir = path_1.default.join((0, paths_1.getTasksDir)(options.runDir), options.effectId, "blobs");
+    await fs_1.promises.mkdir(blobDir, { recursive: true });
+    const hash = crypto_1.default.createHash("sha256").update(json).digest("hex");
+    const blobPath = path_1.default.join(blobDir, `${options.name}-${hash}.json`);
+    await fs_1.promises.mkdir(path_1.default.dirname(blobPath), { recursive: true });
+    await (0, atomic_1.writeFileAtomic)(blobPath, json);
+    return {
+        ref: toRunRelative(options.runDir, blobPath),
+    };
+}
+function toRunRelative(runDir, absolutePath) {
+    const relative = path_1.default.relative(runDir, absolutePath);
+    return relative.split(path_1.default.sep).join("/");
+}
+function stableClone(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => stableClone(entry));
+    }
+    if (value && typeof value === "object") {
+        const entries = Object.keys(value).sort((a, b) => a.localeCompare(b));
+        const clone = {};
+        for (const key of entries) {
+            const child = value[key];
+            clone[key] = stableClone(child);
+        }
+        return clone;
+    }
+    return value;
+}
+function normalizeError(error) {
+    if (!error || typeof error !== "object") {
+        return undefined;
+    }
+    return stableClone(error);
+}

package/dist/tasks/types.d.ts

@@ -0,0 +1,148 @@
+import { JsonRecord } from "../storage/types";
+export type TaskKind = "node" | "breakpoint" | "orchestrator_task" | "sleep" | string;
+export interface TaskIOHints {
+    inputJsonPath?: string;
+    outputJsonPath?: string;
+    stdoutPath?: string;
+    stderrPath?: string;
+}
+export interface NodeTaskOptions {
+    entry: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    timeoutMs?: number;
+}
+export interface BreakpointTaskOptions {
+    payload?: unknown;
+    confirmationRequired?: boolean;
+}
+export interface OrchestratorTaskOptions {
+    payload?: JsonRecord;
+    resumeCommand?: string;
+}
+export interface SleepTaskOptions {
+    iso: string;
+    targetEpochMs: number;
+}
+export interface TaskDef {
+    kind: TaskKind;
+    title?: string;
+    description?: string;
+    labels?: string[];
+    io?: TaskIOHints;
+    metadata?: JsonRecord;
+    node?: NodeTaskOptions;
+    breakpoint?: BreakpointTaskOptions;
+    orchestratorTask?: OrchestratorTaskOptions;
+    sleep?: SleepTaskOptions;
+    [key: string]: unknown;
+}
+export interface BlobWriteOptions {
+    /**
+     * Optional content-type metadata (reserved for future integrations).
+     */
+    contentType?: string;
+    /**
+     * Text encoding to use when serializing string payloads (default: utf8).
+     */
+    encoding?: BufferEncoding;
+    /**
+     * Force JSON serialization (default: true for objects, false for strings/Buffers).
+     */
+    asJson?: boolean;
+}
+export interface TaskBuildContext {
+    effectId: string;
+    invocationKey: string;
+    /**
+     * Stable id returned from defineTask (used for serialization + hashing).
+     */
+    taskId: string;
+    /**
+     * Active run identifier (matches run.json:id).
+     */
+    runId: string;
+    /**
+     * Absolute path to the run directory containing journal/tasks/etc.
+     */
+    runDir: string;
+    /**
+     * Absolute path to the effect-specific task directory (runs/<id>/tasks/<effectId>).
+     */
+    taskDir: string;
+    /**
+     * Absolute path to the run-level tasks directory (runs/<id>/tasks).
+     * @deprecated Use taskDir instead.
+     */
+    tasksDir: string;
+    /**
+     * Optional label provided at invocation time.
+     */
+    label?: string;
+    labels: string[];
+    /**
+     * Writes the provided payload under tasks/<effectId>/blobs and returns a run-relative POSIX path.
+     */
+    createBlobRef(name: string, value: unknown, options?: BlobWriteOptions): Promise<string>;
+    /**
+     * Resolves a task-scoped relative path to a run-relative POSIX string.
+     */
+    toTaskRelativePath(relativePath: string): string;
+}
+export type TaskValueFactory<TArgs, TValue> = (args: TArgs, ctx: TaskBuildContext) => TValue | Promise<TValue>;
+export type TaskValueOrFactory<TArgs, TValue> = TValue | TaskValueFactory<TArgs, TValue>;
+export type TaskImpl<TArgs = unknown, TResult = unknown> = (args: TArgs, ctx: TaskBuildContext) => TaskDef | Promise<TaskDef>;
+export interface DefinedTask<TArgs = unknown, TResult = unknown> {
+    id: string;
+    build(args: TArgs, ctx: TaskBuildContext): TaskDef | Promise<TaskDef>;
+}
+export interface TaskInvokeOptions {
+    label?: string;
+}
+export interface TaskSerializerContext {
+    runDir: string;
+    effectId: string;
+    taskId: string;
+    invocationKey: string;
+    stepId?: string;
+}
+export interface NodeTaskDefinitionOptions<TArgs = unknown> {
+    entry: TaskValueOrFactory<TArgs, string>;
+    title?: TaskValueOrFactory<TArgs, string | undefined>;
+    description?: TaskValueOrFactory<TArgs, string | undefined>;
+    labels?: TaskValueOrFactory<TArgs, string[] | undefined>;
+    metadata?: TaskValueOrFactory<TArgs, JsonRecord | undefined>;
+    io?: TaskValueOrFactory<TArgs, TaskIOHints | undefined>;
+    env?: TaskValueOrFactory<TArgs, Record<string, string | undefined> | undefined>;
+    cwd?: TaskValueOrFactory<TArgs, string | undefined>;
+    args?: TaskValueOrFactory<TArgs, string[] | undefined>;
+    timeoutMs?: TaskValueOrFactory<TArgs, number | undefined>;
+}
+export interface BreakpointTaskDefinitionOptions<TArgs = unknown> {
+    title?: TaskValueOrFactory<TArgs, string | undefined>;
+    description?: TaskValueOrFactory<TArgs, string | undefined>;
+    labels?: TaskValueOrFactory<TArgs, string[] | undefined>;
+    metadata?: TaskValueOrFactory<TArgs, JsonRecord | undefined>;
+    payload?: TaskValueOrFactory<TArgs, unknown>;
+    confirmationRequired?: TaskValueOrFactory<TArgs, boolean | undefined>;
+}
+export interface OrchestratorTaskDefinitionOptions<TArgs = JsonRecord> {
+    title?: TaskValueOrFactory<TArgs, string | undefined>;
+    description?: TaskValueOrFactory<TArgs, string | undefined>;
+    labels?: TaskValueOrFactory<TArgs, string[] | undefined>;
+    metadata?: TaskValueOrFactory<TArgs, JsonRecord | undefined>;
+    payload?: TaskValueOrFactory<TArgs, JsonRecord | undefined>;
+    resumeCommand?: TaskValueOrFactory<TArgs, string | undefined>;
+}
+export interface SleepTaskBuilderArgs {
+    iso: string;
+    targetEpochMs: number;
+}
+export interface SleepTaskDefinitionOptions<TArgs extends SleepTaskBuilderArgs = SleepTaskBuilderArgs> {
+    title?: TaskValueOrFactory<TArgs, string | undefined>;
+    description?: TaskValueOrFactory<TArgs, string | undefined>;
+    labels?: TaskValueOrFactory<TArgs, string[] | undefined>;
+    metadata?: TaskValueOrFactory<TArgs, JsonRecord | undefined>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tasks/types.d.ts.map

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

package/dist/tasks/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/test-fixtures/kinds/index.d.ts

@@ -0,0 +1,56 @@
+export declare const nodeKindFixtures: {
+    id: string;
+    args: {
+        target: string;
+        cacheKey: string;
+    };
+    helperLabels: string[];
+    metadata: {
+        subsystem: string;
+    };
+    env: {
+        sample: {
+            NODE_AUTH_TOKEN: string;
+            CI_SECRET: string;
+            GITHUB_TOKEN: string;
+            DB_PASSWORD: string;
+            PUBLIC_URL: string;
+            LOG_LEVEL: string;
+        };
+        expectedSafe: {
+            PUBLIC_URL: string;
+            LOG_LEVEL: string;
+        };
+        expectedRedacted: string[];
+    };
+};
+export declare const breakpointKindFixtures: {
+    id: string;
+    payload: {
+        reason: string;
+        branch: string;
+    };
+    metadata: {
+        severity: string;
+    };
+};
+export declare const orchestratorKindFixtures: {
+    id: string;
+    payload: {
+        op: string;
+        stage: string;
+    };
+    metadata: {
+        iteration: number;
+    };
+    resumeCommand: string;
+};
+export declare const sleepKindFixtures: {
+    id: string;
+    args: {
+        iso: string;
+        targetEpochMs: number;
+    };
+    helperLabels: string[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/test-fixtures/kinds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/test-fixtures/kinds/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;CAIlC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;CAKpC,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;CAO7B,CAAC"}

package/dist/test-fixtures/kinds/index.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleepKindFixtures = exports.orchestratorKindFixtures = exports.breakpointKindFixtures = exports.nodeKindFixtures = void 0;
+const sleepIso = "2026-02-15T12:00:00.000Z";
+exports.nodeKindFixtures = {
+    id: "fixtures.node.example",
+    args: { target: "web-app", cacheKey: "demo" },
+    helperLabels: ["node-helper"],
+    metadata: { subsystem: "build" },
+    env: {
+        sample: {
+            NODE_AUTH_TOKEN: "token-123",
+            CI_SECRET: "ci-secret",
+            GITHUB_TOKEN: "ghp_example",
+            DB_PASSWORD: "hunter2",
+            PUBLIC_URL: "https://example.test",
+            LOG_LEVEL: "info",
+        },
+        expectedSafe: {
+            PUBLIC_URL: "https://example.test",
+            LOG_LEVEL: "info",
+        },
+        expectedRedacted: ["CI_SECRET", "DB_PASSWORD", "GITHUB_TOKEN", "NODE_AUTH_TOKEN"],
+    },
+};
+exports.breakpointKindFixtures = {
+    id: "fixtures.breakpoint.example",
+    payload: { reason: "inspect diff", branch: "feature/123" },
+    metadata: { severity: "high" },
+};
+exports.orchestratorKindFixtures = {
+    id: "fixtures.orchestrator.example",
+    payload: { op: "plan", stage: "compile" },
+    metadata: { iteration: 3 },
+    resumeCommand: "pnpm babysitter run:continue",
+};
+exports.sleepKindFixtures = {
+    id: "fixtures.sleep.example",
+    args: {
+        iso: sleepIso,
+        targetEpochMs: Date.parse(sleepIso),
+    },
+    helperLabels: ["sleep-helper"],
+};

package/dist/testing/deterministic.d.ts

@@ -0,0 +1,90 @@
+import type { JsonRecord } from "../storage/types";
+import { type StateCacheSnapshot } from "../runtime/replay/stateCache";
+type MaybePromise<T> = T | Promise<T>;
+type ClockValue = string | number | Date;
+export type ClockSequenceInput = ClockValue | readonly ClockValue[];
+export interface SnapshotJournalEntry {
+    seq: number;
+    ulid: string;
+    recordedAt: string;
+    type: string;
+    data: JsonRecord;
+}
+export interface SnapshotStateSummary {
+    savedAt: string;
+    stateVersion: number;
+    journalHead: StateCacheSnapshot["journalHead"];
+    pendingEffectsByKind: StateCacheSnapshot["pendingEffectsByKind"];
+    effectsByInvocation: StateCacheSnapshot["effectsByInvocation"];
+    rebuildReason: StateCacheSnapshot["rebuildReason"];
+}
+export interface DeterministicRunSnapshot {
+    journal: SnapshotJournalEntry[];
+    state: SnapshotStateSummary | null;
+}
+export interface TempDeterministicRun {
+    runDir: string;
+    cleanup(): Promise<void>;
+    restore(): void;
+}
+export interface TempDeterministicRunOptions {
+    processSource: string;
+    inputs?: unknown;
+    runId?: string;
+    request?: string;
+    clock?: ClockSequenceInput;
+    ulids?: readonly string[];
+}
+export interface FixedClockOptions {
+    start?: ClockValue;
+    stepMs?: number;
+    sequence?: ClockSequenceInput;
+}
+export interface FixedClockHandle {
+    now(): Date;
+    advance(ms?: number): Date;
+    reset(): void;
+    timestamp(): number;
+    apply(): () => void;
+    restore(): void;
+}
+export interface DeterministicUlidOptions {
+    preset?: readonly string[];
+    epochMs?: number;
+    incrementMs?: number;
+    randomnessSeed?: number;
+}
+export interface DeterministicUlidHandle {
+    issued: readonly string[];
+    next(): string;
+    reset(): void;
+    apply(): () => void;
+    restore(): void;
+}
+export interface DeterministicRunHarnessOptions {
+    processPath?: string;
+    processSource?: string;
+    inputs?: unknown;
+    runId?: string;
+    request?: string;
+    exportName?: string;
+    clock?: FixedClockOptions;
+    ulids?: DeterministicUlidOptions;
+}
+export interface DeterministicRunHarness {
+    runId: string;
+    runDir: string;
+    runsRoot: string;
+    clock: FixedClockHandle;
+    ulids: DeterministicUlidHandle;
+    cleanup(): Promise<void>;
+}
+export declare function withDeterministicIds<T>(sequence: readonly string[], fn: () => MaybePromise<T>): Promise<T>;
+export declare function withFixedClock<T>(sequenceOrValue: ClockSequenceInput, fn: () => MaybePromise<T>): Promise<T>;
+export declare function createTempDeterministicRun(options: TempDeterministicRunOptions): Promise<TempDeterministicRun>;
+export declare function snapshotRunState(runDir: string): Promise<DeterministicRunSnapshot>;
+export declare function installFixedClock(options?: FixedClockOptions): FixedClockHandle;
+export declare function installDeterministicUlids(options?: DeterministicUlidOptions): DeterministicUlidHandle;
+export declare function createDeterministicRunHarness(options: DeterministicRunHarnessOptions): Promise<DeterministicRunHarness>;
+export {};
+//# sourceMappingURL=deterministic.d.ts.map

package/dist/testing/deterministic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic.d.ts","sourceRoot":"","sources":["../../src/testing/deterministic.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAOvF,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACtC,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AACzC,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC;AAIpE,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC/C,oBAAoB,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IACjE,mBAAmB,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IAC/D,aAAa,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,IAAI,IAAI,CAAC;IACZ,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,SAAS,IAAI,MAAM,CAAC;IACpB,KAAK,IAAI,MAAM,IAAI,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,MAAM,IAAI,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAeD,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,EAAE,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,wBAAsB,cAAc,CAAC,CAAC,EACpC,eAAe,EAAE,kBAAkB,EACnC,EAAE,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAuD/B;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAqBxF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAwC/E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,uBAAuB,CAoDrG;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CA8DlC"}