@openrig/cli 0.0.1 → 0.1.0

package/daemon/dist/domain/agent-manifest.js

@@ -0,0 +1,322 @@
+import { parse as parseYaml } from "yaml";
+import { validateStartupBlock as sharedValidateStartupBlock, normalizeStartupBlock as sharedNormalizeStartupBlock, } from "./startup-validation.js";
+// -- Constants --
+const VALID_EXECUTION_MODES = new Set(["interactive_resident"]);
+const VALID_COMPACTION_STRATEGIES = new Set(["harness_native", "pod_continuity"]);
+const VALID_RESTORE_POLICIES = new Set(["resume_if_possible", "relaunch_fresh", "checkpoint_only"]);
+const VALID_IMPORT_PREFIXES = ["local:", "path:"];
+import { validateSafePath } from "./path-safety.js";
+// -- Import validation --
+function validateImportRef(ref, index) {
+    if (!ref || typeof ref !== "string")
+        return `imports[${index}].ref: must be a non-empty string`;
+    const hasValidPrefix = VALID_IMPORT_PREFIXES.some((p) => ref.startsWith(p));
+    if (!hasValidPrefix)
+        return `imports[${index}].ref: must start with "local:" or "path:" (got "${ref}")`;
+    if (ref.startsWith("local:")) {
+        const path = ref.slice("local:".length);
+        if (!path)
+            return `imports[${index}].ref: local: ref must have a path`;
+        if (path.startsWith("/"))
+            return `imports[${index}].ref: local: ref must be a relative path (got "${ref}")`;
+    }
+    if (ref.startsWith("path:")) {
+        const path = ref.slice("path:".length);
+        if (!path)
+            return `imports[${index}].ref: path: ref must have a path`;
+        if (!path.startsWith("/"))
+            return `imports[${index}].ref: path: ref must be an absolute path (got "${ref}")`;
+    }
+    return null;
+}
+function validateImportVersion(version, index) {
+    if (version === undefined || version === null)
+        return null;
+    if (typeof version !== "string")
+        return `imports[${index}].version: must be a string`;
+    if (/[~^>=<|]/.test(version))
+        return `imports[${index}].version: version ranges are not supported; use exact version (got "${version}")`;
+    return null;
+}
+// Startup validation delegated to shared module
+const validateStartupBlock = sharedValidateStartupBlock;
+// -- Lifecycle validation --
+function validateLifecycle(raw, prefix) {
+    if (raw === undefined || raw === null)
+        return [];
+    if (typeof raw !== "object")
+        return [`${prefix}: must be an object`];
+    const obj = raw;
+    const errors = [];
+    if (obj["execution_mode"] !== undefined) {
+        if (obj["execution_mode"] === "wake_on_demand") {
+            errors.push(`${prefix}.execution_mode: "wake_on_demand" is not supported in v1; use "interactive_resident"`);
+        }
+        else if (!VALID_EXECUTION_MODES.has(obj["execution_mode"])) {
+            errors.push(`${prefix}.execution_mode: must be "interactive_resident" (got "${obj["execution_mode"]}")`);
+        }
+    }
+    if (obj["compaction_strategy"] !== undefined) {
+        if (obj["compaction_strategy"] === "custom_prompt") {
+            errors.push(`${prefix}.compaction_strategy: "custom_prompt" is not supported in v1; use "harness_native" or "pod_continuity"`);
+        }
+        else if (!VALID_COMPACTION_STRATEGIES.has(obj["compaction_strategy"])) {
+            errors.push(`${prefix}.compaction_strategy: must be one of ${[...VALID_COMPACTION_STRATEGIES].join(", ")} (got "${obj["compaction_strategy"]}")`);
+        }
+    }
+    if (obj["restore_policy"] !== undefined && !VALID_RESTORE_POLICIES.has(obj["restore_policy"])) {
+        errors.push(`${prefix}.restore_policy: must be one of ${[...VALID_RESTORE_POLICIES].join(", ")} (got "${obj["restore_policy"]}")`);
+    }
+    return errors;
+}
+// -- Resource validation --
+function validateResourcePaths(resources, category) {
+    const errors = [];
+    const ids = new Set();
+    for (let i = 0; i < resources.length; i++) {
+        const r = resources[i];
+        if (!r.id || typeof r.id !== "string") {
+            errors.push(`resources.${category}[${i}].id: must be a non-empty string`);
+        }
+        else if (ids.has(r.id)) {
+            errors.push(`resources.${category}: duplicate id "${r.id}"`);
+        }
+        else {
+            ids.add(r.id);
+        }
+        const pathErr = validateSafePath(r.path, `resources.${category}[${i}].path`);
+        if (pathErr)
+            errors.push(pathErr);
+    }
+    return errors;
+}
+// -- Public API --
+/**
+ * Parse raw YAML text into an untyped object.
+ * @param yamlText - raw YAML content of agent.yaml
+ * @returns parsed object
+ */
+export function parseAgentSpec(yamlText) {
+    return parseYaml(yamlText);
+}
+/**
+ * Validate a parsed AgentSpec object. Collects all errors.
+ * @param raw - parsed YAML object
+ * @returns validation result with all errors
+ */
+export function validateAgentSpec(raw) {
+    const errors = [];
+    if (!raw || typeof raw !== "object") {
+        return { valid: false, errors: ["agent spec must be an object"] };
+    }
+    const obj = raw;
+    // Required fields
+    if (!obj["name"] || typeof obj["name"] !== "string")
+        errors.push("name: required non-empty string");
+    if (!obj["version"] || typeof obj["version"] !== "string")
+        errors.push("version: required non-empty string");
+    // Imports
+    if (obj["imports"] !== undefined) {
+        if (!Array.isArray(obj["imports"])) {
+            errors.push("imports: must be an array");
+        }
+        else {
+            for (let i = 0; i < obj["imports"].length; i++) {
+                const imp = obj["imports"][i];
+                const refErr = validateImportRef(imp["ref"], i);
+                if (refErr)
+                    errors.push(refErr);
+                const verErr = validateImportVersion(imp["version"], i);
+                if (verErr)
+                    errors.push(verErr);
+            }
+        }
+    }
+    // Defaults lifecycle
+    if (obj["defaults"] && typeof obj["defaults"] === "object") {
+        const defaults = obj["defaults"];
+        if (defaults["lifecycle"]) {
+            errors.push(...validateLifecycle(defaults["lifecycle"], "defaults.lifecycle"));
+        }
+    }
+    // Startup
+    errors.push(...validateStartupBlock(obj["startup"], "startup"));
+    // Profiles shape validation
+    if (obj["profiles"] !== undefined && (typeof obj["profiles"] !== "object" || Array.isArray(obj["profiles"]) || obj["profiles"] === null)) {
+        errors.push("profiles: must be a map (object), not an array or scalar");
+    }
+    // Profile startup + lifecycle
+    if (obj["profiles"] && typeof obj["profiles"] === "object" && !Array.isArray(obj["profiles"])) {
+        for (const [profileName, profileRaw] of Object.entries(obj["profiles"])) {
+            if (profileRaw && typeof profileRaw === "object") {
+                const p = profileRaw;
+                errors.push(...validateStartupBlock(p["startup"], `profiles.${profileName}.startup`));
+                if (p["lifecycle"]) {
+                    errors.push(...validateLifecycle(p["lifecycle"], `profiles.${profileName}.lifecycle`));
+                }
+            }
+        }
+    }
+    // Resources
+    if (obj["resources"] && typeof obj["resources"] === "object") {
+        const res = obj["resources"];
+        const allLocalIds = {};
+        for (const category of ["skills", "guidance", "subagents", "hooks", "runtime_resources"]) {
+            const items = res[category];
+            if (items !== undefined) {
+                if (!Array.isArray(items)) {
+                    errors.push(`resources.${category}: must be an array`);
+                }
+                else {
+                    const entries = items;
+                    errors.push(...validateResourcePaths(entries, category));
+                    allLocalIds[category] = new Set(entries.map((e) => e["id"]).filter(Boolean));
+                    // runtime_resources must have runtime field
+                    if (category === "runtime_resources") {
+                        for (let i = 0; i < entries.length; i++) {
+                            if (!entries[i]["runtime"] || typeof entries[i]["runtime"] !== "string") {
+                                errors.push(`resources.runtime_resources[${i}].runtime: required non-empty string`);
+                            }
+                        }
+                    }
+                }
+            }
+            else {
+                allLocalIds[category] = new Set();
+            }
+        }
+        // Profile uses validation
+        if (obj["profiles"] && typeof obj["profiles"] === "object" && !Array.isArray(obj["profiles"])) {
+            for (const [profileName, profileRaw] of Object.entries(obj["profiles"])) {
+                if (profileRaw && typeof profileRaw === "object") {
+                    const p = profileRaw;
+                    if (p["uses"] && typeof p["uses"] === "object") {
+                        const uses = p["uses"];
+                        for (const category of ["skills", "guidance", "subagents", "hooks", "runtime_resources"]) {
+                            const refs = uses[category];
+                            if (Array.isArray(refs)) {
+                                for (const ref of refs) {
+                                    // Qualified refs (namespace:id) are accepted for later resolution
+                                    if (typeof ref === "string" && ref.includes(":")) {
+                                        const parts = ref.split(":");
+                                        if (parts.length < 2 || !parts[0] || !parts[1]) {
+                                            errors.push(`profiles.${profileName}.uses.${category}: invalid qualified ref "${ref}" (must be namespace:id)`);
+                                        }
+                                        // Otherwise accepted — import resolution in AS-T03
+                                    }
+                                    else if (typeof ref === "string") {
+                                        // Unqualified ref must exist in local declarations
+                                        if (!allLocalIds[category]?.has(ref)) {
+                                            errors.push(`profiles.${profileName}.uses.${category}: resource "${ref}" not found in declared resources`);
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Normalize a validated AgentSpec into the canonical typed shape.
+ * Applies defaults for optional fields.
+ * @param raw - parsed YAML object (must pass validation first)
+ * @returns normalized AgentSpec
+ */
+export function normalizeAgentSpec(raw) {
+    const imports = Array.isArray(raw["imports"])
+        ? raw["imports"].map((imp) => ({
+            ref: imp["ref"],
+            version: imp["version"],
+        }))
+        : [];
+    const startup = normalizeStartupBlock(raw["startup"]);
+    const resources = normalizeResources(raw["resources"]);
+    const profiles = {};
+    if (raw["profiles"] && typeof raw["profiles"] === "object" && !Array.isArray(raw["profiles"])) {
+        for (const [name, profileRaw] of Object.entries(raw["profiles"])) {
+            profiles[name] = normalizeProfile(profileRaw);
+        }
+    }
+    const defaults = raw["defaults"];
+    const result = {
+        version: raw["version"],
+        name: raw["name"],
+        summary: raw["summary"],
+        imports,
+        startup,
+        resources,
+        profiles,
+    };
+    if (defaults) {
+        result.defaults = {
+            runtime: defaults["runtime"],
+            model: defaults["model"],
+        };
+        if (defaults["lifecycle"]) {
+            result.defaults.lifecycle = normalizeLifecycle(defaults["lifecycle"]);
+        }
+    }
+    return result;
+}
+// -- Normalization helpers --
+const normalizeStartupBlock = sharedNormalizeStartupBlock;
+function normalizeLifecycle(raw) {
+    return {
+        executionMode: raw["execution_mode"] ?? "interactive_resident",
+        compactionStrategy: raw["compaction_strategy"] ?? "harness_native",
+        restorePolicy: raw["restore_policy"] ?? "resume_if_possible",
+    };
+}
+function normalizeResources(raw) {
+    if (!raw || typeof raw !== "object") {
+        return { skills: [], guidance: [], subagents: [], hooks: [], runtimeResources: [] };
+    }
+    const obj = raw;
+    return {
+        skills: Array.isArray(obj["skills"])
+            ? obj["skills"].map((s) => ({ id: s["id"], path: s["path"] }))
+            : [],
+        guidance: Array.isArray(obj["guidance"])
+            ? obj["guidance"].map((g) => ({
+                id: g["id"], path: g["path"],
+                target: g["target"], merge: g["merge"] ?? "managed_block",
+            }))
+            : [],
+        subagents: Array.isArray(obj["subagents"])
+            ? obj["subagents"].map((s) => ({ id: s["id"], path: s["path"] }))
+            : [],
+        hooks: Array.isArray(obj["hooks"])
+            ? obj["hooks"].map((h) => ({
+                id: h["id"], path: h["path"],
+                runtimes: Array.isArray(h["runtimes"]) ? h["runtimes"] : undefined,
+            }))
+            : [],
+        runtimeResources: Array.isArray(obj["runtime_resources"])
+            ? obj["runtime_resources"].map((r) => ({
+                id: r["id"], path: r["path"],
+                runtime: r["runtime"], type: r["type"],
+            }))
+            : [],
+    };
+}
+function normalizeProfile(raw) {
+    const uses = raw["uses"];
+    return {
+        summary: raw["summary"],
+        preferences: raw["preferences"],
+        startup: raw["startup"] ? normalizeStartupBlock(raw["startup"]) : undefined,
+        lifecycle: raw["lifecycle"] ? normalizeLifecycle(raw["lifecycle"]) : undefined,
+        uses: {
+            skills: Array.isArray(uses?.["skills"]) ? uses["skills"] : [],
+            guidance: Array.isArray(uses?.["guidance"]) ? uses["guidance"] : [],
+            subagents: Array.isArray(uses?.["subagents"]) ? uses["subagents"] : [],
+            hooks: Array.isArray(uses?.["hooks"]) ? uses["hooks"] : [],
+            runtimeResources: Array.isArray(uses?.["runtime_resources"]) ? uses["runtime_resources"] : [],
+        },
+    };
+}
+//# sourceMappingURL=agent-manifest.js.map

package/daemon/dist/domain/agent-manifest.js.map

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

package/daemon/dist/domain/agent-preflight.d.ts

@@ -0,0 +1,12 @@
+import { type AgentResolverFsOps } from "./agent-resolver.js";
+import type { PreflightResult } from "./types.js";
+/**
+ * Agent-only preflight: resolves agent_ref and its imports.
+ * Does NOT check runtime (that's member-authoritative in rig preflight).
+ * @param agentRef - agent_ref string
+ * @param rigRoot - rig root directory
+ * @param fsOps - filesystem operations
+ * @returns PreflightResult with errors/warnings
+ */
+export declare function agentPreflight(agentRef: string, rigRoot: string, fsOps: AgentResolverFsOps): PreflightResult;
+//# sourceMappingURL=agent-preflight.d.ts.map

package/daemon/dist/domain/agent-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-preflight.d.ts","sourceRoot":"","sources":["../../src/domain/agent-preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,GACxB,eAAe,CA2BjB"}

package/daemon/dist/domain/agent-preflight.js

@@ -0,0 +1,37 @@
+import { resolveAgentRef } from "./agent-resolver.js";
+/**
+ * Agent-only preflight: resolves agent_ref and its imports.
+ * Does NOT check runtime (that's member-authoritative in rig preflight).
+ * @param agentRef - agent_ref string
+ * @param rigRoot - rig root directory
+ * @param fsOps - filesystem operations
+ * @returns PreflightResult with errors/warnings
+ */
+export function agentPreflight(agentRef, rigRoot, fsOps) {
+    const errors = [];
+    const warnings = [];
+    const result = resolveAgentRef(agentRef, rigRoot, fsOps);
+    if (!result.ok) {
+        if (result.code === "validation_failed") {
+            errors.push(...result.errors);
+        }
+        else {
+            errors.push(result.error);
+        }
+        return { ready: false, errors, warnings };
+    }
+    // Import collisions as warnings (non-fatal)
+    for (const col of result.collisions) {
+        if (col.sources.length >= 2) {
+            const hasBase = col.sources.some((s) => s.qualifiedId === col.resourceId);
+            if (hasBase) {
+                warnings.push(`Base/import collision in ${col.category}: "${col.resourceId}" — base keeps unqualified id, import addressable as ${col.sources.find((s) => s.qualifiedId !== col.resourceId)?.qualifiedId}`);
+            }
+            else {
+                warnings.push(`Import/import collision in ${col.category}: "${col.resourceId}" — use qualified ids: ${col.sources.map((s) => s.qualifiedId).join(", ")}`);
+            }
+        }
+    }
+    return { ready: errors.length === 0, errors, warnings };
+}
+//# sourceMappingURL=agent-preflight.js.map

package/daemon/dist/domain/agent-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-preflight.js","sourceRoot":"","sources":["../../src/domain/agent-preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA2B,MAAM,qBAAqB,CAAC;AAG/E;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAAe,EACf,KAAyB;IAEzB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,GAAI,MAA+B,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAE,MAA4B,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED,4CAA4C;IAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1E,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,4BAA4B,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,UAAU,wDAAwD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;YAC9M,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,8BAA8B,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,UAAU,0BAA0B,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5J,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC1D,CAAC"}

package/daemon/dist/domain/agent-resolver.d.ts

@@ -0,0 +1,66 @@
+import type { AgentSpec } from "./types.js";
+export interface AgentResolverFsOps {
+    readFile(path: string): string;
+    exists(path: string): boolean;
+}
+export interface ResolvedAgentSpec {
+    spec: AgentSpec;
+    sourcePath: string;
+    hash: string;
+}
+export interface ResourceCollision {
+    category: string;
+    resourceId: string;
+    sources: Array<{
+        specName: string;
+        qualifiedId: string;
+    }>;
+}
+export type ResolveResult = {
+    ok: true;
+    resolved: ResolvedAgentSpec;
+    imports: ResolvedAgentSpec[];
+    collisions: ResourceCollision[];
+} | {
+    ok: false;
+    code: "not_found";
+    error: string;
+} | {
+    ok: false;
+    code: "parse_error";
+    error: string;
+} | {
+    ok: false;
+    code: "validation_failed";
+    errors: string[];
+} | {
+    ok: false;
+    code: "version_mismatch";
+    error: string;
+} | {
+    ok: false;
+    code: "import_error";
+    error: string;
+    importRef: string;
+} | {
+    ok: false;
+    code: "cycle_detected";
+    error: string;
+};
+/**
+ * Resolve an agent_ref to a concrete AgentSpec, including flat imports.
+ * @param ref - agent_ref string (e.g. "local:agents/impl" or "path:/abs/agents/impl")
+ * @param rigRoot - absolute path to rig root directory
+ * @param fsOps - injectable filesystem operations
+ * @returns structured resolve result
+ */
+export declare function resolveAgentRef(ref: string, rigRoot: string, fsOps: AgentResolverFsOps): ResolveResult;
+/**
+ * Resolve imports for an already-loaded AgentSpec.
+ * Import local: refs resolve relative to the spec's own directory.
+ * @param resolved - already-resolved base spec
+ * @param fsOps - injectable filesystem operations
+ * @returns structured resolve result with imports and collisions
+ */
+export declare function resolveImports(resolved: ResolvedAgentSpec, fsOps: AgentResolverFsOps): ResolveResult;
+//# sourceMappingURL=agent-resolver.d.ts.map

package/daemon/dist/domain/agent-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-resolver.d.ts","sourceRoot":"","sources":["../../src/domain/agent-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAI5D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAAC,UAAU,EAAE,iBAAiB,EAAE,CAAA;CAAE,GACxG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAUzD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,GACxB,aAAa,CAWf;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,kBAAkB,GACxB,aAAa,CAEf"}