@exellix/ai-tasks 7.8.0

package/dist/builders/task-request-builder.js

@@ -0,0 +1,581 @@
+import { SYNTHESIZED_CONTEXT } from "../types/index.js";
+/**
+ * Builder for constructing task requests.
+ *
+ * Provides a fluent API for building task requests with proper defaults
+ * and validation. This makes it easier to construct complex requests
+ * and ensures consistency across the SDK.
+ */
+export class TaskRequestBuilder {
+    request;
+    constructor() {
+        this.request = {};
+    }
+    /**
+     * Set the skill key to execute.
+     *
+     * @param skillKey The skill key (e.g., "skills/professional-answer")
+     * @returns The builder instance for chaining
+     */
+    withSkillKey(skillKey) {
+        this.request.skillKey = skillKey;
+        return this;
+    }
+    /**
+     * Required `@exellix/ai-skills` correlation ids (agent, job type, task type). Must be set before `build()`.
+     */
+    withAiSkillsCorrelation(agentId, jobTypeId, taskTypeId) {
+        this.request.agentId = agentId;
+        this.request.jobTypeId = jobTypeId;
+        this.request.taskTypeId = taskTypeId;
+        return this;
+    }
+    /**
+     * Set the input data.
+     *
+     * @param input The input data (object or string)
+     * @returns The builder instance for chaining
+     */
+    withInput(input) {
+        this.request.input = input;
+        return this;
+    }
+    /**
+     * Set AI scoping instructions (optional). When present, internal AI calls scope memory content into input.aiScoped before the main task runs.
+     *
+     * @param instructions Array of { source, instructions, targetToken }
+     * @returns The builder instance for chaining
+     */
+    withAiScoping(instructions) {
+        this.request.aiScoping = instructions;
+        return this;
+    }
+    /**
+     * Set the execution pipeline (pre → main → post steps).
+     *
+     * @param steps Array of { phase, type, config? }
+     * @returns The builder instance for chaining
+     */
+    withExecutionPipeline(steps) {
+        this.request.executionPipeline = steps;
+        return this;
+    }
+    /**
+     * MAIN wrappers (`RunTaskRequest.executionStrategies`): required at runtime; defaults to `[]` in `build()` when unset.
+     */
+    withExecutionStrategies(executionStrategies) {
+        this.request.executionStrategies = executionStrategies;
+        return this;
+    }
+    /**
+     * Add a synthesized-context PRE step before the main task. A weak model synthesizes context from narrix/memory;
+     * the main task then runs with that as context. Sets includeContextInPrompt to true.
+     * If no pipeline is set yet, defaults to [main: direct] and inserts this pre step.
+     *
+     * @param modelOrConfig Optional model name (e.g. "gpt-5-nano") or full SynthesisConfig
+     * @returns The builder instance for chaining
+     */
+    withSynthesizedContextPreStep(modelOrConfig) {
+        this.request.includeContextInPrompt = true;
+        const config = typeof modelOrConfig === "string"
+            ? { modelConfig: { model: modelOrConfig } }
+            : modelOrConfig ?? {};
+        const preStep = {
+            phase: "pre",
+            type: SYNTHESIZED_CONTEXT,
+            config,
+        };
+        const existing = this.request.executionPipeline;
+        if (existing && Array.isArray(existing) && existing.length > 0) {
+            const mainIdx = existing.findIndex((s) => s.phase === "main");
+            if (mainIdx >= 0) {
+                const before = existing.slice(0, mainIdx);
+                const after = existing.slice(mainIdx);
+                this.request.executionPipeline = [...before, preStep, ...after];
+            }
+            else {
+                this.request.executionPipeline = [preStep, { phase: "main", type: "direct" }];
+            }
+        }
+        else {
+            this.request.executionPipeline = [preStep, { phase: "main", type: "direct" }];
+        }
+        return this;
+    }
+    /**
+     * Set synthesis mode on existing synthesized-context PRE step configs.
+     */
+    withSynthesisMode(synthesisMode) {
+        const pipeline = this.request.executionPipeline;
+        if (!pipeline || !Array.isArray(pipeline))
+            return this;
+        this.request.executionPipeline = pipeline.map((step) => {
+            if (step.phase !== "pre" || step.type !== SYNTHESIZED_CONTEXT)
+                return step;
+            return {
+                ...step,
+                config: {
+                    ...(step.config ?? {}),
+                    synthesisMode,
+                },
+            };
+        });
+        return this;
+    }
+    /**
+     * Add an audit POST step. Quality-gate loop with re-runs and optional synthesis.
+     * Ensures executionPipeline exists with a MAIN "direct" step, then appends the audit step.
+     *
+     * @param config AuditConfig (gateway.must, gateway.should, threshold, maxCycles, etc.)
+     * @returns The builder instance for chaining
+     */
+    withAuditPostStep(config) {
+        const postStep = { phase: "post", type: "audit", config };
+        const existing = this.request.executionPipeline;
+        if (existing && Array.isArray(existing) && existing.length > 0) {
+            const hasMain = existing.some((s) => s.phase === "main");
+            if (hasMain) {
+                this.request.executionPipeline = [...existing, postStep];
+            }
+            else {
+                this.request.executionPipeline = [{ phase: "main", type: "direct" }, postStep];
+            }
+        }
+        else {
+            this.request.executionPipeline = [{ phase: "main", type: "direct" }, postStep];
+        }
+        return this;
+    }
+    /**
+     * Add a polish POST step. Refinement pass against a prioritized checklist.
+     * Ensures executionPipeline exists with a MAIN "direct" step, then appends the polish step.
+     *
+     * @param config PolishConfig (checklist, maxPasses, etc.)
+     * @returns The builder instance for chaining
+     */
+    withPolishPostStep(config) {
+        const postStep = { phase: "post", type: "polish", config };
+        const existing = this.request.executionPipeline;
+        if (existing && Array.isArray(existing) && existing.length > 0) {
+            const hasMain = existing.some((s) => s.phase === "main");
+            if (hasMain) {
+                this.request.executionPipeline = [...existing, postStep];
+            }
+            else {
+                this.request.executionPipeline = [{ phase: "main", type: "direct" }, postStep];
+            }
+        }
+        else {
+            this.request.executionPipeline = [{ phase: "main", type: "direct" }, postStep];
+        }
+        return this;
+    }
+    /**
+     * Set contextual variables.
+     *
+     * @param variables The variables object
+     * @returns The builder instance for chaining
+     */
+    withVariables(variables) {
+        this.request.variables = variables;
+        return this;
+    }
+    /**
+     * Set job- or graph-level fields merged into template variables (lowest precedence vs `withVariables` and `input`-derived bindings).
+     */
+    withJobContext(jobContext) {
+        this.request.jobContext = jobContext;
+        return this;
+    }
+    /**
+     * Set context data.
+     *
+     * @param context The context (object or string)
+     * @returns The builder instance for chaining
+     */
+    withContext(context) {
+        this.request.context = context;
+        return this;
+    }
+    /**
+     * Set knowledge data.
+     *
+     * @param knowledge The knowledge object
+     * @returns The builder instance for chaining
+     */
+    withKnowledge(knowledge) {
+        this.request.knowledge = knowledge;
+        return this;
+    }
+    /**
+     * Set job memory.
+     *
+     * @param jobMemory The job memory
+     * @returns The builder instance for chaining
+     */
+    withJobMemory(jobMemory) {
+        this.request.jobMemory = jobMemory;
+        return this;
+    }
+    /**
+     * Set task memory.
+     *
+     * @param taskMemory The task memory
+     * @returns The builder instance for chaining
+     */
+    withTaskMemory(taskMemory) {
+        this.request.taskMemory = taskMemory;
+        return this;
+    }
+    /**
+     * Set execution memory.
+     *
+     * @param executionMemory The execution memory (history of execution context)
+     * @returns The builder instance for chaining
+     */
+    withExecutionMemory(executionMemory) {
+        this.request.executionMemory = executionMemory;
+        return this;
+    }
+    /**
+     * Set job ID.
+     *
+     * @param jobId The job ID
+     * @returns The builder instance for chaining
+     */
+    withJobId(jobId) {
+        this.request.jobId = jobId;
+        return this;
+    }
+    /**
+     * Set agent ID.
+     *
+     * @param agentId The agent ID
+     * @returns The builder instance for chaining
+     */
+    withAgentId(agentId) {
+        this.request.agentId = agentId;
+        return this;
+    }
+    /** `@exellix/ai-skills` job type id (required with agentId / taskTypeId for `build()`). */
+    withJobTypeId(jobTypeId) {
+        this.request.jobTypeId = jobTypeId;
+        return this;
+    }
+    /** `@exellix/ai-skills` task type id (required with agentId / jobTypeId for `build()`). */
+    withTaskTypeId(taskTypeId) {
+        this.request.taskTypeId = taskTypeId;
+        return this;
+    }
+    /**
+     * Set timeout in milliseconds.
+     *
+     * @param timeoutMs The timeout in milliseconds
+     * @returns The builder instance for chaining
+     */
+    withTimeout(timeoutMs) {
+        this.request.timeoutMs = timeoutMs;
+        return this;
+    }
+    /**
+     * Set additional skill-related IDs.
+     *
+     * @param coreSkillId The core skill ID (renamed from skillId to avoid confusion with runSkill's skillId)
+     * @param masterSkillId The master skill ID
+     * @param masterSkillActivityId The master skill activity ID
+     * @returns The builder instance for chaining
+     */
+    withSkillIds(coreSkillId, masterSkillId, masterSkillActivityId) {
+        if (coreSkillId)
+            this.request.coreSkillId = coreSkillId;
+        if (masterSkillId)
+            this.request.masterSkillId = masterSkillId;
+        if (masterSkillActivityId)
+            this.request.masterSkillActivityId = masterSkillActivityId;
+        return this;
+    }
+    /**
+     * Set graph execution context for better activity tracking.
+     *
+     * These fields enable smarter activity tracking and identity for nodes
+     * executing within graph workflows. When provided, they are automatically
+     * mapped to activity identity fields in the gateway.
+     *
+     * @param graphId Graph identifier for activity tracking
+     * @param nodeId Node identifier for activity tracking
+     * @param prevNodeId Previous node identifier for activity tracking
+     * @returns The builder instance for chaining
+     */
+    withGraphContext(graphId, nodeId, prevNodeId) {
+        if (graphId)
+            this.request.graphId = graphId;
+        if (nodeId)
+            this.request.nodeId = nodeId;
+        if (prevNodeId)
+            this.request.prevNodeId = prevNodeId;
+        return this;
+    }
+    /**
+     * Set graph identifier for activity tracking.
+     *
+     * @param graphId The graph identifier
+     * @returns The builder instance for chaining
+     */
+    withGraphId(graphId) {
+        this.request.graphId = graphId;
+        return this;
+    }
+    /**
+     * Set node identifier for activity tracking.
+     *
+     * @param nodeId The node identifier
+     * @returns The builder instance for chaining
+     */
+    withNodeId(nodeId) {
+        this.request.nodeId = nodeId;
+        return this;
+    }
+    /**
+     * Set previous node identifier for activity tracking.
+     *
+     * Used to track the previous node in a graph execution flow.
+     * Automatically mapped to identity.prevNodeId in activity tracking.
+     *
+     * @param prevNodeId The previous node identifier
+     * @returns The builder instance for chaining
+     */
+    withPrevNodeId(prevNodeId) {
+        this.request.prevNodeId = prevNodeId;
+        return this;
+    }
+    /**
+     * Set model configuration for this task execution.
+     *
+     * Controls which model is used and how it generates responses.
+     * This configuration overrides default model settings from client initialization
+     * and is passed through to the gateway for model selection and parameter control.
+     *
+     * @param modelConfig Model configuration (model, temperature, maxTokens, etc.)
+     * @returns The builder instance for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.withModelConfig({
+     *   model: "gpt-4-turbo",
+     *   temperature: 0.7,
+     *   maxTokens: 2000
+     * })
+     * ```
+     */
+    withModelConfig(modelConfig) {
+        this.request.modelConfig = modelConfig;
+        return this;
+    }
+    /**
+     * Set the **main-skill** LLM call configuration (`RunTaskRequest.llmCall`).
+     *
+     * `LlmCallConfig` is the canonical, per-stage knob set used everywhere LLMs are invoked
+     * (PRE synthesis, AI scoping, MAIN skill, POST audit/polish, utilities). It supports:
+     *
+     * - `model`         — provider/model id (overrides `modelConfig.model`).
+     * - `maxTokensCap`  — **hard ceiling** for completion tokens; passed to `xynthesis.resolveMaxTokens`
+     *                     so the dynamic budget never exceeds this value. Use this instead of a bare
+     *                     `maxTokens` when you want to keep auto-sizing on but bound it.
+     * - `maxTokens`     — alias for `maxTokensCap` (kept for ergonomic parity with `ModelConfig`).
+     * - `temperature`   — sampling temperature.
+     * - `topP`          — nucleus-sampling cutoff.
+     * - `outputExpectation` — caller-supplied size/density hint forwarded to `resolveMaxTokens`
+     *                         (overrides per-action `ACTION_OUTPUT_DEFAULTS` from xynthesis routing JSON).
+     * - `maxOutputLength` — character cap applied after the LLM returns (post-truncation, not a token cap).
+     * - `timeoutMs`     — per-call timeout for the underlying invoke.
+     *
+     * `LlmCallConfig` is composable with the deprecated `modelConfig` and per-step `model`/`timeoutMs`/
+     * `maxOutputLength` fields — when both are set, `llmCall.*` wins.
+     *
+     * @example
+     * ```typescript
+     * builder.withLlmCall({
+     *   model: "gpt-5-mini",
+     *   maxTokensCap: 4096,
+     *   temperature: 0.4,
+     *   outputExpectation: { size: { kind: "absolute", maxWords: 600 }, density: "default" },
+     * })
+     * ```
+     */
+    withLlmCall(llmCall) {
+        this.request.llmCall = llmCall;
+        return this;
+    }
+    /**
+     * Set AI-scoping execution options (request-level fallback for every per-instruction scoping call).
+     *
+     * - `llmCall` — default {@link LlmCallConfig} for scoping LLM calls. Per-instruction `instruction.llmCall`
+     *               overrides this.
+     * - `concurrency` — max parallel scoping calls (default 5; env `AI_SCOPING_CONCURRENCY`).
+     * - `timeoutMsPerItem` — per-instruction timeout in ms (default 30_000; env `AI_SCOPING_TIMEOUT_MS`).
+     *
+     * Per-item failures are captured (not silently dropped) on the response under
+     * `result.metadata.aiScopingFailures`. In trace mode the per-item observations are also surfaced
+     * under `result.metadata.aiScopingLlmCalls`.
+     */
+    withAiScopingOptions(opts) {
+        this.request.aiScopingOptions = opts;
+        return this;
+    }
+    /**
+     * Replace the `llmCall` config on the synthesized-context PRE step (must be added first via
+     * {@link withSynthesizedContextPreStep}).
+     */
+    withSynthesisLlmCall(llmCall) {
+        const pipeline = this.request.executionPipeline;
+        if (!pipeline || !Array.isArray(pipeline))
+            return this;
+        this.request.executionPipeline = pipeline.map((step) => {
+            if (step.phase !== "pre" || step.type !== SYNTHESIZED_CONTEXT)
+                return step;
+            return {
+                ...step,
+                config: {
+                    ...(step.config ?? {}),
+                    llmCall,
+                },
+            };
+        });
+        return this;
+    }
+    /**
+     * Replace the `llmCall` config on the audit POST step (must be added first via
+     * {@link withAuditPostStep}). When `role` is omitted, sets the top-level audit `llmCall` (used by both
+     * the audit evaluator and the synthesis-merge call). Use `role: "audit"` or `role: "synthesis"` to
+     * target a specific sub-call.
+     */
+    withAuditLlmCall(llmCall, role) {
+        const pipeline = this.request.executionPipeline;
+        if (!pipeline || !Array.isArray(pipeline))
+            return this;
+        this.request.executionPipeline = pipeline.map((step) => {
+            if (step.phase !== "post" || step.type !== "audit")
+                return step;
+            const cfg = (step.config ?? {});
+            const nextCfg = role
+                ? {
+                    ...cfg,
+                    audit: {
+                        ...(cfg.audit ?? {}),
+                        ...(role === "audit" ? { llmCall } : {}),
+                        ...(role === "synthesis" ? { synthesis: { ...(cfg?.audit?.synthesis ?? {}), llmCall } } : {}),
+                    },
+                }
+                : { ...cfg, llmCall };
+            return { ...step, config: nextCfg };
+        });
+        return this;
+    }
+    /**
+     * Replace the `llmCall` config on the polish POST step (must be added first via
+     * {@link withPolishPostStep}).
+     */
+    withPolishLlmCall(llmCall) {
+        const pipeline = this.request.executionPipeline;
+        if (!pipeline || !Array.isArray(pipeline))
+            return this;
+        this.request.executionPipeline = pipeline.map((step) => {
+            if (step.phase !== "post" || step.type !== "polish")
+                return step;
+            const cfg = (step.config ?? {});
+            return { ...step, config: { ...cfg, llmCall } };
+        });
+        return this;
+    }
+    /**
+     * Per-task overrides for gateway / athenix-parser template rendering (merged on client defaults for this invoke).
+     * See `@exellix/ai-skills` gateway template v4 docs (`subPathSearch`, optional tokens, etc.).
+     */
+    withTemplateRenderOptions(templateRenderOptions) {
+        this.request.templateRenderOptions = templateRenderOptions;
+        return this;
+    }
+    /**
+     * Highest-priority template token overlay for this invoke (gateway `templateTokens`).
+     */
+    withTemplateTokens(templateTokens) {
+        this.request.templateTokens = templateTokens;
+        return this;
+    }
+    /** Graph/job-level xynthesized memory (job, task, and execution scopes). */
+    withXynthesized(xynthesized) {
+        this.request.xynthesized = xynthesized;
+        return this;
+    }
+    /** Passthrough smart-input config for upstream / Rendrix (legacy string paths or native `{ title, path }[]`). */
+    withSmartInput(config) {
+        this.request.smartInput = config;
+        return this;
+    }
+    /** Sets {@link RunTaskRequest.smartInput} with Rendrix-native path entries (`title` defaults to each path string). */
+    withSmartInputPaths(paths) {
+        this.request.smartInput = {
+            paths: paths.map((path) => ({ title: path, path })),
+        };
+        return this;
+    }
+    /** Gateway/Rendrix rendering options for the smart-input macro (merged like `RunSkillRequest.smartInputRenderOptions`). */
+    withSmartInputRenderOptions(opts) {
+        this.request.smartInputRenderOptions = opts;
+        return this;
+    }
+    /** Merge one key into `xynthesized.job`. */
+    withXynthesizedJob(key, value) {
+        const prev = this.request.xynthesized?.job ?? {};
+        this.request.xynthesized = {
+            ...this.request.xynthesized,
+            job: { ...prev, [key]: value },
+        };
+        return this;
+    }
+    /** Merge one key into `xynthesized.task`. */
+    withXynthesizedTask(key, value) {
+        const prev = this.request.xynthesized?.task ?? {};
+        this.request.xynthesized = {
+            ...this.request.xynthesized,
+            task: { ...prev, [key]: value },
+        };
+        return this;
+    }
+    /** Merge one key into `xynthesized.execution`. */
+    withXynthesizedExecution(key, value) {
+        const prev = this.request.xynthesized?.execution ?? {};
+        this.request.xynthesized = {
+            ...this.request.xynthesized,
+            execution: { ...prev, [key]: value },
+        };
+        return this;
+    }
+    /**
+     * Build the final task request.
+     *
+     * @returns The complete task request
+     */
+    build() {
+        if (!this.request.skillKey) {
+            throw new Error("skillKey is required");
+        }
+        if (!this.request.input) {
+            throw new Error("input is required");
+        }
+        if (!this.request.agentId?.trim()) {
+            throw new Error("agentId is required (RunSkillRequest / runTask contract)");
+        }
+        if (!this.request.jobTypeId?.trim()) {
+            throw new Error("jobTypeId is required (RunSkillRequest / runTask contract)");
+        }
+        if (!this.request.taskTypeId?.trim()) {
+            throw new Error("taskTypeId is required (RunSkillRequest / runTask contract)");
+        }
+        return {
+            ...this.request,
+            executionStrategies: this.request.executionStrategies ?? [],
+        };
+    }
+}
+//# sourceMappingURL=task-request-builder.js.map

package/dist/builders/task-request-builder.js.map

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

package/dist/compile/compileTaskConfiguration.d.ts

@@ -0,0 +1,15 @@
+import { type CompileTaskConfigurationResult } from "../types/task-configuration.js";
+import type { RunTaskRequest } from "../types/task-types.js";
+/**
+ * Compile graph `taskConfiguration` on a {@link RunTaskRequest} into `executionPipeline`,
+ * `includeContextInPrompt`, and related PRE synthesis fields.
+ *
+ * - **`aiTaskStrategies.pre: "synthesis"`** (or array containing `"synthesis"`) → PRE step.
+ * - **`aiTaskProfile.inputSynthesis.enabled: true`** → PRE step (same as graph-engine compile table).
+ * - **`preInputStrategy`** / pre-core keys on `pre` → `SynthesisConfig.synthesisInputStrategy`.
+ *
+ * Removes `taskConfiguration` from the returned request (compile-only blob).
+ */
+export declare function compileTaskConfigurationOnRunTaskRequest(request: RunTaskRequest): CompileTaskConfigurationResult;
+export type { CompileTaskConfigurationResult };
+//# sourceMappingURL=compileTaskConfiguration.d.ts.map

package/dist/compile/compileTaskConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compileTaskConfiguration.d.ts","sourceRoot":"","sources":["../../src/compile/compileTaskConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,8BAA8B,EAGpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,wBAAwB,CAAC;AA2JhC;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,cAAc,GACtB,8BAA8B,CAkFhC;AAED,YAAY,EAAE,8BAA8B,EAAE,CAAC"}