kadi-harness-runtime 0.1.8

package/README.md

@@ -0,0 +1,20 @@
+# kadi-harness-runtime
+
+Frontend-neutral KADI harness execution runtime.
+
+## Runner binary
+
+The package exposes `kadi-harness-runner` through the npm `bin` field. After
+installing the package, invoke it directly from a shell or from
+`kadi-schedule`'s child-process task executor:
+
+```bash
+kadi-harness-runner --reference <base64url-signed-reference>
+```
+
+For local development, use `npm link` (or `npx kadi-harness-runner`) so the
+binary resolves from the package's `dist/runner/cli.js`. The runner loads a
+deployment-specific module named by `KADI_HARNESS_RUNNER_MODULE`; that module
+exports `createRunnerService()` and supplies the runtime registry, request
+store, signing-key provider, and replay guard. This keeps credentials and KADI
+service wiring out of scheduled task commands.

package/dist/adapter-loader.d.ts

@@ -0,0 +1,35 @@
+import type { AdapterIdentity, HarnessAdapter, KadiError } from "@kadi.build/kadi-harness-contracts";
+export type AdapterFactory = () => HarnessAdapter | Promise<HarnessAdapter>;
+export interface AdapterPackageSource {
+    readonly specifier: string;
+    readonly load?: () => Promise<unknown>;
+}
+export interface AdapterLoaderOptions {
+    /** Package specifiers are sorted before loading for deterministic discovery. */
+    readonly packages: readonly (string | AdapterPackageSource)[];
+    readonly importModule?: (specifier: string) => Promise<unknown>;
+}
+export interface LoadedAdapter {
+    readonly adapter: HarnessAdapter;
+    readonly source: string;
+}
+export interface AdapterLoadFailure {
+    readonly source: string;
+    readonly error: KadiError;
+}
+export interface AdapterLoadResult {
+    readonly adapters: readonly LoadedAdapter[];
+    readonly failures: readonly AdapterLoadFailure[];
+}
+/**
+ * Loads explicitly configured adapter packages. Discovery is metadata/factory
+ * based and never calls adapter.initialize(), so native harness processes are
+ * not started until the runtime selects a strategy for a run.
+ */
+export declare class AdapterLoader {
+    private readonly options;
+    constructor(options: AdapterLoaderOptions);
+    load(): Promise<AdapterLoadResult>;
+}
+export type AdapterIdentitySummary = Pick<AdapterIdentity, "id" | "name" | "version" | "contractVersion">;
+//# sourceMappingURL=adapter-loader.d.ts.map

package/dist/adapter-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-loader.d.ts","sourceRoot":"","sources":["../src/adapter-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAc,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEjH,MAAM,MAAM,cAAc,GAAG,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,oBAAoB,CAAC,EAAE,CAAC;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAClD;AAmED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAE5B,OAAO,EAAE,oBAAoB;IAInC,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAoChD;AAED,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAAC,CAAC"}

package/dist/adapter-loader.js

@@ -0,0 +1,109 @@
+const ADAPTER_EXPORTS = ["default", "adapter", "kadiHarnessAdapter", "createAdapter", "adapters"];
+function asRecord(value) {
+    return typeof value === "object" && value !== null ? value : undefined;
+}
+function isHarnessAdapter(value) {
+    const candidate = asRecord(value);
+    return (candidate !== undefined &&
+        typeof candidate.identity === "object" &&
+        candidate.identity !== null &&
+        typeof candidate.transport === "object" &&
+        candidate.transport !== null &&
+        typeof candidate.getCapabilities === "function" &&
+        typeof candidate.initialize === "function" &&
+        typeof candidate.run === "function" &&
+        typeof candidate.cancel === "function" &&
+        typeof candidate.close === "function");
+}
+function toMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function loadError(source, message, cause) {
+    const details = { source };
+    if (cause !== undefined)
+        details.cause = toMessage(cause);
+    return {
+        source,
+        error: {
+            code: "adapter_load_failed",
+            category: "adapter_unavailable",
+            message,
+            retryable: true,
+            details,
+            cause: cause === undefined ? undefined : { message: toMessage(cause) },
+        },
+    };
+}
+function factoriesFromModule(moduleValue) {
+    const moduleRecord = asRecord(moduleValue);
+    if (moduleRecord === undefined)
+        return [moduleValue];
+    const candidates = [];
+    for (const exportName of ADAPTER_EXPORTS) {
+        const candidate = moduleRecord[exportName];
+        if (candidate !== undefined)
+            candidates.push(candidate);
+    }
+    return candidates.length > 0 ? candidates : [moduleValue];
+}
+async function materialize(candidate) {
+    const value = typeof candidate === "function" ? await candidate() : candidate;
+    if (Array.isArray(value)) {
+        const adapters = [];
+        for (const entry of value)
+            adapters.push(...(await materialize(entry)));
+        return adapters;
+    }
+    if (!isHarnessAdapter(value))
+        throw new Error("package export does not provide a conforming HarnessAdapter");
+    return [value];
+}
+/**
+ * Loads explicitly configured adapter packages. Discovery is metadata/factory
+ * based and never calls adapter.initialize(), so native harness processes are
+ * not started until the runtime selects a strategy for a run.
+ */
+export class AdapterLoader {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async load() {
+        const sources = [...this.options.packages].sort((left, right) => {
+            const leftSpecifier = typeof left === "string" ? left : left.specifier;
+            const rightSpecifier = typeof right === "string" ? right : right.specifier;
+            return leftSpecifier.localeCompare(rightSpecifier);
+        });
+        const adapters = [];
+        const failures = [];
+        for (const sourceEntry of sources) {
+            const sourceConfig = typeof sourceEntry === "string" ? undefined : sourceEntry;
+            const source = typeof sourceEntry === "string" ? sourceEntry : sourceEntry.specifier;
+            try {
+                const moduleValue = sourceConfig?.load
+                    ? await sourceConfig.load()
+                    : await (this.options.importModule ?? ((specifier) => import(specifier)))(source);
+                const candidates = factoriesFromModule(moduleValue);
+                let found = false;
+                const moduleAdapterKeys = new Set();
+                for (const candidate of candidates) {
+                    for (const adapter of await materialize(candidate)) {
+                        const adapterKey = `${adapter.identity.id}\u0000${adapter.identity.version}`;
+                        if (moduleAdapterKeys.has(adapterKey))
+                            continue;
+                        moduleAdapterKeys.add(adapterKey);
+                        adapters.push({ adapter, source });
+                        found = true;
+                    }
+                }
+                if (!found)
+                    failures.push(loadError(source, "package did not export an adapter"));
+            }
+            catch (error) {
+                failures.push(loadError(source, `failed to load adapter package '${source}'`, error));
+            }
+        }
+        return { adapters, failures };
+    }
+}
+//# sourceMappingURL=adapter-loader.js.map

package/dist/adapter-loader.js.map

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

package/dist/event-bus.d.ts

@@ -0,0 +1,55 @@
+import { type EventFilter, type HarnessEvent, type KadiError } from "@kadi.build/kadi-harness-contracts";
+import { EventNormalizer, type AdapterEventUpdate, type EventNormalizerOptions, type EventScope } from "./event-normalizer.js";
+export interface EventObserveOptions extends EventFilter {
+    readonly signal?: AbortSignal;
+}
+export type EventDropReason = "duplicate_event" | "terminal_closed";
+export interface EventPublishResult {
+    readonly accepted: boolean;
+    readonly event: HarnessEvent;
+    readonly reason?: EventDropReason;
+}
+export interface EventBusDiagnostics {
+    readonly published: number;
+    readonly duplicateEvents: number;
+    readonly droppedAfterTerminal: number;
+    readonly invalidEvents: number;
+    readonly activeSubscribers: number;
+    readonly terminalRuns: number;
+    readonly trackedRuns: number;
+}
+export interface EventBusOptions {
+    readonly contractVersion?: string;
+    readonly normalizer?: EventNormalizer;
+    readonly normalizerOptions?: EventNormalizerOptions;
+}
+export interface EventSubscription {
+    readonly events: AsyncIterable<HarnessEvent>;
+    close(): Promise<void>;
+}
+export declare class EventBusError extends Error {
+    readonly error: KadiError;
+    constructor(error: KadiError);
+}
+export declare class EventBus {
+    private readonly contractVersion;
+    private readonly normalizer;
+    private readonly runs;
+    private readonly subscribers;
+    private published;
+    private duplicateEvents;
+    private droppedAfterTerminal;
+    private invalidEvents;
+    constructor(options?: EventBusOptions);
+    publish(event: HarnessEvent): Promise<EventPublishResult>;
+    publishUpdate(scope: EventScope, update: AdapterEventUpdate): Promise<EventPublishResult>;
+    subscribe(runId: string, options?: EventObserveOptions): EventSubscription;
+    observe(runId: string, options?: EventObserveOptions): AsyncIterable<HarnessEvent>;
+    diagnostics(): EventBusDiagnostics;
+    private createRun;
+    private replay;
+    private deliver;
+    private next;
+    private closeSubscriber;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAEjB,KAAK,SAAS,EAEf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,eAAe,EAEf,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;CACrD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA6CD,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,KAAK,EAAE,SAAS,CAAC;gBAEd,KAAK,EAAE,SAAS;CAKpC;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,aAAa,CAAK;gBAEP,OAAO,GAAE,eAAoB;IAQnC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuCzD,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS/F,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,iBAAiB;IA8B9E,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,aAAa,CAAC,YAAY,CAAC;IAItF,WAAW,IAAI,mBAAmB;IAYzC,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,IAAI;YAQE,eAAe;CAQ9B"}

package/dist/event-bus.js

@@ -0,0 +1,170 @@
+import { CONTRACT_VERSION, HarnessEventSchema, } from "@kadi.build/kadi-harness-contracts";
+import { EventNormalizer, EventNormalizationError, } from "./event-normalizer.js";
+function makeError(code, message, details = {}) {
+    return {
+        code,
+        category: "validation",
+        message,
+        retryable: false,
+        details: Object.fromEntries(Object.entries(details).filter(([, value]) => value !== undefined)),
+    };
+}
+function isTerminal(type) {
+    return type === "completed" || type === "failed" || type === "cancelled";
+}
+function matches(event, types) {
+    return types === undefined || types.includes(event.type);
+}
+export class EventBusError extends Error {
+    error;
+    constructor(error) {
+        super(error.message);
+        this.name = "EventBusError";
+        this.error = error;
+    }
+}
+export class EventBus {
+    contractVersion;
+    normalizer;
+    runs = new Map();
+    subscribers = new Set();
+    published = 0;
+    duplicateEvents = 0;
+    droppedAfterTerminal = 0;
+    invalidEvents = 0;
+    constructor(options = {}) {
+        this.contractVersion = options.contractVersion ?? CONTRACT_VERSION;
+        this.normalizer = options.normalizer ?? new EventNormalizer({
+            contractVersion: this.contractVersion,
+            ...options.normalizerOptions,
+        });
+    }
+    async publish(event) {
+        const parsed = HarnessEventSchema.safeParse(event);
+        if (!parsed.success) {
+            this.invalidEvents += 1;
+            throw new EventBusError(makeError("invalid_harness_event", "event does not satisfy the published HarnessEvent schema", { issues: parsed.error.issues.map((issue) => ({ path: issue.path.map(String).join("."), message: issue.message })) }));
+        }
+        const normalized = parsed.data;
+        if (normalized.contractVersion !== this.contractVersion) {
+            this.invalidEvents += 1;
+            throw new EventBusError({
+                ...makeError("incompatible_harness_event", `event contract ${normalized.contractVersion} does not match bus contract ${this.contractVersion}`, { eventContractVersion: normalized.contractVersion, busContractVersion: this.contractVersion }),
+                category: "contract_incompatible",
+            });
+        }
+        const run = this.runs.get(normalized.runId) ?? this.createRun(normalized.runId);
+        if (run.eventIds.has(normalized.eventId)) {
+            this.duplicateEvents += 1;
+            return { accepted: false, event: normalized, reason: "duplicate_event" };
+        }
+        if (run.terminal) {
+            this.droppedAfterTerminal += 1;
+            return { accepted: false, event: normalized, reason: "terminal_closed" };
+        }
+        run.eventIds.add(normalized.eventId);
+        run.events.push(normalized);
+        this.published += 1;
+        if (isTerminal(normalized.type))
+            run.terminal = true;
+        this.deliver(normalized);
+        return { accepted: true, event: normalized };
+    }
+    async publishUpdate(scope, update) {
+        try {
+            return await this.publish(this.normalizer.normalize(update, scope));
+        }
+        catch (caught) {
+            if (caught instanceof EventNormalizationError)
+                this.invalidEvents += 1;
+            throw caught;
+        }
+    }
+    subscribe(runId, options = {}) {
+        const stored = this.runs.get(runId);
+        const subscriber = {
+            runId,
+            types: options.types,
+            queue: this.replay(stored?.events ?? [], options),
+            pending: [],
+            closed: false,
+        };
+        this.subscribers.add(subscriber);
+        if (options.signal) {
+            const abort = () => { void this.closeSubscriber(subscriber); };
+            if (options.signal.aborted)
+                abort();
+            else {
+                options.signal.addEventListener("abort", abort, { once: true });
+                subscriber.removeAbortListener = () => options.signal?.removeEventListener("abort", abort);
+            }
+        }
+        const close = async () => this.closeSubscriber(subscriber);
+        const iterator = {
+            next: () => this.next(subscriber),
+            return: async () => {
+                await close();
+                return { done: true, value: undefined };
+            },
+            [Symbol.asyncIterator]() { return this; },
+        };
+        return { events: iterator, close };
+    }
+    observe(runId, options = {}) {
+        return this.subscribe(runId, options).events;
+    }
+    diagnostics() {
+        return {
+            published: this.published,
+            duplicateEvents: this.duplicateEvents,
+            droppedAfterTerminal: this.droppedAfterTerminal,
+            invalidEvents: this.invalidEvents,
+            activeSubscribers: this.subscribers.size,
+            terminalRuns: [...this.runs.values()].filter((run) => run.terminal).length,
+            trackedRuns: this.runs.size,
+        };
+    }
+    createRun(runId) {
+        const run = { events: [], eventIds: new Set(), terminal: false };
+        this.runs.set(runId, run);
+        return run;
+    }
+    replay(events, options) {
+        let start = 0;
+        if (options.afterEventId) {
+            const index = events.findIndex((event) => event.eventId === options.afterEventId);
+            start = index >= 0 ? index + 1 : 0;
+        }
+        return events.slice(start).filter((event) => matches(event, options.types));
+    }
+    deliver(event) {
+        for (const subscriber of this.subscribers) {
+            if (subscriber.closed || subscriber.runId !== event.runId || !matches(event, subscriber.types))
+                continue;
+            const pending = subscriber.pending.shift();
+            if (pending)
+                pending.resolve({ done: false, value: event });
+            else
+                subscriber.queue.push(event);
+        }
+    }
+    next(subscriber) {
+        if (subscriber.queue.length > 0) {
+            return Promise.resolve({ done: false, value: subscriber.queue.shift() });
+        }
+        if (subscriber.closed)
+            return Promise.resolve({ done: true, value: undefined });
+        return new Promise((resolve) => subscriber.pending.push({ resolve }));
+    }
+    async closeSubscriber(subscriber) {
+        if (subscriber.closed)
+            return;
+        subscriber.closed = true;
+        this.subscribers.delete(subscriber);
+        subscriber.removeAbortListener?.();
+        const pending = subscriber.pending.splice(0);
+        for (const waiter of pending)
+            waiter.resolve({ done: true, value: undefined });
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GAMnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,uBAAuB,GAIxB,MAAM,uBAAuB,CAAC;AAsD/B,SAAS,SAAS,CAChB,IAAY,EACZ,OAAe,EACf,UAAmC,EAAE;IAErC,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,YAAY;QACtB,OAAO;QACP,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CACrD;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAsB;IACxC,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,WAAW,CAAC;AAC3E,CAAC;AAED,SAAS,OAAO,CAAC,KAAmB,EAAE,KAA8C;IAClF,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtB,KAAK,CAAY;IAEjC,YAAmB,KAAgB;QACjC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,QAAQ;IACF,eAAe,CAAS;IACxB,UAAU,CAAkB;IAC5B,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IACpC,WAAW,GAAG,IAAI,GAAG,EAAc,CAAC;IAC7C,SAAS,GAAG,CAAC,CAAC;IACd,eAAe,GAAG,CAAC,CAAC;IACpB,oBAAoB,GAAG,CAAC,CAAC;IACzB,aAAa,GAAG,CAAC,CAAC;IAE1B,YAAmB,UAA2B,EAAE;QAC9C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,gBAAgB,CAAC;QACnE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,eAAe,CAAC;YAC1D,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,GAAG,OAAO,CAAC,iBAAiB;SAC7B,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,KAAmB;QACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;YACxB,MAAM,IAAI,aAAa,CAAC,SAAS,CAC/B,uBAAuB,EACvB,0DAA0D,EAC1D,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CACrH,CAAC,CAAC;QACL,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;QAC/B,IAAI,UAAU,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;YACxD,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;YACxB,MAAM,IAAI,aAAa,CAAC;gBACtB,GAAG,SAAS,CACV,4BAA4B,EAC5B,kBAAkB,UAAU,CAAC,eAAe,gCAAgC,IAAI,CAAC,eAAe,EAAE,EAClG,EAAE,oBAAoB,EAAE,UAAU,CAAC,eAAe,EAAE,kBAAkB,EAAE,IAAI,CAAC,eAAe,EAAE,CAC/F;gBACD,QAAQ,EAAE,uBAAuB;aAClC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChF,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;YAC1B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAC3E,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,IAAI,CAAC,oBAAoB,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAC3E,CAAC;QACD,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACrC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,KAAiB,EAAE,MAA0B;QACtE,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,IAAI,MAAM,YAAY,uBAAuB;gBAAE,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;YACvE,MAAM,MAAM,CAAC;QACf,CAAC;IACH,CAAC;IAEM,SAAS,CAAC,KAAa,EAAE,UAA+B,EAAE;QAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,UAAU,GAAe;YAC7B,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC;YACjD,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,KAAK;SACd,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;gBAAE,KAAK,EAAE,CAAC;iBAC/B,CAAC;gBACJ,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChE,UAAU,CAAC,mBAAmB,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAwC;YACpD,IAAI,EAAE,GAA0C,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YACxE,MAAM,EAAE,KAAK,IAA2C,EAAE;gBACxD,MAAM,KAAK,EAAE,CAAC;gBACd,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAkB,EAAE,CAAC;YACnD,CAAC;YACD,CAAC,MAAM,CAAC,aAAa,CAAC,KAA0C,OAAO,IAAI,CAAC,CAAC,CAAC;SAC/E,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IAEM,OAAO,CAAC,KAAa,EAAE,UAA+B,EAAE;QAC7D,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IAC/C,CAAC;IAEM,WAAW;QAChB,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,iBAAiB,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YACxC,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM;YAC1E,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;SAC5B,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,MAAM,GAAG,GAAc,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC5E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,MAAM,CAAC,MAA+B,EAAE,OAA4B;QAC1E,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;YAClF,KAAK,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,CAAC;IAEO,OAAO,CAAC,KAAmB;QACjC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC;gBAAE,SAAS;YACzG,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,OAAO;gBAAE,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;;gBACvD,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,UAAsB;QACjC,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,EAAkB,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,UAAU,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAkB,EAAE,CAAC,CAAC;QACzF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,UAAsB;QAClD,IAAI,UAAU,CAAC,MAAM;YAAE,OAAO;QAC9B,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACpC,UAAU,CAAC,mBAAmB,EAAE,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7C,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAkB,EAAE,CAAC,CAAC;IAC1F,CAAC;CACF"}

package/dist/event-normalizer.d.ts

@@ -0,0 +1,41 @@
+import { type CorrelationMetadata, type HarnessEvent, type HarnessEventType, type KadiError, type JsonObject, type NativeEventExtension } from "@kadi.build/kadi-harness-contracts";
+export interface EventScope {
+    readonly contractVersion?: string;
+    readonly sessionId: string;
+    readonly runId: string;
+    readonly adapterId: string;
+    readonly correlation: CorrelationMetadata;
+}
+/** Adapter translators convert native updates into this small generic shape. */
+export interface AdapterEventUpdate {
+    readonly type: HarnessEventType;
+    readonly eventId?: string;
+    readonly timestamp?: string;
+    readonly correlation?: CorrelationMetadata;
+    readonly payload?: JsonObject;
+    readonly native?: NativeEventExtension;
+}
+export type EventIdFactory = (scope: EventScope) => string;
+export type EventClock = () => string;
+export interface EventNormalizerOptions {
+    readonly contractVersion?: string;
+    readonly eventIdFactory?: EventIdFactory;
+    readonly clock?: EventClock;
+}
+export declare class EventNormalizationError extends Error {
+    readonly error: KadiError;
+    constructor(error: KadiError);
+}
+/**
+ * Converts adapter-neutral updates into the versioned event envelope. Native
+ * adapters can supply translators without adding harness branches here.
+ */
+export declare class EventNormalizer {
+    private readonly contractVersion;
+    private readonly eventIdFactory;
+    private readonly clock;
+    constructor(options?: EventNormalizerOptions);
+    normalize(update: AdapterEventUpdate, scope: EventScope): HarnessEvent;
+    private mergeCorrelation;
+}
+//# sourceMappingURL=event-normalizer.d.ts.map

package/dist/event-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-normalizer.d.ts","sourceRoot":"","sources":["../src/event-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,oBAAoB,EAC1B,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;CAC3C;AAED,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;CACxC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC;AAEtC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,KAAK,EAAE,SAAS,CAAC;gBAEd,KAAK,EAAE,SAAS;CAKpC;AAqBD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEhB,OAAO,GAAE,sBAA2B;IAMhD,SAAS,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY;IA+B7E,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist/event-normalizer.js

@@ -0,0 +1,68 @@
+import { CONTRACT_VERSION, HarnessEventSchema, } from "@kadi.build/kadi-harness-contracts";
+export class EventNormalizationError extends Error {
+    error;
+    constructor(error) {
+        super(error.message);
+        this.name = "EventNormalizationError";
+        this.error = error;
+    }
+}
+let generatedEventId = 0;
+function defaultEventIdFactory(scope) {
+    generatedEventId += 1;
+    return `${scope.adapterId}-event-${Date.now().toString(36)}-${generatedEventId.toString(36)}`;
+}
+function makeError(message, details = {}) {
+    return {
+        code: "invalid_harness_event",
+        category: "validation",
+        message,
+        retryable: false,
+        details: Object.fromEntries(Object.entries(details).filter(([, value]) => value !== undefined)),
+    };
+}
+/**
+ * Converts adapter-neutral updates into the versioned event envelope. Native
+ * adapters can supply translators without adding harness branches here.
+ */
+export class EventNormalizer {
+    contractVersion;
+    eventIdFactory;
+    clock;
+    constructor(options = {}) {
+        this.contractVersion = options.contractVersion ?? CONTRACT_VERSION;
+        this.eventIdFactory = options.eventIdFactory ?? defaultEventIdFactory;
+        this.clock = options.clock ?? (() => new Date().toISOString());
+    }
+    normalize(update, scope) {
+        const event = {
+            type: update.type,
+            contractVersion: scope.contractVersion ?? this.contractVersion,
+            eventId: update.eventId ?? this.eventIdFactory(scope),
+            timestamp: update.timestamp ?? this.clock(),
+            sessionId: scope.sessionId,
+            runId: scope.runId,
+            adapterId: scope.adapterId,
+            correlation: this.mergeCorrelation(scope.correlation, update.correlation),
+            payload: update.payload,
+            native: update.native,
+        };
+        const parsed = HarnessEventSchema.safeParse(event);
+        if (!parsed.success) {
+            throw new EventNormalizationError(makeError("adapter update does not satisfy the published HarnessEvent contract", {
+                sessionId: scope.sessionId,
+                runId: scope.runId,
+                adapterId: scope.adapterId,
+                issues: parsed.error.issues.map((issue) => ({
+                    path: issue.path.map(String).join("."),
+                    message: issue.message,
+                })),
+            }));
+        }
+        return parsed.data;
+    }
+    mergeCorrelation(scopeCorrelation, updateCorrelation) {
+        return { ...scopeCorrelation, ...updateCorrelation };
+    }
+}
+//# sourceMappingURL=event-normalizer.js.map

package/dist/event-normalizer.js.map

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

package/dist/gateways/artifacts.d.ts

@@ -0,0 +1,24 @@
+import { type ArtifactContent, type ArtifactReference, type ArtifactWriteRequest, type ScopedArtifactService, type ServiceResult } from "@kadi.build/kadi-harness-contracts";
+import type { GatewayAuthorizer } from "./tools.js";
+import type { GatewayScope } from "./tools.js";
+export interface ArtifactBackend {
+    put(scope: GatewayScope, request: ArtifactWriteRequest): Promise<unknown> | unknown;
+    get(scope: GatewayScope, reference: ArtifactReference): Promise<unknown> | unknown;
+    list(scope: GatewayScope): Promise<unknown> | unknown;
+}
+export interface ArtifactGatewayOptions {
+    readonly scope: GatewayScope;
+    readonly backend: ArtifactBackend;
+    readonly authorize?: GatewayAuthorizer;
+}
+export declare function normalizeArtifactReference(value: unknown, scope: GatewayScope): ArtifactReference;
+/** Scoped artifact facade over session-state storage or another durable backend. */
+export declare class ArtifactGateway implements ScopedArtifactService {
+    private readonly options;
+    constructor(options: ArtifactGatewayOptions);
+    put(request: ArtifactWriteRequest): Promise<ServiceResult<ArtifactReference>>;
+    get(reference: ArtifactReference): Promise<ServiceResult<ArtifactContent | undefined>>;
+    list(): Promise<ServiceResult<readonly ArtifactReference[]>>;
+}
+export declare function createArtifactGateway(options: ArtifactGatewayOptions): ArtifactGateway;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/gateways/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/gateways/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAEzB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EACnB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACpF,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACnF,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACvD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;CACxC;AA0CD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,GAAG,iBAAiB,CA2BjG;AAED,oFAAoF;AACpF,qBAAa,eAAgB,YAAW,qBAAqB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAE9B,OAAO,EAAE,sBAAsB;IAIrC,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAY7E,GAAG,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IActF,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;CAY1E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAEtF"}