@namzu/sdk 38.1.0 → 39.0.0

package/dist/manager/resident/learning.d.ts.map

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

package/dist/manager/resident/learning.js

@@ -0,0 +1,353 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { normalizeHarnessProtection, } from '../../eval/harness-protection.js';
+import { reviewHarnessCandidate, } from '../../eval/harness-verification.js';
+const label = z.string().trim().min(1).max(256);
+const name = z.string().regex(/^[a-z0-9][a-z0-9_-]{0,63}$/);
+const digest = z.string().regex(/^[a-f0-9]{64}$/);
+export const residentLearningEvidenceSchema = z.object({
+    key: label,
+    source: label,
+    reason: z.string().trim().min(1).max(1_000),
+});
+const sourceSchema = z.object({ key: label, revision: label });
+const sourcesSchema = z
+    .array(sourceSchema)
+    .min(1)
+    .max(8)
+    .superRefine((sources, context) => {
+    if (new Set(sources.map((source) => source.key)).size !== sources.length)
+        context.addIssue({ code: z.ZodIssueCode.custom, message: 'Duplicate learning source keys.' });
+})
+    .transform((sources) => sources.sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0)));
+const candidateSchema = z.object({
+    name,
+    /** Omitted means ordinary task guidance; exploration policies require explicit projection. */
+    purpose: z.enum(['task', 'exploration']).optional(),
+    description: z.string().trim().min(1).max(1_000),
+    body: z.string().trim().min(1).max(4_000),
+    /** Optional dependencies whose revisions must still match before projection. */
+    sources: sourcesSchema.optional(),
+});
+/** Internal canonical snapshot, including immutable source bindings. */
+export function normalizeResidentSkill(input) {
+    const candidate = candidateSchema.parse(input);
+    return Object.freeze({
+        ...candidate,
+        ...(candidate.sources
+            ? { sources: Object.freeze(candidate.sources.map((source) => Object.freeze(source))) }
+            : {}),
+    });
+}
+const learnedSkillSchema = candidateSchema.extend({
+    hash: digest,
+    evidence: residentLearningEvidenceSchema,
+    verification: z.object({
+        baselineHash: z.union([digest, z.literal('none')]),
+        candidateHash: digest,
+        evidenceDigest: digest,
+        verificationTasks: z.number().int().min(5).max(64),
+        confirmationTasks: z.number().int().min(5).max(64),
+        /** Absent only on historical activations made before protection was required. */
+        protection: z
+            .object({
+            verificationTasks: z.number().int().min(1).max(63),
+            confirmationTasks: z.number().int().min(1).max(63),
+            planDigest: digest,
+        })
+            .optional(),
+    }),
+});
+export const residentLearningSchema = z
+    .object({
+    revision: z.number().int().positive().safe(),
+    identity: z
+        .object({
+        text: z.string().trim().min(1).max(4_000),
+        evidence: residentLearningEvidenceSchema,
+    })
+        .optional(),
+    preferences: z
+        .array(z.object({
+        key: name,
+        value: z.string().trim().min(1).max(1_000),
+        evidence: residentLearningEvidenceSchema,
+    }))
+        .max(32),
+    skills: z.array(learnedSkillSchema).max(16),
+    lastChange: residentLearningEvidenceSchema,
+})
+    .superRefine((state, context) => {
+    if (new Set(state.preferences.map((p) => p.key)).size !== state.preferences.length ||
+        new Set(state.skills.map((s) => s.name)).size !== state.skills.length ||
+        state.skills.some((skill) => skill.hash !== hashResidentSkill(skill) ||
+            skill.verification.candidateHash !== skill.hash))
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Invalid resident learning identity or content digest.',
+        });
+});
+/** Internal immutable snapshot used by storage and admitted context. */
+export function freezeResidentLearning(input) {
+    const state = residentLearningSchema.parse(input);
+    return Object.freeze({
+        ...state,
+        ...(state.identity
+            ? {
+                identity: Object.freeze({
+                    ...state.identity,
+                    evidence: Object.freeze(state.identity.evidence),
+                }),
+            }
+            : {}),
+        preferences: Object.freeze(state.preferences.map((p) => Object.freeze({ ...p, evidence: Object.freeze(p.evidence) }))),
+        skills: Object.freeze(state.skills.map((skill) => Object.freeze({
+            ...skill,
+            ...(skill.sources
+                ? { sources: Object.freeze(skill.sources.map((source) => Object.freeze(source))) }
+                : {}),
+            evidence: Object.freeze(skill.evidence),
+            verification: Object.freeze({
+                ...skill.verification,
+                ...(skill.verification.protection
+                    ? { protection: Object.freeze(skill.verification.protection) }
+                    : {}),
+            }),
+        }))),
+        lastChange: Object.freeze(state.lastChange),
+    });
+}
+function evidenceFor(current, input) {
+    const evidence = residentLearningEvidenceSchema.parse(input);
+    const used = [
+        current?.lastChange,
+        current?.identity?.evidence,
+        ...(current?.preferences.map((p) => p.evidence) ?? []),
+        ...(current?.skills.map((s) => s.evidence) ?? []),
+    ];
+    if (used.some((old) => old?.key === evidence.key))
+        throw new Error('A learning change requires a fresh evidence key.');
+    return evidence;
+}
+function base(current, evidence) {
+    const checked = current ? freezeResidentLearning(current) : undefined;
+    return {
+        ...checked,
+        revision: (checked?.revision ?? 0) + 1,
+        preferences: checked?.preferences ?? [],
+        skills: checked?.skills ?? [],
+        lastChange: evidence,
+    };
+}
+/** Internal pure profile transition; storage owns exact agenda CAS and idle admission. */
+export function reviseResidentProfile(current, input) {
+    const checked = z
+        .object({
+        identity: z.string().trim().min(1).max(4_000).optional(),
+        preferences: z
+            .array(z.object({
+            key: name,
+            value: z.string().trim().min(1).max(1_000),
+            supersedes: label.nullable(),
+        }))
+            .max(32)
+            .optional(),
+        evidence: residentLearningEvidenceSchema,
+    })
+        .parse(input);
+    if (checked.identity === undefined && !checked.preferences?.length)
+        throw new Error('A profile change must change identity or preferences.');
+    if (new Set(checked.preferences?.map((p) => p.key)).size !== checked.preferences?.length &&
+        checked.preferences !== undefined)
+        throw new Error('Duplicate preference corrections are not allowed.');
+    const evidence = evidenceFor(current, checked.evidence);
+    const next = base(current, evidence);
+    const preferences = [...next.preferences];
+    for (const change of checked.preferences ?? []) {
+        const index = preferences.findIndex((p) => p.key === change.key);
+        const previous = index >= 0 ? preferences[index] : undefined;
+        if (change.supersedes !== (previous?.evidence.key ?? null))
+            throw new Error('Preference correction does not supersede its current evidence.');
+        const updated = { key: change.key, value: change.value, evidence };
+        if (index < 0)
+            preferences.push(updated);
+        else
+            preferences[index] = updated;
+    }
+    return freezeResidentLearning({
+        ...next,
+        preferences,
+        ...(checked.identity !== undefined ? { identity: { text: checked.identity, evidence } } : {}),
+    });
+}
+/** @experimental Bind evaluation to normalized content and any declared source dependencies. */
+export function hashResidentSkill(input) {
+    const candidate = candidateSchema.parse(input);
+    return createHash('sha256')
+        .update(JSON.stringify([
+        candidate.name,
+        candidate.description,
+        candidate.body,
+        ...(candidate.sources ? [candidate.sources] : []),
+        ...(candidate.purpose === 'exploration' ? [{ purpose: candidate.purpose }] : []),
+    ]))
+        .digest('hex');
+}
+/** Internal pure activation; reuse the kernel's conservative two-round verification gate. */
+export function promoteResidentSkill(current, input, evaluation, inputEvidence) {
+    const protection = normalizeHarnessProtection(evaluation.protection);
+    const candidate = candidateSchema.parse(input);
+    const hash = hashResidentSkill(candidate);
+    const baseline = current?.skills.find((s) => s.name === candidate.name);
+    if (baseline && (baseline.purpose ?? 'task') !== (candidate.purpose ?? 'task'))
+        throw new Error('A skill cannot change learning purpose; use a distinct skill name.');
+    const baselineHash = baseline?.hash ?? 'none';
+    const evidence = evidenceFor(current, inputEvidence);
+    for (const batch of [evaluation.verification, evaluation.confirmation]) {
+        if (!batch)
+            continue;
+        if (batch.baselineRevision !== baselineHash || batch.candidateRevision !== hash)
+            throw new Error('Skill evaluation does not match the active baseline and candidate digests.');
+        if (batch.baseline.length > 128 ||
+            batch.candidate.length > 128 ||
+            batch.attributions.length > 128)
+            throw new Error('Resident skill evaluation is bounded to 64 tasks per round.');
+        // Recorded evidence must consistently identify success and complete measurements.
+        for (const trial of [...batch.baseline, ...batch.candidate]) {
+            if (trial.result.passed !== (trial.result.status === 'passed') ||
+                (trial.result.status === 'passed' && trial.result.failedGates?.length))
+                throw new Error('Inconsistent recorded skill evaluation outcome.');
+        }
+    }
+    const review = reviewHarnessCandidate(evaluation.verification, evaluation.confirmation, protection);
+    if (review.decision !== 'accept')
+        throw new Error(`Resident skill promotion ${review.decision}: ${review.reason}`);
+    const skill = {
+        ...candidate,
+        hash,
+        evidence,
+        verification: {
+            baselineHash,
+            candidateHash: hash,
+            evidenceDigest: createHash('sha256')
+                .update(JSON.stringify({ ...evaluation, protection }))
+                .digest('hex'),
+            verificationTasks: review.verification.tasks.length,
+            confirmationTasks: review.confirmation?.tasks.length ?? 0,
+            protection: {
+                verificationTasks: protection.verification.length,
+                confirmationTasks: protection.confirmation.length,
+                planDigest: createHash('sha256').update(JSON.stringify(protection)).digest('hex'),
+            },
+        },
+    };
+    const next = base(current, evidence);
+    return freezeResidentLearning({
+        ...next,
+        skills: [...next.skills.filter((s) => s.name !== candidate.name), skill],
+    });
+}
+/** Internal rollback appends a new learning version while preserving current profile values. */
+export function restoreResidentSkill(current, historical, skillName, inputEvidence) {
+    name.parse(skillName);
+    if (!current?.skills.some((s) => s.name === skillName))
+        throw new Error('No active resident skill to roll back.');
+    const next = base(current, evidenceFor(current, inputEvidence));
+    const previous = historical
+        ? freezeResidentLearning(historical).skills.find((s) => s.name === skillName)
+        : undefined;
+    return freezeResidentLearning({
+        ...next,
+        skills: [...next.skills.filter((s) => s.name !== skillName), ...(previous ? [previous] : [])],
+    });
+}
+/** @experimental Bounded context data; never registers tools, loads files or executes a skill. */
+export function projectResidentLearning(current, options) {
+    if (!Number.isSafeInteger(options.maxChars) || options.maxChars < 0 || options.maxChars > 64_000)
+        throw new TypeError('Resident learning context requires maxChars between 0 and 64000.');
+    const selected = z.array(name).max(16).parse(options.skillNames);
+    const purpose = z.enum(['task', 'exploration']).parse(options.purpose ?? 'task');
+    if (new Set(selected).size !== selected.length)
+        throw new Error('Duplicate selected skill names.');
+    const sources = z
+        .array(sourceSchema)
+        .max(128)
+        .parse(options.sources ?? []);
+    if (new Set(sources.map((source) => source.key)).size !== sources.length)
+        throw new Error('Duplicate observed learning source keys.');
+    const observed = new Map(sources.map((source) => [source.key, source.revision]));
+    if (!current)
+        return Object.freeze({
+            text: '',
+            revision: null,
+            includedSkills: Object.freeze([]),
+            omitted: selected.length,
+            withheldSkills: Object.freeze([]),
+        });
+    const state = freezeResidentLearning(current);
+    const pieces = [];
+    const includedSkills = [];
+    const withheldSkills = [];
+    let omitted = 0;
+    let length = 0;
+    const add = (value) => {
+        const part = JSON.stringify(value);
+        const size = part.length + (pieces.length ? 1 : 0);
+        if (length + size > options.maxChars) {
+            omitted++;
+            return false;
+        }
+        pieces.push(part);
+        length += size;
+        return true;
+    };
+    if (state.identity)
+        add({ kind: 'self-description', ...state.identity });
+    for (const preference of state.preferences)
+        add({ kind: 'preference', ...preference });
+    for (const skillName of selected) {
+        const skill = state.skills.find((s) => s.name === skillName);
+        if (!skill) {
+            omitted++;
+            continue;
+        }
+        if ((skill.purpose ?? 'task') !== purpose) {
+            omitted++;
+            withheldSkills.push(Object.freeze({
+                name: skill.name,
+                reason: 'different-purpose',
+                sourceKeys: Object.freeze([]),
+            }));
+            continue;
+        }
+        const mismatched = skill.sources?.filter((source) => observed.get(source.key) !== source.revision) ?? [];
+        if (mismatched.length) {
+            omitted++;
+            withheldSkills.push(Object.freeze({
+                name: skill.name,
+                reason: mismatched.some((source) => observed.has(source.key))
+                    ? 'changed-source'
+                    : 'unverified-source',
+                sourceKeys: Object.freeze(mismatched.map((source) => source.key)),
+            }));
+            continue;
+        }
+        if (add({
+            kind: 'evaluated-guidance',
+            name: skill.name,
+            description: skill.description,
+            body: skill.body,
+            hash: skill.hash,
+            evidence: skill.evidence,
+        }))
+            includedSkills.push(skill.name);
+    }
+    return Object.freeze({
+        text: pieces.join('\n'),
+        revision: state.revision,
+        includedSkills: Object.freeze(includedSkills),
+        omitted,
+        withheldSkills: Object.freeze(withheldSkills),
+    });
+}
+//# sourceMappingURL=learning.js.map

package/dist/manager/resident/learning.js.map

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

package/dist/manager/resident/loop.d.ts

@@ -0,0 +1,31 @@
+import { type ResidentDecision, type ResidentExecutionStore, type ResidentState } from './store.js';
+/** @experimental Developer-owned step; bind providers, tools and budgets in the host. */
+export type ResidentStep = (state: ResidentState, signal: AbortSignal) => Promise<ResidentDecision>;
+/** @experimental No model is invoked for an idle, terminal or unresolved resident. */
+export type ResidentStepResult = {
+    status: 'settled';
+    state: ResidentState;
+} | {
+    status: 'idle';
+    reason: 'not-due' | 'terminal' | 'unresolved' | 'contended';
+    state: ResidentState;
+};
+/** @experimental A failed/aborted callback leaves its durable claim unresolved. */
+export declare function stepResident(store: ResidentExecutionStore, step: ResidentStep, signal: AbortSignal, now?: () => number): Promise<ResidentStepResult>;
+/** @experimental Bounded local driver; not a daemon, process recovery service or notification transport. */
+export interface ResidentLoopOptions {
+    readonly store: ResidentExecutionStore;
+    readonly step: ResidentStep;
+    readonly signal: AbortSignal;
+    /** Required finite admission cap for this invocation, independent of provider token limits. */
+    readonly maxSteps: number;
+    /** Maximum single idle wait, default 60 seconds. Longer waits return control to the host. */
+    readonly maxIdleMs?: number;
+}
+/**
+ * @experimental Continue a pursuit without a new user message. Null wake times
+ * and terminal states stop immediately; cancellation also interrupts idle waits.
+ * An abort cannot undo callback effects or forcibly stop a callback ignoring its signal.
+ */
+export declare function runResident(options: ResidentLoopOptions): Promise<ResidentStepResult>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/manager/resident/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/loop.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,MAAM,YAAY,CAAA;AAEnB,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAEnG,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC3C;IACA,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAA;IAC3D,KAAK,EAAE,aAAa,CAAA;CACnB,CAAA;AAEJ,mFAAmF;AACnF,wBAAsB,YAAY,CACjC,KAAK,EAAE,sBAAsB,EAC7B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,WAAW,EACnB,GAAG,GAAE,MAAM,MAAiB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA2B7B;AAED,4GAA4G;AAC5G,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6B3F"}

package/dist/manager/resident/loop.js

@@ -0,0 +1,69 @@
+import { setTimeout as sleep } from 'node:timers/promises';
+import { ResidentConflictError, } from './store.js';
+/** @experimental A failed/aborted callback leaves its durable claim unresolved. */
+export async function stepResident(store, step, signal, now = Date.now) {
+    signal.throwIfAborted();
+    const state = await store.read();
+    signal.throwIfAborted();
+    if (!state)
+        throw new Error('Create the resident before running it.');
+    if (state.phase === 'running')
+        return { status: 'idle', reason: 'unresolved', state };
+    if (state.phase !== 'waiting')
+        return { status: 'idle', reason: 'terminal', state };
+    if (state.wakeAt === null || state.wakeAt > now())
+        return { status: 'idle', reason: 'not-due', state };
+    let claim;
+    try {
+        claim = await store.claim(state, now());
+    }
+    catch (error) {
+        if (!(error instanceof ResidentConflictError))
+            throw error;
+        return {
+            status: 'idle',
+            reason: 'contended',
+            state: (await store.read()) ?? state,
+        };
+    }
+    signal.throwIfAborted();
+    const decision = await step(claim, signal);
+    signal.throwIfAborted();
+    return {
+        status: 'settled',
+        state: await store.settle(claim, decision, now()),
+    };
+}
+/**
+ * @experimental Continue a pursuit without a new user message. Null wake times
+ * and terminal states stop immediately; cancellation also interrupts idle waits.
+ * An abort cannot undo callback effects or forcibly stop a callback ignoring its signal.
+ */
+export async function runResident(options) {
+    const maxIdleMs = options.maxIdleMs ?? 60_000;
+    if (!Number.isSafeInteger(options.maxSteps) ||
+        options.maxSteps < 1 ||
+        !Number.isSafeInteger(maxIdleMs) ||
+        maxIdleMs < 0 ||
+        maxIdleMs > 2_147_483_647) {
+        throw new TypeError('Resident loop requires positive finite maxSteps and bounded nonnegative maxIdleMs.');
+    }
+    let admitted = 0;
+    while (true) {
+        const result = await stepResident(options.store, options.step, options.signal);
+        if (result.status === 'settled')
+            admitted++;
+        if (admitted >= options.maxSteps)
+            return result;
+        const { state } = result;
+        if (state.phase !== 'waiting' ||
+            state.wakeAt === null ||
+            (result.status === 'idle' && result.reason !== 'not-due'))
+            return result;
+        const delay = Math.max(0, state.wakeAt - Date.now());
+        if (delay > maxIdleMs)
+            return result;
+        await sleep(Math.max(1, delay), undefined, { signal: options.signal });
+    }
+}
+//# sourceMappingURL=loop.js.map

package/dist/manager/resident/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../../src/manager/resident/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EACN,qBAAqB,GAIrB,MAAM,YAAY,CAAA;AAcnB,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,KAA6B,EAC7B,IAAkB,EAClB,MAAmB,EACnB,MAAoB,IAAI,CAAC,GAAG;IAE5B,MAAM,CAAC,cAAc,EAAE,CAAA;IACvB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;IAChC,MAAM,CAAC,cAAc,EAAE,CAAA;IACvB,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACrE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IACrF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IACnF,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE;QAChD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IACpD,IAAI,KAAoB,CAAA;IACxB,IAAI,CAAC;QACJ,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,CAAC,KAAK,YAAY,qBAAqB,CAAC;YAAE,MAAM,KAAK,CAAA;QAC1D,OAAO;YACN,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK;SACpC,CAAA;IACF,CAAC;IACD,MAAM,CAAC,cAAc,EAAE,CAAA;IACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC1C,MAAM,CAAC,cAAc,EAAE,CAAA;IACvB,OAAO;QACN,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;KACjD,CAAA;AACF,CAAC;AAaD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA4B;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAA;IAC7C,IACC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvC,OAAO,CAAC,QAAQ,GAAG,CAAC;QACpB,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAChC,SAAS,GAAG,CAAC;QACb,SAAS,GAAG,aAAa,EACxB,CAAC;QACF,MAAM,IAAI,SAAS,CAClB,oFAAoF,CACpF,CAAA;IACF,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAC9E,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,QAAQ,EAAE,CAAA;QAC3C,IAAI,QAAQ,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAA;QAC/C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAA;QACxB,IACC,KAAK,CAAC,KAAK,KAAK,SAAS;YACzB,KAAK,CAAC,MAAM,KAAK,IAAI;YACrB,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;YAEzD,OAAO,MAAM,CAAA;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;QACpD,IAAI,KAAK,GAAG,SAAS;YAAE,OAAO,MAAM,CAAA;QACpC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACvE,CAAC;AACF,CAAC"}