@exellix/ai-tasks 7.8.0

package/dist/narrix/webScoper.js

@@ -0,0 +1,144 @@
+import { createWebScoper } from "@exellix/narrix-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;
+}
+/** Returns (and lazily creates) the shared NarrixWebScoper instance (default @exellix/narrix-web-scoper config). */
+export function getWebScoper() {
+    if (testOverride)
+        return testOverride;
+    if (!defaultScoper) {
+        defaultScoper = createWebScoper({ enabled: true, searchAdapter: getSearchAdapter() });
+    }
+    return defaultScoper;
+}
+/** Reset singletons (test helper). */
+export function resetWebScoperSingleton() {
+    searchAdapterInstance = null;
+    defaultScoper = null;
+    testOverride = null;
+}
+/** Override singleton with a mock (test helper). */
+export function setWebScoperForTesting(mock) {
+    testOverride = mock;
+}
+function hasRequestScoping(scoping) {
+    if (!scoping)
+        return false;
+    return Object.keys(scoping).length > 0;
+}
+function scoperForCall(scoping) {
+    if (testOverride)
+        return testOverride;
+    if (hasRequestScoping(scoping)) {
+        return createWebScoper({
+            enabled: true,
+            searchAdapter: getSearchAdapter(),
+            scoping,
+        });
+    }
+    return getWebScoper();
+}
+function isWebContextLike(v) {
+    if (!v || typeof v !== "object")
+        return false;
+    const o = v;
+    return Array.isArray(o.findings) && Array.isArray(o.sources) && Array.isArray(o.queriesUsed);
+}
+/**
+ * Map `scopeQuestionPack` output to the legacy `WebScoperResult` shape stored in `executionMemory.webContext`
+ * so `buildWebContextEvidenceMarkdown` and synthesis paths stay compatible.
+ */
+export function mapWebScopePackResultToWebScoperResult(pack) {
+    if (!pack.available) {
+        return { available: false, reason: "notEligible" };
+    }
+    const pc = pack.context;
+    const findings = Array.isArray(pc.findings) ? pc.findings : [];
+    const sources = Array.isArray(pc.sources) ? pc.sources : [];
+    const queriesUsed = Array.isArray(pc.queriesUsed) ? pc.queriesUsed : [];
+    const summary = typeof pc.summary === "string" ? pc.summary.trim() : "";
+    const hasLegacy = findings.length > 0 ||
+        sources.length > 0 ||
+        queriesUsed.length > 0 ||
+        summary.length > 0;
+    if (hasLegacy) {
+        return {
+            available: true,
+            context: {
+                findings,
+                ...(summary ? { summary } : {}),
+                queriesUsed,
+                evidenceCount: findings.length,
+                sources,
+                retrievedAt: new Date().toISOString(),
+            },
+            cached: false,
+        };
+    }
+    const scopes = pc.scopes;
+    if (scopes && typeof scopes === "object") {
+        for (const s of Object.values(scopes)) {
+            if (s?.available === true && s.context && isWebContextLike(s.context)) {
+                return {
+                    available: true,
+                    context: s.context,
+                    cached: Boolean(s.cached),
+                };
+            }
+        }
+    }
+    return { available: false, reason: "noQueries" };
+}
+/** Non-empty trimmed strings only; omits unset/blank ids. */
+export function webScopeActivixCorrelationPatch(parts) {
+    const out = {};
+    const jobId = typeof parts.jobId === "string" ? parts.jobId.trim() : "";
+    const taskId = typeof parts.taskId === "string" ? parts.taskId.trim() : "";
+    const sessionId = typeof parts.sessionId === "string" ? parts.sessionId.trim() : "";
+    if (jobId)
+        out.jobId = jobId;
+    if (taskId)
+        out.taskId = taskId;
+    if (sessionId)
+        out.sessionId = sessionId;
+    return out;
+}
+/**
+ * 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 async function runWebScope(input, options) {
+    try {
+        return await scoperForCall(options?.scoping).scopeGeneric(input);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { available: false, reason: "error", error: message };
+    }
+}
+/**
+ * Run `scopeQuestionPack` and normalize to {@link WebScoperResult} for `executionMemory.webContext`.
+ */
+export async function runWebScopeQuestionPack(input, options) {
+    try {
+        const pack = await scoperForCall(options?.scoping).scopeQuestionPack(input);
+        return mapWebScopePackResultToWebScoperResult(pack);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { available: false, reason: "error", error: message };
+    }
+}
+//# sourceMappingURL=webScoper.js.map

package/dist/narrix/webScoper.js.map

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

package/dist/observability/debugTrace.d.ts

@@ -0,0 +1,31 @@
+import type { DebugTraceTask } from "../types/task-types.js";
+export type DebugTraceCollector = {
+    push: (task: DebugTraceTask) => void;
+    tasks: () => DebugTraceTask[];
+};
+export declare function createDebugTraceCollector(): DebugTraceCollector;
+/**
+ * Default `onError` implementation: extracts upstream typed-error payloads (`XynthesisInvokeError.invokeSummary`,
+ * `XynthesisResponseParseError.invokeSummary`, `SkillExecutionTraceError.diagnostics`, `LlmCallContextError.observation`)
+ * into the failure trace metadata so trace consumers can see model / max-tokens / usage / cost without re-wrapping.
+ */
+export declare function defaultLlmErrorTraceMetadata(err: unknown): Record<string, unknown>;
+/**
+ * Wraps an async LLM-bearing function with debug-trace recording. When `collector` is null, runs `fn` and returns;
+ * when set, on success appends a trace entry with `ok:true` and on failure appends a trace entry with `ok:false`
+ * before rethrowing.
+ *
+ * `onSuccess` lets the caller lift `modelUsed` / `metadata` from the success value (e.g. `result.invokeSummary`).
+ * `onError` lets the caller lift extra failure metadata; defaults to {@link defaultLlmErrorTraceMetadata} which
+ * extracts upstream typed-error payloads.
+ */
+export declare function traceWrap<T>(collector: DebugTraceCollector | null, task: Omit<DebugTraceTask, "metadata"> & {
+    metadata?: Record<string, unknown>;
+}, fn: () => Promise<T>, onSuccess?: (value: T) => {
+    metadata?: Record<string, unknown>;
+    modelUsed?: string | null;
+} | void, onError?: (err: unknown) => {
+    metadata?: Record<string, unknown>;
+    modelUsed?: string | null;
+} | void): Promise<T>;
+//# sourceMappingURL=debugTrace.d.ts.map

package/dist/observability/debugTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugTrace.d.ts","sourceRoot":"","sources":["../../src/observability/debugTrace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQ7D,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACrC,KAAK,EAAE,MAAM,cAAc,EAAE,CAAC;CAC/B,CAAC;AAEF,wBAAgB,yBAAyB,IAAI,mBAAmB,CAQ/D;AAaD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BlF;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,mBAAmB,GAAG,IAAI,EACrC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAC/E,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,EAClG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GACnG,OAAO,CAAC,CAAC,CAAC,CAiDZ"}

package/dist/observability/debugTrace.js

@@ -0,0 +1,117 @@
+import { XynthesisInvokeError, XynthesisResponseParseError, SkillExecutionTraceError, LlmCallContextError, } from "../types/llmCall.js";
+export function createDebugTraceCollector() {
+    const items = [];
+    return {
+        push: (task) => {
+            items.push(task);
+        },
+        tasks: () => items,
+    };
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function serializeError(err) {
+    if (err instanceof Error) {
+        return { errorName: err.name, errorMessage: err.message, errorStack: err.stack };
+    }
+    return { errorMessage: typeof err === "string" ? err : JSON.stringify(err) };
+}
+/**
+ * Default `onError` implementation: extracts upstream typed-error payloads (`XynthesisInvokeError.invokeSummary`,
+ * `XynthesisResponseParseError.invokeSummary`, `SkillExecutionTraceError.diagnostics`, `LlmCallContextError.observation`)
+ * into the failure trace metadata so trace consumers can see model / max-tokens / usage / cost without re-wrapping.
+ */
+export function defaultLlmErrorTraceMetadata(err) {
+    if (err instanceof XynthesisInvokeError) {
+        return {
+            errorKind: "XynthesisInvokeError",
+            invokeSummary: err.invokeSummary,
+        };
+    }
+    if (err instanceof XynthesisResponseParseError) {
+        return {
+            errorKind: "XynthesisResponseParseError",
+            invokeSummary: err.invokeSummary,
+            stage: err.stage,
+            responseLength: err.responseLength,
+            responsePreview: err.responsePreview,
+            actionType: err.actionType,
+        };
+    }
+    if (err instanceof SkillExecutionTraceError) {
+        return {
+            errorKind: "SkillExecutionTraceError",
+            diagnostics: err.diagnostics,
+        };
+    }
+    if (err instanceof LlmCallContextError) {
+        return {
+            errorKind: "LlmCallContextError",
+            observation: err.observation,
+        };
+    }
+    return {};
+}
+/**
+ * Wraps an async LLM-bearing function with debug-trace recording. When `collector` is null, runs `fn` and returns;
+ * when set, on success appends a trace entry with `ok:true` and on failure appends a trace entry with `ok:false`
+ * before rethrowing.
+ *
+ * `onSuccess` lets the caller lift `modelUsed` / `metadata` from the success value (e.g. `result.invokeSummary`).
+ * `onError` lets the caller lift extra failure metadata; defaults to {@link defaultLlmErrorTraceMetadata} which
+ * extracts upstream typed-error payloads.
+ */
+export async function traceWrap(collector, task, fn, onSuccess, onError) {
+    if (!collector)
+        return fn();
+    const startMs = Date.now();
+    const startedAt = nowIso();
+    try {
+        const value = await fn();
+        const endMs = Date.now();
+        const endedAt = nowIso();
+        const extra = onSuccess ? onSuccess(value) : undefined;
+        collector.push({
+            ...task,
+            metadata: {
+                ...(task.metadata ?? {}),
+                ...(extra && typeof extra === "object" ? (extra.metadata ?? {}) : {}),
+                timing: {
+                    startedAt,
+                    endedAt,
+                    durationMs: endMs - startMs,
+                },
+                ok: true,
+            },
+            ...(extra && typeof extra === "object" && "modelUsed" in extra ? { modelUsed: extra.modelUsed } : {}),
+        });
+        return value;
+    }
+    catch (err) {
+        const endMs = Date.now();
+        const endedAt = nowIso();
+        const errorExtra = onError ? onError(err) : undefined;
+        const defaultErrorMeta = defaultLlmErrorTraceMetadata(err);
+        collector.push({
+            ...task,
+            metadata: {
+                ...(task.metadata ?? {}),
+                ...defaultErrorMeta,
+                ...(errorExtra && typeof errorExtra === "object" ? (errorExtra.metadata ?? {}) : {}),
+                timing: {
+                    startedAt,
+                    endedAt,
+                    durationMs: endMs - startMs,
+                },
+                ok: false,
+                error: serializeError(err),
+            },
+            ...(errorExtra && typeof errorExtra === "object" && "modelUsed" in errorExtra
+                ? { modelUsed: errorExtra.modelUsed }
+                : { modelUsed: task.modelUsed ?? null }),
+        });
+        throw err;
+    }
+}
+//# sourceMappingURL=debugTrace.js.map

package/dist/observability/debugTrace.js.map

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

package/dist/observability/extractAiTasksObservability.d.ts

@@ -0,0 +1,7 @@
+import type { RunTaskRequest, RunTaskResponse, AiTasksObservabilityDigest } from "../types/task-types.js";
+/**
+ * Build a stable, versioned observability digest from a `runTask` response (and optional request context).
+ * Safe to call on partial / early responses; missing fields become `undefined` or sensible defaults.
+ */
+export declare function extractAiTasksObservabilityFromRunTaskResponse<TParsed = unknown>(result: RunTaskResponse<TParsed>, request?: RunTaskRequest): AiTasksObservabilityDigest;
+//# sourceMappingURL=extractAiTasksObservability.d.ts.map

package/dist/observability/extractAiTasksObservability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractAiTasksObservability.d.ts","sourceRoot":"","sources":["../../src/observability/extractAiTasksObservability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,0BAA0B,EAE3B,MAAM,wBAAwB,CAAC;AA2DhC;;;GAGG;AACH,wBAAgB,8CAA8C,CAAC,OAAO,GAAG,OAAO,EAC9E,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,0BAA0B,CAgD5B"}

package/dist/observability/extractAiTasksObservability.js

@@ -0,0 +1,98 @@
+function shallowKeys(obj) {
+    if (!obj || typeof obj !== "object" || Array.isArray(obj))
+        return [];
+    return Object.keys(obj);
+}
+function approxJsonChars(obj) {
+    try {
+        return JSON.stringify(obj ?? {}).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function pickPipeline(meta) {
+    const v = meta?.effectiveExecutionPipeline;
+    return Array.isArray(v) ? v : undefined;
+}
+function pickBool(meta, key) {
+    const v = meta?.[key];
+    return typeof v === "boolean" ? v : undefined;
+}
+function pickString(meta, key) {
+    const v = meta?.[key];
+    return typeof v === "string" ? v : undefined;
+}
+function pickStringArray(meta, key) {
+    const v = meta?.[key];
+    if (!Array.isArray(v))
+        return undefined;
+    const all = v.every((x) => typeof x === "string");
+    return all ? v : undefined;
+}
+function pickExecutionStrategiesSummary(meta) {
+    const v = meta?.executionStrategiesSummary;
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        return undefined;
+    const o = v;
+    const beforeKeys = pickStringArray(o, "beforeKeys");
+    const afterKeys = pickStringArray(o, "afterKeys");
+    const primaryOptimizerMaxIterations = o.primaryOptimizerMaxIterations;
+    if (!beforeKeys || !afterKeys)
+        return undefined;
+    const wrapKeys = new Set(["planner", "optimizer"]);
+    if (!beforeKeys.every((k) => wrapKeys.has(k)) || !afterKeys.every((k) => wrapKeys.has(k)))
+        return undefined;
+    return {
+        beforeKeys: beforeKeys,
+        afterKeys: afterKeys,
+        ...(typeof primaryOptimizerMaxIterations === "number" && Number.isFinite(primaryOptimizerMaxIterations)
+            ? { primaryOptimizerMaxIterations }
+            : {}),
+    };
+}
+/**
+ * Build a stable, versioned observability digest from a `runTask` response (and optional request context).
+ * Safe to call on partial / early responses; missing fields become `undefined` or sensible defaults.
+ */
+export function extractAiTasksObservabilityFromRunTaskResponse(result, request) {
+    const meta = result.metadata;
+    const execMem = result.executionMemory ??
+        result.executionState
+            ?.executionMemory;
+    const narrixMeta = meta?.narrix;
+    const synthesisEnabled = pickBool(meta, "synthesisEnabled") ?? false;
+    const synthesizedContextPresent = pickBool(meta, "synthesizedContextPresent") ?? !!execMem?.synthesizedContext;
+    const mainSource = pickString(meta, "mainContextSource");
+    const mainContextSource = mainSource === "synthesizedContext" || mainSource === "unsynthesized"
+        ? mainSource
+        : "unsynthesized";
+    const digest = {
+        schemaVersion: 1,
+        synthesisEnabled,
+        effectiveExecutionPipeline: pickPipeline(meta),
+        synthesizedContextPresent,
+        mainContextSource,
+        detectedTemplateCores: pickStringArray(meta, "detectedTemplateCores"),
+        synthesisMode: pickString(meta, "synthesisMode") === "markdown" || pickString(meta, "synthesisMode") === "structured"
+            ? pickString(meta, "synthesisMode")
+            : undefined,
+        inputStrategyKey: pickString(meta, "inputStrategyKey"),
+        executionStrategiesSummary: pickExecutionStrategiesSummary(meta),
+        narrixMode: pickString(meta, "narrixMode"),
+        executionMemorySummary: execMem && typeof execMem === "object"
+            ? {
+                topLevelKeys: shallowKeys(execMem),
+                approxJsonChars: approxJsonChars(execMem),
+            }
+            : undefined,
+        narrixSummary: narrixMeta && typeof narrixMeta === "object"
+            ? {
+                durationMs: typeof narrixMeta.durationMs === "number" ? narrixMeta.durationMs : undefined,
+                ok: typeof narrixMeta.ok === "boolean" ? narrixMeta.ok : undefined,
+            }
+            : undefined,
+    };
+    return digest;
+}
+//# sourceMappingURL=extractAiTasksObservability.js.map

package/dist/observability/extractAiTasksObservability.js.map

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

package/dist/observability/graphExecutionRunLogContract.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Contract hints for `@woroces/worox-graph` (implemented in that package, not here).
+ *
+ * Graph HTTP responses should expose at least one of:
+ * - `debugTrace: import("@exellix/ai-tasks").DebugTraceTask[]` — authoritative ordered execution trace (ai-tasks trace mode)
+ * - `executionTrace` — narrowed `{ nodes: Record<string, unknown> }` (or full `execution` with `_trace`)
+ *
+ * Prefer `executionMode: "trace"` on `runTask()` when a full diagnostic trace is needed.
+ */
+import type { DebugTraceTask } from "../types/task-types.js";
+/** Fields worox-graph may add to graph execute JSON responses (downstream implements). */
+export type GraphExecutionConsoleFields = {
+    debugTrace?: DebugTraceTask[];
+    executionTrace?: {
+        nodes: Record<string, unknown>;
+        graphEvents?: unknown[];
+    };
+};
+//# sourceMappingURL=graphExecutionRunLogContract.d.ts.map

package/dist/observability/graphExecutionRunLogContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphExecutionRunLogContract.d.ts","sourceRoot":"","sources":["../../src/observability/graphExecutionRunLogContract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,0FAA0F;AAC1F,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CAC9E,CAAC"}

package/dist/observability/graphExecutionRunLogContract.js

@@ -0,0 +1,11 @@
+/**
+ * Contract hints for `@woroces/worox-graph` (implemented in that package, not here).
+ *
+ * Graph HTTP responses should expose at least one of:
+ * - `debugTrace: import("@exellix/ai-tasks").DebugTraceTask[]` — authoritative ordered execution trace (ai-tasks trace mode)
+ * - `executionTrace` — narrowed `{ nodes: Record<string, unknown> }` (or full `execution` with `_trace`)
+ *
+ * Prefer `executionMode: "trace"` on `runTask()` when a full diagnostic trace is needed.
+ */
+export {};
+//# sourceMappingURL=graphExecutionRunLogContract.js.map

package/dist/observability/graphExecutionRunLogContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphExecutionRunLogContract.js","sourceRoot":"","sources":["../../src/observability/graphExecutionRunLogContract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/packaged-tasks-client.d.ts

@@ -0,0 +1,66 @@
+import { ExellixSkillsClient } from "@exellix/ai-skills";
+import type { ExellixSkillsClientOptions } from "@exellix/ai-skills";
+import type { RunTaskResponse } from "./types/index.js";
+import { WorexClientTasks } from "./core/task-sdk.js";
+/**
+ * Options for {@link createDefaultWorexClientTasks}. Extends {@link ExellixSkillsClientOptions}
+ * (which requires a {@link ExellixSkillsClientOptions.catalox Catalox} client for the `ai-skills` catalog).
+ *
+ * When `catalox` is omitted, {@link createCataloxFromEnv} is used (Catalox v4 / Firebase Admin env:
+ * `FIREBASE_PROJECT_ID`, `GOOGLE_SERVICE_ACCOUNT_BASE64`, optional `FIRESTORE_DATABASE_ID`; see `@exellix/ai-skills` README).
+ *
+ * @deprecated `mongoUri` / `mongoDb` are ignored (Xillix Mongo catalog was removed upstream in `@exellix/ai-skills` 4.1+).
+ */
+export type CreateDefaultWorexClientTasksOptions = ExellixSkillsClientOptions & {
+    mongoUri?: string;
+    mongoDb?: string;
+};
+/**
+ * Absolute path to the `.metadata` directory shipped with the installed `@exellix/ai-tasks` package.
+ */
+export declare function getPackagedAiTasksMetadataDir(): string;
+/**
+ * Previously selected **gateway** vs **xillix** template source. Upstream now always resolves skill bodies from **Catalox**
+ * (`ai-skills`); this always returns `"gateway"` for backward compatibility with callers that branch on the string.
+ */
+export declare function resolvePackagedSkillContentSource(_options?: CreateDefaultWorexClientTasksOptions): "gateway";
+/**
+ * Default {@link WorexClientTasks} for running skills with `@exellix/ai-skills` **5.x** (Catalox **v4**):
+ * **Catalox**-backed templates (`ai-skills`) plus gateway execution.
+ *
+ * Constructs {@link ExellixSkillsClient} and its executor internally. Embedders may depend only on `@exellix/ai-tasks`.
+ */
+export declare function createDefaultWorexClientTasks(options?: CreateDefaultWorexClientTasksOptions): Promise<PackagedWorexClientTasks>;
+export type PackagedWorexClientTasksLifecycle = {
+    skillContentSource?: "gateway";
+};
+/**
+ * {@link WorexClientTasks} plus lifecycle helpers for the packaged-skills setup.
+ */
+export declare class PackagedWorexClientTasks extends WorexClientTasks {
+    private readonly skillContentSource;
+    constructor(skillsClient: ExellixSkillsClient, executor: {
+        execute(input: any, onNotFound: (key: string) => Promise<void>): Promise<RunTaskResponse<unknown>>;
+    }, lifecycle?: PackagedWorexClientTasksLifecycle);
+    /** Underlying skills client (gateway, registry, shutdown). */
+    getSkillsClient(): ExellixSkillsClient;
+    /**
+     * @deprecated Mongo-backed Xillix catalog was removed in `@exellix/ai-skills` 4.1+. Always `undefined`.
+     */
+    getSkillCatalog(): undefined;
+    /**
+     * Resolves when skill content is reachable (gateway / registry checks).
+     */
+    warmup(opts?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    /** Alias for {@link warmup}. */
+    whenReady(opts?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    /** @inheritdoc */
+    dispose(): Promise<void>;
+    /** Alias for {@link dispose}. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=packaged-tasks-client.d.ts.map

package/dist/packaged-tasks-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packaged-tasks-client.d.ts","sourceRoot":"","sources":["../src/packaged-tasks-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAwB,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,oCAAoC,GAAG,0BAA0B,GAAG;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,CAAC,EAAE,oCAAoC,GAAG,SAAS,CAE5G;AAcD;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,CAAC,EAAE,oCAAoC,GAC7C,OAAO,CAAC,wBAAwB,CAAC,CAgBnC;AAED,MAAM,MAAM,iCAAiC,GAAG;IAC9C,kBAAkB,CAAC,EAAE,SAAS,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAY;gBAG7C,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE;QACR,OAAO,CACL,KAAK,EAAE,GAAG,EACV,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACzC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;KACtC,EACD,SAAS,CAAC,EAAE,iCAAiC;IAO/C,8DAA8D;IAC9D,eAAe,IAAI,mBAAmB;IAItC;;OAEG;IACH,eAAe,IAAI,SAAS;IAI5B;;OAEG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB1D,gCAAgC;IAChC,SAAS,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,kBAAkB;IACZ,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,iCAAiC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/packaged-tasks-client.js

@@ -0,0 +1,100 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ExellixSkillsClient, createCataloxFromEnv } from "@exellix/ai-skills";
+import { WorexClientTasks } from "./core/task-sdk.js";
+/**
+ * Absolute path to the `.metadata` directory shipped with the installed `@exellix/ai-tasks` package.
+ */
+export function getPackagedAiTasksMetadataDir() {
+    const here = fileURLToPath(import.meta.url);
+    return join(dirname(here), "..", ".metadata");
+}
+/**
+ * Previously selected **gateway** vs **xillix** template source. Upstream now always resolves skill bodies from **Catalox**
+ * (`ai-skills`); this always returns `"gateway"` for backward compatibility with callers that branch on the string.
+ */
+export function resolvePackagedSkillContentSource(_options) {
+    return "gateway";
+}
+function stripLegacyOptions(options) {
+    const catalox = options?.catalox ?? createCataloxFromEnv();
+    const bindingDefaults = {
+        bindingDefaultsDb: options?.bindingDefaultsDb ?? process.env.MONGO_LOGS_DB ?? "logs-db",
+    };
+    if (!options) {
+        return { catalox, ...bindingDefaults };
+    }
+    const { mongoUri: _m, mongoDb: _d, ...rest } = options;
+    return { ...rest, catalox, ...bindingDefaults };
+}
+/**
+ * Default {@link WorexClientTasks} for running skills with `@exellix/ai-skills` **5.x** (Catalox **v4**):
+ * **Catalox**-backed templates (`ai-skills`) plus gateway execution.
+ *
+ * Constructs {@link ExellixSkillsClient} and its executor internally. Embedders may depend only on `@exellix/ai-tasks`.
+ */
+export async function createDefaultWorexClientTasks(options) {
+    const skillsOpts = stripLegacyOptions(options);
+    const skillsClient = new ExellixSkillsClient(skillsOpts);
+    const executor = skillsClient.getExecutor();
+    return new PackagedWorexClientTasks(skillsClient, {
+        async execute(input, onNotFound) {
+            return executor.execute(input, onNotFound);
+        },
+    }, {
+        skillContentSource: "gateway",
+    });
+}
+/**
+ * {@link WorexClientTasks} plus lifecycle helpers for the packaged-skills setup.
+ */
+export class PackagedWorexClientTasks extends WorexClientTasks {
+    skillContentSource;
+    constructor(skillsClient, executor, lifecycle) {
+        // Align with WorexClientTasks generic executor typing (SkillExecutor.execute is generic).
+        super(skillsClient, executor);
+        this.skillContentSource = lifecycle?.skillContentSource ?? "gateway";
+    }
+    /** Underlying skills client (gateway, registry, shutdown). */
+    getSkillsClient() {
+        return this.skillsClient;
+    }
+    /**
+     * @deprecated Mongo-backed Xillix catalog was removed in `@exellix/ai-skills` 4.1+. Always `undefined`.
+     */
+    getSkillCatalog() {
+        return undefined;
+    }
+    /**
+     * Resolves when skill content is reachable (gateway / registry checks).
+     */
+    async warmup(opts) {
+        const timeoutMs = opts?.timeoutMs ?? 60_000;
+        const deadline = Date.now() + timeoutMs;
+        let lastErr;
+        while (Date.now() < deadline) {
+            try {
+                await this.skillsClient.testContentRegistryConnection();
+                return;
+            }
+            catch (e) {
+                lastErr = e;
+                await new Promise((r) => setTimeout(r, 100));
+            }
+        }
+        throw new Error(`PackagedWorexClientTasks.warmup timed out after ${timeoutMs}ms: ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`);
+    }
+    /** Alias for {@link warmup}. */
+    whenReady(opts) {
+        return this.warmup(opts);
+    }
+    /** @inheritdoc */
+    async dispose() {
+        await this.skillsClient.shutdown();
+    }
+    /** Alias for {@link dispose}. */
+    async close() {
+        return this.dispose();
+    }
+}
+//# sourceMappingURL=packaged-tasks-client.js.map

package/dist/packaged-tasks-client.js.map

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