@adhamalkhaja/seyola-runtime 0.11.4

package/dist/run-step/contextPacket.js

@@ -0,0 +1,213 @@
+/**
+ * Compiles a ContextPacket for a single WorkPlan step. Reads the SKILL.md
+ * body, the references the body explicitly invokes, and walks step.inputs
+ * via the generic input resolver to load every input the step declares.
+ *
+ * Returns the packet plus the prompt that would be sent to the runtime
+ * backend.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { resolvePackPath } from "../lib/paths.js";
+import { loadJson } from "../lib/loadJson.js";
+import { resolveStepInputs } from "./inputResolver.js";
+const DEFAULT_BUDGET = {
+    max_total: 60000,
+    skill_instructions: 9000,
+    retrieved_evidence: 33000,
+    working_state: 6000,
+    headroom: 12000,
+};
+export function assembleContextPacket(args) {
+    const { packPath, selected } = args;
+    const skillAbs = resolvePackPath(packPath, selected.skillRef);
+    if (!existsSync(skillAbs)) {
+        return { ok: false, code: "skill_file_not_found", message: `Skill body not found at ${skillAbs}`, path: skillAbs };
+    }
+    const skillBody = readFileSync(skillAbs, "utf8");
+    // Discover references the skill body explicitly invokes.
+    const skillDir = dirname(skillAbs);
+    const referencePaths = [];
+    const referenceContents = [];
+    const referenceMatches = skillBody.matchAll(/`(references\/[^`]+\.md)`/g);
+    const seenRefs = new Set();
+    for (const match of referenceMatches) {
+        const refRel = match[1];
+        if (seenRefs.has(refRel))
+            continue;
+        seenRefs.add(refRel);
+        const refAbs = join(skillDir, refRel);
+        if (existsSync(refAbs)) {
+            referencePaths.push(refAbs);
+            referenceContents.push({ name: refRel, content: readFileSync(refAbs, "utf8") });
+        }
+    }
+    // Load output schema.
+    const schemaJson = loadJson(selected.outputSchemaPath);
+    if (!schemaJson.ok) {
+        return { ok: false, code: "output_schema_load_failed", message: schemaJson.message, path: selected.outputSchemaPath };
+    }
+    // Walk step.inputs through the generic resolver. Apply --input-transcript
+    // override if provided AND the step has an input named `transcript`.
+    const stepInputs = selected.step.inputs ?? {};
+    const resolvedInputs = resolveStepInputs({
+        inputs: stepInputs,
+        inputArtifacts: args.inputArtifacts,
+        packPath,
+        memberRoot: args.memberRoot,
+        taskSpecDir: args.taskSpecDir,
+        outputDir: args.outputDir,
+        configs: args.configs,
+        capabilityById: args.capabilityById,
+        stepIdToCapabilityId: args.stepIdToCapabilityId,
+    });
+    // Apply transcript override if provided.
+    if (args.inputTranscriptPath) {
+        for (const input of resolvedInputs) {
+            if (input.paramName === "transcript") {
+                const abs = args.inputTranscriptPath;
+                if (existsSync(abs)) {
+                    input.kind = "substrate-path";
+                    input.resolvedPath = abs;
+                    input.contentText = readFileSync(abs, "utf8");
+                    input.error = undefined;
+                }
+            }
+        }
+    }
+    // Hard-fail if any required input has an unresolved error.
+    // For substrate-path soft-fails (e.g., audience profile not yet built),
+    // the skill must degrade gracefully — we surface the error in the packet
+    // metadata but do not block dispatch.
+    // In dry-run mode, artifact-upstream missing-file errors are demoted to
+    // soft errors so the planner can walk the full plan even when downstream
+    // artifacts haven't been produced yet.
+    const hardErrors = resolvedInputs.filter((i) => {
+        if (!i.error)
+            return false;
+        if (i.kind === "typed-config" || i.kind === "unresolved")
+            return true;
+        if (i.kind === "artifact-upstream") {
+            // In dry-run, tolerate missing predicted upstream artifacts.
+            if (args.dryRun && i.error.code === "input_artifact_file_missing")
+                return false;
+            return true;
+        }
+        return false;
+    });
+    if (hardErrors.length > 0) {
+        const first = hardErrors[0];
+        return {
+            ok: false,
+            code: first.error.code,
+            message: first.error.message,
+            path: first.resolvedPath,
+        };
+    }
+    // Assemble the prompt.
+    const prompt = assemblePrompt({
+        selected,
+        skillBody,
+        references: referenceContents,
+        resolvedInputs,
+        outputSchema: schemaJson.data,
+    });
+    // Surface what got loaded into the packet metadata.
+    const loaded_configs = resolvedInputs
+        .filter((i) => i.kind === "typed-config")
+        .map((i) => i.resolvedAddress ?? i.rawValue);
+    const loaded_resources = [
+        ...resolvedInputs
+            .filter((i) => i.resolvedPath && (i.kind === "artifact-upstream" || i.kind === "substrate-path" || i.kind === "typed-config"))
+            .map((i) => i.resolvedPath),
+        ...referencePaths,
+    ];
+    const packet = {
+        step_id: selected.stepId,
+        task_summary: extractTaskSummary(selected.task),
+        current_step: {
+            kind: "skill",
+            skill: selected.skillRef,
+            capability: selected.capability,
+        },
+        loaded_skills: [selected.skillRef],
+        loaded_configs,
+        loaded_resources,
+        excluded: ["other_skill_bodies", "non_referenced_assets", "all_other_capabilities"],
+        token_budget: DEFAULT_BUDGET,
+        prompt,
+        output_schema: schemaJson.data,
+        resolved_inputs: resolvedInputs.map((i) => ({
+            param: i.paramName,
+            kind: i.kind,
+            source: i.resolvedPath ?? i.resolvedAddress ?? i.rawValue,
+            validated: i.validated,
+            error: i.error?.message,
+        })),
+    };
+    return { ok: true, packet, resolved_inputs: resolvedInputs };
+}
+function extractTaskSummary(task) {
+    const t = task;
+    return t.raw_intent ?? "";
+}
+function assemblePrompt(args) {
+    const { selected, skillBody, references, resolvedInputs, outputSchema } = args;
+    const lines = [];
+    lines.push("=== seyola-runtime: skill execution ===");
+    lines.push(`You are executing the Seyola skill at ${selected.skillRef}. ` +
+        `Follow the SKILL.md instructions exactly. ` +
+        `Output a single JSON object that validates against the output schema. ` +
+        `No prose around the JSON. No markdown fences. JSON only.`);
+    lines.push("");
+    lines.push("=== Step Contract ===");
+    lines.push(`step_id: ${selected.stepId}`);
+    lines.push(`capability: ${selected.capability}`);
+    lines.push(`output_artifact_type: ${selected.outputArtifactType}`);
+    lines.push("");
+    lines.push("=== Output Schema (JSON Schema draft 2020-12) ===");
+    lines.push("```json");
+    lines.push(JSON.stringify(outputSchema, null, 2));
+    lines.push("```");
+    lines.push("");
+    lines.push("=== Skill Instructions (SKILL.md) ===");
+    lines.push(skillBody);
+    lines.push("");
+    for (const ref of references) {
+        lines.push(`=== Reference: ${ref.name} ===`);
+        lines.push(ref.content);
+        lines.push("");
+    }
+    for (const input of resolvedInputs) {
+        // Header shape is intentionally simple. The kind + source go to a
+        // metadata line so the model sees the labeled content cleanly.
+        lines.push(`=== Input: ${input.paramName} ===`);
+        const sourceLabel = input.kind === "inline-content"
+            ? "(supplied inline)"
+            : input.kind === "artifact-upstream"
+                ? `(upstream artifact, kind=${input.kind}${input.expectedArtifactType ? `, type=${input.expectedArtifactType}` : ""})`
+                : `(kind=${input.kind}, source=${input.resolvedAddress ?? input.resolvedPath ?? input.rawValue})`;
+        lines.push(sourceLabel);
+        lines.push("");
+        if (input.error && !input.contentText) {
+            lines.push(`(Input could not be resolved: ${input.error.message})`);
+        }
+        else if (input.kind === "artifact-upstream" && input.parsedJson !== undefined) {
+            lines.push("```json");
+            lines.push(JSON.stringify(input.parsedJson, null, 2));
+            lines.push("```");
+        }
+        else if (input.contentText !== undefined && input.contentText.length > 0) {
+            lines.push(input.contentText);
+        }
+        else {
+            lines.push(`(${input.rawValue})`);
+        }
+        lines.push("");
+    }
+    lines.push("=== Now emit the JSON output ===");
+    lines.push("Respond with ONLY a single JSON object matching the output schema above.");
+    lines.push("No prose before or after. No markdown wrapping. No code fences. JSON only.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=contextPacket.js.map

package/dist/run-step/contextPacket.js.map

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

package/dist/run-step/derivation.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Derivation record writer. Per V2.1 §19, every step execution produces a
+ * derivation record at .derivations/[hash].json. For the v0.4.x runtime we
+ * write under {outputDir}/derivations/ since substrate root layout for
+ * derivations is still a Phase 6 concern.
+ */
+import type { SelectedStepContext, StructuredResult, ContextPacketAssembled } from "./types.js";
+export interface DerivationRecord {
+    $type: "derivation-record";
+    $schema_version: "1.0.0";
+    execution_id: string;
+    step_id: string;
+    capability: string;
+    skill_ref: string;
+    task_id: string | null;
+    plan_id: string | null;
+    backend: string;
+    context_packet_hash: string;
+    prompt_hash: string;
+    output_hash: string | null;
+    result_status: StructuredResult["status"];
+    produced_at: string;
+    outputs: StructuredResult["outputs"];
+    evaluations: StructuredResult["evaluations"];
+    cost: StructuredResult["cost"];
+    errors: StructuredResult["errors"];
+}
+export interface WriteDerivationArgs {
+    outputDir: string;
+    selected: SelectedStepContext;
+    packet: ContextPacketAssembled;
+    result: StructuredResult;
+    backend: string;
+}
+export declare function writeDerivation(args: WriteDerivationArgs): {
+    ok: true;
+    path: string;
+    record: DerivationRecord;
+};
+export declare function ensureDir(path: string): void;
+//# sourceMappingURL=derivation.d.ts.map

package/dist/run-step/derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivation.d.ts","sourceRoot":"","sources":["../../src/run-step/derivation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEhG,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC7C,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CA8C/G;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK5C"}

package/dist/run-step/derivation.js

@@ -0,0 +1,61 @@
+/**
+ * Derivation record writer. Per V2.1 §19, every step execution produces a
+ * derivation record at .derivations/[hash].json. For the v0.4.x runtime we
+ * write under {outputDir}/derivations/ since substrate root layout for
+ * derivations is still a Phase 6 concern.
+ */
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { createHash } from "node:crypto";
+export function writeDerivation(args) {
+    const promptHash = sha256(args.packet.prompt);
+    const packetHash = sha256(JSON.stringify({
+        step_id: args.packet.step_id,
+        loaded_skills: args.packet.loaded_skills,
+        loaded_configs: args.packet.loaded_configs,
+        loaded_resources: args.packet.loaded_resources,
+    }));
+    const outputHash = args.result.outputs && args.result.outputs.length > 0
+        ? sha256(JSON.stringify(args.result.outputs))
+        : null;
+    const executionId = `exec-${new Date().toISOString().replace(/[:.]/g, "-")}-${promptHash.slice(0, 8)}`;
+    const task = args.selected.task;
+    const plan = args.selected.plan;
+    const record = {
+        $type: "derivation-record",
+        $schema_version: "1.0.0",
+        execution_id: executionId,
+        step_id: args.selected.stepId,
+        capability: args.selected.capability,
+        skill_ref: args.selected.skillRef,
+        task_id: task.id ?? null,
+        plan_id: plan.id ?? null,
+        backend: args.backend,
+        context_packet_hash: packetHash,
+        prompt_hash: promptHash,
+        output_hash: outputHash,
+        result_status: args.result.status,
+        produced_at: args.result.produced_at,
+        outputs: args.result.outputs,
+        evaluations: args.result.evaluations,
+        cost: args.result.cost,
+        errors: args.result.errors,
+    };
+    const derivationsDir = join(args.outputDir, "derivations");
+    if (!existsSync(derivationsDir)) {
+        mkdirSync(derivationsDir, { recursive: true });
+    }
+    const recordPath = join(derivationsDir, `${executionId}.json`);
+    writeFileSync(recordPath, JSON.stringify(record, null, 2));
+    return { ok: true, path: recordPath, record };
+}
+function sha256(input) {
+    return createHash("sha256").update(input).digest("hex");
+}
+export function ensureDir(path) {
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+//# sourceMappingURL=derivation.js.map

package/dist/run-step/derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivation.js","sourceRoot":"","sources":["../../src/run-step/derivation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgCzC,MAAM,UAAU,eAAe,CAAC,IAAyB;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QACvC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;QAC5B,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;QACxC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;QAC1C,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB;KAC/C,CAAC,CAAC,CAAC;IACJ,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACtE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,WAAW,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAEvG,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAuB,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAuB,CAAC;IAEnD,MAAM,MAAM,GAAqB;QAC/B,KAAK,EAAE,mBAAmB;QAC1B,eAAe,EAAE,OAAO;QACxB,YAAY,EAAE,WAAW;QACzB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;QAC7B,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;QACpC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;QACjC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;QACxB,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,mBAAmB,EAAE,UAAU;QAC/B,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QACjC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;QACpC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;QAC5B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;QACpC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;QACtB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;KAC3B,CAAC;IAEF,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,WAAW,OAAO,CAAC,CAAC;IAC/D,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAE3D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/run-step/effectExecutor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Effect step executor. v0.8.0 supports a single effect:
+ *
+ *   file.export — copy upstream step outputs into a final export directory.
+ *
+ * Local-only. Idempotent. Low-risk. No approval gate. The runtime validates
+ * the effect against .effects/registry.json + the effect's policy file
+ * before executing. Refuses any target outside the configured outputDir.
+ *
+ * External effects (email.draft, slack.post, vercel.deploy, payment.send)
+ * are NOT in scope for v0.8.0. They require approval gating + tool registry
+ * plumbing.
+ */
+import type { ResolvedInput } from "./inputResolver.js";
+import type { SelectedStepContext, StructuredResult } from "./types.js";
+export interface EffectExecuteArgs {
+    packPath: string;
+    selected: SelectedStepContext;
+    resolvedInputs: ResolvedInput[];
+    outputDir: string;
+    upstreamOutputPaths?: string[];
+}
+export interface EffectExecuteResult {
+    ok: boolean;
+    outputs: Array<{
+        format: string;
+        path: string;
+        ready: boolean;
+    }>;
+    exportDirectory?: string;
+    manifestPath?: string;
+    effectRecordPath?: string;
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+    effect_id?: string;
+}
+export declare function executeEffectStep(args: EffectExecuteArgs): Promise<EffectExecuteResult>;
+/** Builds a StructuredResult for an effect step execution. */
+export declare function effectStepResult(selected: SelectedStepContext, exec: EffectExecuteResult, backend: string, durationMs: number): StructuredResult;
+//# sourceMappingURL=effectExecutor.d.ts.map

package/dist/run-step/effectExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectExecutor.d.ts","sourceRoot":"","sources":["../../src/run-step/effectExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAwDxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsO7F;AAiCD,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,gBAAgB,CA6BlB"}