@exellix/ai-tasks 7.8.0

package/dist/strategies/direct-execution-strategy.js

@@ -0,0 +1,107 @@
+import { SkillExecutionTraceError } from "@exellix/ai-skills";
+import { ExecutionType } from "../types/executionType.js";
+import { LlmCallContextError } from "../types/llmCall.js";
+import { pickRunSkillRequestFields } from "../utils/bridgeRunSkillGatewayMemory.js";
+/**
+ * Direct execution strategy.
+ *
+ * Executes tasks by directly passing through to the skill executor.
+ * This is the simplest and most common execution strategy.
+ *
+ * The client's runSkill method handles:
+ * 1. Skill execution via the AI Gateway
+ * 2. FlexMD response parsing
+ * 3. Returns structured response with payloads
+ *
+ * Trace mode integration (when `executionMode === "trace"` is forwarded by the caller):
+ *   - Forwards `executionMode: "trace"` and `diagnostics: { includeRawProviderPayload }` to `runSkill`.
+ *   - Catches and re-throws upstream `SkillExecutionTraceError` unchanged (already carries
+ *     `RunSkillDiagnostics` with full trace + invokeRequest echo).
+ *   - For default-mode raw errors (untyped), wraps with `LlmCallContextError` carrying a
+ *     `LlmCallObservation` snapshot of `modelConfig` so callers can read the request context.
+ */
+export class DirectExecutionStrategy {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async execute(request) {
+        const taskRequest = { ...request };
+        // Convert RunTaskRequest to RunSkillRequest. Map coreSkillId back to skillId for RunSkillRequest compatibility.
+        // modelConfig is automatically included via spread operator since it's part of RunSkillRequest
+        const { llmCall } = taskRequest;
+        const coreSkillId = taskRequest.coreSkillId;
+        const traceMode = taskRequest.executionMode === "trace";
+        const skillBase = pickRunSkillRequestFields(taskRequest);
+        // Compose the effective modelConfig sent downstream: `modelConfig` is the base, and matching
+        // `llmCall.*` fields win. Unknown `modelConfig` extras are preserved.
+        const baseModelConfig = skillBase.modelConfig ?? undefined;
+        const overlayedModelConfig = llmCall || baseModelConfig
+            ? {
+                ...(baseModelConfig ?? {}),
+                ...(llmCall?.model !== undefined ? { model: llmCall.model } : {}),
+                ...(llmCall?.temperature !== undefined ? { temperature: llmCall.temperature } : {}),
+                ...(llmCall?.topP !== undefined ? { topP: llmCall.topP } : {}),
+                ...(llmCall?.maxTokensCap !== undefined ? { maxTokens: llmCall.maxTokensCap } : {}),
+            }
+            : undefined;
+        const effectiveTimeoutMs = llmCall?.timeoutMs ?? skillBase.timeoutMs;
+        const runSkillRequest = {
+            ...skillBase,
+            executionType: ExecutionType.DIRECT,
+            ...(overlayedModelConfig ? { modelConfig: overlayedModelConfig } : {}),
+            ...(effectiveTimeoutMs !== undefined ? { timeoutMs: effectiveTimeoutMs } : {}),
+            ...(coreSkillId && { skillId: coreSkillId }),
+            // Forward trace mode + diagnostics opt-in. ai-skills 5.0.1+ honors `executionMode: "trace"`
+            // and returns `result.diagnostics` / `result.debugTrace` (and throws `SkillExecutionTraceError`
+            // on failure with full diagnostics).
+            ...(traceMode
+                ? {
+                    executionMode: "trace",
+                    diagnostics: { includeDebugTrace: true },
+                }
+                : {}),
+        };
+        const startMs = Date.now();
+        try {
+            return await this.client.runSkill(runSkillRequest);
+        }
+        catch (error) {
+            // Trace-mode typed error: pass through unchanged. Carries `RunSkillDiagnostics` with `trace.invokeRequest`
+            // (modelConfig + timeoutMs echo), `usage`, `routing`, `costUsd`, `attempts[]`.
+            if (error instanceof SkillExecutionTraceError) {
+                throw error;
+            }
+            // Default-mode raw error: wrap with LlmCallContextError so callers see what was sent. Track C feature
+            // request asks ai-skills to throw a typed `SkillExecutionError` even outside trace mode; until then this
+            // is the best we can do client-side.
+            const observation = {
+                source: "ai-skills",
+                stage: "main-skill",
+                request: {
+                    model: runSkillRequest.modelConfig?.model,
+                    maxTokensCap: runSkillRequest.modelConfig?.maxTokens,
+                    temperature: runSkillRequest.modelConfig?.temperature,
+                    topP: runSkillRequest.modelConfig?.topP,
+                    timeoutMs: runSkillRequest.timeoutMs,
+                    outputExpectation: llmCall?.outputExpectation,
+                    maxOutputLength: llmCall?.maxOutputLength,
+                },
+                durationMs: Date.now() - startMs,
+                ok: false,
+                error: {
+                    name: error instanceof Error ? error.name : "Error",
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            };
+            throw new LlmCallContextError(error instanceof Error ? error.message : String(error), observation, error);
+        }
+    }
+    getType() {
+        return ExecutionType.DIRECT;
+    }
+    canHandle(request) {
+        return Array.isArray(request.executionStrategies);
+    }
+}
+//# sourceMappingURL=direct-execution-strategy.js.map

package/dist/strategies/direct-execution-strategy.js.map

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

package/dist/strategies/execution-strategy.interface.d.ts

@@ -0,0 +1,31 @@
+import type { RunTaskRequest, RunSkillResponse } from "../types/index.js";
+/**
+ * Base interface for execution strategies.
+ *
+ * Each strategy defines how a task should be executed.
+ * This allows for extensibility as new execution types are added
+ * (e.g., MULTI_STEP, PARALLEL, CONDITIONAL, etc.).
+ */
+export interface IExecutionStrategy {
+    /**
+     * Execute a task using this strategy.
+     *
+     * @param request The task request
+     * @returns Promise resolving to the execution result
+     */
+    execute<TParsed = any>(request: RunTaskRequest): Promise<RunSkillResponse<TParsed>>;
+    /**
+     * Get the strategy name/type.
+     *
+     * @returns The execution type this strategy handles
+     */
+    getType(): string;
+    /**
+     * Check if this strategy can handle the given request.
+     *
+     * @param request The task request to check
+     * @returns True if this strategy can handle the request
+     */
+    canHandle(request: RunTaskRequest): boolean;
+}
+//# sourceMappingURL=execution-strategy.interface.d.ts.map

package/dist/strategies/execution-strategy.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-strategy.interface.d.ts","sourceRoot":"","sources":["../../src/strategies/execution-strategy.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,GAAG,GAAG,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtC;;;;OAIG;IACH,OAAO,IAAI,MAAM,CAAC;IAElB;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;CAC7C"}

package/dist/strategies/execution-strategy.interface.js

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

package/dist/strategies/execution-strategy.interface.js.map

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

package/dist/strategies/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Execution strategies module
+ *
+ * Exports all execution strategy-related classes and interfaces.
+ */
+export type { IExecutionStrategy } from "./execution-strategy.interface.js";
+export { DirectExecutionStrategy } from "./direct-execution-strategy.js";
+export { ExecutionStrategyFactory } from "./strategy-factory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/strategies/index.js

@@ -0,0 +1,8 @@
+/**
+ * Execution strategies module
+ *
+ * Exports all execution strategy-related classes and interfaces.
+ */
+export { DirectExecutionStrategy } from "./direct-execution-strategy.js";
+export { ExecutionStrategyFactory } from "./strategy-factory.js";
+//# sourceMappingURL=index.js.map

package/dist/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/strategies/strategy-factory.d.ts

@@ -0,0 +1,45 @@
+import { ExellixSkillsClient } from "@exellix/ai-skills";
+type WorexClientSkills = ExellixSkillsClient;
+import type { RunTaskRequest } from "../types/index.js";
+import type { IExecutionStrategy } from "./execution-strategy.interface.js";
+/**
+ * Factory for creating and managing execution strategies.
+ *
+ * Responsible for:
+ * - Registering available strategies
+ * - Selecting the appropriate strategy for a task
+ * - Providing extensibility for future strategy types
+ *
+ * This factory pattern allows easy addition of new execution strategies
+ * (e.g., MULTI_STEP, PARALLEL, CONDITIONAL) without modifying core SDK code.
+ */
+export declare class ExecutionStrategyFactory {
+    private strategies;
+    private defaultStrategy;
+    private client;
+    constructor(client: ExellixSkillsClient | WorexClientSkills);
+    /**
+     * Register a new execution strategy.
+     *
+     * This allows extending the SDK with custom execution strategies.
+     *
+     * @param strategy The strategy to register
+     */
+    registerStrategy(strategy: IExecutionStrategy): void;
+    /**
+     * Get the appropriate strategy for a task request.
+     *
+     * @param request The task request
+     * @returns The execution strategy to use
+     */
+    getStrategy(request: RunTaskRequest): IExecutionStrategy;
+    /**
+     * Get a strategy by its type.
+     *
+     * @param executionType The execution type
+     * @returns The strategy for the given type, or default if not found
+     */
+    getStrategyByType(executionType: string): IExecutionStrategy;
+}
+export {};
+//# sourceMappingURL=strategy-factory.d.ts.map

package/dist/strategies/strategy-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-factory.d.ts","sourceRoot":"","sources":["../../src/strategies/strategy-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIzD,KAAK,iBAAiB,GAAG,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAG5E;;;;;;;;;;GAUG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB,GAAG,iBAAiB;IAQ3D;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIpD;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB;IASxD;;;;;OAKG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB;CAG7D"}

package/dist/strategies/strategy-factory.js

@@ -0,0 +1,59 @@
+import { ExecutionType } from "../types/executionType.js";
+import { DirectExecutionStrategy } from "./direct-execution-strategy.js";
+/**
+ * Factory for creating and managing execution strategies.
+ *
+ * Responsible for:
+ * - Registering available strategies
+ * - Selecting the appropriate strategy for a task
+ * - Providing extensibility for future strategy types
+ *
+ * This factory pattern allows easy addition of new execution strategies
+ * (e.g., MULTI_STEP, PARALLEL, CONDITIONAL) without modifying core SDK code.
+ */
+export class ExecutionStrategyFactory {
+    strategies = new Map();
+    defaultStrategy;
+    client;
+    constructor(client) {
+        this.client = client;
+        // Register default DIRECT strategy
+        const directStrategy = new DirectExecutionStrategy(client);
+        this.defaultStrategy = directStrategy;
+        this.strategies.set(ExecutionType.DIRECT, directStrategy);
+    }
+    /**
+     * Register a new execution strategy.
+     *
+     * This allows extending the SDK with custom execution strategies.
+     *
+     * @param strategy The strategy to register
+     */
+    registerStrategy(strategy) {
+        this.strategies.set(strategy.getType(), strategy);
+    }
+    /**
+     * Get the appropriate strategy for a task request.
+     *
+     * @param request The task request
+     * @returns The execution strategy to use
+     */
+    getStrategy(request) {
+        for (const strategy of this.strategies.values()) {
+            if (strategy.canHandle(request)) {
+                return strategy;
+            }
+        }
+        return this.defaultStrategy;
+    }
+    /**
+     * Get a strategy by its type.
+     *
+     * @param executionType The execution type
+     * @returns The strategy for the given type, or default if not found
+     */
+    getStrategyByType(executionType) {
+        return this.strategies.get(executionType) || this.defaultStrategy;
+    }
+}
+//# sourceMappingURL=strategy-factory.js.map

package/dist/strategies/strategy-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-factory.js","sourceRoot":"","sources":["../../src/strategies/strategy-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,wBAAwB;IAC3B,UAAU,GAAoC,IAAI,GAAG,EAAE,CAAC;IACxD,eAAe,CAAqB;IACpC,MAAM,CAAsB;IAEpC,YAAY,MAA+C;QACzD,IAAI,CAAC,MAAM,GAAG,MAA6B,CAAC;QAC5C,mCAAmC;QACnC,MAAM,cAAc,GAAG,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,QAA4B;QAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,OAAuB;QACjC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,IAAI,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,aAAqB;QACrC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC;IACpE,CAAC;CACF"}

package/dist/synthesis/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Synthesis: `@exellix/xynthesis` for prompts, structured parsing, and LLM invocation;
+ * `resolveSourceMaterial*` stays here (Narrix + web + memory wiring).
+ */
+export * from "@exellix/xynthesis";
+export { resolveSourceMaterial, resolveSourceMaterialParts } from "./resolveSourceMaterial.js";
+export type { ContextSourcePolicy, ResolveSourceMaterialInput, SourceMaterialParts, } from "./resolveSourceMaterial.js";
+export { runStructuredSynthesisGatewayCallRobust } from "./runStructuredSynthesisRobust.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/synthesis/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC/F,YAAY,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,uCAAuC,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/synthesis/index.js

@@ -0,0 +1,8 @@
+/**
+ * Synthesis: `@exellix/xynthesis` for prompts, structured parsing, and LLM invocation;
+ * `resolveSourceMaterial*` stays here (Narrix + web + memory wiring).
+ */
+export * from "@exellix/xynthesis";
+export { resolveSourceMaterial, resolveSourceMaterialParts } from "./resolveSourceMaterial.js";
+export { runStructuredSynthesisGatewayCallRobust } from "./runStructuredSynthesisRobust.js";
+//# sourceMappingURL=index.js.map

package/dist/synthesis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/synthesis/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAO/F,OAAO,EAAE,uCAAuC,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/synthesis/resolveSourceMaterial.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Resolve source material for synthesis from contextSourcePolicy, narrix attachment, and memory.
+ */
+import { type BuildWebContextEvidenceMarkdownOptions } from "../narrix/webContextMarkdown.js";
+import type { NarrixEnrichedAttachment } from "../narrix/types.js";
+import type { ContextSourcePolicy } from "../types/task-types.js";
+export type { ContextSourcePolicy } from "../types/task-types.js";
+export type ResolveSourceMaterialInput = {
+    contextSourcePolicy: ContextSourcePolicy;
+    narrixAttachment: NarrixEnrichedAttachment | null;
+    enrichedMemoryBundle: {
+        jobMemory?: Record<string, unknown>;
+        taskMemory?: Record<string, unknown>;
+        executionMemory?: Record<string, unknown>;
+    };
+    memoryPaths?: string[];
+    /** Options passed to buildWebContextEvidenceMarkdown (synthesis path defaults: clean-first, dedupe, cap sources). */
+    webEvidence?: BuildWebContextEvidenceMarkdownOptions;
+    /** executionMemory field for Narrix attachment; default `_narrix`. Used to strip Narrix for `memory-web`. */
+    narrixAttachToField?: string;
+};
+/** Semantic split for structured synthesis: task/runtime vs web/external (order may differ from combined `resolveSourceMaterial` string). */
+export type SourceMaterialParts = {
+    localMarkdown: string;
+    supportingMarkdown: string;
+};
+/**
+ * Same policy as `resolveSourceMaterial`, but splits **local** (Narrix + memory JSON) from **supporting** (web markdown).
+ */
+export declare function resolveSourceMaterialParts(input: ResolveSourceMaterialInput): SourceMaterialParts;
+/**
+ * Resolve and serialize source material for the synthesis prompt based on policy and available data.
+ */
+export declare function resolveSourceMaterial(input: ResolveSourceMaterialInput): string;
+//# sourceMappingURL=resolveSourceMaterial.d.ts.map

package/dist/synthesis/resolveSourceMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSourceMaterial.d.ts","sourceRoot":"","sources":["../../src/synthesis/resolveSourceMaterial.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAIL,KAAK,sCAAsC,EAC5C,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAyBlE,MAAM,MAAM,0BAA0B,GAAG;IACvC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,gBAAgB,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAClD,oBAAoB,EAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC3C,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qHAAqH;IACrH,WAAW,CAAC,EAAE,sCAAsC,CAAC;IACrD,6GAA6G;IAC7G,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,6IAA6I;AAC7I,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAiDF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,0BAA0B,GAAG,mBAAmB,CAuDjG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CA8D/E"}

package/dist/synthesis/resolveSourceMaterial.js

@@ -0,0 +1,152 @@
+/**
+ * Resolve source material for synthesis from contextSourcePolicy, narrix attachment, and memory.
+ */
+import { getByPath } from "../utils/jsonPaths.js";
+import { buildNarrixPreProcessorContextMarkdown } from "../narrix/narrixContextMarkdown.js";
+import { buildWebContextEvidenceMarkdown, omitNarrixFromMemoryBundle, omitWebContextFromMemoryBundle, } from "../narrix/webContextMarkdown.js";
+function normalizePolicyAlias(policy) {
+    if (policy === "narrix-only")
+        return "narrix-web";
+    if (policy === "narrix+memory")
+        return "narrix-web-memory";
+    return policy;
+}
+/**
+ * Default `contextSourcePolicy: "auto"` always uses the full combined layout (D6): memory JSON
+ * (web omitted from JSON — surfaced as web markdown) plus optional Narrix and web sections.
+ * Explicit `memory-web` / `memory-only` remain for advanced callers that want narrowing.
+ */
+function resolveAutoPolicy(_hasNarrix, _webContext) {
+    return "narrix-web-memory";
+}
+/**
+ * Serialize memory (or a subset by paths) to a deterministic string.
+ * Never embeds raw `executionMemory.webContext` (use web markdown when web is part of the policy).
+ */
+function serializeMemory(bundle, memoryPaths) {
+    const withoutWeb = omitWebContextFromMemoryBundle(bundle);
+    let obj;
+    if (memoryPaths && memoryPaths.length > 0) {
+        obj = {};
+        const full = {
+            jobMemory: withoutWeb.jobMemory ?? {},
+            taskMemory: withoutWeb.taskMemory ?? {},
+            executionMemory: withoutWeb.executionMemory ?? {},
+        };
+        for (const path of memoryPaths) {
+            const value = getByPath(full, path);
+            if (value !== undefined) {
+                const parts = path.split(".");
+                let cur = obj;
+                for (let i = 0; i < parts.length - 1; i++) {
+                    const p = parts[i];
+                    if (!(p in cur) || typeof cur[p] !== "object")
+                        cur[p] = {};
+                    cur = cur[p];
+                }
+                cur[parts[parts.length - 1]] = value;
+            }
+        }
+    }
+    else {
+        obj = {
+            jobMemory: withoutWeb.jobMemory ?? {},
+            taskMemory: withoutWeb.taskMemory ?? {},
+            executionMemory: withoutWeb.executionMemory ?? {},
+        };
+    }
+    return JSON.stringify(obj, null, 2);
+}
+function buildWebMd(webContext, webEvidence) {
+    return buildWebContextEvidenceMarkdown(webContext, webEvidence);
+}
+/**
+ * Same policy as `resolveSourceMaterial`, but splits **local** (Narrix + memory JSON) from **supporting** (web markdown).
+ */
+export function resolveSourceMaterialParts(input) {
+    const { contextSourcePolicy, narrixAttachment, enrichedMemoryBundle, memoryPaths, webEvidence, narrixAttachToField = "_narrix", } = input;
+    const hasNarrix = !!narrixAttachment &&
+        typeof narrixAttachment === "object" &&
+        "scoping" in narrixAttachment &&
+        "discovery" in narrixAttachment;
+    const normalized = normalizePolicyAlias(contextSourcePolicy ?? "auto");
+    const webCtx = enrichedMemoryBundle.executionMemory?.webContext;
+    const effective = normalized === "auto" ? resolveAutoPolicy(hasNarrix, webCtx) : normalized;
+    const webMd = buildWebMd(webCtx, webEvidence);
+    if (effective === "narrix-web") {
+        if (!hasNarrix) {
+            throw new Error("contextSourcePolicy requires Narrix output but no narrix attachment is available (run narrix pre-processor or use narrix-then-direct, or use memory-web / memory-only).");
+        }
+        const narrixMd = buildNarrixPreProcessorContextMarkdown(narrixAttachment);
+        return { localMarkdown: narrixMd, supportingMarkdown: webMd };
+    }
+    if (effective === "memory-only") {
+        const memoryText = serializeMemory(enrichedMemoryBundle, memoryPaths);
+        return { localMarkdown: memoryText, supportingMarkdown: "" };
+    }
+    if (effective === "memory-web") {
+        const bundleNoNarrix = omitNarrixFromMemoryBundle(enrichedMemoryBundle, narrixAttachToField);
+        const memoryText = serializeMemory(bundleNoNarrix, memoryPaths);
+        const localMarkdown = `## Memory\n\n${memoryText}`;
+        return { localMarkdown, supportingMarkdown: webMd };
+    }
+    const narrixSection = hasNarrix ? buildNarrixPreProcessorContextMarkdown(narrixAttachment) : "";
+    const memoryText = serializeMemory(enrichedMemoryBundle, memoryPaths);
+    let localMarkdown = "";
+    if (narrixSection) {
+        localMarkdown = `## Narrix\n\n${narrixSection}\n\n## Memory\n\n${memoryText}`;
+    }
+    else {
+        localMarkdown = `## Memory\n\n${memoryText}`;
+    }
+    return { localMarkdown, supportingMarkdown: webMd };
+}
+/**
+ * Resolve and serialize source material for the synthesis prompt based on policy and available data.
+ */
+export function resolveSourceMaterial(input) {
+    const { contextSourcePolicy, narrixAttachment, enrichedMemoryBundle, memoryPaths, webEvidence, narrixAttachToField = "_narrix", } = input;
+    const hasNarrix = !!narrixAttachment &&
+        typeof narrixAttachment === "object" &&
+        "scoping" in narrixAttachment &&
+        "discovery" in narrixAttachment;
+    const normalized = normalizePolicyAlias(contextSourcePolicy ?? "auto");
+    const webCtx = enrichedMemoryBundle.executionMemory?.webContext;
+    const effective = normalized === "auto" ? resolveAutoPolicy(hasNarrix, webCtx) : normalized;
+    if (effective === "narrix-web") {
+        if (!hasNarrix) {
+            throw new Error("contextSourcePolicy requires Narrix output but no narrix attachment is available (run narrix pre-processor or use narrix-then-direct, or use memory-web / memory-only).");
+        }
+        const narrixMd = buildNarrixPreProcessorContextMarkdown(narrixAttachment);
+        const webMd = buildWebMd(webCtx, webEvidence);
+        return narrixMd + webMd;
+    }
+    if (effective === "memory-only") {
+        return serializeMemory(enrichedMemoryBundle, memoryPaths);
+    }
+    if (effective === "memory-web") {
+        const webMd = buildWebMd(webCtx, webEvidence);
+        const bundleNoNarrix = omitNarrixFromMemoryBundle(enrichedMemoryBundle, narrixAttachToField);
+        const memoryText = serializeMemory(bundleNoNarrix, memoryPaths);
+        if (webMd) {
+            return `${webMd}\n\n## Memory\n\n${memoryText}`;
+        }
+        return memoryText;
+    }
+    // narrix-web-memory
+    const narrixSection = hasNarrix ? buildNarrixPreProcessorContextMarkdown(narrixAttachment) : "";
+    const webMd = buildWebMd(webCtx, webEvidence);
+    const memoryText = serializeMemory(enrichedMemoryBundle, memoryPaths);
+    let head = "";
+    if (narrixSection) {
+        head = `## Narrix\n\n${narrixSection}`;
+    }
+    if (webMd) {
+        head += (head ? "\n\n" : "") + webMd;
+    }
+    if (head) {
+        return `${head}\n\n## Memory\n\n${memoryText}`;
+    }
+    return memoryText;
+}
+//# sourceMappingURL=resolveSourceMaterial.js.map

package/dist/synthesis/resolveSourceMaterial.js.map

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

package/dist/synthesis/runStructuredSynthesisRobust.d.ts

@@ -0,0 +1,42 @@
+import type { SynthesizedPromptPayload } from "@exellix/xynthesis/ai-actions";
+type InvokeText = (req: {
+    systemPrompt: string;
+    userPrompt: string;
+    model?: string;
+    timeoutMs?: number;
+    maxOutputLength?: number;
+    maxTokens?: number;
+    jobId?: string;
+    agentId?: string;
+}) => Promise<string>;
+export type RunStructuredSynthesisRobustParams = any & {
+    /** Default 1. */
+    repairMaxRetries?: number;
+    /** Default true. */
+    enableRepair?: boolean;
+    /** Default 4000. */
+    diagnosticsMaxChars?: number;
+    /** For tests; production uses ai-gateway directly. */
+    invokeTextOverride?: InvokeText;
+    /**
+     * Test hook: when provided, the function will throw this error instead of executing the initial
+     * `runStructuredSynthesisGatewayCall` path. This allows deterministic tests without network calls.
+     */
+    forceFirstPathError?: unknown;
+};
+/**
+ * Robust structured synthesis:
+ * - First try the normal xynthesis gateway path (may use a strict invoker / JSON mode).
+ * - If response normalization fails, fall back to a plain-text ai-gateway call + JSON parse/validate.
+ * - Optionally retry once with a minimal "JSON only" hardening if parsing fails.
+ *
+ * Errors thrown from this function are wrapped with `LlmCallContextError` carrying
+ * `stage: "structured-repair"`, attempt index, and the existing diagnostics text. Upstream typed
+ * errors (`XynthesisInvokeError`, `XynthesisResponseParseError`) from the first path are passed
+ * through unchanged so callers can inspect their `invokeSummary`.
+ *
+ * This prevents flaky failures when providers/models return prose around JSON.
+ */
+export declare function runStructuredSynthesisGatewayCallRobust(params: RunStructuredSynthesisRobustParams): Promise<SynthesizedPromptPayload>;
+export {};
+//# sourceMappingURL=runStructuredSynthesisRobust.d.ts.map

package/dist/synthesis/runStructuredSynthesisRobust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runStructuredSynthesisRobust.d.ts","sourceRoot":"","sources":["../../src/synthesis/runStructuredSynthesisRobust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAgBjG,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAkJtB,MAAM,MAAM,kCAAkC,GAAG,GAAG,GAAG;IACrD,iBAAiB;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAsB,uCAAuC,CAC3D,MAAM,EAAE,kCAAkC,GACzC,OAAO,CAAC,wBAAwB,CAAC,CAmLnC"}