@askdkc/kiokuko 0.1.17 → 0.1.20

package/dist/skills/materialization-service.js

@@ -0,0 +1,101 @@
+import { KiokukoError } from '../errors.js';
+import { authorizeSkillMaterialization } from './materialization-authority.js';
+import { reviewedCatalogSkill } from './official-catalog.js';
+import { SkillProviderError } from './providers/schema.js';
+import { SkillSourceError } from './source/errors.js';
+import { validateSkillCandidate } from './source/snapshot-validator.js';
+import { clearPersistentSkillAuditFailure, clearPersistentSkillSourceFailure, readPersistentSkillAuditFailure, readPersistentSkillSourceFailure, writePersistentSkillAuditFailure, writePersistentSkillSourceFailure, } from './store.js';
+export const DEFAULT_EXTERNAL_SKILL_FAILURE_TTL_MS = 10 * 60_000;
+export const MAX_EXTERNAL_SKILL_RETRY_AFTER_MS = 24 * 60 * 60_000;
+export function externalSkillFailureTtlMs(retryAfterSeconds) {
+    if (retryAfterSeconds === null || !Number.isFinite(retryAfterSeconds) || retryAfterSeconds <= 0) {
+        return DEFAULT_EXTERNAL_SKILL_FAILURE_TTL_MS;
+    }
+    return Math.min(MAX_EXTERNAL_SKILL_RETRY_AFTER_MS, Math.max(1, Math.floor(retryAfterSeconds * 1000)));
+}
+function publicAuditFailure(error) {
+    const failureCode = error.code;
+    const code = (() => {
+        switch (failureCode) {
+            case 'registry_authentication_failed': return 'AUTHENTICATION_ERROR';
+            case 'registry_invalid_response': return 'INTEGRITY_ERROR';
+            case 'registry_unavailable':
+            case 'registry_rate_limited': return 'SERVICE_UNAVAILABLE';
+            default: throw error;
+        }
+    })();
+    return new KiokukoError(code, 'External skill provider audit failed closed', {
+        failureCode,
+        ...(error.retryAfterSeconds === null ? {} : { retryAfterSeconds: error.retryAfterSeconds }),
+    });
+}
+/**
+ * Apply exact provider-audit and GitHub-source backoff before retrieving a
+ * snapshot. Cache rows are operational denial state; they never authorize a
+ * materialization and a stored passed audit label is deliberately ignored.
+ */
+export async function fetchMaterializableSkillSnapshot(database, candidate, dependencies) {
+    const now = dependencies.now ?? new Date().toISOString();
+    const cacheWrite = dependencies.cacheWrite ?? (async (operation) => operation());
+    const materializationCandidate = validateSkillCandidate(candidate);
+    const providerId = dependencies.provider.id;
+    const reviewedCatalog = reviewedCatalogSkill(materializationCandidate) !== undefined;
+    if (!reviewedCatalog && providerId !== materializationCandidate.provider) {
+        throw new KiokukoError('SECURITY_REJECTION', 'External skill audit provider does not match the candidate provider');
+    }
+    const cachedSourceFailure = readPersistentSkillSourceFailure(database, materializationCandidate, now);
+    if (cachedSourceFailure !== null)
+        throw new SkillSourceError(cachedSourceFailure.code);
+    let authorization;
+    if (!reviewedCatalog) {
+        const cachedAuditFailure = readPersistentSkillAuditFailure(database, providerId, materializationCandidate, now);
+        if (cachedAuditFailure !== null) {
+            throw new KiokukoError('SERVICE_UNAVAILABLE', 'External skill provider audit is in backoff', {
+                failureCode: cachedAuditFailure.code,
+                expiresAt: cachedAuditFailure.expiresAt,
+            });
+        }
+    }
+    try {
+        authorization = await authorizeSkillMaterialization(dependencies.provider, materializationCandidate);
+    }
+    catch (error) {
+        if (!(error instanceof SkillProviderError))
+            throw error;
+        if (error.code === 'registry_rate_limited' || error.code === 'registry_unavailable') {
+            const failureCode = error.code;
+            await cacheWrite(() => writePersistentSkillAuditFailure(database, providerId, materializationCandidate, failureCode, externalSkillFailureTtlMs(error.retryAfterSeconds), now));
+        }
+        throw publicAuditFailure(error);
+    }
+    if (authorization.status === 'unavailable') {
+        await cacheWrite(() => writePersistentSkillAuditFailure(database, providerId, materializationCandidate, 'registry_unavailable', DEFAULT_EXTERNAL_SKILL_FAILURE_TTL_MS, now));
+        throw new KiokukoError('SERVICE_UNAVAILABLE', 'External skill provider audit is unavailable', {
+            failureCode: 'registry_unavailable',
+        });
+    }
+    if (!reviewedCatalog)
+        await cacheWrite(() => clearPersistentSkillAuditFailure(database, providerId, materializationCandidate));
+    if (authorization.status === 'failed') {
+        throw new KiokukoError('SECURITY_REJECTION', 'External skill provider audit rejected the candidate', {
+            failureCode: 'community_audit_failed',
+        });
+    }
+    let snapshot;
+    try {
+        snapshot = await dependencies.sourceFetcher.fetch(authorization.candidate, dependencies.sourceRequest);
+    }
+    catch (error) {
+        if (error instanceof SkillSourceError && (error.code === 'source_rate_limited' || error.code === 'source_unavailable')) {
+            const failureCode = error.code;
+            await cacheWrite(() => writePersistentSkillSourceFailure(database, materializationCandidate, failureCode, externalSkillFailureTtlMs(error.retryAfterSeconds), now));
+        }
+        throw error;
+    }
+    await cacheWrite(() => clearPersistentSkillSourceFailure(database, materializationCandidate));
+    return {
+        snapshot,
+        ...(authorization.status === 'passed' ? { authorization: authorization.authorization } : {}),
+    };
+}
+//# sourceMappingURL=materialization-service.js.map

package/dist/skills/materialization-service.js.map

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

package/dist/skills/official-catalog.d.ts

@@ -0,0 +1,31 @@
+import type { ProjectFingerprint } from '../repository/project-fingerprint.js';
+import type { SkillCandidate, SkillRequirement } from './types.js';
+export interface OfficialTechnologyDefinition {
+    id: string;
+    aliases: string[];
+    fuzzyAliases?: string[];
+    applicableLanguages?: string[];
+    applicableRuntimes?: string[];
+    applicableDatabases?: string[];
+    packages: string[];
+    frameworks: string[];
+    owners: string[];
+    repositories: string[];
+    /** Exact provider candidate identities and primary paths reviewed for source validation. */
+    reviewedSkills?: Array<{
+        slug: string;
+        primaryPaths: string[];
+    }>;
+    queries: string[];
+}
+export declare const OFFICIAL_TECHNOLOGIES: readonly OfficialTechnologyDefinition[];
+export declare function technologyDefinition(id: string): OfficialTechnologyDefinition | undefined;
+export declare const OFFICIAL_SKILL_REPOSITORIES: string[];
+export declare function reviewedCatalogSkill(candidate: Pick<SkillCandidate, 'source' | 'slug'>): {
+    slug: string;
+    primaryPaths: string[];
+} | undefined;
+/** Resolve only repository identities already pinned in Kiokuko's local catalog. */
+export declare function requirementForOfficialSkill(candidate: Pick<SkillCandidate, 'source' | 'slug' | 'name'>): SkillRequirement | undefined;
+export declare function requirementsFromFingerprint(fingerprint: ProjectFingerprint): SkillRequirement[];
+//# sourceMappingURL=official-catalog.d.ts.map

package/dist/skills/official-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-catalog.d.ts","sourceRoot":"","sources":["../../src/skills/official-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,qBAAqB,EAAE,SAAS,4BAA4B,EAgBxE,CAAC;AAyBF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS,CAEzF;AAED,eAAO,MAAM,2BAA2B,UAAiF,CAAC;AAE1H,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAS7I;AAWD,oFAAoF;AACpF,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAsBrI;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,kBAAkB,GAAG,gBAAgB,EAAE,CAwB/F"}

package/dist/skills/official-catalog.js

@@ -0,0 +1,110 @@
+import { compareCanonicalStrings } from '../serialization/validate.js';
+export const OFFICIAL_TECHNOLOGIES = [
+    { id: 'svelte', aliases: ['svelte'], fuzzyAliases: ['svelte'], applicableLanguages: ['JavaScript', 'TypeScript'], applicableRuntimes: ['Node.js'], packages: ['svelte'], frameworks: ['Svelte'], owners: ['sveltejs'], repositories: ['sveltejs/ai-tools'], reviewedSkills: [{ slug: 'svelte-code-writer', primaryPaths: ['skills/svelte-code-writer/SKILL.md', 'tools/skills/svelte-code-writer/SKILL.md'] }], queries: ['svelte'] },
+    { id: 'sveltekit', aliases: ['sveltekit', 'svelte'], fuzzyAliases: ['sveltekit', 'svelte'], applicableLanguages: ['JavaScript', 'TypeScript'], applicableRuntimes: ['Node.js'], packages: ['@sveltejs/kit'], frameworks: ['SvelteKit'], owners: ['sveltejs'], repositories: ['sveltejs/ai-tools'], reviewedSkills: [{ slug: 'svelte-code-writer', primaryPaths: ['skills/svelte-code-writer/SKILL.md', 'tools/skills/svelte-code-writer/SKILL.md'] }], queries: ['sveltekit', 'svelte'] },
+    { id: 'laravel', aliases: ['laravel'], fuzzyAliases: ['laravel'], applicableLanguages: ['PHP'], applicableRuntimes: ['PHP'], packages: ['laravel/framework'], frameworks: ['Laravel'], owners: ['laravel'], repositories: ['laravel/boost'], reviewedSkills: [{ slug: 'laravel-best-practices', primaryPaths: ['.ai/laravel/skill/laravel-best-practices/SKILL.md'] }], queries: ['laravel', 'laravel testing'] },
+    // Upstream framework repositories are not automatically Skill repositories.
+    // Keep their verified owners for scoped search, but add a reviewed repository
+    // only after its SKILL.md layout has a fixture and has been reviewed.
+    { id: 'react', aliases: ['react'], fuzzyAliases: ['react'], applicableLanguages: ['JavaScript', 'TypeScript'], applicableRuntimes: ['Node.js'], packages: ['react'], frameworks: ['React'], owners: ['facebook'], repositories: [], queries: ['react'] },
+    { id: 'nextjs', aliases: ['next', 'nextjs'], fuzzyAliases: ['nextjs'], applicableLanguages: ['JavaScript', 'TypeScript'], applicableRuntimes: ['Node.js'], packages: ['next'], frameworks: ['Next.js'], owners: ['vercel'], repositories: [], queries: ['nextjs', 'react'] },
+    { id: 'postgresql', aliases: ['postgres', 'postgresql'], fuzzyAliases: ['postgresql'], applicableDatabases: ['PostgreSQL'], packages: ['pg'], frameworks: [], owners: ['postgres'], repositories: [], queries: ['postgresql'] },
+    { id: 'mysql', aliases: ['mysql'], fuzzyAliases: ['mysql'], applicableDatabases: ['MySQL'], packages: ['mysql2'], frameworks: [], owners: ['mysql'], repositories: [], queries: ['mysql'] },
+    { id: 'sqlite', aliases: ['sqlite'], fuzzyAliases: ['sqlite'], applicableDatabases: ['SQLite'], packages: ['sqlite3', 'better-sqlite3'], frameworks: [], owners: ['sqlite'], repositories: [], queries: ['sqlite'] },
+    { id: 'typescript', aliases: ['typescript'], fuzzyAliases: ['typescript'], applicableLanguages: ['TypeScript'], applicableRuntimes: ['Node.js'], packages: ['typescript'], frameworks: [], owners: ['microsoft'], repositories: [], queries: ['typescript'] },
+    { id: 'python', aliases: ['python'], fuzzyAliases: ['python'], applicableLanguages: ['Python'], applicableRuntimes: ['Python'], packages: [], frameworks: [], owners: ['python'], repositories: [], queries: ['python'] },
+    { id: 'go', aliases: ['go', 'golang'], fuzzyAliases: ['golang'], applicableLanguages: ['Go'], applicableRuntimes: ['Go'], packages: [], frameworks: [], owners: ['golang'], repositories: [], queries: ['go'] },
+    { id: 'rust', aliases: ['rust'], fuzzyAliases: ['rust'], applicableLanguages: ['Rust'], applicableRuntimes: ['Rust'], packages: [], frameworks: [], owners: ['rust-lang'], repositories: [], queries: ['rust'] },
+];
+function unique(values) { return [...new Set(values)]; }
+function norm(value) { return value.normalize('NFKC').toLowerCase(); }
+function matches(value, candidates) { const current = norm(value); return candidates.some((candidate) => norm(candidate) === current); }
+function matchingValues(targets, actual) {
+    if (targets === undefined)
+        return undefined;
+    const values = targets.filter((target) => actual.some((value) => matches(value, [target])));
+    return values.length > 0 ? values : undefined;
+}
+function applicability(definition, fingerprint) {
+    const languages = matchingValues(definition.applicableLanguages, fingerprint.languages);
+    const runtimes = matchingValues(definition.applicableRuntimes, fingerprint.runtimes);
+    const frameworks = fingerprint.frameworks.filter((item) => definition.frameworks.some((name) => matches(item.name, [name])));
+    const databases = matchingValues(definition.applicableDatabases, fingerprint.databases);
+    return {
+        ...(languages === undefined ? {} : { languages }),
+        ...(runtimes === undefined ? {} : { runtimes }),
+        ...(frameworks.length > 0 ? { frameworks } : definition.frameworks.length > 0 ? { frameworks: definition.frameworks.map((name) => ({ name })) } : {}),
+        ...(databases === undefined ? {} : { databases }),
+    };
+}
+export function technologyDefinition(id) {
+    return OFFICIAL_TECHNOLOGIES.find((item) => item.id === id);
+}
+export const OFFICIAL_SKILL_REPOSITORIES = unique(OFFICIAL_TECHNOLOGIES.flatMap((definition) => definition.repositories));
+export function reviewedCatalogSkill(candidate) {
+    const matches = OFFICIAL_TECHNOLOGIES.flatMap((definition) => definition.repositories.some((repository) => norm(repository) === norm(candidate.source))
+        ? (definition.reviewedSkills ?? []).filter((skill) => skill.slug === candidate.slug)
+        : []);
+    if (matches.length === 0)
+        return undefined;
+    const first = matches[0];
+    const primaryPaths = unique(matches.flatMap((match) => match.primaryPaths));
+    return { slug: first.slug, primaryPaths };
+}
+function genericApplicability(definition) {
+    return {
+        ...(definition.applicableLanguages === undefined ? {} : { languages: [...definition.applicableLanguages] }),
+        ...(definition.applicableRuntimes === undefined ? {} : { runtimes: [...definition.applicableRuntimes] }),
+        ...(definition.frameworks.length === 0 ? {} : { frameworks: definition.frameworks.map((name) => ({ name })) }),
+        ...(definition.applicableDatabases === undefined ? {} : { databases: [...definition.applicableDatabases] }),
+    };
+}
+/** Resolve only repository identities already pinned in Kiokuko's local catalog. */
+export function requirementForOfficialSkill(candidate) {
+    const definitions = OFFICIAL_TECHNOLOGIES.filter((definition) => definition.repositories.some((repository) => norm(repository) === norm(candidate.source))
+        && (definition.reviewedSkills ?? []).some((skill) => skill.slug === candidate.slug));
+    if (definitions.length === 0)
+        return undefined;
+    const tokens = new Set(norm(`${candidate.slug} ${candidate.name}`).split(/[^\p{L}\p{N}]+/u).filter(Boolean));
+    const definition = [...definitions].sort((left, right) => {
+        const score = (item) => (tokens.has(norm(item.id)) ? 10 : 0) + item.aliases.filter((alias) => tokens.has(norm(alias))).length;
+        return score(right) - score(left) || right.id.length - left.id.length || compareCanonicalStrings(left.id, right.id);
+    })[0];
+    return {
+        id: definition.id,
+        technology: definition.id,
+        aliases: unique([definition.id, ...definition.aliases, ...definition.frameworks]),
+        ...(definition.fuzzyAliases === undefined ? {} : { fuzzyAliases: unique(definition.fuzzyAliases) }),
+        queries: unique(definition.queries),
+        owners: unique(definition.owners),
+        repositories: unique(definition.repositories),
+        applicability: genericApplicability(definition),
+        signals: definition.packages.length > 0 ? { packages: [...definition.packages] } : {},
+        reason: `Local official catalog matched ${candidate.source}.`,
+    };
+}
+export function requirementsFromFingerprint(fingerprint) {
+    const packageNames = fingerprint.packages.map((item) => item.name);
+    const definitions = OFFICIAL_TECHNOLOGIES.filter((definition) => definition.packages.some((name) => packageNames.includes(name))
+        || definition.frameworks.some((name) => fingerprint.frameworks.some((framework) => matches(framework.name, [name])))
+        || definition.id === 'typescript' && fingerprint.tools.some((tool) => norm(tool) === 'typescript')
+        || definition.id === 'python' && fingerprint.languages.includes('Python')
+        || definition.id === 'go' && fingerprint.languages.includes('Go')
+        || definition.id === 'rust' && fingerprint.languages.includes('Rust')
+        || definition.id === 'postgresql' && fingerprint.databases.includes('PostgreSQL')
+        || definition.id === 'mysql' && fingerprint.databases.includes('MySQL')
+        || definition.id === 'sqlite' && fingerprint.databases.includes('SQLite'));
+    return definitions.map((definition) => ({
+        id: definition.id,
+        technology: definition.id,
+        aliases: unique([definition.id, ...definition.aliases, ...definition.frameworks]),
+        ...(definition.fuzzyAliases === undefined ? {} : { fuzzyAliases: unique(definition.fuzzyAliases) }),
+        queries: unique(definition.queries),
+        owners: unique(definition.owners),
+        repositories: unique(definition.repositories),
+        applicability: applicability(definition, fingerprint),
+        signals: definition.packages.length > 0 ? { packages: [...definition.packages] } : {},
+        reason: `Project fingerprint detected ${definition.id}.`,
+    }));
+}
+//# sourceMappingURL=official-catalog.js.map

package/dist/skills/official-catalog.js.map

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

package/dist/skills/providers/schema.d.ts

@@ -0,0 +1,30 @@
+import type { SkillAuditResult, SkillCandidate, SkillProviderFailureCode } from '../types.js';
+export declare class SkillProviderError extends Error {
+    readonly code: SkillProviderFailureCode;
+    readonly retryAfterSeconds: number | null;
+    constructor(code: SkillProviderFailureCode, retryAfterSeconds?: number | null);
+}
+export declare function verifiedOfficialRepositories(values?: string[]): ReadonlySet<string>;
+export declare function readSkillProviderJson(response: Response): Promise<unknown>;
+export declare function parseSkillsShCompatibilityResponse(value: unknown, provider: string, expected: {
+    query: string;
+    limit: number;
+}, officialRepositories: ReadonlySet<string>): SkillCandidate[];
+export declare function parseSkillsShV1SearchResponse(value: unknown, provider: string, expected: {
+    query: string;
+    limit: number;
+}, officialRepositories: ReadonlySet<string>): SkillCandidate[];
+export declare function parseSkillsShV1CuratedResponse(value: unknown, provider: string, officialRepositories: ReadonlySet<string>): SkillCandidate[];
+export declare function parseSkillsShV1AuditResponse(value: unknown, expected: {
+    source: string;
+    slug: string;
+}): SkillAuditResult;
+/** Strictly parse Kiokuko's own cached candidate shape. */
+export declare function parseSkillCandidates(value: unknown, provider: string, provenance: 'search' | 'curated'): SkillCandidate[];
+export declare function cacheKey(input: {
+    provider: string;
+    query: string;
+    owner?: string | null;
+    mode: string;
+}): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/skills/providers/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/skills/providers/schema.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAK9F,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAC9B,IAAI,EAAE,wBAAwB,EAAE,iBAAiB,GAAE,MAAM,GAAG,IAAW;CAMpF;AAsGD,wBAAgB,4BAA4B,CAAC,MAAM,GAAE,MAAM,EAAgC,GAAG,WAAW,CAAC,MAAM,CAAC,CAahH;AAED,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA0ChF;AAeD,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC1C,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,cAAc,EAAE,CAUlB;AAiCD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC1C,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,cAAc,EAAE,CASlB;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,CAwB5I;AAOD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CA6BzH;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,cAAc,EAAE,CAkBzH;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEhH"}