@exellix/ai-tasks 7.8.0

package/dist/narrix/task.js

@@ -0,0 +1,143 @@
+import { narrixFlags } from "./flags.js";
+import { runNarrixForRecord } from "./runNarrixForRecord.js";
+import { runNarrixForText } from "./runNarrixForText.js";
+import { runNarrixForDocs } from "./runNarrixForDocs.js";
+import { runNarrixForChat } from "./runNarrixForChat.js";
+const NARRIX_DEBUG = process.env.NARRIX_DEBUG === "1";
+function isNarrixRunnerError(err) {
+    return (err instanceof Error &&
+        err.name === "RunnerError" &&
+        typeof err.code === "string");
+}
+export const NARRIX_RUN_SKILL_KEY = "skills/skill.local:narrixRun";
+function debugLog(...args) {
+    if (NARRIX_DEBUG) {
+        // eslint-disable-next-line no-console
+        console.log("[NARRIX_DEBUG]", ...args);
+    }
+}
+export const narrixRunHandler = async ({ input }) => {
+    if (!narrixFlags.useNarrixIngest) {
+        return { ok: false, error: "NARRIX_DISABLED" };
+    }
+    const normalized = normalizeInput(input);
+    if (!normalized) {
+        return {
+            ok: false,
+            error: "NARRIX_INVALID_INPUT",
+            message: "input must include medium (record|text|docs|chat), datasetId, and the fields required for that medium",
+        };
+    }
+    let result;
+    try {
+        switch (normalized.medium) {
+            case "record":
+                result = await runNarrixForRecord(normalized);
+                break;
+            case "text":
+                result = await runNarrixForText(normalized);
+                break;
+            case "docs":
+                result = await runNarrixForDocs(normalized);
+                break;
+            case "chat":
+                result = await runNarrixForChat(normalized);
+                break;
+            default:
+                result = {
+                    ok: false,
+                    error: "NARRIX_INVALID_INPUT",
+                    message: `unknown medium: ${normalized.medium}`,
+                };
+        }
+    }
+    catch (err) {
+        if (isNarrixRunnerError(err)) {
+            result = {
+                ok: false,
+                error: err.code,
+                message: err.message,
+            };
+        }
+        else {
+            const e = err;
+            result = {
+                ok: false,
+                error: e.code ?? "NARRIX_UNKNOWN_ERROR",
+                message: e.message ?? "narrix run failed",
+            };
+        }
+    }
+    if (NARRIX_DEBUG && result.ok) {
+        debugLog("datasetId", normalized.datasetId, "medium", normalized.medium);
+        debugLog("packId", result.meta.packId, "entityKind", result.meta.entityKind);
+        debugLog("signal codes", result.signals.map((s) => s.code));
+        debugLog("narrativeTypeIds", result.stories.map((s) => s.narrativeTypeId));
+    }
+    return result;
+};
+function normalizeInput(input) {
+    if (!input || typeof input !== "object")
+        return null;
+    const o = input;
+    const questionId = typeof o.questionId === "string" ? o.questionId : undefined;
+    const narrativeTypeId = typeof o.narrativeTypeId === "string" ? o.narrativeTypeId : undefined;
+    if (o.medium === "record" && typeof o.datasetId === "string" && o.record && typeof o.record === "object") {
+        return {
+            medium: "record",
+            datasetId: o.datasetId,
+            record: o.record,
+            recordType: typeof o.recordType === "string" ? o.recordType : undefined,
+            questionId,
+            narrativeTypeId,
+            sourceMeta: o.sourceMeta,
+        };
+    }
+    if (o.medium === "text" && typeof o.datasetId === "string" && typeof o.text === "string") {
+        return {
+            medium: "text",
+            datasetId: o.datasetId,
+            text: o.text,
+            meta: o.meta,
+            questionId,
+            narrativeTypeId,
+        };
+    }
+    if (o.medium === "docs" && typeof o.datasetId === "string" && o.document && typeof o.document === "object") {
+        const doc = o.document;
+        if (Array.isArray(doc.pages)) {
+            return {
+                medium: "docs",
+                datasetId: o.datasetId,
+                document: {
+                    pages: doc.pages,
+                    docId: doc.docId,
+                    title: doc.title,
+                },
+                questionId,
+                narrativeTypeId,
+            };
+        }
+        return null;
+    }
+    if (o.medium === "chat" && typeof o.datasetId === "string" && o.thread && typeof o.thread === "object") {
+        const thread = o.thread;
+        if (Array.isArray(thread.messages)) {
+            return {
+                medium: "chat",
+                datasetId: o.datasetId,
+                thread: {
+                    messages: thread.messages,
+                    threadId: o.thread.threadId,
+                    title: o.thread.title,
+                    participants: o.thread.participants,
+                },
+                questionId,
+                narrativeTypeId,
+            };
+        }
+        return null;
+    }
+    return null;
+}
+//# sourceMappingURL=task.js.map

package/dist/narrix/task.js.map

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

package/dist/narrix/types.d.ts

@@ -0,0 +1,104 @@
+export type NarrixMedium = "record" | "text" | "docs" | "chat";
+/** Optional runner overrides; if omitted, question id is derived from the catalog for `datasetId`. */
+export type NarrixRunRouting = {
+    /** Preferred: catalog question id for `runner.runByQuestion`. */
+    questionId?: string;
+    /** Alternative: narrative type id for `runner.runByNarrative`. */
+    narrativeTypeId?: string;
+};
+export type NarrixRunInputRecord = NarrixRunRouting & {
+    medium: "record";
+    datasetId: string;
+    record: Record<string, unknown>;
+    /** When set, overrides catalog entityKind for the records adapter `recordType`. */
+    recordType?: string;
+    /** Optional; forwarded to runner options as `sourceMeta`. */
+    sourceMeta?: Record<string, unknown>;
+};
+export type NarrixRunInputText = NarrixRunRouting & {
+    medium: "text";
+    datasetId: string;
+    text: string;
+    meta?: Record<string, unknown>;
+};
+export type NarrixDocPage = {
+    text: string;
+    pageId?: string;
+    pageNumber?: number;
+    index?: number;
+    mime?: "text/plain" | "text/markdown";
+    meta?: Record<string, unknown>;
+};
+export type NarrixRunInputDocs = NarrixRunRouting & {
+    medium: "docs";
+    datasetId: string;
+    document: {
+        pages: NarrixDocPage[];
+        docId?: string;
+        title?: string;
+    };
+};
+export type NarrixChatMessage = {
+    role: "user" | "assistant" | "system" | "tool" | "other";
+    text: string;
+    id?: string;
+    ts?: number;
+    authorId?: string;
+    meta?: Record<string, unknown>;
+};
+export type NarrixRunInputChat = NarrixRunRouting & {
+    medium: "chat";
+    datasetId: string;
+    thread: {
+        messages: NarrixChatMessage[];
+        threadId?: string;
+        title?: string;
+        participants?: string[];
+    };
+};
+export type NarrixRunInput = NarrixRunInputRecord | NarrixRunInputText | NarrixRunInputDocs | NarrixRunInputChat;
+export type NarrixRunOutputSuccess = {
+    ok: true;
+    entity: {
+        entityKind: string;
+        entityId?: string;
+        entityKey: string;
+    };
+    signals: unknown[];
+    stories: unknown[];
+    passes?: Record<string, {
+        stories: unknown[];
+        signals: unknown[];
+    }>;
+    meta: {
+        datasetId: string;
+        packId: string;
+        entityKind: string;
+        [k: string]: unknown;
+    };
+    /** CNI produced by ingest; forwarded for optional web-scoper enrichment. */
+    cni?: unknown;
+};
+export type NarrixRunOutputFailure = {
+    ok: false;
+    error: string;
+    message?: string;
+    meta?: Record<string, unknown>;
+};
+export type NarrixRunOutput = NarrixRunOutputSuccess | NarrixRunOutputFailure;
+/**
+ * Attachment shape injected into executionMemory (and optionally jobMemory) by the
+ * NARRIX task-level pre-processor. Task handlers read ctx.executionMemory._narrix (or attachToField).
+ */
+export type NarrixEnrichedAttachment = {
+    scoping: {
+        stories: unknown[];
+        signals: unknown[];
+    };
+    discovery: {
+        stories: unknown[];
+        signals: unknown[];
+    };
+    meta: Record<string, unknown>;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/narrix/types.js

@@ -0,0 +1,3 @@
+// --- Unified input (one handler, four media) ---
+export {};
+//# sourceMappingURL=types.js.map

package/dist/narrix/types.js.map

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

package/dist/narrix/webContextMarkdown.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Serialize executionMemory.webContext (WebScoperResult) into markdown for LLM prompts.
+ * Per-source body prefers @exellix/narrix-web-scoper first-class fields; order depends on
+ * preferCleanContent (clean content before raw HTML when true).
+ * Summary / findings are included as non-authoritative overview only.
+ */
+/**
+ * Pick excerpt body for a source. When preferCleanContent is true, prefer cleaned text over raw HTML.
+ */
+export declare function pickSourceBodyForOptions(src: Record<string, unknown>, preferCleanContent: boolean): string | undefined;
+export type BuildWebContextEvidenceMarkdownOptions = {
+    /** Max Unicode code units for the entire markdown output; tail is truncated with a marker. */
+    maxTotalChars?: number;
+    /** Prefer providerContent/content over providerRawContent/rawContent. Default true. */
+    preferCleanContent?: boolean;
+    /** Max number of sources to include after dedupe. Default 5. */
+    maxSources?: number;
+    /** Dedupe sources by normalized URL (first wins). Default true. */
+    dedupeByUrl?: boolean;
+};
+/**
+ * True when web scoping returned a hit with summary, findings, or at least one usable source.
+ */
+export declare function isWebContextEvidenceAvailable(webContextEntry: unknown): boolean;
+/**
+ * When web scoping returned a hit, builds a markdown section with source excerpts as primary evidence.
+ * Returns "" on miss, error, or when there is no usable context.
+ */
+export declare function buildWebContextEvidenceMarkdown(webContextEntry: unknown, options?: BuildWebContextEvidenceMarkdownOptions): string;
+/**
+ * Shallow clone of the memory bundle with executionMemory.webContext omitted (avoids duplicating web context in JSON + markdown).
+ */
+export declare function omitWebContextFromMemoryBundle(bundle: {
+    jobMemory?: Record<string, unknown>;
+    taskMemory?: Record<string, unknown>;
+    executionMemory?: Record<string, unknown>;
+}): {
+    jobMemory?: Record<string, unknown>;
+    taskMemory?: Record<string, unknown>;
+    executionMemory?: Record<string, unknown>;
+};
+/**
+ * Clone bundle for memory JSON serialization without Narrix attachment fields (for memory-web policy).
+ */
+export declare function omitNarrixFromMemoryBundle(bundle: {
+    jobMemory?: Record<string, unknown>;
+    taskMemory?: Record<string, unknown>;
+    executionMemory?: Record<string, unknown>;
+}, attachToField: string): {
+    jobMemory?: Record<string, unknown>;
+    taskMemory?: Record<string, unknown>;
+    executionMemory?: Record<string, unknown>;
+};
+//# sourceMappingURL=webContextMarkdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webContextMarkdown.d.ts","sourceRoot":"","sources":["../../src/narrix/webContextMarkdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,kBAAkB,EAAE,OAAO,GAC1B,MAAM,GAAG,SAAS,CAiBpB;AAwBD,MAAM,MAAM,sCAAsC,GAAG;IACnD,8FAA8F;IAC9F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAc/E;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,OAAO,EACxB,OAAO,CAAC,EAAE,sCAAsC,GAC/C,MAAM,CAkFR;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,CAWA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE;IACN,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,EACD,aAAa,EAAE,MAAM,GACpB;IACD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,CAsBA"}

package/dist/narrix/webContextMarkdown.js

@@ -0,0 +1,206 @@
+/**
+ * Serialize executionMemory.webContext (WebScoperResult) into markdown for LLM prompts.
+ * Per-source body prefers @exellix/narrix-web-scoper first-class fields; order depends on
+ * preferCleanContent (clean content before raw HTML when true).
+ * Summary / findings are included as non-authoritative overview only.
+ */
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function nonEmptyString(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const t = v.trim();
+    return t ? t : undefined;
+}
+function normalizeUrlKey(url) {
+    try {
+        const u = new URL(url.trim());
+        u.hash = "";
+        return u.href;
+    }
+    catch {
+        return url.trim().split("#")[0] ?? url.trim();
+    }
+}
+function pickSourceUrl(src) {
+    return nonEmptyString(src.url) ?? nonEmptyString(src.link);
+}
+/**
+ * Pick excerpt body for a source. When preferCleanContent is true, prefer cleaned text over raw HTML.
+ */
+export function pickSourceBodyForOptions(src, preferCleanContent) {
+    if (preferCleanContent) {
+        return (nonEmptyString(src.providerContent) ??
+            nonEmptyString(src.content) ??
+            nonEmptyString(src.providerRawContent) ??
+            nonEmptyString(src.rawContent) ??
+            nonEmptyString(src.snippet));
+    }
+    return (nonEmptyString(src.providerRawContent) ??
+        nonEmptyString(src.rawContent) ??
+        nonEmptyString(src.providerContent) ??
+        nonEmptyString(src.content) ??
+        nonEmptyString(src.snippet));
+}
+function formatFindings(findings) {
+    if (findings == null)
+        return undefined;
+    if (typeof findings === "string") {
+        const t = findings.trim();
+        return t ? `**Findings:**\n\n${t}` : undefined;
+    }
+    if (!Array.isArray(findings) || findings.length === 0)
+        return undefined;
+    const lines = ["**Findings:**", ""];
+    for (const f of findings) {
+        if (typeof f === "string" && f.trim())
+            lines.push(`- ${f.trim()}`);
+        else if (isRecord(f))
+            lines.push(`- ${JSON.stringify(f)}`);
+    }
+    return lines.join("\n");
+}
+function parseMaxTotalCharsEnv() {
+    const raw = process.env.WEB_CONTEXT_MARKDOWN_MAX_CHARS;
+    if (!raw)
+        return undefined;
+    const n = parseInt(raw, 10);
+    return !Number.isNaN(n) && n > 0 ? n : undefined;
+}
+/**
+ * True when web scoping returned a hit with summary, findings, or at least one usable source.
+ */
+export function isWebContextEvidenceAvailable(webContextEntry) {
+    if (!isRecord(webContextEntry) || webContextEntry.available !== true)
+        return false;
+    const ctx = webContextEntry.context;
+    if (!isRecord(ctx))
+        return false;
+    const sources = Array.isArray(ctx.sources) ? ctx.sources : [];
+    const preferClean = true;
+    const hasSourceMaterial = sources.some((s) => isRecord(s) &&
+        (pickSourceBodyForOptions(s, preferClean) || pickSourceUrl(s)));
+    const summary = nonEmptyString(ctx.summary);
+    const findingsBlock = formatFindings(ctx.findings);
+    return hasSourceMaterial || !!summary || !!findingsBlock;
+}
+/**
+ * When web scoping returned a hit, builds a markdown section with source excerpts as primary evidence.
+ * Returns "" on miss, error, or when there is no usable context.
+ */
+export function buildWebContextEvidenceMarkdown(webContextEntry, options) {
+    if (!isRecord(webContextEntry) || webContextEntry.available !== true)
+        return "";
+    const ctx = webContextEntry.context;
+    if (!isRecord(ctx))
+        return "";
+    let sources = Array.isArray(ctx.sources) ? [...ctx.sources] : [];
+    const preferClean = options?.preferCleanContent !== false;
+    const dedupeByUrl = options?.dedupeByUrl !== false;
+    const maxSources = options?.maxSources ?? 5;
+    if (dedupeByUrl && sources.length > 0) {
+        const seen = new Set();
+        const out = [];
+        for (const s of sources) {
+            if (!isRecord(s)) {
+                out.push(s);
+                continue;
+            }
+            const url = pickSourceUrl(s);
+            const key = url ? normalizeUrlKey(url) : `__nourl_${out.length}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(s);
+        }
+        sources = out;
+    }
+    if (maxSources > 0 && sources.length > maxSources) {
+        sources = sources.slice(0, maxSources);
+    }
+    const summary = nonEmptyString(ctx.summary);
+    const findingsBlock = formatFindings(ctx.findings);
+    const hasSourceMaterial = sources.some((s) => isRecord(s) && (pickSourceBodyForOptions(s, preferClean) || pickSourceUrl(s)));
+    if (!hasSourceMaterial && !summary && !findingsBlock)
+        return "";
+    const lines = [
+        "",
+        "## Web sources (primary evidence)",
+        "",
+        "Ground factual claims in the **source excerpts** below. **Summary** and **findings** (if present) are overview hints only—not authoritative on their own.",
+        "",
+    ];
+    if (summary || findingsBlock) {
+        lines.push("### Web overview (hints only)", "", "*Do not treat this subsection alone as sufficient evidence.*", "");
+        if (summary) {
+            lines.push("**Summary:**", summary, "");
+        }
+        if (findingsBlock) {
+            lines.push(findingsBlock, "");
+        }
+    }
+    lines.push("### Source excerpts (ground truth)", "");
+    for (let i = 0; i < sources.length; i++) {
+        const src = sources[i];
+        if (!isRecord(src))
+            continue;
+        const title = nonEmptyString(src.title) ?? nonEmptyString(src.name) ?? `Source ${i + 1}`;
+        const url = pickSourceUrl(src);
+        const body = pickSourceBodyForOptions(src, preferClean);
+        if (!body && !url)
+            continue;
+        lines.push(`#### ${title}`, "");
+        if (url)
+            lines.push(`- URL: ${url}`, "");
+        if (body)
+            lines.push(body, "");
+    }
+    let out = lines.join("\n");
+    const maxTotal = options?.maxTotalChars ?? parseMaxTotalCharsEnv();
+    if (maxTotal !== undefined && out.length > maxTotal) {
+        const marker = "\n\n[truncated — web source budget exceeded]";
+        const cut = Math.max(0, maxTotal - marker.length);
+        // Return as-is so we do not append a trailing newline past maxTotalChars.
+        return out.slice(0, cut) + marker;
+    }
+    return out.endsWith("\n") ? out : `${out}\n`;
+}
+/**
+ * Shallow clone of the memory bundle with executionMemory.webContext omitted (avoids duplicating web context in JSON + markdown).
+ */
+export function omitWebContextFromMemoryBundle(bundle) {
+    const ex = bundle.executionMemory;
+    if (!ex || typeof ex !== "object" || !("webContext" in ex)) {
+        return bundle;
+    }
+    const restExec = { ...ex };
+    delete restExec.webContext;
+    return {
+        ...bundle,
+        executionMemory: restExec,
+    };
+}
+/**
+ * Clone bundle for memory JSON serialization without Narrix attachment fields (for memory-web policy).
+ */
+export function omitNarrixFromMemoryBundle(bundle, attachToField) {
+    let { jobMemory, taskMemory, executionMemory } = bundle;
+    if (executionMemory && typeof executionMemory === "object" && attachToField in executionMemory) {
+        const rest = { ...executionMemory };
+        delete rest[attachToField];
+        executionMemory = rest;
+    }
+    if (jobMemory && typeof jobMemory === "object" && "_narrix" in jobMemory) {
+        const jm = { ...jobMemory };
+        delete jm._narrix;
+        jobMemory = jm;
+    }
+    if (taskMemory && typeof taskMemory === "object" && "narrix" in taskMemory) {
+        const tm = { ...taskMemory };
+        delete tm.narrix;
+        taskMemory = tm;
+    }
+    return { ...bundle, jobMemory, taskMemory, executionMemory };
+}
+//# sourceMappingURL=webContextMarkdown.js.map

package/dist/narrix/webContextMarkdown.js.map

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

package/dist/narrix/webScoper.d.ts

@@ -0,0 +1,43 @@
+import type { NarrixWebScoper, WebScoperConfig, WebScoperResult, ScopeInput, WebScopePackInput, WebScopePackResult } from "@exellix/narrix-web-scoper";
+/** Returns (and lazily creates) the shared NarrixWebScoper instance (default @exellix/narrix-web-scoper config). */
+export declare function getWebScoper(): NarrixWebScoper;
+/** Reset singletons (test helper). */
+export declare function resetWebScoperSingleton(): void;
+/** Override singleton with a mock (test helper). */
+export declare function setWebScoperForTesting(mock: NarrixWebScoper): void;
+export type RunWebScopeOptions = {
+    /** Per-request slice of @exellix/narrix-web-scoper `WebScoperConfig.scoping` (snippets, caps, raw content). */
+    scoping?: WebScoperConfig["scoping"];
+};
+/**
+ * Map `scopeQuestionPack` output to the legacy `WebScoperResult` shape stored in `executionMemory.webContext`
+ * so `buildWebContextEvidenceMarkdown` and synthesis paths stay compatible.
+ */
+export declare function mapWebScopePackResultToWebScoperResult(pack: WebScopePackResult): WebScoperResult;
+/**
+ * Optional fields merged into {@link ScopeInput} so `@exellix/narrix-web-scoper` Activix wrapping
+ * (`extractRunIds`) can correlate web-scope activities with the surrounding task run.
+ *
+ * Matches task-sdk `runContext.sessionId` when `sessionId` is set to the same value as `taskId`.
+ */
+export type WebScopeActivixCorrelationFields = {
+    jobId?: string;
+    taskId?: string;
+    sessionId?: string;
+};
+/** Non-empty trimmed strings only; omits unset/blank ids. */
+export declare function webScopeActivixCorrelationPatch(parts: {
+    jobId?: string | null | undefined;
+    taskId?: string | null | undefined;
+    sessionId?: string | null | undefined;
+}): WebScopeActivixCorrelationFields;
+/**
+ * Run scopeGeneric and return the result. On any thrown error, returns an available:false result
+ * so callers can apply lenient fallback without try/catch boilerplate.
+ */
+export declare function runWebScope(input: ScopeInput, options?: RunWebScopeOptions): Promise<WebScoperResult>;
+/**
+ * Run `scopeQuestionPack` and normalize to {@link WebScoperResult} for `executionMemory.webContext`.
+ */
+export declare function runWebScopeQuestionPack(input: WebScopePackInput, options?: RunWebScopeOptions): Promise<WebScoperResult>;
+//# sourceMappingURL=webScoper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webScoper.d.ts","sourceRoot":"","sources":["../../src/narrix/webScoper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,UAAU,EAEV,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAkBpC,oHAAoH;AACpH,wBAAgB,YAAY,IAAI,eAAe,CAM9C;AAED,sCAAsC;AACtC,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAED,oDAAoD;AACpD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAElE;AAmBD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;CACtC,CAAC;AAQF;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAyChG;AAED;;;;;GAKG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACvC,GAAG,gCAAgC,CASnC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAO1B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAQ1B"}