@agent-relay/factory 0.1.31 → 0.1.33

package/dist/observability/events.d.ts.map

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

package/dist/observability/events.js

@@ -0,0 +1,229 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { z } from 'zod';
+export const FACTORY_CLOUD_EVENT_CONTRACT_V1 = 'factory.telemetry.v1';
+export const FACTORY_CLOUD_EVENT_MAX_BATCH_SIZE = 100;
+/** Leave headroom below Cloud's 256 KiB request-body limit. */
+export const FACTORY_CLOUD_EVENT_MAX_PAYLOAD_BYTES = 240 * 1024;
+export const FACTORY_CLOUD_RELEASE_REASONS_V1 = [
+    'completed',
+    'human_review',
+    'factory_stopped',
+    'waiting_for_human',
+    'exited',
+    'offline',
+    'node_offline',
+    'crashed',
+    'reconciled_missing',
+    'delivery_failed',
+    'dispatch_failed',
+    'other',
+];
+export const FACTORY_CLOUD_EVENT_TYPES = [
+    'instance.started',
+    'instance.heartbeat',
+    'instance.stopping',
+    'instance.stopped',
+    'run.queued',
+    'run.started',
+    'run.phase_changed',
+    'run.waiting',
+    'run.blocked',
+    'run.succeeded',
+    'run.failed',
+    'run.cancelled',
+    'agent.planned',
+    'agent.spawned',
+    'agent.adopted',
+    'agent.resumed',
+    'agent.exited',
+    'agent.released',
+    'clarification.requested',
+    'clarification.delivered',
+    'clarification.waiting',
+    'clarification.answered',
+    'clarification.woken',
+    'clarification.escalated',
+    'pull_request.discovered',
+    'pull_request.published',
+    'pull_request.ready',
+    'pull_request.merged',
+    'writeback.applied',
+    'factory.failure',
+    'factory.anomaly',
+    'factory.snapshot',
+];
+const opaqueString = z.string().trim().min(1).max(256);
+const categoryString = z.string().trim().min(1).max(120).regex(/^[a-zA-Z0-9][a-zA-Z0-9._:/-]*$/u);
+const nonNegativeInteger = z.number().int().nonnegative();
+const boundedCount = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
+const W3C_INVALID_TRACE_ID = '00000000000000000000000000000000';
+const W3C_INVALID_SPAN_ID = '0000000000000000';
+const FACTORY_RUN_TRACE_DOMAIN_V1 = 'agent-relay.factory.run-trace.v1\0';
+export const FactoryCloudTraceIdV1Schema = z.string()
+    .regex(/^[a-f0-9]{32}$/u)
+    .refine((value) => value !== W3C_INVALID_TRACE_ID, 'traceId must not be all zeroes');
+export const FactoryCloudSpanIdV1Schema = z.string()
+    .regex(/^[a-f0-9]{16}$/u)
+    .refine((value) => value !== W3C_INVALID_SPAN_ID, 'spanId must not be all zeroes');
+/**
+ * Deliberately narrow operational attributes. This is not a general log bag:
+ * task text, prompts, issue descriptions, messages, paths, URLs, command lines,
+ * stack traces, and raw error messages have no representable field.
+ */
+export const FactoryCloudEventAttributesV1Schema = z.object({
+    backend: categoryString.optional(),
+    mode: categoryString.optional(),
+    component: categoryString.optional(),
+    operation: categoryString.optional(),
+    errorClass: categoryString.optional(),
+    errorCode: categoryString.optional(),
+    errorFingerprint: categoryString.optional(),
+    retryable: z.boolean().optional(),
+    attempt: nonNegativeInteger.optional(),
+    durationMs: nonNegativeInteger.optional(),
+    agentRole: categoryString.optional(),
+    invocationId: opaqueString.optional(),
+    nodeId: opaqueString.optional(),
+    previousPhase: categoryString.optional(),
+    releaseReason: z.enum(FACTORY_CLOUD_RELEASE_REASONS_V1).optional(),
+    dryRun: z.boolean().optional(),
+    count: boundedCount.optional(),
+    activeRuns: boundedCount.optional(),
+    queuedRuns: boundedCount.optional(),
+    trackedAgents: boundedCount.optional(),
+    unownedAgents: boundedCount.optional(),
+    outboxDepth: boundedCount.optional(),
+    outboxOldestAgeMs: nonNegativeInteger.optional(),
+    droppedEvents: boundedCount.optional(),
+    transport: categoryString.optional(),
+    locality: categoryString.optional(),
+}).strict();
+export const FactoryCloudInstanceV1Schema = z.object({
+    id: opaqueString,
+    bootId: opaqueString,
+    version: z.string().trim().min(1).max(64),
+    metadata: z.object({
+        backend: categoryString.optional(),
+        mode: categoryString.optional(),
+        platform: categoryString.optional(),
+        arch: categoryString.optional(),
+        runtime: categoryString.optional(),
+    }).strict().optional(),
+}).strict();
+const factoryCloudEventShape = {
+    id: opaqueString,
+    occurredAt: z.string().datetime({ offset: true }),
+    type: categoryString,
+    level: z.enum(['debug', 'info', 'warn', 'error']).optional(),
+    runId: opaqueString.optional(),
+    phase: categoryString.optional(),
+    status: z.enum(['queued', 'running', 'waiting', 'blocked', 'succeeded', 'failed', 'cancelled']).optional(),
+    run: z.object({
+        source: categoryString.optional(),
+        repository: opaqueString.optional(),
+        issueKey: opaqueString.optional(),
+        recipe: categoryString.optional(),
+    }).strict().optional(),
+    attributes: FactoryCloudEventAttributesV1Schema.optional(),
+    trace: z.object({
+        traceId: FactoryCloudTraceIdV1Schema,
+        spanId: FactoryCloudSpanIdV1Schema.optional(),
+        parentSpanId: FactoryCloudSpanIdV1Schema.optional(),
+    }).strict().optional(),
+};
+const requireRunId = (event, context) => {
+    if (event.type.startsWith('run.') && !event.runId) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['runId'],
+            message: 'runId is required for run.* events',
+        });
+    }
+};
+export const FactoryCloudEventInputV1Schema = z.object(factoryCloudEventShape).strict().superRefine(requireRunId);
+export const FactoryCloudEventV1Schema = z.object({
+    ...factoryCloudEventShape,
+    sequence: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+}).strict().superRefine(requireRunId);
+export const FactoryCloudEventBatchV1Schema = z.object({
+    contract: z.literal(FACTORY_CLOUD_EVENT_CONTRACT_V1),
+    instance: FactoryCloudInstanceV1Schema,
+    events: z.array(FactoryCloudEventV1Schema).min(1).max(FACTORY_CLOUD_EVENT_MAX_BATCH_SIZE),
+}).strict();
+/**
+ * Stable correlation ID for the durable run. It has W3C trace-id shape but is
+ * not evidence that an OpenTelemetry span was created or exported.
+ */
+export function factoryRunTraceIdV1(runId) {
+    const normalizedRunId = opaqueString.parse(runId);
+    const traceId = createHash('sha256')
+        .update(FACTORY_RUN_TRACE_DOMAIN_V1)
+        .update(normalizedRunId)
+        .digest('hex')
+        .slice(0, 32);
+    // SHA-256 producing this value is fantastically unlikely, but W3C forbids it
+    // and this helper promises validity rather than probability.
+    return traceId === W3C_INVALID_TRACE_ID
+        ? '00000000000000000000000000000001'
+        : traceId;
+}
+export function createFactoryCloudEventV1(input, options = {}) {
+    const trace = input.trace ?? (input.runId ? { traceId: factoryRunTraceIdV1(input.runId) } : undefined);
+    return FactoryCloudEventInputV1Schema.parse({
+        ...input,
+        id: input.id ?? (options.id ?? randomUUID)(),
+        occurredAt: input.occurredAt ?? (options.now ?? (() => new Date()))().toISOString(),
+        ...(trace ? { trace } : {}),
+    });
+}
+/**
+ * Converts provider-owned exit/release text into a closed operational category.
+ * Unknown text is never forwarded because it can contain task or error details.
+ */
+export function factoryCloudReleaseReasonV1(value) {
+    if (value === undefined || !value.trim())
+        return undefined;
+    switch (value.trim().toLowerCase()) {
+        case 'issue-done':
+        case 'done':
+        case 'completed':
+            return 'completed';
+        case 'issue-human-review':
+            return 'human_review';
+        case 'factory-stopped':
+            return 'factory_stopped';
+        case 'waiting-for-human':
+            return 'waiting_for_human';
+        case 'task_exit':
+        case 'exited':
+            return 'exited';
+        case 'offline':
+            return 'offline';
+        case 'node-offline':
+            return 'node_offline';
+        case 'crash':
+        case 'crashed':
+            return 'crashed';
+        case 'reconciled-missing':
+            return 'reconciled_missing';
+        case 'dead-lettered':
+        case 'dropped':
+        case 'max delivery retries exceeded':
+        case 'recipient unavailable':
+            return 'delivery_failed';
+        case 'dispatch failed':
+            return 'dispatch_failed';
+        default:
+            return 'other';
+    }
+}
+export function isCriticalFactoryCloudEvent(event) {
+    return event.level === 'error' ||
+        event.type === 'factory.failure' ||
+        event.type === 'factory.anomaly' ||
+        event.type === 'instance.stopped' ||
+        event.status === 'failed' ||
+        event.status === 'succeeded' ||
+        event.status === 'cancelled';
+}
+//# sourceMappingURL=events.js.map

package/dist/observability/events.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,5 @@
+export * from './cloud-reporter.js';
+export * from './events.js';
+export * from './instance-identity.js';
+export * from './outbox.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA"}

package/dist/observability/index.js

@@ -0,0 +1,5 @@
+export * from './cloud-reporter.js';
+export * from './events.js';
+export * from './instance-identity.js';
+export * from './outbox.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA"}

package/dist/observability/instance-identity.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Return one opaque identity for this Factory installation. The create-only
+ * file makes concurrent starts converge without deriving identity from a
+ * hostname, username, local path, or other machine fingerprint.
+ */
+export declare function loadOrCreateFactoryInstanceId(path: string): Promise<string>;
+//# sourceMappingURL=instance-identity.d.ts.map

package/dist/observability/instance-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-identity.d.ts","sourceRoot":"","sources":["../../src/observability/instance-identity.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqCjF"}

package/dist/observability/instance-identity.js

@@ -0,0 +1,59 @@
+import { randomUUID } from 'node:crypto';
+import { link, mkdir, open, readFile, unlink } from 'node:fs/promises';
+import { dirname } from 'node:path';
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+/**
+ * Return one opaque identity for this Factory installation. The create-only
+ * file makes concurrent starts converge without deriving identity from a
+ * hostname, username, local path, or other machine fingerprint.
+ */
+export async function loadOrCreateFactoryInstanceId(path) {
+    try {
+        const existing = (await readFile(path, 'utf8')).trim();
+        if (!UUID.test(existing))
+            throw new Error('Factory instance identity file is invalid');
+        return existing;
+    }
+    catch (error) {
+        if (!isMissingFileError(error))
+            throw error;
+    }
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const candidatePath = `${path}.${randomUUID()}.tmp`;
+    let candidateExists = false;
+    try {
+        const handle = await open(candidatePath, 'wx', 0o600);
+        candidateExists = true;
+        const id = randomUUID();
+        try {
+            await handle.writeFile(`${id}\n`, 'utf8');
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        try {
+            await link(candidatePath, path);
+            return id;
+        }
+        catch (error) {
+            if (!isAlreadyExistsError(error))
+                throw error;
+        }
+    }
+    catch (error) {
+        if (!isAlreadyExistsError(error))
+            throw error;
+    }
+    finally {
+        if (candidateExists)
+            await unlink(candidatePath).catch(() => undefined);
+    }
+    const id = (await readFile(path, 'utf8')).trim();
+    if (!UUID.test(id))
+        throw new Error('Factory instance identity file is invalid');
+    return id;
+}
+const isAlreadyExistsError = (error) => Boolean(error && typeof error === 'object' && 'code' in error && error.code === 'EEXIST');
+const isMissingFileError = (error) => Boolean(error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT');
+//# sourceMappingURL=instance-identity.js.map

package/dist/observability/instance-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-identity.js","sourceRoot":"","sources":["../../src/observability/instance-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,IAAI,GAAG,6EAA6E,CAAA;AAE1F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,IAAY;IAC9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACtD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;QACtF,OAAO,QAAQ,CAAA;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;IAC7C,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC5D,MAAM,aAAa,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAA;IACnD,IAAI,eAAe,GAAG,KAAK,CAAA;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QACrD,eAAe,GAAG,IAAI,CAAA;QACtB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAA;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;YACzC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QACrB,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;YAC/B,OAAO,EAAE,CAAA;QACX,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAA;QAC/C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;IAC/C,CAAC;YAAS,CAAC;QACT,IAAI,eAAe;YAAE,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACzE,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAChD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAChF,OAAO,EAAE,CAAA;AACX,CAAC;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAW,EAAE,CACvD,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAA;AAE3F,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAW,EAAE,CACrD,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAA"}

package/dist/observability/outbox.d.ts

@@ -0,0 +1,42 @@
+import { type FactoryCloudEventBatchV1, type FactoryCloudEventInputV1, type FactoryCloudEventV1, type FactoryCloudInstanceV1 } from './events.js';
+export interface FileFactoryCloudEventOutboxOptions {
+    path: string;
+    maxEvents?: number;
+    maxBytes?: number;
+    /** Finite advisory-lock retries; defaults to a short fail-open window. */
+    lockRetries?: number;
+}
+export interface FactoryCloudEventEnqueueResult {
+    event: FactoryCloudEventV1;
+    duplicate: boolean;
+    droppedEvents: number;
+    pending: number;
+}
+export interface FactoryCloudEventOutboxStats {
+    pending: number;
+    droppedEvents: number;
+    oldestOccurredAt?: string;
+}
+export interface FactoryCloudEventOutbox {
+    enqueue(instance: FactoryCloudInstanceV1, event: FactoryCloudEventInputV1): Promise<FactoryCloudEventEnqueueResult>;
+    peekBatch(limit?: number, maxPayloadBytes?: number): Promise<FactoryCloudEventBatchV1 | undefined>;
+    acknowledge(eventIds: readonly string[]): Promise<number>;
+    /** Remove undeliverable events and increment the durable dropped counter. */
+    discard(eventIds: readonly string[]): Promise<number>;
+    stats(): Promise<FactoryCloudEventOutboxStats>;
+}
+/**
+ * A process-safe, append-by-rewrite outbox. Documents are written atomically
+ * with mode 0600 and guarded by the same advisory-lock pattern as Factory's
+ * durable lifecycle store. Event IDs are first-write-wins idempotency keys.
+ */
+export declare class FileFactoryCloudEventOutbox implements FactoryCloudEventOutbox {
+    #private;
+    constructor(options: FileFactoryCloudEventOutboxOptions);
+    enqueue(rawInstance: FactoryCloudInstanceV1, rawEvent: FactoryCloudEventInputV1): Promise<FactoryCloudEventEnqueueResult>;
+    peekBatch(limit?: number, maxPayloadBytes?: number): Promise<FactoryCloudEventBatchV1 | undefined>;
+    acknowledge(eventIds: readonly string[]): Promise<number>;
+    discard(eventIds: readonly string[]): Promise<number>;
+    stats(): Promise<FactoryCloudEventOutboxStats>;
+}
+//# sourceMappingURL=outbox.d.ts.map

package/dist/observability/outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../src/observability/outbox.ts"],"names":[],"mappings":"AAOA,OAAO,EASL,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,UAAU,CAAA;AAwBjB,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,mBAAmB,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,QAAQ,EAAE,sBAAsB,EAAE,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAA;IACnH,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAA;IAClG,WAAW,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzD,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACrD,KAAK,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAA;CAC/C;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,YAAW,uBAAuB;;gBAO7D,OAAO,EAAE,kCAAkC;IAOjD,OAAO,CACX,WAAW,EAAE,sBAAsB,EACnC,QAAQ,EAAE,wBAAwB,GACjC,OAAO,CAAC,8BAA8B,CAAC;IA6BpC,SAAS,CACb,KAAK,SAAqC,EAC1C,eAAe,SAAwC,GACtD,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;IAqC1C,WAAW,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAazD,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBrD,KAAK,IAAI,OAAO,CAAC,4BAA4B,CAAC;CAyErD"}