@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/engine/artifact-validation.js

@@ -0,0 +1,211 @@
+/**
+ * @owner Uni-CLI Engine
+ * @does Infers and executes artifact validators for file-producing commands.
+ * @needs AdapterCommand pipeline metadata and command result rows.
+ * @feeds CommandContract artifacts and adapter/backend validation gates.
+ * @breaks Artifact-producing adapters when exit code is treated as sufficient proof.
+ */
+import { stat } from "node:fs/promises";
+function pipelineAction(step) {
+    return Object.keys(step)[0];
+}
+function hasPipelineAction(command, action) {
+    return (command.pipeline ?? []).some((step) => pipelineAction(step) === action);
+}
+function uniqueValidators(validators) {
+    const seen = new Set();
+    return validators.filter((validator) => {
+        const key = `${validator.kind}:${validator.source}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+export function inferArtifactValidators(command) {
+    const validators = [];
+    if (hasPipelineAction(command, "download")) {
+        validators.push({
+            kind: "download.status_success",
+            source: "pipeline.download",
+            required: true,
+        }, { kind: "file.exists", source: "pipeline.download", required: true }, { kind: "file.non_empty", source: "pipeline.download", required: true });
+    }
+    if (hasPipelineAction(command, "write_temp")) {
+        validators.push({ kind: "file.exists", source: "pipeline.write_temp", required: true }, { kind: "file.non_empty", source: "pipeline.write_temp", required: true });
+    }
+    return uniqueValidators(validators);
+}
+function recordIssue(issues, issue) {
+    issues.push(issue);
+}
+function downloadFromRow(row) {
+    if (!row || typeof row !== "object" || Array.isArray(row))
+        return undefined;
+    const value = row._download;
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+async function validateDownloadRow(row, rowIndex, issues) {
+    const download = downloadFromRow(row);
+    if (!download) {
+        recordIssue(issues, {
+            code: "missing_download_result",
+            message: "row has no _download artifact metadata",
+            row_index: rowIndex,
+        });
+        return 0;
+    }
+    if (download.status !== "success" && download.status !== "skipped") {
+        recordIssue(issues, {
+            code: "download_failed",
+            message: typeof download.error === "string"
+                ? download.error
+                : "download artifact did not succeed",
+            row_index: rowIndex,
+        });
+        return 0;
+    }
+    if (typeof download.path !== "string" || download.path.length === 0) {
+        recordIssue(issues, {
+            code: "missing_artifact_path",
+            message: "download artifact has no path",
+            row_index: rowIndex,
+        });
+        return 0;
+    }
+    return validateFilePath(download.path, rowIndex, issues);
+}
+async function validateFilePath(path, rowIndex, issues) {
+    try {
+        const info = await stat(path);
+        if (!info.isFile()) {
+            recordIssue(issues, {
+                code: "artifact_missing",
+                message: "artifact path is not a file",
+                row_index: rowIndex,
+                path,
+            });
+            return 0;
+        }
+        if (info.size <= 0) {
+            recordIssue(issues, {
+                code: "artifact_empty",
+                message: "artifact file is empty",
+                row_index: rowIndex,
+                path,
+            });
+            return 1;
+        }
+        return 1;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        recordIssue(issues, {
+            code: "artifact_missing",
+            message: `artifact path does not exist: ${message}`,
+            row_index: rowIndex,
+            path,
+        });
+        return 0;
+    }
+}
+function artifactPathsFromRow(row) {
+    if (!row || typeof row !== "object" || Array.isArray(row))
+        return [];
+    const record = row;
+    const paths = [];
+    const artifact = record._artifact;
+    if (artifact && typeof artifact === "object" && !Array.isArray(artifact)) {
+        const path = artifact.path;
+        if (typeof path === "string" && path.length > 0)
+            paths.push(path);
+    }
+    const artifacts = record._artifacts;
+    if (Array.isArray(artifacts)) {
+        for (const item of artifacts) {
+            if (!item || typeof item !== "object" || Array.isArray(item))
+                continue;
+            const path = item.path;
+            if (typeof path === "string" && path.length > 0)
+                paths.push(path);
+        }
+    }
+    const temp = record._temp ?? record.temp;
+    if (temp && typeof temp === "object" && !Array.isArray(temp)) {
+        for (const value of Object.values(temp)) {
+            if (typeof value === "string" && value.length > 0)
+                paths.push(value);
+        }
+    }
+    if (typeof record.path === "string" && record.path.length > 0) {
+        paths.push(record.path);
+    }
+    return [...new Set(paths)];
+}
+async function validateArtifactPathRow(row, rowIndex, issues) {
+    const paths = artifactPathsFromRow(row);
+    if (paths.length === 0) {
+        recordIssue(issues, {
+            code: "missing_artifact_path",
+            message: "row has no artifact path metadata",
+            row_index: rowIndex,
+        });
+        return 0;
+    }
+    let checked = 0;
+    for (const path of paths) {
+        checked += await validateFilePath(path, rowIndex, issues);
+    }
+    return checked;
+}
+export async function validateArtifactRows(command, rows) {
+    const validators = inferArtifactValidators(command);
+    const issues = [];
+    let checkedFiles = 0;
+    const validatesDownloads = validators.some((validator) => {
+        return validator.source === "pipeline.download";
+    });
+    if (validatesDownloads) {
+        for (const [index, row] of rows.entries()) {
+            checkedFiles += await validateDownloadRow(row, index, issues);
+        }
+    }
+    const validatesGenericArtifacts = validators.some((validator) => {
+        return (validator.source === "pipeline.write_temp" ||
+            validator.source === "desktop.exec");
+    });
+    if (validatesGenericArtifacts) {
+        for (const [index, row] of rows.entries()) {
+            checkedFiles += await validateArtifactPathRow(row, index, issues);
+        }
+    }
+    const unsupported = validators.filter((validator) => {
+        return (validator.source !== "pipeline.download" &&
+            validator.source !== "pipeline.write_temp" &&
+            validator.source !== "desktop.exec");
+    });
+    for (const validator of unsupported) {
+        recordIssue(issues, {
+            code: "unsupported_artifact_validator",
+            message: `unsupported artifact validator source ${validator.source}`,
+            row_index: -1,
+        });
+    }
+    if (validators.length > 0 && checkedFiles === 0 && issues.length === 0) {
+        recordIssue(issues, {
+            code: "missing_artifact_path",
+            message: "artifact-producing command produced no artifact rows",
+            row_index: -1,
+        });
+    }
+    return {
+        ok: issues.length === 0,
+        validators,
+        checked_files: checkedFiles,
+        issues,
+    };
+}
+//# sourceMappingURL=artifact-validation.js.map

package/dist/engine/artifact-validation.js.map

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

package/dist/engine/browser/diagnostics.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @owner Uni-CLI Browser
+ * @does Projects browser-backed command metadata into kernel diagnostics.
+ * @needs Invocation identity, adapter source path, target surface, and site-memory paths.
+ * @feeds InvocationResult diagnostics for CLI/MCP/ACP wrappers and browser evidence tests.
+ * @breaks Browser repair when commands do not expose target identity, evidence commands, or site memory locations.
+ */
+import type { TargetSurface } from "../../types.js";
+export interface BrowserCommandDiagnosticInput {
+    site: string;
+    command: string;
+    adapterPath: string;
+    targetSurface: TargetSurface;
+    browser: boolean;
+    domain?: string;
+}
+export interface BrowserCommandDiagnostic {
+    kind: "browser_command";
+    site: string;
+    command: string;
+    adapter_path: string;
+    target_surface: TargetSurface;
+    evidence: {
+        session: string;
+        network: string;
+        verify: string;
+    };
+    site_memory: {
+        endpoints: string;
+        field_map: string;
+        notes: string;
+        fixtures_dir: string;
+        verify_dir: string;
+    };
+    authoring_loop: string[];
+}
+export declare function buildBrowserCommandDiagnostic(input: BrowserCommandDiagnosticInput): BrowserCommandDiagnostic | undefined;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/engine/browser/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/engine/browser/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,aAAa,CAAC;IAC9B,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,6BAA6B,GACnC,wBAAwB,GAAG,SAAS,CA6BtC"}

package/dist/engine/browser/diagnostics.js

@@ -0,0 +1,40 @@
+/**
+ * @owner Uni-CLI Browser
+ * @does Projects browser-backed command metadata into kernel diagnostics.
+ * @needs Invocation identity, adapter source path, target surface, and site-memory paths.
+ * @feeds InvocationResult diagnostics for CLI/MCP/ACP wrappers and browser evidence tests.
+ * @breaks Browser repair when commands do not expose target identity, evidence commands, or site memory locations.
+ */
+import { siteMemoryPaths } from "../../browser/site-memory.js";
+export function buildBrowserCommandDiagnostic(input) {
+    if (!input.browser)
+        return undefined;
+    const paths = siteMemoryPaths(input.site);
+    const analyzeTarget = input.domain ?? `${input.site}.com`;
+    return {
+        kind: "browser_command",
+        site: input.site,
+        command: input.command,
+        adapter_path: input.adapterPath,
+        target_surface: input.targetSurface,
+        evidence: {
+            session: "unicli browser evidence --render-aware",
+            network: "unicli browser network --raw",
+            verify: `unicli browser verify ${input.site}/${input.command} --strict-memory`,
+        },
+        site_memory: {
+            endpoints: paths.endpoints,
+            field_map: paths.fieldMap,
+            notes: paths.notes,
+            fixtures_dir: paths.fixturesDir,
+            verify_dir: paths.verifyDir,
+        },
+        authoring_loop: [
+            `unicli browser analyze https://${analyzeTarget}`,
+            "unicli browser network --filter id,title",
+            `unicli browser verify ${input.site}/${input.command} --write-fixture`,
+            `unicli repair ${input.site} ${input.command}`,
+        ],
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/engine/browser/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/engine/browser/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAiC/D,MAAM,UAAU,6BAA6B,CAC3C,KAAoC;IAEpC,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,MAAM,CAAC;IAC1D,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,KAAK,CAAC,WAAW;QAC/B,cAAc,EAAE,KAAK,CAAC,aAAa;QACnC,QAAQ,EAAE;YACR,OAAO,EAAE,wCAAwC;YACjD,OAAO,EAAE,8BAA8B;YACvC,MAAM,EAAE,yBAAyB,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,kBAAkB;SAC/E;QACD,WAAW,EAAE;YACX,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,QAAQ;YACzB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,WAAW;YAC/B,UAAU,EAAE,KAAK,CAAC,SAAS;SAC5B;QACD,cAAc,EAAE;YACd,kCAAkC,aAAa,EAAE;YACjD,0CAA0C;YAC1C,yBAAyB,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,kBAAkB;YACtE,iBAAiB,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE;SAC/C;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/invoke.d.ts

@@ -13,4 +13,5 @@ export type { Invocation, CompiledCommand, InvocationResult, AjvValidateFn, } fr
 export { newULID, _resetULIDForTests } from "./kernel/ulid.js";
 export { compileAll, getCompiled, compileCommand, _resetCompiledCacheForTests, } from "./kernel/compile.js";
 export { buildInvocation, execute, KernelLookupError, } from "./kernel/execute.js";
+export { KERNEL_STAGE_ORDER, authorizeKernelInvocation, hardenKernelInput, resolveKernelCommandContext, validateKernelInput, } from "./kernel/stages.js";
 //# sourceMappingURL=invoke.d.ts.map

package/dist/engine/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/engine/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,OAAO,EACP,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/engine/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,OAAO,EACP,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/engine/invoke.js

@@ -12,4 +12,5 @@
 export { newULID, _resetULIDForTests } from "./kernel/ulid.js";
 export { compileAll, getCompiled, compileCommand, _resetCompiledCacheForTests, } from "./kernel/compile.js";
 export { buildInvocation, execute, KernelLookupError, } from "./kernel/execute.js";
+export { KERNEL_STAGE_ORDER, authorizeKernelInvocation, hardenKernelInput, resolveKernelCommandContext, validateKernelInput, } from "./kernel/stages.js";
 //# sourceMappingURL=invoke.js.map

package/dist/engine/invoke.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../src/engine/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,OAAO,EACP,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../src/engine/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,OAAO,EACP,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/engine/kernel/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @owner Uni-CLI Kernel
+ * @does Defines kernel-specific error classes shared by stage modules.
+ * @needs Command lookup keys.
+ * @feeds Kernel stage resolution and legacy invoke exports.
+ * @breaks Missing compiled command cache entries.
+ */
+export declare class KernelLookupError extends Error {
+    constructor(key: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/engine/kernel/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/engine/kernel/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,GAAG,EAAE,MAAM;CAOxB"}

package/dist/engine/kernel/errors.js

@@ -0,0 +1,15 @@
+/**
+ * @owner Uni-CLI Kernel
+ * @does Defines kernel-specific error classes shared by stage modules.
+ * @needs Command lookup keys.
+ * @feeds Kernel stage resolution and legacy invoke exports.
+ * @breaks Missing compiled command cache entries.
+ */
+export class KernelLookupError extends Error {
+    constructor(key) {
+        super(`KernelLookupError: compiled command not found: ${key}. ` +
+            "Loader must call compileAll() before execute() — call primeKernelCache() from discovery/loader.ts.");
+        this.name = "KernelLookupError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/engine/kernel/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/engine/kernel/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,GAAW;QACrB,KAAK,CACH,kDAAkD,GAAG,IAAI;YACvD,oGAAoG,CACvG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/engine/kernel/execute.d.ts

@@ -1,25 +1,14 @@
 /**
- * execute() — the bag-to-envelope pipeline every surface shares.
- *
- * Flow per invocation:
- *   1. ajv validate(bag.args)              → fail-closed USAGE_ERROR on reject
- *   2. hardenArgs(bag.args, argByName)     → schema-driven hardening
- *   3. runPipeline() / command.func()      → actual work
- *   4. build success envelope with live next_actions (runtime, not templated)
- *
- * Callers (CLI/MCP/ACP) format the returned `InvocationResult` for their
- * transport; they do not rebuild envelopes.
+ * @owner Uni-CLI Kernel
+ * @does Builds invocations and runs the shared kernel stage chain.
+ * @needs Registry resolution, compiled command cache, and explicit kernel stages.
+ * @feeds CLI/MCP/ACP transport renderers through InvocationResult.
+ * @breaks Surface parity when wrappers rebuild validation, authorization, execution, diagnostics, or envelopes.
  */
 import type { ResolvedArgs } from "../args.js";
+import { KernelLookupError } from "./errors.js";
 import type { Invocation, InvocationResult } from "./types.js";
-/**
- * Raised when execute() is called for a (site, cmd) pair that was not seen
- * by `compileAll()` at loader boot. Signals a wiring bug (the loader forgot
- * to prime the cache), not a user error.
- */
-export declare class KernelLookupError extends Error {
-    constructor(key: string);
-}
+export { KernelLookupError };
 /**
  * Look up an adapter + command pair and return an Invocation ready for
  * execute(). Returns `null` if either the site or command is unknown —

package/dist/engine/kernel/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/engine/kernel/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAW/C,OAAO,KAAK,EACV,UAAU,EAEV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAGpB;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,GAAG,EAAE,MAAM;CAOxB;AAyDD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE;IACP,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACvB,GACL,UAAU,GAAG,IAAI,CAcnB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsYxE"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/engine/kernel/execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG/D,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE;IACP,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACvB,GACL,UAAU,GAAG,IAAI,CAcnB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BxE"}