agentplane 0.3.12 → 0.3.14

package/dist/runtime/incidents/shared.d.ts

@@ -0,0 +1,34 @@
+import type { IncidentAdviceMatch, IncidentRegistry, IncidentRegistryEntry, IncidentRegistryEntryState } from "./types.js";
+export declare const STRUCTURED_INCIDENTS_HEADER: string;
+export declare const COMPACT_INCIDENTS_HEADER: string;
+export declare function normalizeLines(text: string): string[];
+export declare function normalizeKey(key: string): string;
+export declare function normalizeSearchText(text: string): string;
+export declare function tokenize(text: string): string[];
+export declare function dedupeCaseInsensitive(values: readonly string[]): string[];
+export declare function parseCsvList(value: string | null | undefined): string[];
+export declare function incidentField(key: string, value: string): [string, string];
+export declare function parseBoolean(value: string | null | undefined): boolean;
+export declare function parseFixability(value: string | null | undefined): "external" | "repo-fixable" | null;
+export declare function parseEntryState(value: string | null | undefined): IncidentRegistryEntryState;
+export declare function appendFieldValue(record: Record<string, string>, key: string, value: string, joiner?: string): void;
+export declare function deriveSourceTask(explicitSourceTask: string | null | undefined, evidence: string | null | undefined): string | null;
+export declare function buildIncidentSignature(entry: Pick<IncidentRegistryEntry, "scope" | "failure" | "rule">): string;
+export declare function buildIncidentFingerprint(entry: Pick<IncidentRegistryEntry, "sourceTask" | "scope" | "failure" | "rule">): string;
+export declare function buildMatchTerms(opts: {
+    scope: string;
+    tags: readonly string[];
+    explicitMatch: readonly string[];
+    extraText?: readonly string[];
+}): string[];
+export declare function occursWithinDays(date: string, now: Date, days: number): boolean;
+export declare function entryStateRank(state: IncidentRegistryEntryState): number;
+export declare function compareIncidentAdviceMatch(left: IncidentAdviceMatch, right: IncidentAdviceMatch): number;
+export declare function summarizeTaskScope(scope: string | null | undefined, title: string): string;
+export declare function buildDerivedIncidentRule(scope: string): string;
+export declare function resolveIncidentState(opts: {
+    registry: IncidentRegistry;
+    entry: Pick<IncidentRegistryEntry, "scope" | "failure" | "rule">;
+    now: Date;
+}): IncidentRegistryEntryState;
+//# sourceMappingURL=shared.d.ts.map

package/dist/runtime/incidents/shared.d.ts.map

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

package/dist/runtime/incidents/shared.js

@@ -0,0 +1,171 @@
+export const STRUCTURED_INCIDENTS_HEADER = [
+    "# Policy Incidents Log",
+    "",
+    "This is the single file for incident-derived and situational policy rules.",
+].join("\n");
+export const COMPACT_INCIDENTS_HEADER = [
+    "# Policy Incidents Log",
+    "- Append-only. Required fields: `id`, `date`, `scope`, `failure`, `rule`, `evidence`, `enforcement`, `state`; optional: `tags`, `match`, `advice`, `source_task`, `fixability`.",
+].join("\n");
+export function normalizeLines(text) {
+    return text.replaceAll("\r\n", "\n").split("\n");
+}
+export function normalizeKey(key) {
+    return key
+        .trim()
+        .toLowerCase()
+        .replaceAll(/[\s_-]+/g, "");
+}
+export function normalizeSearchText(text) {
+    return text
+        .toLowerCase()
+        .replaceAll(/[^a-z0-9]+/gi, " ")
+        .trim();
+}
+export function tokenize(text) {
+    const normalized = normalizeSearchText(text);
+    if (!normalized)
+        return [];
+    return normalized
+        .split(/\s+/)
+        .map((token) => token.trim())
+        .filter((token) => token.length >= 3);
+}
+export function dedupeCaseInsensitive(values) {
+    const seen = new Set();
+    const out = [];
+    for (const value of values) {
+        const trimmed = String(value ?? "").trim();
+        if (!trimmed)
+            continue;
+        const key = trimmed.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(trimmed);
+    }
+    return out;
+}
+export function parseCsvList(value) {
+    if (!value)
+        return [];
+    return dedupeCaseInsensitive(value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean));
+}
+export function incidentField(key, value) {
+    return [key, value];
+}
+export function parseBoolean(value) {
+    const normalized = String(value ?? "")
+        .trim()
+        .toLowerCase();
+    return normalized === "true" || normalized === "yes" || normalized === "y" || normalized === "1";
+}
+export function parseFixability(value) {
+    const normalized = String(value ?? "")
+        .trim()
+        .toLowerCase()
+        .replaceAll(/[\s_-]+/g, "");
+    if (normalized === "external")
+        return "external";
+    if (normalized === "repofixable" || normalized === "internal")
+        return "repo-fixable";
+    return null;
+}
+export function parseEntryState(value) {
+    return value === "open" || value === "promoted" ? value : "stabilized";
+}
+export function appendFieldValue(record, key, value, joiner = " ") {
+    if (!record[key]) {
+        record[key] = value.trim();
+        return;
+    }
+    record[key] = `${record[key]}${joiner}${value.trim()}`.trim();
+}
+export function deriveSourceTask(explicitSourceTask, evidence) {
+    const direct = String(explicitSourceTask ?? "").trim();
+    if (direct)
+        return direct;
+    const match = /\btasks?\s+([A-Za-z0-9-]+)/iu.exec(String(evidence ?? ""));
+    return match?.[1]?.trim() ?? null;
+}
+export function buildIncidentSignature(entry) {
+    return [
+        normalizeSearchText(entry.scope),
+        normalizeSearchText(entry.failure),
+        normalizeSearchText(entry.rule),
+    ].join("|");
+}
+export function buildIncidentFingerprint(entry) {
+    return [entry.sourceTask ?? "", buildIncidentSignature(entry)].join("|");
+}
+export function buildMatchTerms(opts) {
+    const scopeTokens = tokenize(opts.scope);
+    const extraTokens = (opts.extraText ?? []).flatMap((value) => tokenize(value));
+    return dedupeCaseInsensitive([
+        ...opts.explicitMatch,
+        ...opts.tags,
+        ...scopeTokens,
+        ...extraTokens,
+    ]).slice(0, 16);
+}
+function parseDateOnly(value) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return null;
+    const parsed = Date.parse(`${value}T00:00:00.000Z`);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+export function occursWithinDays(date, now, days) {
+    const timestamp = parseDateOnly(date);
+    if (timestamp === null)
+        return false;
+    const delta = now.getTime() - timestamp;
+    if (delta < 0)
+        return false;
+    return delta <= days * 24 * 60 * 60 * 1000;
+}
+export function entryStateRank(state) {
+    if (state === "promoted")
+        return 2;
+    if (state === "stabilized")
+        return 1;
+    return 0;
+}
+export function compareIncidentAdviceMatch(left, right) {
+    if (right.score !== left.score)
+        return right.score - left.score;
+    const rightState = entryStateRank(right.entry.state);
+    const leftState = entryStateRank(left.entry.state);
+    if (rightState !== leftState)
+        return rightState - leftState;
+    return right.entry.date.localeCompare(left.entry.date);
+}
+export function summarizeTaskScope(scope, title) {
+    const lines = normalizeLines(scope ?? "");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let candidate = trimmed.replace(/^-+\s*/, "");
+        candidate = candidate.replace(/^in scope:\s*/i, "").trim();
+        if (!candidate || /^out of scope:/i.test(candidate))
+            continue;
+        return candidate;
+    }
+    return title.trim();
+}
+export function buildDerivedIncidentRule(scope) {
+    return `Analogous ${scope} work MUST review and apply the recorded external incident advice before retrying.`;
+}
+export function resolveIncidentState(opts) {
+    const signature = buildIncidentSignature(opts.entry);
+    const similarEntries = opts.registry.entries.filter((candidate) => buildIncidentSignature(candidate) === signature);
+    if (similarEntries.some((candidate) => candidate.state === "promoted" ||
+        candidate.state === "stabilized" ||
+        occursWithinDays(candidate.date, opts.now, 30))) {
+        return "stabilized";
+    }
+    return "open";
+}

package/dist/shared/errors.d.ts

@@ -1,4 +1,4 @@
-export type ErrorCode = "E_USAGE" | "E_VALIDATION" | "E_IO" | "E_GIT" | "E_BACKEND" | "E_NETWORK" | "E_RUNTIME" | "E_INTERNAL";
+export type ErrorCode = "E_USAGE" | "E_VALIDATION" | "E_IO" | "E_GIT" | "E_HANDOFF" | "E_BACKEND" | "E_NETWORK" | "E_RUNTIME" | "E_INTERNAL";
 export declare class CliError extends Error {
     readonly exitCode: number;
     readonly code: ErrorCode;

package/dist/shared/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAMF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAiBnF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAMF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAiBnF"}

package/dist/shared/runtime-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-source.d.ts","sourceRoot":"","sources":["../../src/shared/runtime-source.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AAOtC,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,qBAAqB,GACrB,4BAA4B,GAC5B,YAAY,GACZ,oBAAoB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,sBAAsB,CAAC;IAClC,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC;AAuHF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAQ7D;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,iBAAiB,CAiCnB"}
+{"version":3,"file":"runtime-source.d.ts","sourceRoot":"","sources":["../../src/shared/runtime-source.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AAOtC,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,qBAAqB,GACrB,4BAA4B,GAC5B,YAAY,GACZ,oBAAoB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,sBAAsB,CAAC;IAClC,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC;AA6HF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAQ7D;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,iBAAiB,CAoCnB"}

package/dist/shared/runtime-source.js

@@ -73,10 +73,13 @@ function resolveAgentplanePackageInfo(options) {
     }
     return resolvePackageInfo(path.join(inferredRoot, "package.json"));
 }
-function resolveCorePackageInfo(options) {
+function resolveCorePackageInfo(options, frameworkCoreRoot) {
     if (options.corePackageJsonPath) {
         return resolvePackageInfo(path.resolve(options.corePackageJsonPath));
     }
+    if (frameworkCoreRoot) {
+        return resolvePackageInfo(path.join(frameworkCoreRoot, "package.json"));
+    }
     try {
         const req = createRequire(options.entryModuleUrl ?? import.meta.url);
         const entryPath = req.resolve("@agentplaneorg/core");
@@ -127,7 +130,6 @@ export function resolveRuntimeSourceInfo(options = {}) {
     const cwd = path.resolve(options.cwd ?? process.cwd());
     const env = options.env ?? process.env;
     const agentplane = resolveAgentplanePackageInfo(options);
-    const core = resolveCorePackageInfo(options);
     const fallbackBin = agentplane.packageRoot === null
         ? null
         : path.join(agentplane.packageRoot, "bin", "agentplane.js");
@@ -139,6 +141,9 @@ export function resolveRuntimeSourceInfo(options = {}) {
         cwd,
         thisBin: activeBinaryPath ?? fallbackBin ?? cwd,
     });
+    const frameworkCoreRoot = resolveFrameworkCoreRoot(framework.checkout?.repoRoot ?? null);
+    const preferredFrameworkCoreRoot = framework.inFrameworkCheckout && framework.isRepoLocalRuntime ? frameworkCoreRoot : null;
+    const core = resolveCorePackageInfo(options, preferredFrameworkCoreRoot);
     return {
         cwd,
         activeBinaryPath,
@@ -148,7 +153,7 @@ export function resolveRuntimeSourceInfo(options = {}) {
         frameworkSources: {
             repoRoot: framework.checkout?.repoRoot ?? null,
             agentplaneRoot: framework.checkout?.packageRoot ?? agentplane.packageRoot,
-            coreRoot: resolveFrameworkCoreRoot(framework.checkout?.repoRoot ?? null),
+            coreRoot: frameworkCoreRoot,
         },
         agentplane,
         core,

package/dist/testing/cli-harness/recipe-archives.d.ts

@@ -0,0 +1,28 @@
+export declare function createRecipeArchive(opts?: {
+    id?: string;
+    version?: string;
+    name?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    format?: "tar" | "zip";
+    wrapDir?: boolean;
+}): Promise<{
+    archivePath: string;
+    manifest: Record<string, unknown>;
+}>;
+export declare function createRecipeArchiveWithManifest(opts: {
+    manifest: Record<string, unknown>;
+    files?: Record<string, string>;
+    format?: "tar" | "zip";
+    wrapDir?: boolean;
+}): Promise<string>;
+export declare function createUnsafeRecipeArchive(opts: {
+    format: "tar" | "zip";
+    entryPath?: string;
+}): Promise<string>;
+export declare function createUpgradeBundle(files: Record<string, string>): Promise<{
+    bundlePath: string;
+    checksumPath: string;
+}>;
+//# sourceMappingURL=recipe-archives.d.ts.map

package/dist/testing/cli-harness/recipe-archives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-archives.d.ts","sourceRoot":"","sources":["../../../src/testing/cli-harness/recipe-archives.ts"],"names":[],"mappings":"AAgBA,wBAAsB,mBAAmB,CAAC,IAAI,CAAC,EAAE;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAsKtE;AAED,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+GlB;AAyDD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAkDD"}