@sentropic/h2a-runtime 0.81.0

package/dist/lineage-lease.d.ts

@@ -0,0 +1,152 @@
+/**
+ * lineage-lease.ts — Phase A0a
+ *
+ * Pure module: lineage identity + lease/epoch/fencing.
+ * No pods, no sync, no secrets, no kubectl. Only node:fs / node:path / node:crypto.
+ *
+ * Invariants
+ * ----------
+ * - Every mutating lease operation verifies epoch === expectedEpoch.
+ *   A stale epoch is rejected — no exception, typed error return.
+ * - Write-rename atomicity: write to <file>.tmp then renameSync to <file>.
+ *   Atomicity relies on POSIX rename (best-effort on NFS).
+ * - No external dependencies.
+ *
+ * Root path
+ * ---------
+ * All files live under `root` (default: process.cwd()).
+ *   Leases:   <root>/.remote/leases/<lineageId>.json
+ *   Lineages: <root>/.remote/lineages/<lineageId>.json
+ */
+/** Opaque lineage identity: `lin_<uuidv7-style>`. Struck once, persisted, derived from nothing. */
+export type LineageId = `lin_${string}`;
+/**
+ * Full lineage record persisted in `.remote/lineages/<id>.json`.
+ * One file per lineage — supports multiple sessions / fanout on the same workspace.
+ */
+export interface LineageRecord {
+    lineage: LineageId;
+    profile: string;
+    kind: "local" | "remote";
+    incarnation: {
+        local: {
+            tmux: string;
+            pid: number;
+        } | null;
+        remote: {
+            sessionId: string;
+        } | null;
+    };
+    /** ws:<hex> values accumulated over the lineage's lifetime (one per ws move) */
+    wsHistory: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Lease record persisted in `.remote/leases/<lineageId>.json`.
+ * `epoch` is the fencing token: every mutation must present the current epoch.
+ */
+export interface LineageLease {
+    lineageId: LineageId;
+    /** Monotone fencing token — incremented on handoff, rejected when stale. */
+    epoch: number;
+    /** Instance id of the current holder, e.g. "claude:remote:181cda7ac333". */
+    holder: string;
+    /** Tmux slug (local) or sessionId (remote). */
+    incarnationId: string;
+    location: "local" | "remote";
+    /** ISO timestamp after which this lease is considered expired. */
+    expiresAt: string;
+}
+export type AcquireResult = LineageLease | {
+    error: "conflict";
+    current: LineageLease;
+};
+export type RenewResult = LineageLease | {
+    error: "stale_epoch" | "not_holder";
+};
+export type HandoffResult = LineageLease | {
+    error: "stale_epoch" | "not_holder";
+};
+export type ReleaseResult = void | {
+    error: "stale_epoch" | "not_holder";
+};
+/**
+ * Read the current lease for a lineage without mutating it.
+ */
+export declare function readLease(lineageId: LineageId, root?: string): LineageLease | null;
+/**
+ * Returns true when the lease's `expiresAt` is in the past.
+ */
+export declare function isLeaseExpired(lease: LineageLease): boolean;
+/**
+ * Acquire (or take over an expired) lease.
+ *
+ * - If no lease exists → creates one at epoch 0.
+ * - If the existing lease is expired → takes over, keeps epoch (no increment).
+ * - If the existing lease is held and not expired → returns { error: "conflict" }.
+ */
+export declare function acquireLease(lineageId: LineageId, holder: string, incarnationId: string, location: "local" | "remote", ttlMs: number, root?: string): AcquireResult;
+/**
+ * Renew a held lease (push expiry forward).
+ *
+ * Rejects with `stale_epoch` when expectedEpoch !== current epoch.
+ * Rejects with `not_holder` when holder doesn't match.
+ */
+export declare function renewLease(lineageId: LineageId, holder: string, expectedEpoch: number, ttlMs: number, root?: string): RenewResult;
+/**
+ * Hand off the lease from one holder to another.
+ *
+ * Increments epoch (+1) on success — the old epoch is now invalid for any
+ * mutation (fencing: the old holder becomes a zombie and will be rejected on
+ * any future renew/handoff/release attempt).
+ *
+ * Rejects with `stale_epoch` when expectedEpoch !== current epoch.
+ * Rejects with `not_holder` when fromHolder doesn't match.
+ */
+export declare function handoffLease(lineageId: LineageId, fromHolder: string, expectedEpoch: number, toHolder: string, toIncarnationId: string, toLocation: "local" | "remote", ttlMs: number, root?: string): HandoffResult;
+/**
+ * Release (delete) a held lease.
+ *
+ * Rejects with `stale_epoch` when expectedEpoch !== current epoch.
+ * Rejects with `not_holder` when holder doesn't match.
+ * No-ops if the lease file doesn't exist (idempotent on double-release).
+ */
+export declare function releaseLease(lineageId: LineageId, holder: string, expectedEpoch: number, root?: string): ReleaseResult;
+/**
+ * Create and persist a new LineageRecord.
+ * Does NOT create a lease — that is a separate step.
+ */
+export declare function createLineage(profile: string, kind: "local" | "remote", wsHex: string, root?: string): LineageRecord;
+/**
+ * Read a lineage record by id.
+ */
+export declare function readLineage(lineageId: LineageId, root?: string): LineageRecord | null;
+/**
+ * Patch a lineage record. `updatedAt` is always refreshed.
+ * Throws if the lineage doesn't exist.
+ */
+export declare function updateLineage(lineageId: LineageId, patch: Partial<Omit<LineageRecord, "lineage" | "createdAt">>, root?: string): LineageRecord;
+/**
+ * List all lineage records under <root>/.remote/lineages/.
+ * Returns an empty array if the directory doesn't exist yet.
+ */
+export declare function listLineages(root?: string): LineageRecord[];
+/**
+ * Suspend the local incarnation: write a sentinel file that the agent checks
+ * before starting a new turn. Does NOT kill the process.
+ *
+ * File path: <root>/.remote/lineages/<lineageId>.suspended
+ */
+export declare function suspendLocalIncarnation(lineageId: LineageId, root?: string): void;
+/**
+ * Returns true when the sentinel file exists (incarnation is suspended).
+ */
+export declare function isIncarnationSuspended(lineageId: LineageId, root?: string): boolean;
+/**
+ * Resume the local incarnation: remove the sentinel file.
+ * No-op if the file doesn't exist.
+ */
+export declare function resumeLocalIncarnation(lineageId: LineageId, root?: string): void;
+export { computeDurableWorkspaceId, normalizeRootCommits, } from "./conductor-launch.js";
+//# sourceMappingURL=lineage-lease.d.ts.map

package/dist/lineage-lease.d.ts.map

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

package/dist/lineage-lease.js

@@ -0,0 +1,303 @@
+/**
+ * lineage-lease.ts — Phase A0a
+ *
+ * Pure module: lineage identity + lease/epoch/fencing.
+ * No pods, no sync, no secrets, no kubectl. Only node:fs / node:path / node:crypto.
+ *
+ * Invariants
+ * ----------
+ * - Every mutating lease operation verifies epoch === expectedEpoch.
+ *   A stale epoch is rejected — no exception, typed error return.
+ * - Write-rename atomicity: write to <file>.tmp then renameSync to <file>.
+ *   Atomicity relies on POSIX rename (best-effort on NFS).
+ * - No external dependencies.
+ *
+ * Root path
+ * ---------
+ * All files live under `root` (default: process.cwd()).
+ *   Leases:   <root>/.remote/leases/<lineageId>.json
+ *   Lineages: <root>/.remote/lineages/<lineageId>.json
+ */
+import { createHash, randomUUID } from "node:crypto";
+import { mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// Filesystem helpers
+// ---------------------------------------------------------------------------
+function leasesDir(root) {
+    return join(root, ".remote", "leases");
+}
+function lineagesDir(root) {
+    return join(root, ".remote", "lineages");
+}
+function leaseFile(root, lineageId) {
+    return join(leasesDir(root), `${lineageId}.json`);
+}
+function lineageFile(root, lineageId) {
+    return join(lineagesDir(root), `${lineageId}.json`);
+}
+function ensureDir(dir) {
+    mkdirSync(dir, { recursive: true });
+}
+/**
+ * Atomic write: serialize to JSON, write to <path>.tmp, then rename to <path>.
+ * Relies on POSIX rename semantics (best-effort on NFS).
+ */
+function atomicWrite(filePath, data) {
+    const tmp = `${filePath}.tmp`;
+    writeFileSync(tmp, JSON.stringify(data, null, 2), "utf8");
+    renameSync(tmp, filePath);
+}
+function readJson(filePath) {
+    try {
+        const raw = readFileSync(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Lease operations
+// ---------------------------------------------------------------------------
+/**
+ * Read the current lease for a lineage without mutating it.
+ */
+export function readLease(lineageId, root = process.cwd()) {
+    return readJson(leaseFile(root, lineageId));
+}
+/**
+ * Returns true when the lease's `expiresAt` is in the past.
+ */
+export function isLeaseExpired(lease) {
+    return new Date(lease.expiresAt).getTime() <= Date.now();
+}
+/**
+ * Acquire (or take over an expired) lease.
+ *
+ * - If no lease exists → creates one at epoch 0.
+ * - If the existing lease is expired → takes over, keeps epoch (no increment).
+ * - If the existing lease is held and not expired → returns { error: "conflict" }.
+ */
+export function acquireLease(lineageId, holder, incarnationId, location, ttlMs, root = process.cwd()) {
+    ensureDir(leasesDir(root));
+    const existing = readLease(lineageId, root);
+    if (existing !== null && !isLeaseExpired(existing)) {
+        return { error: "conflict", current: existing };
+    }
+    const epoch = existing?.epoch ?? 0;
+    const lease = {
+        lineageId,
+        epoch,
+        holder,
+        incarnationId,
+        location,
+        expiresAt: new Date(Date.now() + ttlMs).toISOString(),
+    };
+    atomicWrite(leaseFile(root, lineageId), lease);
+    return lease;
+}
+/**
+ * Renew a held lease (push expiry forward).
+ *
+ * Rejects with `stale_epoch` when expectedEpoch !== current epoch.
+ * Rejects with `not_holder` when holder doesn't match.
+ */
+export function renewLease(lineageId, holder, expectedEpoch, ttlMs, root = process.cwd()) {
+    const current = readLease(lineageId, root);
+    if (current === null) {
+        return { error: "stale_epoch" };
+    }
+    if (current.epoch !== expectedEpoch) {
+        return { error: "stale_epoch" };
+    }
+    if (current.holder !== holder) {
+        return { error: "not_holder" };
+    }
+    const renewed = {
+        ...current,
+        expiresAt: new Date(Date.now() + ttlMs).toISOString(),
+    };
+    atomicWrite(leaseFile(root, lineageId), renewed);
+    return renewed;
+}
+/**
+ * Hand off the lease from one holder to another.
+ *
+ * Increments epoch (+1) on success — the old epoch is now invalid for any
+ * mutation (fencing: the old holder becomes a zombie and will be rejected on
+ * any future renew/handoff/release attempt).
+ *
+ * Rejects with `stale_epoch` when expectedEpoch !== current epoch.
+ * Rejects with `not_holder` when fromHolder doesn't match.
+ */
+export function handoffLease(lineageId, fromHolder, expectedEpoch, toHolder, toIncarnationId, toLocation, ttlMs, root = process.cwd()) {
+    const current = readLease(lineageId, root);
+    if (current === null) {
+        return { error: "stale_epoch" };
+    }
+    if (current.epoch !== expectedEpoch) {
+        return { error: "stale_epoch" };
+    }
+    if (current.holder !== fromHolder) {
+        return { error: "not_holder" };
+    }
+    const next = {
+        lineageId,
+        epoch: current.epoch + 1,
+        holder: toHolder,
+        incarnationId: toIncarnationId,
+        location: toLocation,
+        expiresAt: new Date(Date.now() + ttlMs).toISOString(),
+    };
+    atomicWrite(leaseFile(root, lineageId), next);
+    return next;
+}
+/**
+ * Release (delete) a held lease.
+ *
+ * Rejects with `stale_epoch` when expectedEpoch !== current epoch.
+ * Rejects with `not_holder` when holder doesn't match.
+ * No-ops if the lease file doesn't exist (idempotent on double-release).
+ */
+export function releaseLease(lineageId, holder, expectedEpoch, root = process.cwd()) {
+    const current = readLease(lineageId, root);
+    if (current === null) {
+        // Already gone — idempotent.
+        return;
+    }
+    if (current.epoch !== expectedEpoch) {
+        return { error: "stale_epoch" };
+    }
+    if (current.holder !== holder) {
+        return { error: "not_holder" };
+    }
+    rmSync(leaseFile(root, lineageId), { force: true });
+}
+// ---------------------------------------------------------------------------
+// Lineage record CRUD
+// ---------------------------------------------------------------------------
+/**
+ * Generate a fresh `lin_<uuid>` lineage id. Uses crypto.randomUUID() (v4),
+ * prefixed with "lin_".
+ */
+function newLineageId() {
+    return `lin_${randomUUID().replace(/-/g, "")}`;
+}
+/**
+ * Create and persist a new LineageRecord.
+ * Does NOT create a lease — that is a separate step.
+ */
+export function createLineage(profile, kind, wsHex, root = process.cwd()) {
+    ensureDir(lineagesDir(root));
+    const now = new Date().toISOString();
+    const record = {
+        lineage: newLineageId(),
+        profile,
+        kind,
+        incarnation: {
+            local: null,
+            remote: null,
+        },
+        wsHistory: [wsHex],
+        createdAt: now,
+        updatedAt: now,
+    };
+    atomicWrite(lineageFile(root, record.lineage), record);
+    return record;
+}
+/**
+ * Read a lineage record by id.
+ */
+export function readLineage(lineageId, root = process.cwd()) {
+    return readJson(lineageFile(root, lineageId));
+}
+/**
+ * Patch a lineage record. `updatedAt` is always refreshed.
+ * Throws if the lineage doesn't exist.
+ */
+export function updateLineage(lineageId, patch, root = process.cwd()) {
+    const existing = readLineage(lineageId, root);
+    if (existing === null) {
+        throw new Error(`lineage not found: ${lineageId}`);
+    }
+    const updated = {
+        ...existing,
+        ...patch,
+        lineage: existing.lineage, // immutable
+        createdAt: existing.createdAt, // immutable
+        updatedAt: new Date().toISOString(),
+    };
+    atomicWrite(lineageFile(root, lineageId), updated);
+    return updated;
+}
+/**
+ * List all lineage records under <root>/.remote/lineages/.
+ * Returns an empty array if the directory doesn't exist yet.
+ */
+export function listLineages(root = process.cwd()) {
+    const dir = lineagesDir(root);
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".json"))
+            continue;
+        const rec = readJson(join(dir, entry));
+        if (rec !== null) {
+            results.push(rec);
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Incarnation suspension — Phase A0c
+// ---------------------------------------------------------------------------
+/**
+ * Path of the sentinel file that signals a local incarnation is suspended.
+ * Written by `suspendLocalIncarnation`, checked by `isIncarnationSuspended`,
+ * removed by `resumeLocalIncarnation`.
+ */
+function suspendedFile(lineageId, root) {
+    return join(lineagesDir(root), `${lineageId}.suspended`);
+}
+/**
+ * Suspend the local incarnation: write a sentinel file that the agent checks
+ * before starting a new turn. Does NOT kill the process.
+ *
+ * File path: <root>/.remote/lineages/<lineageId>.suspended
+ */
+export function suspendLocalIncarnation(lineageId, root = process.cwd()) {
+    ensureDir(lineagesDir(root));
+    writeFileSync(suspendedFile(lineageId, root), new Date().toISOString(), "utf8");
+}
+/**
+ * Returns true when the sentinel file exists (incarnation is suspended).
+ */
+export function isIncarnationSuspended(lineageId, root = process.cwd()) {
+    try {
+        // Just check existence — readFileSync throws on ENOENT.
+        readFileSync(suspendedFile(lineageId, root));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resume the local incarnation: remove the sentinel file.
+ * No-op if the file doesn't exist.
+ */
+export function resumeLocalIncarnation(lineageId, root = process.cwd()) {
+    rmSync(suspendedFile(lineageId, root), { force: true });
+}
+// ---------------------------------------------------------------------------
+// Re-export ws:<hex> utility (avoid duplication)
+// ---------------------------------------------------------------------------
+export { computeDurableWorkspaceId, normalizeRootCommits, } from "./conductor-launch.js";
+//# sourceMappingURL=lineage-lease.js.map

package/dist/lineage-lease.js.map

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

package/dist/llm-gateway-runtime/accounts.d.ts

@@ -0,0 +1,48 @@
+import { type ModelCatalogEntry, type RoutingTarget } from "./model-catalog.js";
+export interface AccountDescriptor {
+    id: string;
+    provider: string;
+    label: string;
+    token: string;
+    authType?: "api-key" | "bearer";
+    refreshToken?: string;
+    expiresAt?: string;
+    modelIds?: string[];
+    models?: string[];
+    status?: "active" | "disabled";
+}
+export interface PublicAccountDescriptor {
+    id: string;
+    provider: string;
+    label: string;
+    authType?: AccountDescriptor["authType"];
+    expiresAt?: string;
+    modelIds: string[];
+    status: "active" | "disabled";
+}
+export declare function getAccounts(): AccountDescriptor[];
+export declare function publicAccountDescriptor(account: AccountDescriptor): PublicAccountDescriptor;
+export declare function listAccountDescriptors(): PublicAccountDescriptor[];
+export type AccountProviderFamily = "anthropic" | "openai" | "other";
+export declare function providerFamily(provider: string): AccountProviderFamily;
+export declare const DEFAULT_QUOTA_EXHAUSTION_MS: number;
+export declare function markAccountExhausted(accountId: string, reason?: string, windowMs?: number, nowMs?: number): void;
+export declare function isAccountExhausted(accountId: string, nowMs?: number): boolean;
+export declare function accountExhaustionReason(accountId: string): string | undefined;
+export declare function resetAccountsCache(): void;
+export declare function accountSupportsRoute(account: AccountDescriptor, route: RoutingTarget): boolean;
+export declare function eligibleAccountsForRoute(route?: RoutingTarget): AccountDescriptor[];
+export declare function selectAccount(): AccountDescriptor;
+export declare function selectAccountForRoute(route: RoutingTarget): AccountDescriptor;
+export declare function findAccount(accountId: string): AccountDescriptor | undefined;
+export declare function listRoutableModels(): ModelCatalogEntry[];
+export declare function selectFallbackAccount(exhaustedAccountId: string, nowMs?: number): AccountDescriptor | undefined;
+/** Update the in-memory token for an account (after OAuth refresh). */
+export declare function updateAccountToken(accountId: string, newToken: string, expiresAt?: string): void;
+/**
+ * Refresh the OAuth access token for an account using its refresh_token.
+ * Updates the in-memory account on success. No-op if no refresh_token.
+ * Returns the new token, or null if refresh is not applicable.
+ */
+export declare function refreshOAuthToken(accountId: string): Promise<string | null>;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/llm-gateway-runtime/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/llm-gateway-runtime/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AA6BD,wBAAgB,WAAW,IAAI,iBAAiB,EAAE,CAGjD;AAUD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,GACzB,uBAAuB,CAUzB;AAED,wBAAgB,sBAAsB,IAAI,uBAAuB,EAAE,CAElE;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAKtE;AAED,eAAO,MAAM,2BAA2B,QAAqB,CAAC;AAoB9D,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,GAAE,MAAkC,EAC5C,KAAK,GAAE,MAAmB,GACzB,IAAI,CAMN;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAmB,GACzB,OAAO,CAQT;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7E;AAGD,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC;AAKD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,aAAa,GACnB,OAAO,CAiBT;AAED,wBAAgB,wBAAwB,CACtC,KAAK,CAAC,EAAE,aAAa,GACpB,iBAAiB,EAAE,CAOrB;AAED,wBAAgB,aAAa,IAAI,iBAAiB,CAOjD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CAY7E;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE5E;AAED,wBAAgB,kBAAkB,IAAI,iBAAiB,EAAE,CASxD;AAED,wBAAgB,qBAAqB,CACnC,kBAAkB,EAAE,MAAM,EAC1B,KAAK,GAAE,MAAmB,GACzB,iBAAiB,GAAG,SAAS,CAqB/B;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAON;AA0BD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CxB"}