@exellix/ai-tasks 10.0.9 → 10.0.10

package/dist/web-scope/buildSearchInput.js

@@ -0,0 +1,178 @@
+import { randomUUID } from "node:crypto";
+function isRecord(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function readRecordInput(request) {
+    const em = request.executionMemory;
+    const emInput = em?.input;
+    if (isRecord(emInput) && isRecord(emInput.raw)) {
+        return emInput.raw;
+    }
+    if (isRecord(emInput))
+        return emInput;
+    return request.input;
+}
+function readQuestion(input) {
+    if (typeof input === "string") {
+        const t = input.trim();
+        return t || undefined;
+    }
+    if (isRecord(input) && typeof input.question === "string") {
+        const t = input.question.trim();
+        return t || undefined;
+    }
+    return undefined;
+}
+function readQuestionFromRequest(request) {
+    const fromInput = readQuestion(request.input);
+    if (fromInput)
+        return fromInput;
+    const contract = request.nodePlan?.invokeContract;
+    const taskVariable = contract?.taskVariable;
+    if (isRecord(taskVariable) && typeof taskVariable.question === "string") {
+        const t = taskVariable.question.trim();
+        if (t)
+            return t;
+    }
+    const em = request.executionMemory;
+    const emTaskVars = em?.taskVariables;
+    if (isRecord(emTaskVars) && typeof emTaskVars.question === "string") {
+        const t = emTaskVars.question.trim();
+        if (t)
+            return t;
+    }
+    return undefined;
+}
+function readRecordFromInput(input) {
+    if (!isRecord(input))
+        return undefined;
+    if (isRecord(input.record))
+        return input.record;
+    const { question: _q, ...rest } = input;
+    return Object.keys(rest).length > 0 ? rest : undefined;
+}
+function knownFactsToRecord(cni) {
+    if (!isRecord(cni))
+        return undefined;
+    const facts = cni.knownFacts;
+    if (!Array.isArray(facts))
+        return undefined;
+    const out = {};
+    for (const f of facts) {
+        if (!isRecord(f))
+            continue;
+        const key = f.key;
+        if (typeof key !== "string" || !key.trim())
+            continue;
+        if (f.value !== undefined)
+            out[key.trim()] = f.value;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function mergeRecords(...parts) {
+    const out = {};
+    for (const p of parts) {
+        if (!p)
+            continue;
+        Object.assign(out, p);
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/** Map legacy graphenix `webScoping` / unitParams into {@link WebScopeOptions}. */
+export function mapLegacyWebScopingToOptions(raw) {
+    if (!isRecord(raw))
+        return undefined;
+    const opts = {};
+    if (typeof raw.maxQueries === "number")
+        opts.maxQueries = raw.maxQueries;
+    if (typeof raw.freshnessDays === "number")
+        opts.freshnessDays = raw.freshnessDays;
+    if (Array.isArray(raw.includeDomains))
+        opts.includeDomains = raw.includeDomains.filter((d) => typeof d === "string");
+    if (Array.isArray(raw.excludeDomains))
+        opts.excludeDomains = raw.excludeDomains.filter((d) => typeof d === "string");
+    if (Array.isArray(raw.preferredDomains)) {
+        opts.preferredDomains = raw.preferredDomains.filter((d) => typeof d === "string");
+    }
+    if (raw.topic === "general" || raw.topic === "news")
+        opts.topic = raw.topic;
+    if (typeof raw.gapFill === "boolean")
+        opts.gapFill = raw.gapFill;
+    if (Array.isArray(raw.webScopeTemplates)) {
+        opts.queryTemplates = raw.webScopeTemplates.filter((t) => typeof t === "string" && t.trim()).map((t) => t.trim());
+    }
+    if (Array.isArray(raw.queryTemplates)) {
+        opts.queryTemplates = raw.queryTemplates.filter((t) => typeof t === "string" && t.trim()).map((t) => t.trim());
+    }
+    return Object.keys(opts).length > 0 ? opts : undefined;
+}
+export function normalizeWebScopeQuestions(entries) {
+    if (!Array.isArray(entries))
+        return [];
+    const out = [];
+    for (const e of entries) {
+        if (!e || typeof e !== "object")
+            continue;
+        const question = typeof e.question === "string" ? e.question.trim() : "";
+        if (!question)
+            continue;
+        const id = typeof e.id === "string" && e.id.trim() ? e.id.trim() : randomUUID();
+        out.push({
+            id,
+            question,
+            ...(typeof e.purpose === "string" && e.purpose.trim() ? { purpose: e.purpose.trim() } : {}),
+            ...(typeof e.mappedProperty === "string" && e.mappedProperty.trim()
+                ? { mappedProperty: e.mappedProperty.trim() }
+                : {}),
+            ...(e.options ? { options: e.options } : {}),
+        });
+    }
+    return out;
+}
+export function webScopeInvokeConfigFromUnitParams(unitParams) {
+    if (!unitParams)
+        return { enableWebScope: true };
+    const legacyScoping = unitParams.webScoping ?? unitParams.webScopeOptions;
+    const options = (isRecord(unitParams.options) ? unitParams.options : undefined) ??
+        mapLegacyWebScopingToOptions(legacyScoping);
+    const questionsRaw = (Array.isArray(unitParams.webScopeQuestions) ? unitParams.webScopeQuestions : undefined) ??
+        (Array.isArray(unitParams.questions) ? unitParams.questions : undefined);
+    return {
+        enableWebScope: unitParams.enableWebScope !== false,
+        options,
+        questions: Array.isArray(questionsRaw) ? questionsRaw : undefined,
+        snapshot: isRecord(unitParams.snapshot) ? unitParams.snapshot : undefined,
+        forceWeb: unitParams.forceWeb === true,
+        primaryQuestionId: typeof unitParams.primaryQuestionId === "string" ? unitParams.primaryQuestionId : undefined,
+    };
+}
+/**
+ * Compile a RunTaskRequest + invoke config into {@link WebScopeInput} or {@link WebScopePackInput}
+ * for `@x12i/web-scoper`. No Graphenix / Activix fields.
+ */
+export function buildWebScopeSearchPayload(args) {
+    const { request, config, cni } = args;
+    const rawInput = request.input;
+    const question = readQuestionFromRequest(request);
+    const record = mergeRecords(readRecordFromInput(rawInput), isRecord(readRecordInput(request)) ? readRecordInput(request) : undefined, knownFactsToRecord(cni));
+    const packQuestions = normalizeWebScopeQuestions(config.questions);
+    if (packQuestions.length > 0) {
+        const payload = {
+            questions: packQuestions,
+            ...(record ? { record } : {}),
+            ...(config.snapshot ? { snapshot: config.snapshot } : {}),
+            ...(config.options ? { options: config.options } : {}),
+            ...(config.forceWeb ? { forceWeb: true } : {}),
+            ...(config.primaryQuestionId ? { primaryQuestionId: config.primaryQuestionId } : {}),
+        };
+        return payload;
+    }
+    if (!question)
+        return null;
+    return {
+        question,
+        ...(record ? { record } : {}),
+        ...(config.options ? { options: config.options } : {}),
+    };
+}
+//# sourceMappingURL=buildSearchInput.js.map

package/dist/web-scope/buildSearchInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSearchInput.js","sourceRoot":"","sources":["../../src/web-scope/buildSearchInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,OAAuB;IAC9C,MAAM,EAAE,GAAG,OAAO,CAAC,eAAsD,CAAC;IAC1E,MAAM,OAAO,GAAG,EAAE,EAAE,KAAK,CAAC;IAC1B,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAE,OAA6B,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,OAAQ,OAA4C,CAAC,GAAG,CAAC;IAC3D,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,OAAO,OAAO,CAAC,KAA4D,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,SAAS,CAAC;IACxB,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,SAAS,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAuB;IACtD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,cAAqD,CAAC;IACzF,MAAM,YAAY,GAAG,QAAQ,EAAE,YAAY,CAAC;IAC5C,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,OAAO,YAAY,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxE,MAAM,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,GAAG,OAAO,CAAC,eAAsD,CAAC;IAC1E,MAAM,UAAU,GAAG,EAAE,EAAE,aAAa,CAAC;IACrC,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpE,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAY;IACtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,SAAS;QAC3B,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAClB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YAAE,SAAS;QACrD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CACnB,GAAG,KAAiD;IAEpD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,4BAA4B,CAAC,GAAY;IACvD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAAE,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IACzE,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ;QAAE,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IAClF,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACrH,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACrH,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM;QAAE,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IAC5E,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IACjE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpH,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA2C;IACpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,SAAS;QAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QAChF,GAAG,CAAC,IAAI,CAAC;YACP,EAAE;YACF,QAAQ;YACR,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE;gBACjE,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE;gBAC7C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,UAAoC;IAEpC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IACjD,MAAM,aAAa,GAAG,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,eAAe,CAAC;IAC1E,MAAM,OAAO,GACX,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,UAAU,CAAC,OAA2B,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,4BAA4B,CAAC,aAAa,CAAC,CAAC;IAE9C,MAAM,YAAY,GAChB,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE3E,OAAO;QACL,cAAc,EAAE,UAAU,CAAC,cAAc,KAAK,KAAK;QACnD,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAE,YAAuC,CAAC,CAAC,CAAC,SAAS;QAC7F,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACzE,QAAQ,EAAE,UAAU,CAAC,QAAQ,KAAK,IAAI;QACtC,iBAAiB,EACf,OAAO,UAAU,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;KAC9F,CAAC;AACJ,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAA6B;IAE7B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,YAAY,CACzB,mBAAmB,CAAC,QAAQ,CAAC,EAC7B,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAE,eAAe,CAAC,OAAO,CAA6B,CAAC,CAAC,CAAC,SAAS,EACtG,kBAAkB,CAAC,GAAG,CAAC,CACxB,CAAC;IAEF,MAAM,aAAa,GAAG,0BAA0B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAsB;YACjC,SAAS,EAAE,aAAa;YACxB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,OAAO;QACL,QAAQ;QACR,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/web-scope/client.d.ts

@@ -0,0 +1,12 @@
+import type { WebScopeInput, WebScopePackInput, WebScopePackResult, WebScopeResult, WebScoper } from "@x12i/web-scoper";
+export type { WebScopeInput, WebScopePackInput, WebScopePackResult, WebScopeResult, WebContext, WebScopeOptions, WebScoper, WebScoperConfig, } from "@x12i/web-scoper";
+export declare function getWebScoper(): WebScoper;
+export declare function resetWebScoperSingleton(): void;
+export declare function setWebScoperForTesting(mock: WebScoper): void;
+export declare function runWebScopeSearch(input: WebScopeInput): Promise<WebScopeResult>;
+export declare function runWebScopeSearchMany(input: WebScopePackInput): Promise<WebScopePackResult>;
+/** Stored on executionMemory.webContext — single or multi search output. */
+export type WebScopeExecutionResult = WebScopeResult | WebScopePackResult;
+export declare function isWebScopeSearchManyResult(v: unknown): v is WebScopePackResult;
+export declare function isWebScopeHit(v: unknown): boolean;
+//# sourceMappingURL=client.d.ts.map

package/dist/web-scope/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/web-scope/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACV,MAAM,kBAAkB,CAAC;AAI1B,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,eAAe,EACf,SAAS,EACT,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAkB1B,wBAAgB,YAAY,IAAI,SAAS,CAUxC;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAE5D;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAOrF;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYjG;AAED,4EAA4E;AAC5E,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAE1E,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,kBAAkB,CAE9E;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAKjD"}

package/dist/web-scope/client.js

@@ -0,0 +1,72 @@
+import { createWebScoper } from "@x12i/web-scoper";
+import { createSearchAdapter } from "@x12i/search-adapter";
+let searchAdapterInstance = null;
+let defaultScoper = null;
+let testOverride = null;
+function getSearchAdapter() {
+    if (!searchAdapterInstance) {
+        searchAdapterInstance = createSearchAdapter({
+            provider: "tavily",
+            tavily: {
+                apiKey: process.env.TAVILY_API_KEY,
+            },
+        });
+    }
+    return searchAdapterInstance;
+}
+export function getWebScoper() {
+    if (testOverride)
+        return testOverride;
+    if (!defaultScoper) {
+        defaultScoper = createWebScoper({
+            searchAdapter: getSearchAdapter(),
+            defaults: { maxQueries: 3, maxFindings: 10, maxSources: 10 },
+            snippets: { include: true, maxCharsPerSource: 500 },
+        });
+    }
+    return defaultScoper;
+}
+export function resetWebScoperSingleton() {
+    searchAdapterInstance = null;
+    defaultScoper = null;
+    testOverride = null;
+}
+export function setWebScoperForTesting(mock) {
+    testOverride = mock;
+}
+export async function runWebScopeSearch(input) {
+    try {
+        return await getWebScoper().search(input);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: { reason: "error", message } };
+    }
+}
+export async function runWebScopeSearchMany(input) {
+    try {
+        return await getWebScoper().searchMany(input);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            results: {},
+            pack: { scopes: {} },
+            error: { reason: "error", message },
+        };
+    }
+}
+export function isWebScopeSearchManyResult(v) {
+    return !!v && typeof v === "object" && "pack" in v && "results" in v;
+}
+export function isWebScopeHit(v) {
+    if (!v || typeof v !== "object")
+        return false;
+    if ("ok" in v && v.ok === true)
+        return true;
+    if (isWebScopeSearchManyResult(v) && v.ok === true)
+        return true;
+    return false;
+}
+//# sourceMappingURL=client.js.map

package/dist/web-scope/client.js.map

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