@exellix/ai-tasks 7.8.0

package/dist/methods/convenience-methods.d.ts

@@ -0,0 +1,45 @@
+import type { RunSkillResponse } from "../types/index.js";
+import type { ExecutionStrategyFactory } from "../strategies/strategy-factory.js";
+/**
+ * Convenience methods for common task execution patterns.
+ *
+ * These methods provide simplified APIs for common use cases,
+ * reducing boilerplate when executing tasks.
+ */
+export declare class TaskConvenienceMethods {
+    private strategyFactory;
+    constructor(strategyFactory: ExecutionStrategyFactory);
+    /**
+     * Convenience method for direct task execution.
+     *
+     * This is the most common execution pattern - directly executing
+     * a task without complex orchestration.
+     *
+     * @param skillKey The skill key to execute (e.g., "skills/professional-answer")
+     * @param input The input data
+     * @param options Must include `agentId`, `jobTypeId`, and `taskTypeId` (see `@exellix/ai-skills`).
+     * @returns Promise resolving to the task response
+     */
+    executeDirect<TParsed = any>(skillKey: string, input: Record<string, any> | string, options: {
+        /** Required — forwarded to `RunTaskRequest` / `@exellix/ai-skills`. */
+        agentId: string;
+        jobTypeId: string;
+        taskTypeId: string;
+        variables?: Record<string, any>;
+        context?: Record<string, any> | string;
+        knowledge?: Record<string, any>;
+        jobMemory?: any;
+        taskMemory?: any;
+        executionMemory?: any;
+        jobId?: string;
+        /** Defaults to a new UUID when omitted (required by `@exellix/ai-skills` RunSkillRequest). */
+        taskId?: string;
+        coreSkillId?: string;
+        masterSkillId?: string;
+        masterSkillActivityId?: string;
+        graphId?: string;
+        nodeId?: string;
+        timeoutMs?: number;
+    }): Promise<RunSkillResponse<TParsed>>;
+}
+//# sourceMappingURL=convenience-methods.d.ts.map

package/dist/methods/convenience-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convenience-methods.d.ts","sourceRoot":"","sources":["../../src/methods/convenience-methods.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAElF;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,eAAe,CAA2B;gBAEtC,eAAe,EAAE,wBAAwB;IAIrD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,OAAO,GAAG,GAAG,EAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EACnC,OAAO,EAAE;QACP,uEAAuE;QACvE,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;QACvC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,SAAS,CAAC,EAAE,GAAG,CAAC;QAChB,UAAU,CAAC,EAAE,GAAG,CAAC;QACjB,eAAe,CAAC,EAAE,GAAG,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,8FAA8F;QAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAetC"}

package/dist/methods/convenience-methods.js

@@ -0,0 +1,39 @@
+import { randomUUID } from "node:crypto";
+/**
+ * Convenience methods for common task execution patterns.
+ *
+ * These methods provide simplified APIs for common use cases,
+ * reducing boilerplate when executing tasks.
+ */
+export class TaskConvenienceMethods {
+    strategyFactory;
+    constructor(strategyFactory) {
+        this.strategyFactory = strategyFactory;
+    }
+    /**
+     * Convenience method for direct task execution.
+     *
+     * This is the most common execution pattern - directly executing
+     * a task without complex orchestration.
+     *
+     * @param skillKey The skill key to execute (e.g., "skills/professional-answer")
+     * @param input The input data
+     * @param options Must include `agentId`, `jobTypeId`, and `taskTypeId` (see `@exellix/ai-skills`).
+     * @returns Promise resolving to the task response
+     */
+    async executeDirect(skillKey, input, options) {
+        const taskId = options.taskId ?? randomUUID();
+        const jobId = options.jobId ?? randomUUID();
+        const request = {
+            skillKey,
+            input,
+            ...options,
+            taskId,
+            jobId,
+            executionStrategies: [],
+        };
+        const strategy = this.strategyFactory.getStrategy(request);
+        return strategy.execute(request);
+    }
+}
+//# sourceMappingURL=convenience-methods.js.map

package/dist/methods/convenience-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convenience-methods.js","sourceRoot":"","sources":["../../src/methods/convenience-methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACzB,eAAe,CAA2B;IAElD,YAAY,eAAyC;QACnD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,aAAa,CACjB,QAAgB,EAChB,KAAmC,EACnC,OAoBC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAmB;YAC9B,QAAQ;YACR,KAAK;YACL,GAAG,OAAO;YACV,MAAM;YACN,KAAK;YACL,mBAAmB,EAAE,EAAE;SACxB,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,QAAQ,CAAC,OAAO,CAAU,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/narrix/applyNarrixScope.d.ts

@@ -0,0 +1,10 @@
+import type { NarrixRunOutputSuccess } from "./types.js";
+import type { NarrixScope, TaskMemoryNarrixEntry } from "../types/task-types.js";
+/**
+ * Filters Narrix output by narrixScope before writing to task memory.
+ * - Signals: if includeSignals set, keep only those codes; else if excludeSignals set, drop those; else keep all.
+ * - Stories: same for includeStories / excludeStories with narrativeTypeId.
+ * - Entity and meta always pass through. If scope is undefined, returns full entry.
+ */
+export declare function applyNarrixScope(narrixOutput: NarrixRunOutputSuccess, scope?: NarrixScope | null): TaskMemoryNarrixEntry;
+//# sourceMappingURL=applyNarrixScope.d.ts.map

package/dist/narrix/applyNarrixScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyNarrixScope.d.ts","sourceRoot":"","sources":["../../src/narrix/applyNarrixScope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAkBjF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,sBAAsB,EACpC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,GACzB,qBAAqB,CAiDvB"}

package/dist/narrix/applyNarrixScope.js

@@ -0,0 +1,69 @@
+function getSignalCode(s) {
+    if (s !== null && typeof s === "object" && "code" in s) {
+        const v = s.code;
+        return typeof v === "string" ? v : undefined;
+    }
+    return undefined;
+}
+function getStoryNarrativeTypeId(st) {
+    if (st !== null && typeof st === "object" && "narrativeTypeId" in st) {
+        const v = st.narrativeTypeId;
+        return typeof v === "string" ? v : undefined;
+    }
+    return undefined;
+}
+/**
+ * Filters Narrix output by narrixScope before writing to task memory.
+ * - Signals: if includeSignals set, keep only those codes; else if excludeSignals set, drop those; else keep all.
+ * - Stories: same for includeStories / excludeStories with narrativeTypeId.
+ * - Entity and meta always pass through. If scope is undefined, returns full entry.
+ */
+export function applyNarrixScope(narrixOutput, scope) {
+    const entity = narrixOutput.entity ?? { entityKind: "", entityKey: "" };
+    const meta = (narrixOutput.meta && typeof narrixOutput.meta === "object") ? narrixOutput.meta : {};
+    if (!scope) {
+        return {
+            entity: { entityKind: entity.entityKind, entityKey: entity.entityKey },
+            signals: Array.isArray(narrixOutput.signals) ? [...narrixOutput.signals] : [],
+            stories: Array.isArray(narrixOutput.stories) ? [...narrixOutput.stories] : [],
+            meta: { ...meta },
+        };
+    }
+    let signals = Array.isArray(narrixOutput.signals) ? narrixOutput.signals : [];
+    if (scope.includeSignals?.length) {
+        const set = new Set(scope.includeSignals);
+        signals = signals.filter((s) => {
+            const code = getSignalCode(s);
+            return code !== undefined && set.has(code);
+        });
+    }
+    else if (scope.excludeSignals?.length) {
+        const set = new Set(scope.excludeSignals);
+        signals = signals.filter((s) => {
+            const code = getSignalCode(s);
+            return code === undefined || !set.has(code);
+        });
+    }
+    let stories = Array.isArray(narrixOutput.stories) ? narrixOutput.stories : [];
+    if (scope.includeStories?.length) {
+        const set = new Set(scope.includeStories);
+        stories = stories.filter((st) => {
+            const id = getStoryNarrativeTypeId(st);
+            return id !== undefined && set.has(id);
+        });
+    }
+    else if (scope.excludeStories?.length) {
+        const set = new Set(scope.excludeStories);
+        stories = stories.filter((st) => {
+            const id = getStoryNarrativeTypeId(st);
+            return id === undefined || !set.has(id);
+        });
+    }
+    return {
+        entity: { entityKind: entity.entityKind, entityKey: entity.entityKey },
+        signals,
+        stories,
+        meta: { ...meta },
+    };
+}
+//# sourceMappingURL=applyNarrixScope.js.map

package/dist/narrix/applyNarrixScope.js.map

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

package/dist/narrix/buildNarrixAttachment.d.ts

@@ -0,0 +1,9 @@
+import type { NarrixRunOutputSuccess, NarrixEnrichedAttachment } from "./types.js";
+/**
+ * Build the _narrix attachment from a successful NARRIX run for injection into
+ * executionMemory (and optionally jobMemory). Uses result.passes when
+ * passes.scoping and passes.discovery exist; otherwise uses top-level
+ * signals/stories for both scoping and discovery.
+ */
+export declare function buildNarrixAttachment(result: NarrixRunOutputSuccess): NarrixEnrichedAttachment;
+//# sourceMappingURL=buildNarrixAttachment.d.ts.map

package/dist/narrix/buildNarrixAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildNarrixAttachment.d.ts","sourceRoot":"","sources":["../../src/narrix/buildNarrixAttachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,CA0B9F"}

package/dist/narrix/buildNarrixAttachment.js

@@ -0,0 +1,29 @@
+/**
+ * Build the _narrix attachment from a successful NARRIX run for injection into
+ * executionMemory (and optionally jobMemory). Uses result.passes when
+ * passes.scoping and passes.discovery exist; otherwise uses top-level
+ * signals/stories for both scoping and discovery.
+ */
+export function buildNarrixAttachment(result) {
+    const passes = result.passes;
+    const topSignals = Array.isArray(result.signals) ? result.signals : [];
+    const topStories = Array.isArray(result.stories) ? result.stories : [];
+    const scoping = passes && typeof passes.scoping === "object" && passes.scoping !== null
+        ? {
+            signals: Array.isArray(passes.scoping.signals) ? passes.scoping.signals : topSignals,
+            stories: Array.isArray(passes.scoping.stories) ? passes.scoping.stories : topStories,
+        }
+        : { signals: topSignals, stories: topStories };
+    const discovery = passes && typeof passes.discovery === "object" && passes.discovery !== null
+        ? {
+            signals: Array.isArray(passes.discovery.signals) ? passes.discovery.signals : topSignals,
+            stories: Array.isArray(passes.discovery.stories) ? passes.discovery.stories : topStories,
+        }
+        : { signals: topSignals, stories: topStories };
+    return {
+        scoping,
+        discovery,
+        meta: result.meta && typeof result.meta === "object" ? result.meta : {},
+    };
+}
+//# sourceMappingURL=buildNarrixAttachment.js.map

package/dist/narrix/buildNarrixAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildNarrixAttachment.js","sourceRoot":"","sources":["../../src/narrix/buildNarrixAttachment.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA8B;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,MAAM,OAAO,GACX,MAAM,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;QACrE,CAAC,CAAC;YACE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;YACpF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;SACrF;QACH,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAEnD,MAAM,SAAS,GACb,MAAM,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI;QACzE,CAAC,CAAC;YACE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;YACxF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;SACzF;QACH,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAEnD,OAAO;QACL,OAAO;QACP,SAAS;QACT,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;KACxE,CAAC;AACJ,CAAC"}

package/dist/narrix/buildWebScopeScopeInput.d.ts

@@ -0,0 +1,39 @@
+import type { NarrixCniLike, WebScopePackInput } from "@exellix/narrix-web-scoper";
+type WebScopeQuestion = WebScopePackInput["questions"][number];
+import type { NarrixPreProcessorConfig, NarrixWebScopeQuestion } from "../types/task-types.js";
+import type { NarrixRunOutputSuccess } from "./types.js";
+export type BuildWebScopeTemplateContextArgs = {
+    cni?: NarrixCniLike;
+    entity?: Record<string, unknown>;
+    baseQuestion?: string;
+    entityKey?: string;
+};
+/**
+ * Flatten CNI knownFacts, common graphized entity paths, and question aliases for web scope templates / Handlebars.
+ */
+export declare function buildWebScopeTemplateContext(args: BuildWebScopeTemplateContextArgs): Record<string, unknown>;
+export type ResolveWebScopeQuestionAndTemplatesArgs = {
+    narrix: NarrixPreProcessorConfig;
+    requestInput: Record<string, unknown> | string | null | undefined;
+    successResult: NarrixRunOutputSuccess;
+    entity?: Record<string, unknown>;
+};
+/** Fields merged into `scopeGeneric` or into `scopeQuestionPack` base input. */
+export type ResolvedWebScopeScopeFields = {
+    question?: string;
+    webScopeTemplates?: string[];
+    webScopeObjects?: Record<string, unknown>;
+    /** When non-empty, task-sdk uses `scopeQuestionPack` instead of `scopeGeneric`. */
+    packQuestions?: WebScopeQuestion[];
+};
+/**
+ * Normalize `narrix.webScopeQuestions` into `@exellix/narrix-web-scoper` `WebScopeQuestion[]`
+ * (stable `id`, trimmed `question`, optional `purpose` from `source`).
+ */
+export declare function normalizeNarrixWebScopeQuestions(entries: NarrixWebScopeQuestion[] | undefined): WebScopeQuestion[];
+/**
+ * Resolves ScopeInput fields for web scoping: optional athenix templates + objects, or enriched question (Handlebars or default append).
+ */
+export declare function resolveWebScopeQuestionAndTemplates(args: ResolveWebScopeQuestionAndTemplatesArgs): ResolvedWebScopeScopeFields;
+export {};
+//# sourceMappingURL=buildWebScopeScopeInput.d.ts.map

package/dist/narrix/buildWebScopeScopeInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildWebScopeScopeInput.d.ts","sourceRoot":"","sources":["../../src/narrix/buildWebScopeScopeInput.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEnF,KAAK,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AA2BzD,MAAM,MAAM,gCAAgC,GAAG;IAC7C,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,gCAAgC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsD5G;AA2BD,MAAM,MAAM,uCAAuC,GAAG;IACpD,MAAM,EAAE,wBAAwB,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,aAAa,EAAE,sBAAsB,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,mFAAmF;IACnF,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,sBAAsB,EAAE,GAAG,SAAS,GAC5C,gBAAgB,EAAE,CAkBpB;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,uCAAuC,GAC5C,2BAA2B,CA6D7B"}

package/dist/narrix/buildWebScopeScopeInput.js

@@ -0,0 +1,193 @@
+import { randomUUID } from "node:crypto";
+import Handlebars from "handlebars";
+function isRecord(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function digGraphized(entity, path) {
+    if (!entity)
+        return undefined;
+    const g = entity.graphized;
+    if (!isRecord(g))
+        return undefined;
+    let cur = g;
+    for (const key of path) {
+        if (!isRecord(cur))
+            return undefined;
+        cur = cur[key];
+    }
+    return cur;
+}
+function pickScalarString(obj, keys) {
+    for (const k of keys) {
+        const v = obj[k];
+        if (typeof v === "string" && v.trim())
+            return v.trim();
+        if (v != null && typeof v !== "object" && String(v).trim())
+            return String(v).trim();
+    }
+    return undefined;
+}
+/**
+ * Flatten CNI knownFacts, common graphized entity paths, and question aliases for web scope templates / Handlebars.
+ */
+export function buildWebScopeTemplateContext(args) {
+    const out = {};
+    const { cni, entity, baseQuestion, entityKey } = args;
+    if (baseQuestion !== undefined && baseQuestion !== "") {
+        out.question = baseQuestion;
+        out.baseQuestion = baseQuestion;
+    }
+    if (entityKey !== undefined && entityKey !== "") {
+        out.label = entityKey;
+        out.entityKey = entityKey;
+    }
+    const facts = cni?.knownFacts;
+    if (Array.isArray(facts)) {
+        for (const f of facts) {
+            if (!isRecord(f))
+                continue;
+            const key = f.key;
+            if (typeof key !== "string" || !key.trim())
+                continue;
+            const value = f.value;
+            if (value !== undefined)
+                out[key.trim()] = value;
+        }
+    }
+    if (entity) {
+        const cveId = pickScalarString(out, ["cveId", "CVE_ID", "cve", "CVE"]) ??
+            (() => {
+                const v = digGraphized(entity, ["vulnerability", "cveId"]);
+                if (typeof v === "string" && v.trim())
+                    return v.trim();
+                const v2 = digGraphized(entity, ["vulnerability", "cve"]);
+                if (typeof v2 === "string" && v2.trim())
+                    return v2.trim();
+                return undefined;
+            })();
+        if (cveId && out.cveId === undefined)
+            out.cveId = cveId;
+        const vendor = pickScalarString(out, ["vendor", "Vendor"]) ??
+            (() => {
+                const v = digGraphized(entity, ["vulnerability", "vendor"]);
+                return typeof v === "string" && v.trim() ? v.trim() : undefined;
+            })();
+        if (vendor && out.vendor === undefined)
+            out.vendor = vendor;
+        const product = pickScalarString(out, ["product", "Product"]) ??
+            (() => {
+                const v = digGraphized(entity, ["vulnerability", "product"]);
+                return typeof v === "string" && v.trim() ? v.trim() : undefined;
+            })();
+        if (product && out.product === undefined)
+            out.product = product;
+    }
+    return out;
+}
+function tokenNotInBase(base, token) {
+    if (!token)
+        return false;
+    return !base.toLowerCase().includes(token.toLowerCase());
+}
+function defaultEnrichQuestion(baseQuestion, ctx) {
+    const cveId = pickScalarString(ctx, ["cveId", "CVE_ID", "cve", "CVE"]);
+    const vendor = pickScalarString(ctx, ["vendor", "Vendor"]);
+    const product = pickScalarString(ctx, ["product", "Product"]);
+    const extras = [];
+    const base = baseQuestion?.trim() ?? "";
+    for (const t of [cveId, vendor, product]) {
+        if (t && (!base || tokenNotInBase(base, t)))
+            extras.push(t);
+    }
+    const suffix = extras.join(" ").trim();
+    if (!base && !suffix)
+        return undefined;
+    if (!suffix)
+        return base || undefined;
+    if (!base)
+        return suffix;
+    return `${base} ${suffix}`.trim();
+}
+/**
+ * Normalize `narrix.webScopeQuestions` into `@exellix/narrix-web-scoper` `WebScopeQuestion[]`
+ * (stable `id`, trimmed `question`, optional `purpose` from `source`).
+ */
+export function normalizeNarrixWebScopeQuestions(entries) {
+    if (!Array.isArray(entries))
+        return [];
+    const out = [];
+    for (const e of entries) {
+        if (!e || typeof e !== "object")
+            continue;
+        const q = typeof e.question === "string" ? e.question.trim() : "";
+        if (!q)
+            continue;
+        const id = typeof e.id === "string" && e.id.trim()
+            ? e.id.trim()
+            : randomUUID();
+        const purpose = e.source === "manual" || e.source === "ai-driven"
+            ? `source:${e.source}`
+            : undefined;
+        out.push({ id, question: q, ...(purpose ? { purpose } : {}) });
+    }
+    return out;
+}
+/**
+ * Resolves ScopeInput fields for web scoping: optional athenix templates + objects, or enriched question (Handlebars or default append).
+ */
+export function resolveWebScopeQuestionAndTemplates(args) {
+    const { narrix, requestInput, successResult, entity } = args;
+    const baseQuestion = typeof requestInput === "string"
+        ? requestInput.trim() || undefined
+        : requestInput && typeof requestInput === "object" && typeof requestInput.question === "string"
+            ? requestInput.question.trim() || undefined
+            : undefined;
+    const cni = successResult.cni;
+    const autoContext = buildWebScopeTemplateContext({
+        cni,
+        entity,
+        baseQuestion,
+        entityKey: successResult.entity.entityKey,
+    });
+    const templates = narrix.webScopeTemplates?.filter((t) => typeof t === "string" && t.trim());
+    if (templates?.length) {
+        const webScopeObjects = {
+            ...autoContext,
+            ...(narrix.webScopeObjects ?? {}),
+        };
+        return {
+            webScopeTemplates: templates.map((t) => t.trim()),
+            webScopeObjects,
+        };
+    }
+    const packQuestions = normalizeNarrixWebScopeQuestions(narrix.webScopeQuestions);
+    if (packQuestions.length > 0) {
+        return { packQuestions };
+    }
+    const mergedForHandlebars = {
+        ...autoContext,
+        ...(narrix.webScopeObjects ?? {}),
+        input: requestInput ?? {},
+    };
+    const hbTpl = narrix.webScopeQuestionTemplate?.trim();
+    if (hbTpl) {
+        try {
+            const compiled = Handlebars.compile(hbTpl);
+            const rendered = compiled(mergedForHandlebars).trim().replace(/\s+/g, " ");
+            if (rendered) {
+                return { question: rendered };
+            }
+        }
+        catch {
+            // fall through to default enrichment
+        }
+    }
+    const ctxForDefault = mergedForHandlebars;
+    const enriched = defaultEnrichQuestion(baseQuestion, ctxForDefault);
+    const finalQ = enriched ?? baseQuestion;
+    if (finalQ !== undefined && finalQ !== "") {
+        return { question: finalQ };
+    }
+    return {};
+}
+//# sourceMappingURL=buildWebScopeScopeInput.js.map

package/dist/narrix/buildWebScopeScopeInput.js.map

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

package/dist/narrix/flags.d.ts

@@ -0,0 +1,4 @@
+export declare const narrixFlags: {
+    useNarrixIngest: boolean;
+};
+//# sourceMappingURL=flags.d.ts.map

package/dist/narrix/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/narrix/flags.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;CAEvB,CAAC"}

package/dist/narrix/flags.js

@@ -0,0 +1,4 @@
+export const narrixFlags = {
+    useNarrixIngest: process.env.USE_NARRIX_INGEST === "1",
+};
+//# sourceMappingURL=flags.js.map

package/dist/narrix/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/narrix/flags.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG;CACvD,CAAC"}

package/dist/narrix/index.d.ts

@@ -0,0 +1,11 @@
+export { runNarrixForRecord } from "./runNarrixForRecord.js";
+export { runNarrixForText } from "./runNarrixForText.js";
+export { runNarrixForDocs } from "./runNarrixForDocs.js";
+export { runNarrixForChat } from "./runNarrixForChat.js";
+export { getNarrixClient } from "./narrixClient.js";
+export { narrixFlags } from "./flags.js";
+export { NARRIX_RUN_SKILL_KEY } from "./task.js";
+export { getNarrixCatalogBundle, pickQuestionIdForDataset, resolveDatasetIngestHints } from "./seedBundleRouting.js";
+export type { DatasetIngestHints } from "./seedBundleRouting.js";
+export type { NarrixMedium, NarrixRunRouting, NarrixRunInput, NarrixRunInputRecord, NarrixRunInputText, NarrixRunInputDocs, NarrixRunInputChat, NarrixRunOutput, NarrixRunOutputSuccess, NarrixRunOutputFailure, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/narrix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/narrix/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACrH,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/narrix/index.js

@@ -0,0 +1,14 @@
+import { registerLocalTask } from "../localTasks/registry.js";
+import { NARRIX_RUN_SKILL_KEY, narrixRunHandler } from "./task.js";
+// Side effect: registers skills/skill.local:narrixRun when this module is imported
+registerLocalTask(NARRIX_RUN_SKILL_KEY, narrixRunHandler);
+// Public exports for use inside ai-tasks
+export { runNarrixForRecord } from "./runNarrixForRecord.js";
+export { runNarrixForText } from "./runNarrixForText.js";
+export { runNarrixForDocs } from "./runNarrixForDocs.js";
+export { runNarrixForChat } from "./runNarrixForChat.js";
+export { getNarrixClient } from "./narrixClient.js";
+export { narrixFlags } from "./flags.js";
+export { NARRIX_RUN_SKILL_KEY } from "./task.js";
+export { getNarrixCatalogBundle, pickQuestionIdForDataset, resolveDatasetIngestHints } from "./seedBundleRouting.js";
+//# sourceMappingURL=index.js.map

package/dist/narrix/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/narrix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEnE,mFAAmF;AACnF,iBAAiB,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;AAE1D,yCAAyC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/narrix/narrixClient.d.ts

@@ -0,0 +1,9 @@
+import type { NarrixIngest } from "@exellix/narrix-ingest";
+import type { NarrixRunner } from "@exellix/narrix-runner";
+type NarrixClient = {
+    ingest: NarrixIngest;
+    runner: NarrixRunner;
+};
+export declare function getNarrixClient(): Promise<NarrixClient>;
+export {};
+//# sourceMappingURL=narrixClient.d.ts.map

package/dist/narrix/narrixClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrixClient.d.ts","sourceRoot":"","sources":["../../src/narrix/narrixClient.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAuB3D,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAIF,wBAAgB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAqBvD"}

package/dist/narrix/narrixClient.js

@@ -0,0 +1,46 @@
+import { createIngest } from "@exellix/narrix-ingest";
+import { getNarrixRunnerModule } from "./narrixRunnerModule.js";
+import { recordAdapter } from "@exellix/narrix-adapter-records";
+import { adapter as textAdapter } from "@exellix/narrix-adapter-text";
+import { toCni as chatToCni } from "@exellix/narrix-adapter-chat";
+import { adapter as docsAdapter } from "@exellix/narrix-adapter-docs";
+const CHAT_ADAPTER_ID = "@exellix/narrix-adapter-chat";
+const CHAT_VERSION = "1.1.0";
+const chatProducer = {
+    kind: "chat",
+    adapterId: CHAT_ADAPTER_ID,
+    version: CHAT_VERSION,
+    toCni(input, options) {
+        return chatToCni(input, options);
+    },
+};
+function createFullIngest() {
+    const ingest = createIngest();
+    ingest.registry.register(recordAdapter, { makeDefault: true });
+    ingest.registry.register(textAdapter, { makeDefault: true });
+    ingest.registry.register(docsAdapter, { makeDefault: true });
+    ingest.registry.register(chatProducer, { makeDefault: true });
+    return ingest;
+}
+let singleton = null;
+export function getNarrixClient() {
+    if (!singleton) {
+        singleton = (async () => {
+            const ingest = createFullIngest();
+            const { createRunner } = await getNarrixRunnerModule();
+            const runner = await createRunner({
+                runtime: {
+                    onProcessorNotMatched: "attachError",
+                    onMissingMapping: "attachError",
+                    deterministicSort: true,
+                },
+            });
+            return { ingest, runner };
+        })().catch((err) => {
+            singleton = null;
+            throw err;
+        });
+    }
+    return singleton;
+}
+//# sourceMappingURL=narrixClient.js.map

package/dist/narrix/narrixClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrixClient.js","sourceRoot":"","sources":["../../src/narrix/narrixClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAItE,MAAM,eAAe,GAAG,8BAA8B,CAAC;AACvD,MAAM,YAAY,GAAG,OAAO,CAAC;AAE7B,MAAM,YAAY,GAAmB;IACnC,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,YAAY;IACrB,KAAK,CAAC,KAAc,EAAE,OAAiB;QACrC,OAAO,SAAS,CAAC,KAAwC,EAAE,OAA0C,CAAC,CAAC;IACzG,CAAC;CACF,CAAC;AAEF,SAAS,gBAAgB;IACvB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,IAAI,SAAS,GAAiC,IAAI,CAAC;AAEnD,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE;YACtB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;YAElC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,qBAAqB,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,OAAO,EAAE;oBACP,qBAAqB,EAAE,aAAa;oBACpC,gBAAgB,EAAE,aAAa;oBAC/B,iBAAiB,EAAE,IAAI;iBACxB;aACF,CAAC,CAAC;YAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACjB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/narrix/narrixContextMarkdown.d.ts

@@ -0,0 +1,15 @@
+import type { TaskMemoryNarrixEntry } from "../types/task-types.js";
+import type { NarrixEnrichedAttachment } from "./types.js";
+/**
+ * Builds a "## Scoping and discovery" markdown section from executionMemory._narrix (task-level pre-processor attachment).
+ * Used when the request had narrix config and the DIRECT path includes the enriched context in the LLM prompt.
+ * Returns empty string when there is no content (no signals or stories in scoping or discovery); does not include
+ * internal product names in the output.
+ */
+export declare function buildNarrixPreProcessorContextMarkdown(attachment: NarrixEnrichedAttachment): string;
+/**
+ * Builds a "## Narrix Scoping" markdown section from taskMemory.narrix (array of entries).
+ * Used to inject Narrix context into the LLM prompt. Returns empty string if array is empty or missing.
+ */
+export declare function buildNarrixContextMarkdown(narrixArray: TaskMemoryNarrixEntry[] | undefined | null): string;
+//# sourceMappingURL=narrixContextMarkdown.d.ts.map

package/dist/narrix/narrixContextMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrixContextMarkdown.d.ts","sourceRoot":"","sources":["../../src/narrix/narrixContextMarkdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,sCAAsC,CAAC,UAAU,EAAE,wBAAwB,GAAG,MAAM,CAuDnG;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAuC1G"}