@exellix/ai-tasks 7.8.0

package/dist/localTasks/narrixVulnInstancePlayground.js

@@ -0,0 +1,165 @@
+/**
+ * Playground/batch test: run narrix record handler on all vulnerability (instance) test-data JSON files,
+ * write one output JSON per input plus _summary.json.
+ *
+ * Env (optional):
+ *   NARRIX_PLAYGROUND_IN   default .tests/test-data
+ *   NARRIX_PLAYGROUND_OUT  default .tests/test-output/vulnerabilities
+ *   NARRIX_DATASET_ID      default vulnInstance
+ *
+ * Run: npm run local:narrix:vuln-instances (after npm run build)
+ */
+import { readdir, readFile, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { narrixRunHandler } from "../narrix/task.js";
+const DATASET_ID = process.env.NARRIX_DATASET_ID ?? "vulnInstance";
+const PLAYGROUND_IN = process.env.NARRIX_PLAYGROUND_IN ?? ".tests/test-data";
+const PLAYGROUND_OUT = process.env.NARRIX_PLAYGROUND_OUT ?? ".tests/test-output/vulnerabilities";
+/** Match: vulnerabilities-information_g.*.json or vuln*instance*.json (avoid vuln groups) */
+function isVulnInstanceInputFile(name) {
+    if (!name.endsWith(".json"))
+        return false;
+    if (name.startsWith("vulnerabilities-information_g."))
+        return true;
+    if (name.includes("vulnerability-groups"))
+        return false;
+    return name.includes("vulnerabilities") || (name.includes("vuln") && name.includes("instance"));
+}
+function deriveFromResult(result) {
+    if (!result.ok) {
+        return {
+            signalCodes: [],
+            narrativeTypeIds: [],
+            ok: false,
+            error: result.error ?? null,
+        };
+    }
+    const signals = result.signals ?? [];
+    const stories = result.stories ?? [];
+    return {
+        signalCodes: signals.map((s) => s.code ?? "").filter(Boolean),
+        narrativeTypeIds: stories.map((s) => s.narrativeTypeId ?? "").filter(Boolean),
+        ok: true,
+        error: null,
+    };
+}
+function getProjectRoot() {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    if (dir.endsWith("localTasks"))
+        return path.resolve(dir, "../..");
+    return path.resolve(dir, "../..");
+}
+const ctx = {
+    skillKey: "skills/skill.local:narrixRun",
+};
+async function main() {
+    const root = getProjectRoot();
+    const inDir = path.resolve(root, PLAYGROUND_IN);
+    const outDir = path.resolve(root, PLAYGROUND_OUT);
+    let entries;
+    try {
+        entries = (await readdir(inDir, { withFileTypes: true }));
+    }
+    catch (err) {
+        const e = err;
+        console.error("Playground input dir not found or not readable:", inDir, e.message);
+        process.exit(1);
+    }
+    const files = entries
+        .filter((e) => e.isFile() && isVulnInstanceInputFile(e.name))
+        .map((e) => e.name)
+        .sort();
+    if (files.length === 0) {
+        console.log("No vulnerability (instance) input files found in", inDir);
+        await mkdir(outDir, { recursive: true });
+        const summary = {
+            datasetId: DATASET_ID,
+            runCount: 0,
+            okCount: 0,
+            failCount: 0,
+            byFile: [],
+        };
+        await writeFile(path.join(outDir, "_summary.json"), JSON.stringify(summary, null, 2), "utf8");
+        console.log("Wrote _summary.json (0 runs).");
+        return;
+    }
+    console.log("Running", files.length, "vulnerability file(s)…");
+    await mkdir(outDir, { recursive: true });
+    const byFile = [];
+    let okCount = 0;
+    let failCount = 0;
+    for (const filename of files) {
+        const fullPath = path.join(inDir, filename);
+        const startedAt = new Date().toISOString();
+        let result;
+        try {
+            const raw = await readFile(fullPath, "utf8");
+            const parsed = JSON.parse(raw);
+            const record = Array.isArray(parsed) && parsed.length > 0
+                ? parsed[0]
+                : parsed;
+            try {
+                result = (await narrixRunHandler({
+                    input: { medium: "record", datasetId: DATASET_ID, record },
+                    ctx,
+                }));
+            }
+            catch (err) {
+                const e = err;
+                result = {
+                    ok: false,
+                    error: "PLAYGROUND_EXCEPTION",
+                    message: e.message ?? "narrix run threw",
+                };
+            }
+        }
+        catch (err) {
+            const e = err;
+            result = {
+                ok: false,
+                error: "PLAYGROUND_EXCEPTION",
+                message: `Failed to read/parse input: ${e.message}`,
+            };
+        }
+        const finishedAt = new Date().toISOString();
+        const durationMs = new Date(finishedAt).getTime() - new Date(startedAt).getTime();
+        const derived = deriveFromResult(result);
+        if (derived.ok)
+            okCount++;
+        else
+            failCount++;
+        byFile.push({
+            filename,
+            ok: derived.ok,
+            signalCount: derived.signalCodes.length,
+            storyCount: derived.narrativeTypeIds.length,
+            signalCodes: derived.signalCodes,
+            narrativeTypeIds: derived.narrativeTypeIds,
+            error: derived.error,
+        });
+        const outDoc = {
+            input: { filename, fullPath, datasetId: DATASET_ID },
+            result,
+            derived,
+            timestamps: { startedAt, finishedAt, durationMs },
+        };
+        const outBasename = filename.replace(/\.json$/i, "") + ".out.json";
+        await writeFile(path.join(outDir, outBasename), JSON.stringify(outDoc, null, 2), "utf8");
+        console.log(derived.ok ? "ok" : "fail", filename, "signals:", derived.signalCodes.length, "stories:", derived.narrativeTypeIds.length, derived.error ?? "");
+    }
+    const summary = {
+        datasetId: DATASET_ID,
+        runCount: files.length,
+        okCount,
+        failCount,
+        byFile,
+    };
+    await writeFile(path.join(outDir, "_summary.json"), JSON.stringify(summary, null, 2), "utf8");
+    console.log("Finished. ok:", okCount, "fail:", failCount, "→", path.join(outDir, "_summary.json"));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=narrixVulnInstancePlayground.js.map

package/dist/localTasks/narrixVulnInstancePlayground.js.map

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

package/dist/localTasks/nodeCallExport.d.ts

@@ -0,0 +1,6 @@
+import type { LocalTaskHandler } from "./types.js";
+export declare const globalCache: Map<string, any>;
+export declare function resolveArg(arg: any, input: any, ctx: any): any;
+export declare function loadModule(moduleNameOrPath: string): Promise<any>;
+export declare const nodeCallExportHandler: LocalTaskHandler;
+//# sourceMappingURL=nodeCallExport.d.ts.map

package/dist/localTasks/nodeCallExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeCallExport.d.ts","sourceRoot":"","sources":["../../src/localTasks/nodeCallExport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,WAAW,kBAAyB,CAAC;AAElD,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,CAqB9D;AAED,wBAAsB,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAEvE;AAED,eAAO,MAAM,qBAAqB,EAAE,gBAuFnC,CAAC"}

package/dist/localTasks/nodeCallExport.js

@@ -0,0 +1,99 @@
+import { getByPath, setByPath } from "../utils/jsonPaths.js";
+export const globalCache = new Map();
+export function resolveArg(arg, input, ctx) {
+    if (arg && typeof arg === "object" && typeof arg.$path === "string") {
+        const path = arg.$path;
+        const root = path.startsWith("jobMemory.")
+            ? ctx.jobMemory
+            : path.startsWith("taskMemory.")
+                ? ctx.taskMemory
+                : path.startsWith("executionMemory.")
+                    ? ctx.executionMemory
+                    : path.startsWith("variables.")
+                        ? ctx.variables
+                        : path.startsWith("input.")
+                            ? input
+                            : undefined;
+        const rel = path.replace(/^(jobMemory|taskMemory|executionMemory|variables|input)\./, "");
+        return getByPath(root, rel);
+    }
+    return arg;
+}
+export async function loadModule(moduleNameOrPath) {
+    return import(moduleNameOrPath);
+}
+export const nodeCallExportHandler = async ({ input, ctx }) => {
+    const started = Date.now();
+    const { module: moduleName, export: exportName = "default", call, cache } = input ?? {};
+    if (!moduleName || !call?.method) {
+        throw new Error(`node.callExport: missing required fields: module / call.method`);
+    }
+    const cacheKey = cache?.key ? `${cache.scope}:${cache.key}` : undefined;
+    let cachedValue;
+    if (cacheKey) {
+        if (cache.scope === "global")
+            cachedValue = globalCache.get(cacheKey);
+        if (cache.scope === "job")
+            cachedValue = getByPath(ctx.jobMemory ?? {}, `_localCache.${cache.key}`);
+    }
+    const mod = await loadModule(moduleName);
+    const exported = exportName === "default" ? mod.default : mod[exportName];
+    if (!exported) {
+        throw new Error(`node.callExport: export not found: ${exportName} in ${moduleName}`);
+    }
+    const args = (call.args ?? []).map((a) => resolveArg(a, input, ctx));
+    let value;
+    let cached = false;
+    if (call.method === "function") {
+        if (typeof exported !== "function")
+            throw new Error(`export is not a function`);
+        value = await exported(...args);
+    }
+    else if (call.method === "create") {
+        if (typeof exported !== "function")
+            throw new Error(`export is not a function`);
+        value = await exported(...args);
+        if (cacheKey) {
+            cached = true;
+            if (cache.scope === "global")
+                globalCache.set(cacheKey, value);
+            if (cache.scope === "job") {
+                const jm = ctx.jobMemory ?? {};
+                setByPath(jm, `_localCache.${cache.key}`, value);
+            }
+        }
+    }
+    else {
+        let instance = cachedValue;
+        if (!instance) {
+            if (typeof exported !== "function")
+                throw new Error(`export is not a function (needed to create instance)`);
+            instance = await exported();
+            if (cacheKey) {
+                cached = true;
+                if (cache.scope === "global")
+                    globalCache.set(cacheKey, instance);
+                if (cache.scope === "job") {
+                    const jm = ctx.jobMemory ?? {};
+                    setByPath(jm, `_localCache.${cache.key}`, instance);
+                }
+            }
+        }
+        const fn = instance?.[call.method];
+        if (typeof fn !== "function")
+            throw new Error(`method not found on instance: ${call.method}`);
+        value = await fn(...args);
+    }
+    return {
+        ok: true,
+        value,
+        meta: {
+            moduleResolved: moduleName,
+            exportResolved: exportName,
+            methodCalled: call.method,
+            cached,
+            durationMs: Date.now() - started,
+        },
+    };
+};
+//# sourceMappingURL=nodeCallExport.js.map

package/dist/localTasks/nodeCallExport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeCallExport.js","sourceRoot":"","sources":["../../src/localTasks/nodeCallExport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAG7D,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAe,CAAC;AAElD,MAAM,UAAU,UAAU,CAAC,GAAQ,EAAE,KAAU,EAAE,GAAQ;IACvD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YACxC,CAAC,CAAC,GAAG,CAAC,SAAS;YACf,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;gBAC9B,CAAC,CAAC,GAAG,CAAC,UAAU;gBAChB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;oBACnC,CAAC,CAAC,GAAG,CAAC,eAAe;oBACrB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;wBAC7B,CAAC,CAAC,GAAG,CAAC,SAAS;wBACf,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;4BACzB,CAAC,CAAC,KAAK;4BACP,CAAC,CAAC,SAAS,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CACtB,2DAA2D,EAC3D,EAAE,CACH,CAAC;QACF,OAAO,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,gBAAwB;IACvD,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAqB,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;IAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GACvE,KAAK,IAAI,EAAE,CAAC;IAEd,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,IAAI,WAA4B,CAAC;IACjC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ;YAAE,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;YACvB,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,EAAE,eAAe,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,QAAQ,GACZ,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,sCAAsC,UAAU,OAAO,UAAU,EAAE,CACpE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAE1E,IAAI,KAAU,CAAC;IACf,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,OAAO,QAAQ,KAAK,UAAU;YAChC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IAClC,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACpC,IAAI,OAAO,QAAQ,KAAK,UAAU;YAChC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ;gBAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC/D,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;gBAC/B,SAAS,CAAC,EAAE,EAAE,eAAe,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,QAAQ,GAAG,WAAW,CAAC;QAC3B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAChC,MAAM,IAAI,KAAK,CACb,sDAAsD,CACvD,CAAC;YACJ,QAAQ,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC5B,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,GAAG,IAAI,CAAC;gBACd,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ;oBAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAClE,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;oBAC1B,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;oBAC/B,SAAS,CAAC,EAAE,EAAE,eAAe,KAAK,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,OAAO,EAAE,KAAK,UAAU;YAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK;QACL,IAAI,EAAE;YACJ,cAAc,EAAE,UAAU;YAC1B,cAAc,EAAE,UAAU;YAC1B,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,MAAM;YACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SACjC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/localTasks/nodeCallExportBatch.d.ts

@@ -0,0 +1,3 @@
+import type { LocalTaskHandler } from "./types.js";
+export declare const nodeCallExportBatchHandler: LocalTaskHandler;
+//# sourceMappingURL=nodeCallExportBatch.d.ts.map

package/dist/localTasks/nodeCallExportBatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeCallExportBatch.d.ts","sourceRoot":"","sources":["../../src/localTasks/nodeCallExportBatch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,0BAA0B,EAAE,gBA2ExC,CAAC"}

package/dist/localTasks/nodeCallExportBatch.js

@@ -0,0 +1,52 @@
+import { getByPath, setByPath } from "../utils/jsonPaths.js";
+import { resolveArg, loadModule, globalCache, } from "./nodeCallExport.js";
+export const nodeCallExportBatchHandler = async ({ input, ctx, }) => {
+    const started = Date.now();
+    const { module: moduleName, export: exportName = "default", call, cache, } = input ?? {};
+    if (!moduleName || !call?.create || !call?.batch?.method) {
+        throw new Error(`node.callExportBatch: missing required fields: module / call.create / call.batch.method`);
+    }
+    const cacheKey = cache?.key ? `${cache.scope}:${cache.key}` : undefined;
+    let instance;
+    if (cacheKey) {
+        if (cache.scope === "global")
+            instance = globalCache.get(cacheKey);
+        if (cache.scope === "job")
+            instance = getByPath(ctx.jobMemory ?? {}, `_localCache.${cache.key}`);
+    }
+    if (!instance) {
+        const mod = await loadModule(moduleName);
+        const exported = exportName === "default" ? mod.default : mod[exportName];
+        if (!exported || typeof exported !== "function") {
+            throw new Error(`node.callExportBatch: export ${exportName} not found or not a function in ${moduleName}`);
+        }
+        const createArgs = (call.create.args ?? []).map((a) => resolveArg(a, input, ctx));
+        instance = await exported(...createArgs);
+        if (cacheKey) {
+            if (cache.scope === "global")
+                globalCache.set(cacheKey, instance);
+            if (cache.scope === "job") {
+                const jm = ctx.jobMemory ?? {};
+                setByPath(jm, `_localCache.${cache.key}`, instance);
+            }
+        }
+    }
+    const batchArgs = (call.batch.args ?? []).map((a) => resolveArg(a, input, ctx));
+    const fn = instance[call.batch.method];
+    if (typeof fn !== "function") {
+        throw new Error(`node.callExportBatch: method not found on instance: ${call.batch.method}`);
+    }
+    const value = await fn(...batchArgs);
+    const processed = value?.records?.length ?? 0;
+    const errors = value?.errors ?? value?.meta?.errors ?? 0;
+    return {
+        ok: true,
+        value,
+        meta: {
+            processed,
+            errors: typeof errors === "number" ? errors : (value?.errors?.length ?? 0),
+            durationMs: Date.now() - started,
+        },
+    };
+};
+//# sourceMappingURL=nodeCallExportBatch.js.map

package/dist/localTasks/nodeCallExportBatch.js.map

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

package/dist/localTasks/normalizeNarrixResult.d.ts

@@ -0,0 +1,3 @@
+import type { LocalTaskHandler } from "./types.js";
+export declare const normalizeNarrixResultHandler: LocalTaskHandler;
+//# sourceMappingURL=normalizeNarrixResult.d.ts.map

package/dist/localTasks/normalizeNarrixResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeNarrixResult.d.ts","sourceRoot":"","sources":["../../src/localTasks/normalizeNarrixResult.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgFnD,eAAO,MAAM,4BAA4B,EAAE,gBAqC1C,CAAC"}

package/dist/localTasks/normalizeNarrixResult.js

@@ -0,0 +1,106 @@
+import { getByPath, setByPath } from "../utils/jsonPaths.js";
+import { resolveArg } from "./nodeCallExport.js";
+function simpleHash(str) {
+    let h = 0;
+    for (let i = 0; i < str.length; i++) {
+        const c = str.charCodeAt(i);
+        h = (h << 5) - h + c;
+        h = h & h;
+    }
+    return Math.abs(h).toString(36);
+}
+function deepClone(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map((item) => deepClone(item));
+    const out = {};
+    for (const k of Object.keys(obj)) {
+        out[k] = deepClone(obj[k]);
+    }
+    return out;
+}
+function ensureAttachRoot(record, attachRoot) {
+    let root = getByPath(record, attachRoot);
+    if (!root || typeof root !== "object") {
+        root = {};
+        setByPath(record, attachRoot, root);
+    }
+}
+function ensureEntityKey(record, attachRoot) {
+    const root = getByPath(record, attachRoot);
+    if (!root || typeof root !== "object")
+        return;
+    const meta = root.meta ?? {};
+    const entity = meta.entity ?? {};
+    if (entity.entityKey === undefined || entity.entityKey === null) {
+        const fallback = record.id != null
+            ? String(record.id)
+            : simpleHash(JSON.stringify(record));
+        entity.entityKey = fallback;
+        meta.entity = entity;
+        root.meta = meta;
+        setByPath(record, attachRoot, root);
+    }
+}
+function ensureScopingDiscovery(record, attachRoot, defaults) {
+    const root = getByPath(record, attachRoot);
+    if (!root || typeof root !== "object")
+        return;
+    const scopingPath = defaults.scopingPath ?? "scoping";
+    const discoveryPath = defaults.discoveryPath ?? "discovery";
+    let scoping = getByPath(root, scopingPath);
+    if (!scoping || typeof scoping !== "object") {
+        scoping = {};
+        setByPath(root, scopingPath, scoping);
+    }
+    for (const key of ["facts", "signals", "stories"]) {
+        if (!Array.isArray(scoping[key]))
+            scoping[key] = [];
+    }
+    let discovery = getByPath(root, discoveryPath);
+    if (!discovery || typeof discovery !== "object") {
+        discovery = {};
+        setByPath(root, discoveryPath, discovery);
+    }
+    for (const key of ["facts", "signals", "stories"]) {
+        if (!Array.isArray(discovery[key]))
+            discovery[key] = [];
+    }
+    if (root.joinCandidates === undefined || root.joinCandidates === null) {
+        root.joinCandidates = {};
+    }
+    setByPath(record, attachRoot, root);
+}
+export const normalizeNarrixResultHandler = async ({ input, ctx, }) => {
+    const { recordsPath, attachRoot = "_narrix", defaults = {} } = input ?? {};
+    if (!recordsPath) {
+        return {
+            ok: false,
+            errors: [{ message: "recordsPath is required" }],
+        };
+    }
+    const records = resolveArg(recordsPath, input, ctx);
+    if (!Array.isArray(records)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    message: "recordsPath did not resolve to an array",
+                },
+            ],
+        };
+    }
+    const normalized = records.map((r) => {
+        const copy = deepClone(r);
+        ensureAttachRoot(copy, attachRoot);
+        ensureEntityKey(copy, attachRoot);
+        ensureScopingDiscovery(copy, attachRoot, defaults);
+        return copy;
+    });
+    return {
+        ok: true,
+        value: { records: normalized },
+    };
+};
+//# sourceMappingURL=normalizeNarrixResult.js.map

package/dist/localTasks/normalizeNarrixResult.js.map

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

package/dist/localTasks/registry.d.ts

@@ -0,0 +1,4 @@
+import type { LocalTaskHandler } from "./types.js";
+export declare function registerLocalTask(skillKey: string, handler: LocalTaskHandler): void;
+export declare function getLocalTask(skillKey: string): LocalTaskHandler | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/localTasks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/localTasks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEnF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE3E"}

package/dist/localTasks/registry.js

@@ -0,0 +1,8 @@
+const registry = {};
+export function registerLocalTask(skillKey, handler) {
+    registry[skillKey] = handler;
+}
+export function getLocalTask(skillKey) {
+    return registry[skillKey];
+}
+//# sourceMappingURL=registry.js.map

package/dist/localTasks/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/localTasks/registry.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAqC,EAAE,CAAC;AAEtD,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,OAAyB;IAC3E,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC"}

package/dist/localTasks/types.d.ts

@@ -0,0 +1,28 @@
+import type { SmartInputConfig, XynthesizedMemory } from "../types/task-types.js";
+/**
+ * Context passed to local task handlers (deterministic, no LLM).
+ */
+export type LocalTaskContext = {
+    skillKey: string;
+    jobMemory?: any;
+    taskMemory?: any;
+    executionMemory?: any;
+    variables?: Record<string, any>;
+    xynthesized?: XynthesizedMemory;
+    smartInput?: SmartInputConfig;
+    jobId?: string;
+    /** Task instance id (aligned with `RunTaskRequest.taskId` and Activix correlation). */
+    taskId?: string;
+    agentId?: string;
+    graphId?: string;
+    nodeId?: string;
+    prevNodeId?: string;
+    coreSkillId?: string;
+    masterSkillId?: string;
+    masterSkillActivityId?: string;
+};
+export type LocalTaskHandler = (args: {
+    input: any;
+    ctx: LocalTaskContext;
+}) => Promise<any>;
+//# sourceMappingURL=types.d.ts.map

package/dist/localTasks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/localTasks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,eAAe,CAAC,EAAE,GAAG,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE;IACpC,KAAK,EAAE,GAAG,CAAC;IACX,GAAG,EAAE,gBAAgB,CAAC;CACvB,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC"}

package/dist/localTasks/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/localTasks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/localTasks/types.ts"],"names":[],"mappings":""}

package/dist/localTasks/validateInput.d.ts

@@ -0,0 +1,3 @@
+import type { LocalTaskHandler } from "./types.js";
+export declare const validateInputHandler: LocalTaskHandler;
+//# sourceMappingURL=validateInput.d.ts.map

package/dist/localTasks/validateInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateInput.d.ts","sourceRoot":"","sources":["../../src/localTasks/validateInput.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,oBAAoB,EAAE,gBAwElC,CAAC"}

package/dist/localTasks/validateInput.js

@@ -0,0 +1,66 @@
+import { getByPath } from "../utils/jsonPaths.js";
+import { resolveArg } from "./nodeCallExport.js";
+export const validateInputHandler = async ({ input, ctx }) => {
+    const { schema: _schema, datasetId, recordsPath, rules } = input ?? {};
+    if (!recordsPath) {
+        return {
+            ok: false,
+            errors: [{ message: "recordsPath is required", path: "recordsPath" }],
+        };
+    }
+    const records = resolveArg(recordsPath, input, ctx);
+    if (!Array.isArray(records)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    message: "recordsPath did not resolve to an array",
+                    path: recordsPath?.$path ?? "recordsPath",
+                },
+            ],
+        };
+    }
+    const requirePaths = rules?.requirePaths ?? [];
+    const graphTypeEquals = rules?.graphTypeEquals;
+    const graphTypePath = "graphized.meta.graphType";
+    let valid = 0;
+    const errors = [];
+    for (let i = 0; i < records.length; i++) {
+        const record = records[i];
+        let recordValid = true;
+        for (const path of requirePaths) {
+            const val = getByPath(record, path);
+            if (val === undefined || val === null) {
+                recordValid = false;
+                errors.push({ index: i, path, message: `Missing required path: ${path}` });
+            }
+        }
+        if (recordValid && graphTypeEquals != null) {
+            const actual = getByPath(record, graphTypePath);
+            if (actual !== graphTypeEquals) {
+                recordValid = false;
+                errors.push({
+                    index: i,
+                    path: graphTypePath,
+                    message: `Expected graphType "${graphTypeEquals}", got "${actual}"`,
+                });
+            }
+        }
+        if (recordValid)
+            valid++;
+    }
+    const invalid = records.length - valid;
+    const total = records.length;
+    if (invalid > 0) {
+        return {
+            ok: false,
+            errors,
+            meta: { total, valid, invalid },
+        };
+    }
+    return {
+        ok: true,
+        meta: { total, valid, invalid },
+    };
+};
+//# sourceMappingURL=validateInput.js.map

package/dist/localTasks/validateInput.js.map

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