@exellix/ai-tasks 7.8.0

package/dist/execution-strategies/runFuncxExecutionStrategy.js

@@ -0,0 +1,72 @@
+import { createClient } from "@x12i/funcx";
+import { run } from "@x12i/funcx/functions";
+import { FUNCX_EXECUTION_EVALUATE_RESULT_FUNCTION_ID, FUNCX_EXECUTION_PLAN_FUNCTION_ID, } from "./constants.js";
+import { adaptEvaluateResultResponse, adaptExecutionPlanResult, buildOptimizerGenericPayload, buildPlannerGenericPayload, unwrapFuncxRunValue, } from "./genericExecutionFuncxEnvelope.js";
+/**
+ * Test-only override: if set, replaces live FuncX `run()` for execution strategies.
+ */
+let injectedInvoker = null;
+export function setFuncxExecutionStrategyInvoker(fn) {
+    injectedInvoker = fn;
+}
+let cachedClient = null;
+function defaultOpenRouterClient() {
+    if (!cachedClient) {
+        cachedClient = createClient({ backend: "openrouter" });
+    }
+    return cachedClient;
+}
+async function invokeFuncx(functionId, payload) {
+    if (injectedInvoker) {
+        return injectedInvoker({ functionId, payload });
+    }
+    const client = defaultOpenRouterClient();
+    const raw = await run(functionId, payload, { client });
+    return unwrapFuncxRunValue(raw);
+}
+function pickFunctionId(explicit, fallback) {
+    if (typeof explicit === "string" && explicit.trim())
+        return explicit.trim();
+    return fallback;
+}
+/** Build a JSON-safe snapshot from task state (feeds generic `context` / attribution builders). */
+export function buildExecutionStrategyRequestPayload(req) {
+    return {
+        skillKey: req.skillKey,
+        input: req.input,
+        variables: req.variables ?? {},
+        jobContext: req.jobContext ?? {},
+        jobMemory: req.jobMemory ?? {},
+        taskMemory: req.taskMemory ?? {},
+        executionMemory: req.executionMemory ?? {},
+        jobId: req.jobId,
+        taskId: req.taskId,
+        agentId: req.agentId,
+        graphId: req.graphId,
+        nodeId: req.nodeId,
+        prevNodeId: req.prevNodeId,
+        coreSkillId: req.coreSkillId,
+        includeContextInPrompt: req.includeContextInPrompt === true,
+    };
+}
+export async function runPlannerFuncx(params) {
+    const functionId = pickFunctionId(params.args?.functionId, pickFunctionId(params.defaultFunctionId, FUNCX_EXECUTION_PLAN_FUNCTION_ID));
+    const payload = buildPlannerGenericPayload({
+        requestPayload: params.requestPayload,
+        strategyArgs: params.args,
+    });
+    const raw = await invokeFuncx(functionId, payload);
+    return adaptExecutionPlanResult(raw);
+}
+export async function runOptimizerFuncx(params) {
+    const functionId = pickFunctionId(params.args?.functionId, pickFunctionId(params.defaultFunctionId, FUNCX_EXECUTION_EVALUATE_RESULT_FUNCTION_ID));
+    const payload = buildOptimizerGenericPayload({
+        requestPayload: params.requestPayload,
+        mainResultSummary: params.mainResultSummary,
+        iterationIndex: params.iterationIndex,
+        strategyArgs: params.args,
+    });
+    const raw = await invokeFuncx(functionId, payload);
+    return adaptEvaluateResultResponse(raw);
+}
+//# sourceMappingURL=runFuncxExecutionStrategy.js.map

package/dist/execution-strategies/runFuncxExecutionStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runFuncxExecutionStrategy.js","sourceRoot":"","sources":["../../src/execution-strategies/runFuncxExecutionStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EACL,2CAA2C,EAC3C,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAO5C;;GAEG;AACH,IAAI,eAAe,GAA4E,IAAI,CAAC;AAEpG,MAAM,UAAU,gCAAgC,CAC9C,EAA2E;IAE3E,eAAe,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,SAAS,uBAAuB;IAC9B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,UAAkB,EAAE,OAAgB;IAC7D,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,cAAc,CAAC,QAAiB,EAAE,QAAgB;IACzD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,oCAAoC,CAAC,GAgBpD;IACC,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC9B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAChC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC9B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAChC,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE;QAC1C,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,sBAAsB,EAAE,GAAG,CAAC,sBAAsB,KAAK,IAAI;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAIrC;IACC,MAAM,UAAU,GAAG,cAAc,CAC/B,MAAM,CAAC,IAAI,EAAE,UAAU,EACvB,cAAc,CAAC,MAAM,CAAC,iBAAiB,EAAE,gCAAgC,CAAC,CAC3E,CAAC;IACF,MAAM,OAAO,GAAG,0BAA0B,CAAC;QACzC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,YAAY,EAAE,MAAM,CAAC,IAAI;KAC1B,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAMvC;IACC,MAAM,UAAU,GAAG,cAAc,CAC/B,MAAM,CAAC,IAAI,EAAE,UAAU,EACvB,cAAc,CAAC,MAAM,CAAC,iBAAiB,EAAE,2CAA2C,CAAC,CACtF,CAAC;IACF,MAAM,OAAO,GAAG,4BAA4B,CAAC;QAC3C,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,YAAY,EAAE,MAAM,CAAC,IAAI;KAC1B,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,2BAA2B,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Main entry point for the Task SDK
+ *
+ * Provides both class-based and function-based APIs for executing tasks.
+ */
+import { ExellixSkillsClient } from "@exellix/ai-skills";
+import type { ExellixSkillsClientOptions } from "@exellix/ai-skills";
+import type { RunTaskRequest, RunTaskResponse } from "./types/index.js";
+import type { RunUtilityRequest, RunUtilityResponse } from "./types/index.js";
+import { createDefaultWorexClientTasks } from "./packaged-tasks-client.js";
+export { getTaskActivities } from "./activix/getTaskActivities.js";
+export { createDefaultWorexClientTasks, getPackagedAiTasksMetadataDir, PackagedWorexClientTasks, resolvePackagedSkillContentSource, } from "./packaged-tasks-client.js";
+export type { CreateDefaultWorexClientTasksOptions, PackagedWorexClientTasksLifecycle, } from "./packaged-tasks-client.js";
+export { mergeSkillTemplateVariables, passthroughJobTemplateVariables, } from "./utils/skillTemplateVariables.js";
+export { bridgeJobMemoryForGatewayExecutionMemory, pickRunSkillRequestFields, } from "./utils/bridgeRunSkillGatewayMemory.js";
+export { normalizeRunTaskRequest, collectRunTaskRequestWarnings, collectExecutionPipelineWarnings, isRunTaskRequestWarningsEnabled, } from "./utils/runTaskRequestShape.js";
+export { compileTaskConfigurationOnRunTaskRequest, type CompileTaskConfigurationResult, } from "./compile/index.js";
+export { TaskConfigurationCompileError, TASK_CONFIGURATION_COMPILE_ERROR_NAME, isTaskConfigurationCompileError, } from "./errors/taskConfigurationCompileError.js";
+export { AI_TASK_PRE_ENABLE_SYNTHESIS, type TaskConfigurationAuthoring, type AiTaskStrategiesAuthoring, type AiTaskProfileAuthoring, type InputSynthesisAuthoring, } from "./types/task-configuration.js";
+export { assertRequiredRunSkillCorrelation } from "./utils/assertRequiredRunSkillCorrelation.js";
+export { SmartInputValidationError, SMART_INPUT_VALIDATION_ERROR_NAME, isSmartInputValidationError, formatSmartInputValidationMessage, } from "./errors/smartInputValidationError.js";
+export type { SmartInputValidationErrorCode, SmartInputValidationErrorDetails, } from "./errors/smartInputValidationError.js";
+export { validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, collectSmartInputValidationIssues, buildRunTaskValidationContext, } from "./validation/index.js";
+export type { RunTaskValidationIssue, RunTaskValidationResult, RunTaskInvokeValidationResult, ExpectedRunTaskInputPath, AnalyzeExpectedRunTaskInputResult, ValidateRunTaskInvokeParams, RunTaskTemplateResolver, } from "./validation/index.js";
+export { analyzeRunTaskRequest } from "./analysis/index.js";
+export type { AnalyzeRunTaskRequestOptions, AnalyzeRunTaskRequestResult } from "./analysis/index.js";
+export type { OutputValidationErrorCode, OutputValidationErrorItem, OutputValidationResult, } from "./utils/outputValidation.js";
+export { validateParsedOutput } from "./utils/outputValidation.js";
+export { extractAiTasksObservabilityFromRunTaskResponse } from "./observability/extractAiTasksObservability.js";
+export { resolveRunTaskRuntimeKnobs, type ResolvedRunTaskRuntimeKnobs, type ResolvedExecutionStrategies, } from "./internal/resolveRunTaskRuntimeKnobs.js";
+export { setFuncxExecutionStrategyInvoker } from "./execution-strategies/runFuncxExecutionStrategy.js";
+export { FUNCX_EXECUTION_PLAN_FUNCTION_ID, FUNCX_EXECUTION_EVALUATE_RESULT_FUNCTION_ID, FUNCX_RESEARCH_PLAN_QUESTIONS_FUNCTION_ID, DEFAULT_OPTIMIZER_MAX_ITERATIONS, ENV_OPTIMIZER_MAX_ITERATIONS, } from "./execution-strategies/constants.js";
+export { adaptExecutionPlanResult, adaptEvaluateResultResponse, buildOptimizerGenericPayload, buildPlannerGenericPayload, buildResearchPlanQuestionsPayload, adaptResearchPlanQuestionsResult, unwrapFuncxRunValue, } from "./execution-strategies/genericExecutionFuncxEnvelope.js";
+export { resolveSafeExecutionStrategyCatalogDefaultFunctionId } from "./execution-strategies/executionStrategyCatalogMetadata.js";
+/** @see https://github.com/x12i/funcx — canonical `run()` JSON normalization (≥3.8.2). */
+export { getRunJsonResult, isHttpRunSuccessBody, genericExecutionEnvelopeJsonSchema, buildAskAttribution, } from "@x12i/funcx/functions";
+export type { GenericExecutionEnvelope } from "@x12i/funcx/functions";
+export type { GenericExecutionStrategyPayload, GenericFuncxAttribution, ResearchPlanQuestionsGenericPayload, ResearchPlanQuestionsInputShape, } from "./execution-strategies/genericExecutionFuncxEnvelope.js";
+export type { GraphExecutionConsoleFields } from "./observability/graphExecutionRunLogContract.js";
+export * from "./skillCatalogExports.js";
+export * from "./aiSkillsUpstreamExports.js";
+export * from "./rendrixUpstreamExports.js";
+export * from "./analysis/index.js";
+export * from "./task-strategies/index.js";
+export { PlanWebScopeQuestionsReasonCode, parseAndValidatePlanWebScopeQuestionsOutput, buildPlanWebScopeQuestionsUserPrompt, runPlanWebScopeQuestions, setResearchPlanQuestionsFuncxInvoker, } from "./planWebScopeQuestions/index.js";
+export type { PlanWebScopeQuestionsInput, PlanWebScopeQuestionsOutput, PlanWebScopeQuestionItem, PlanWebScopeQuestionsMemorySummary, RunPlanWebScopeQuestionsParams, ParsePlanWebScopeQuestionsResult, } from "./planWebScopeQuestions/index.js";
+/** @alias createDefaultWorexClientTasks — name aligned with optional `WorexClientTasks.forPackagedSkills` style API. */
+export declare const forPackagedSkills: typeof createDefaultWorexClientTasks;
+export type WorexClientSkills = ExellixSkillsClient;
+export type WorexClientSkillsOptions = ExellixSkillsClientOptions;
+export { ExellixSkillsClient };
+export { WorexClientTasks } from "./core/task-sdk.js";
+export { TaskRequestBuilder } from "./builders/task-request-builder.js";
+export { setContextSynthesizer, getContextSynthesizer, runStructuredSynthesisGatewayCall, createGatewayStructuredContextSynthesizer, buildSynthesizedContextMarkdown, resolveSynthesisQuestion, resolveSourceMaterialParts, parseAndValidateSynthesizedPromptPayload, normalizeAndValidateSynthesizedPayload, executeXynthesisAction, setSynthesisInvoker, getSynthesisInvoker, } from "./synthesis/index.js";
+export type { RunStructuredSynthesisParams, ParseSynthesizedPayloadOptions, SourceMaterialParts, SynthesisInvoker, SynthesisInvokerOptions, ExecuteXynthesisActionRequest, } from "./synthesis/index.js";
+/**
+ * Execute a task with the specified execution strategy (function-based API).
+ *
+ * This is a convenience function that automatically initializes the SDK.
+ * For more control, use the WorexClientTasks class directly.
+ *
+ * @param request The task execution request
+ * @param options Optional client configuration (only used on first call)
+ * @returns Promise resolving to the task response
+ *
+ * @example
+ * ```typescript
+ * import { runTask } from "@exellix/ai-tasks";
+ *
+ * const result = await runTask({
+ *   skillKey: "tasks/security-risk-summary",
+ *   agentId: "my-agent",
+ *   jobTypeId: "security-summary-job",
+ *   taskTypeId: "security-summary-task",
+ *   input: { assetId: "a-123" },
+ *   variables: { orgName: "MyOrganization" },
+ * });
+ * ```
+ */
+export declare function runTask<TParsed = any>(request: RunTaskRequest, options?: ExellixSkillsClientOptions): Promise<RunTaskResponse<TParsed>>;
+/**
+ * Execute an ai-tasks utility request (function-based API).
+ *
+ * This is used by upstream orchestration (e.g. worox-graph) to run deterministic utility kinds
+ * like `xynthesis/finalize` and return canonical structured output in `response.parsed`.
+ */
+export declare function runUtility<TParsed = any>(request: RunUtilityRequest): Promise<RunUtilityResponse<TParsed>>;
+export type { RunTaskRequest, RunTaskResponse, RunTaskTraceResponse, DebugTraceTask, RunSkillResponse, RunSkillRequest, RunUtilityRequest, RunUtilityResponse, UtilityExecutionPolicy, EvidenceCollectionInput, EvidenceBundle, EvidenceRequest, EvidencePolicy, EvidenceExtractionConfig, EvidenceRequestInputKind, EvidenceRequestStatus, EvidenceBundleValue, EvidenceBundleRequestResult, EvidenceSource, EvidenceFact, EvidenceCoverage, EvidenceBundleError, EvidenceBundleWarning, JobHistory, TaskHistory, ExecutionHistory, TaskMemoryNarrixEntry, NarrixScope, NarrixRunInput, IntermediateStep, IntermediateSteps, RunTaskResponseWithSteps, ExecutionPhase, ExecutionStep, ContextSourcePolicy, WebEvidenceConfig, SynthesisConfig, SynthesisMode, TaskCore, SynthesisInput, SynthesizedItem, SynthesizedContext, SynthesizedPromptPayload, ContextSynthesizer, AuditConfig, AuditCheck, AuditResult, AuditCheckResult, AuditLLMOutput, AuditPostStepMetadata, PolishConfig, PolishChecklistItem, PolishLLMOutput, PolishPostStepMetadata, RunTaskResponsePostStepsMetadata, SynthesizedContextArtifact, QuestionDrivenSynthesizedContext, AnySynthesizedContextArtifact, SynthesizedInputArtifact, TemplateRenderOptions, GatewayTemplateTokens, OutputSchema, AiTasksObservabilityDigest, XynthesizedMemory, SmartInputConfig, SmartInputRenderOptions, SmartInputRenderResult, RunTaskSmartInput, XynthesizedDestinationScope, XynthesizedOutputConfig, ExecutionStrategyInvocation, ExecutionStrategyPhase, ExecutionStrategyWrapperKey, } from "./types/index.js";
+export { ExecutionType, NARRIX_THEN_DIRECT, SYNTHESIZED_CONTEXT, } from "./types/index.js";
+export { registerLocalTask, getLocalTask, registerBuiltInLocalTasks, } from "./localTasks/index.js";
+export type { LocalTaskContext, LocalTaskHandler } from "./localTasks/index.js";
+export { runAiScoping, AI_SCOPING_DEFAULT_OUTPUT_EXPECTATION, } from "./aiScoping/index.js";
+export type { RunAiScopingResult } from "./aiScoping/index.js";
+export type { LlmCallConfig, LlmCallStage, LlmCallRequestSnapshot, LlmCallObservation, LlmCallError, AiScopingFailureRecord, RunTaskResponseTraceMetadata, InvokeAttemptSummary, UsageDiagnostics, RoutingDiagnostics, MaxTokensResolution, OutputExpectation, XynthesisDebugTrace, SkillDiagnosticsTrace, SkillTraceUsage, RunSkillDiagnostics, } from "./types/index.js";
+export { LlmCallContextError } from "./types/index.js";
+export { XynthesisInvokeError, XynthesisResponseParseError, resolveMaxTokens, resolveOutputExpectation, PACKAGE_FALLBACK_OUTPUT_EXPECTATION, } from "@exellix/xynthesis/ai-actions";
+export { buildInvokeAttemptSummary, ACTION_OUTPUT_DEFAULTS, MODEL_CAPABILITIES } from "@exellix/xynthesis";
+export { SkillExecutionTraceError, mapGatewayInvokeToTrace, traceToDiagnostics, } from "@exellix/ai-skills";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,106 @@
+/**
+ * Main entry point for the Task SDK
+ *
+ * Provides both class-based and function-based APIs for executing tasks.
+ */
+import { ExellixSkillsClient } from "@exellix/ai-skills";
+import { runUtility as runUtilityImpl } from "./utilities/runUtility.js";
+import { createDefaultWorexClientTasks, } from "./packaged-tasks-client.js";
+export { getTaskActivities } from "./activix/getTaskActivities.js";
+export { createDefaultWorexClientTasks, getPackagedAiTasksMetadataDir, PackagedWorexClientTasks, resolvePackagedSkillContentSource, } from "./packaged-tasks-client.js";
+export { mergeSkillTemplateVariables, passthroughJobTemplateVariables, } from "./utils/skillTemplateVariables.js";
+export { bridgeJobMemoryForGatewayExecutionMemory, pickRunSkillRequestFields, } from "./utils/bridgeRunSkillGatewayMemory.js";
+export { normalizeRunTaskRequest, collectRunTaskRequestWarnings, collectExecutionPipelineWarnings, isRunTaskRequestWarningsEnabled, } from "./utils/runTaskRequestShape.js";
+export { compileTaskConfigurationOnRunTaskRequest, } from "./compile/index.js";
+export { TaskConfigurationCompileError, TASK_CONFIGURATION_COMPILE_ERROR_NAME, isTaskConfigurationCompileError, } from "./errors/taskConfigurationCompileError.js";
+export { AI_TASK_PRE_ENABLE_SYNTHESIS, } from "./types/task-configuration.js";
+export { assertRequiredRunSkillCorrelation } from "./utils/assertRequiredRunSkillCorrelation.js";
+export { SmartInputValidationError, SMART_INPUT_VALIDATION_ERROR_NAME, isSmartInputValidationError, formatSmartInputValidationMessage, } from "./errors/smartInputValidationError.js";
+export { validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, collectSmartInputValidationIssues, buildRunTaskValidationContext, } from "./validation/index.js";
+export { analyzeRunTaskRequest } from "./analysis/index.js";
+export { validateParsedOutput } from "./utils/outputValidation.js";
+export { extractAiTasksObservabilityFromRunTaskResponse } from "./observability/extractAiTasksObservability.js";
+export { resolveRunTaskRuntimeKnobs, } from "./internal/resolveRunTaskRuntimeKnobs.js";
+export { setFuncxExecutionStrategyInvoker } from "./execution-strategies/runFuncxExecutionStrategy.js";
+export { FUNCX_EXECUTION_PLAN_FUNCTION_ID, FUNCX_EXECUTION_EVALUATE_RESULT_FUNCTION_ID, FUNCX_RESEARCH_PLAN_QUESTIONS_FUNCTION_ID, DEFAULT_OPTIMIZER_MAX_ITERATIONS, ENV_OPTIMIZER_MAX_ITERATIONS, } from "./execution-strategies/constants.js";
+export { adaptExecutionPlanResult, adaptEvaluateResultResponse, buildOptimizerGenericPayload, buildPlannerGenericPayload, buildResearchPlanQuestionsPayload, adaptResearchPlanQuestionsResult, unwrapFuncxRunValue, } from "./execution-strategies/genericExecutionFuncxEnvelope.js";
+export { resolveSafeExecutionStrategyCatalogDefaultFunctionId } from "./execution-strategies/executionStrategyCatalogMetadata.js";
+/** @see https://github.com/x12i/funcx — canonical `run()` JSON normalization (≥3.8.2). */
+export { getRunJsonResult, isHttpRunSuccessBody, genericExecutionEnvelopeJsonSchema, buildAskAttribution, } from "@x12i/funcx/functions";
+export * from "./skillCatalogExports.js";
+export * from "./aiSkillsUpstreamExports.js";
+export * from "./rendrixUpstreamExports.js";
+export * from "./analysis/index.js";
+export * from "./task-strategies/index.js";
+export { PlanWebScopeQuestionsReasonCode, parseAndValidatePlanWebScopeQuestionsOutput, buildPlanWebScopeQuestionsUserPrompt, runPlanWebScopeQuestions, setResearchPlanQuestionsFuncxInvoker, } from "./planWebScopeQuestions/index.js";
+/** @alias createDefaultWorexClientTasks — name aligned with optional `WorexClientTasks.forPackagedSkills` style API. */
+export const forPackagedSkills = createDefaultWorexClientTasks;
+export { ExellixSkillsClient };
+// Export the main class
+export { WorexClientTasks } from "./core/task-sdk.js";
+// Export builders
+export { TaskRequestBuilder } from "./builders/task-request-builder.js";
+// Synthesis via @exellix/xynthesis (+ resolveSourceMaterial*, tests use setSynthesisInvoker)
+export { setContextSynthesizer, getContextSynthesizer, runStructuredSynthesisGatewayCall, createGatewayStructuredContextSynthesizer, buildSynthesizedContextMarkdown, resolveSynthesisQuestion, resolveSourceMaterialParts, parseAndValidateSynthesizedPromptPayload, normalizeAndValidateSynthesizedPayload, executeXynthesisAction, setSynthesisInvoker, getSynthesisInvoker, } from "./synthesis/index.js";
+// Internal SDK instance (singleton pattern for function-based API)
+let internalSDKPromise = null;
+/**
+ * Initialize the internal SDK instance for function-based API.
+ * Uses {@link createDefaultWorexClientTasks} (xillix when `MONGO_URI` is set, else gateway + packaged `.metadata`).
+ * @internal
+ */
+async function getInternalSDK(options) {
+    if (!internalSDKPromise) {
+        internalSDKPromise = createDefaultWorexClientTasks(options);
+    }
+    return internalSDKPromise;
+}
+/**
+ * Execute a task with the specified execution strategy (function-based API).
+ *
+ * This is a convenience function that automatically initializes the SDK.
+ * For more control, use the WorexClientTasks class directly.
+ *
+ * @param request The task execution request
+ * @param options Optional client configuration (only used on first call)
+ * @returns Promise resolving to the task response
+ *
+ * @example
+ * ```typescript
+ * import { runTask } from "@exellix/ai-tasks";
+ *
+ * const result = await runTask({
+ *   skillKey: "tasks/security-risk-summary",
+ *   agentId: "my-agent",
+ *   jobTypeId: "security-summary-job",
+ *   taskTypeId: "security-summary-task",
+ *   input: { assetId: "a-123" },
+ *   variables: { orgName: "MyOrganization" },
+ * });
+ * ```
+ */
+export async function runTask(request, options) {
+    const sdk = await getInternalSDK(options);
+    return sdk.runTask(request);
+}
+/**
+ * Execute an ai-tasks utility request (function-based API).
+ *
+ * This is used by upstream orchestration (e.g. worox-graph) to run deterministic utility kinds
+ * like `xynthesis/finalize` and return canonical structured output in `response.parsed`.
+ */
+export async function runUtility(request) {
+    return runUtilityImpl(request);
+}
+export { ExecutionType, NARRIX_THEN_DIRECT, SYNTHESIZED_CONTEXT, } from "./types/index.js";
+// Local task registry (for custom local tasks)
+export { registerLocalTask, getLocalTask, registerBuiltInLocalTasks, } from "./localTasks/index.js";
+// AI scoping (programmatic API for the same code path used by `RunTaskRequest.aiScoping[]`).
+export { runAiScoping, AI_SCOPING_DEFAULT_OUTPUT_EXPECTATION, } from "./aiScoping/index.js";
+export { LlmCallContextError } from "./types/index.js";
+// Upstream value re-exports: orchestrator-sized budgeting + errors from `@exellix/xynthesis/ai-actions`;
+// model-routing table exports remain on the full `@exellix/xynthesis` entry.
+export { XynthesisInvokeError, XynthesisResponseParseError, resolveMaxTokens, resolveOutputExpectation, PACKAGE_FALLBACK_OUTPUT_EXPECTATION, } from "@exellix/xynthesis/ai-actions";
+export { buildInvokeAttemptSummary, ACTION_OUTPUT_DEFAULTS, MODEL_CAPABILITIES } from "@exellix/xynthesis";
+export { SkillExecutionTraceError, mapGatewayInvokeToTrace, traceToDiagnostics, } from "@exellix/ai-skills";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/internal/resolveLlmCallForXynthesis.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Pure helper: resolves the effective `outputExpectation` and runs xynthesis `resolveMaxTokens`
+ * for any ai-tasks LLM call site that goes through `executeXynthesisAction` (PRE markdown / question-driven /
+ * structured, POST audit, POST polish, AI scoping, utility finalize, structured-repair).
+ *
+ * Caller passes prompts (system + user + material), the resolved model id, and the user-facing
+ * `LlmCallConfig`. Returns the auto-resolved `maxTokens` to forward to xynthesis, plus the
+ * `tokenResolutionMetadata` blob that xynthesis writes into Activix telemetry.
+ *
+ * Per-stage default `outputExpectation`:
+ *   - When the stage maps to a `SidekickActionType` (`synthesis` / `audit` / `fix` / `pick-best` / `craft-final`),
+ *     uses xynthesis `resolveOutputExpectation(actionType)`.
+ *   - Otherwise (AI scoping / utility-finalize / structured-repair) uses the supplied `stageDefault`
+ *     or `PACKAGE_FALLBACK_OUTPUT_EXPECTATION`.
+ *
+ * Caller's `outputExpectation` ALWAYS wins over the per-stage default (passed through `resolveOutputExpectation`).
+ */
+import type { MaxTokensResolution, OutputExpectation } from "@exellix/xynthesis/ai-actions";
+import type { LlmCallConfig, LlmCallStage } from "../types/llmCall.js";
+export type ResolveLlmCallForXynthesisInput = {
+    stage: LlmCallStage;
+    llmCall?: LlmCallConfig;
+    /**
+     * Combined text used as `inputText` for `resolveMaxTokens` (system + user + material).
+     * Order/composition does not matter for sizing — only total length.
+     */
+    inputText: string;
+    /** Resolved model id (after caller / env / fallback resolution). */
+    modelId: string;
+    /** Set true for JSON / structured outputs so xynthesis multiplies estimated output tokens. */
+    structuredOutput?: boolean;
+    /**
+     * Override for the per-stage default `outputExpectation` (used when the stage doesn't map to a
+     * `SidekickActionType`, e.g. AI scoping). Falls back to `PACKAGE_FALLBACK_OUTPUT_EXPECTATION`.
+     */
+    stageDefault?: OutputExpectation;
+    /** Optional: structured-mode output multiplier override (forwarded to `resolveMaxTokens`). */
+    structuredModeMultiplier?: number;
+};
+export type ResolveLlmCallForXynthesisResult = {
+    /** Auto-resolved cap to forward as `executeXynthesisAction({ maxTokens })`. */
+    maxTokens: number;
+    /** Effective expectation after caller -> action default -> stage default chain. */
+    effectiveOutputExpectation: OutputExpectation;
+    /** Verbatim `MaxTokensResolution` (reason + diagnostics) for trace + telemetry. */
+    resolution: MaxTokensResolution;
+    /** Blob to forward as `executeXynthesisAction({ tokenResolutionMetadata })` (Activix outer.metadata). */
+    tokenResolutionMetadata: Record<string, unknown>;
+};
+/** Resolve effective `outputExpectation` + auto-sized `maxTokens` for one LLM call. */
+export declare function resolveLlmCallForXynthesis(input: ResolveLlmCallForXynthesisInput): ResolveLlmCallForXynthesisResult;
+//# sourceMappingURL=resolveLlmCallForXynthesis.d.ts.map

package/dist/internal/resolveLlmCallForXynthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveLlmCallForXynthesis.d.ts","sourceRoot":"","sources":["../../src/internal/resolveLlmCallForXynthesis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAE5F,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA4BvE,MAAM,MAAM,+BAA+B,GAAG;IAC5C,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,8FAA8F;IAC9F,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,0BAA0B,EAAE,iBAAiB,CAAC;IAC9C,mFAAmF;IACnF,UAAU,EAAE,mBAAmB,CAAC;IAChC,yGAAyG;IACzG,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClD,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,+BAA+B,GACrC,gCAAgC,CAuClC"}

package/dist/internal/resolveLlmCallForXynthesis.js

@@ -0,0 +1,81 @@
+/**
+ * Pure helper: resolves the effective `outputExpectation` and runs xynthesis `resolveMaxTokens`
+ * for any ai-tasks LLM call site that goes through `executeXynthesisAction` (PRE markdown / question-driven /
+ * structured, POST audit, POST polish, AI scoping, utility finalize, structured-repair).
+ *
+ * Caller passes prompts (system + user + material), the resolved model id, and the user-facing
+ * `LlmCallConfig`. Returns the auto-resolved `maxTokens` to forward to xynthesis, plus the
+ * `tokenResolutionMetadata` blob that xynthesis writes into Activix telemetry.
+ *
+ * Per-stage default `outputExpectation`:
+ *   - When the stage maps to a `SidekickActionType` (`synthesis` / `audit` / `fix` / `pick-best` / `craft-final`),
+ *     uses xynthesis `resolveOutputExpectation(actionType)`.
+ *   - Otherwise (AI scoping / utility-finalize / structured-repair) uses the supplied `stageDefault`
+ *     or `PACKAGE_FALLBACK_OUTPUT_EXPECTATION`.
+ *
+ * Caller's `outputExpectation` ALWAYS wins over the per-stage default (passed through `resolveOutputExpectation`).
+ */
+import { PACKAGE_FALLBACK_OUTPUT_EXPECTATION, resolveMaxTokens, resolveOutputExpectation, } from "@exellix/xynthesis/ai-actions";
+/** Map every `LlmCallStage` to a `SidekickActionType` when one applies, else null (use stage default). */
+function actionTypeForStage(stage) {
+    switch (stage) {
+        case "pre-synthesis-markdown":
+        case "pre-synthesis-question":
+        case "pre-synthesis-structured":
+            return "synthesis";
+        case "post-audit":
+        case "post-audit-merge":
+            return "audit";
+        case "post-polish":
+            return "fix";
+        case "main-skill":
+        case "ai-scoping":
+        case "plan-web-scope-questions":
+        case "utility-finalize":
+        case "structured-repair":
+            return null;
+        default: {
+            const _exhaustive = stage;
+            void _exhaustive;
+            return null;
+        }
+    }
+}
+/** Resolve effective `outputExpectation` + auto-sized `maxTokens` for one LLM call. */
+export function resolveLlmCallForXynthesis(input) {
+    const callerOverride = input.llmCall?.outputExpectation;
+    const actionType = actionTypeForStage(input.stage);
+    let effectiveOutputExpectation;
+    if (actionType) {
+        // resolveOutputExpectation chains: caller override -> action default (model-routing.json) -> package fallback.
+        effectiveOutputExpectation = resolveOutputExpectation(actionType, callerOverride);
+    }
+    else {
+        effectiveOutputExpectation =
+            callerOverride ?? input.stageDefault ?? PACKAGE_FALLBACK_OUTPUT_EXPECTATION;
+    }
+    const callerMaxTokens = input.llmCall?.maxTokensCap;
+    const resolution = resolveMaxTokens({
+        inputText: input.inputText,
+        outputExpectation: effectiveOutputExpectation,
+        modelId: input.modelId,
+        callerMaxTokens,
+        structuredOutput: input.structuredOutput,
+        structuredModeMultiplier: input.structuredModeMultiplier,
+    });
+    const tokenResolutionMetadata = {
+        stage: input.stage,
+        reason: resolution.reason,
+        diagnostics: resolution.diagnostics,
+        outputExpectation: effectiveOutputExpectation,
+        callerMaxTokensCap: callerMaxTokens,
+        structuredOutput: input.structuredOutput ?? false,
+    };
+    return {
+        maxTokens: resolution.maxTokens,
+        effectiveOutputExpectation,
+        resolution,
+        tokenResolutionMetadata,
+    };
+}
+//# sourceMappingURL=resolveLlmCallForXynthesis.js.map

package/dist/internal/resolveLlmCallForXynthesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveLlmCallForXynthesis.js","sourceRoot":"","sources":["../../src/internal/resolveLlmCallForXynthesis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,mCAAmC,EACnC,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAKvC,0GAA0G;AAC1G,SAAS,kBAAkB,CAAC,KAAmB;IAC7C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,wBAAwB,CAAC;QAC9B,KAAK,wBAAwB,CAAC;QAC9B,KAAK,0BAA0B;YAC7B,OAAO,WAAW,CAAC;QACrB,KAAK,YAAY,CAAC;QAClB,KAAK,kBAAkB;YACrB,OAAO,OAAO,CAAC;QACjB,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC;QACf,KAAK,YAAY,CAAC;QAClB,KAAK,YAAY,CAAC;QAClB,KAAK,0BAA0B,CAAC;QAChC,KAAK,kBAAkB,CAAC;QACxB,KAAK,mBAAmB;YACtB,OAAO,IAAI,CAAC;QACd,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,KAAK,CAAC;YACjC,KAAK,WAAW,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAkCD,uFAAuF;AACvF,MAAM,UAAU,0BAA0B,CACxC,KAAsC;IAEtC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACxD,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnD,IAAI,0BAA6C,CAAC;IAClD,IAAI,UAAU,EAAE,CAAC;QACf,+GAA+G;QAC/G,0BAA0B,GAAG,wBAAwB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,0BAA0B;YACxB,cAAc,IAAI,KAAK,CAAC,YAAY,IAAI,mCAAmC,CAAC;IAChF,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC;IAEpD,MAAM,UAAU,GAAG,gBAAgB,CAAC;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,iBAAiB,EAAE,0BAA0B;QAC7C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,eAAe;QACf,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;KACzD,CAAC,CAAC;IAEH,MAAM,uBAAuB,GAA4B;QACvD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,iBAAiB,EAAE,0BAA0B;QAC7C,kBAAkB,EAAE,eAAe;QACnC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,KAAK;KAClD,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,0BAA0B;QAC1B,UAAU;QACV,uBAAuB;KACxB,CAAC;AACJ,CAAC"}

package/dist/internal/resolveRunTaskRuntimeKnobs.d.ts

@@ -0,0 +1,19 @@
+import type { RunTaskRequest } from "../types/task-types.js";
+import type { InputStrategyKey } from "../task-strategies/canonicalInputExecutionStrategies.js";
+import { type NarrixModeKey } from "../task-strategies/canonicalNarrixModes.js";
+import { type ResolvedExecutionStrategies } from "../execution-strategies/resolveExecutionStrategies.js";
+export type { ResolvedExecutionStrategies };
+export type ResolvedRunTaskRuntimeKnobs = {
+    narrixMode: NarrixModeKey;
+    inputStrategyKey: InputStrategyKey | string;
+    resolvedExecutionStrategies: ResolvedExecutionStrategies;
+};
+/**
+ * Resolves independent runtime dimensions for `runTask` (early, before side effects).
+ *
+ * - **narrixMode:** explicit field, else inferred from `narrix` / `narrixInput`.
+ * - **inputStrategyKey:** explicit or default `no-narrative` — **not** inferred from Narrix wiring.
+ * - **executionStrategies:** required array; validated and sorted (see `resolveExecutionStrategies`).
+ */
+export declare function resolveRunTaskRuntimeKnobs(request: RunTaskRequest): ResolvedRunTaskRuntimeKnobs;
+//# sourceMappingURL=resolveRunTaskRuntimeKnobs.d.ts.map

package/dist/internal/resolveRunTaskRuntimeKnobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRunTaskRuntimeKnobs.d.ts","sourceRoot":"","sources":["../../src/internal/resolveRunTaskRuntimeKnobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAChG,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,uDAAuD,CAAC;AAE/D,YAAY,EAAE,2BAA2B,EAAE,CAAC;AAQ5C,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,aAAa,CAAC;IAC1B,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAC5C,2BAA2B,EAAE,2BAA2B,CAAC;CAC1D,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,2BAA2B,CAyC/F"}

package/dist/internal/resolveRunTaskRuntimeKnobs.js

@@ -0,0 +1,52 @@
+import { CANONICAL_NARRIX_MODE_KEYS, } from "../task-strategies/canonicalNarrixModes.js";
+import { resolveExecutionStrategies, } from "../execution-strategies/resolveExecutionStrategies.js";
+function trimStr(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const t = v.trim();
+    return t ? t : undefined;
+}
+function isNarrixModeKey(v) {
+    return CANONICAL_NARRIX_MODE_KEYS.includes(v);
+}
+/**
+ * Resolves independent runtime dimensions for `runTask` (early, before side effects).
+ *
+ * - **narrixMode:** explicit field, else inferred from `narrix` / `narrixInput`.
+ * - **inputStrategyKey:** explicit or default `no-narrative` — **not** inferred from Narrix wiring.
+ * - **executionStrategies:** required array; validated and sorted (see `resolveExecutionStrategies`).
+ */
+export function resolveRunTaskRuntimeKnobs(request) {
+    const hasNarrixCfg = !!request.narrix;
+    const hasNarrixInput = !!request.narrixInput;
+    const explicitModeRaw = trimStr(request.narrixMode);
+    if (hasNarrixCfg && hasNarrixInput && !explicitModeRaw) {
+        throw new Error('Ambiguous Narrix wiring: both `request.narrix` and `narrixInput` are set. Set `narrixMode` to "preprocessor" or "handler" to choose exactly one path.');
+    }
+    if (explicitModeRaw && !isNarrixModeKey(explicitModeRaw)) {
+        throw new Error(`Unknown narrixMode "${explicitModeRaw}". Expected one of: ${CANONICAL_NARRIX_MODE_KEYS.join(", ")}.`);
+    }
+    if (explicitModeRaw === "preprocessor" && !hasNarrixCfg) {
+        throw new Error('narrixMode "preprocessor" requires `request.narrix` to be set.');
+    }
+    if (explicitModeRaw === "handler" && !hasNarrixInput) {
+        throw new Error('narrixMode "handler" requires `narrixInput` to be set.');
+    }
+    let narrixMode;
+    if (explicitModeRaw) {
+        narrixMode = explicitModeRaw;
+    }
+    else if (hasNarrixCfg) {
+        narrixMode = "preprocessor";
+    }
+    else if (hasNarrixInput) {
+        narrixMode = "handler";
+    }
+    else {
+        narrixMode = "off";
+    }
+    const inputStrategyKey = trimStr(request.inputStrategyKey) ?? "no-narrative";
+    const resolvedExecutionStrategies = resolveExecutionStrategies(request);
+    return { narrixMode, inputStrategyKey, resolvedExecutionStrategies };
+}
+//# sourceMappingURL=resolveRunTaskRuntimeKnobs.js.map

package/dist/internal/resolveRunTaskRuntimeKnobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRunTaskRuntimeKnobs.js","sourceRoot":"","sources":["../../src/internal/resolveRunTaskRuntimeKnobs.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,0BAA0B,GAE3B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,0BAA0B,GAE3B,MAAM,uDAAuD,CAAC;AAI/D,SAAS,OAAO,CAAC,CAAU;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3B,CAAC;AAQD,SAAS,eAAe,CAAC,CAAS;IAChC,OAAQ,0BAAgD,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAuB;IAChE,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACtC,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAE7C,MAAM,eAAe,GAAG,OAAO,CAAE,OAAoC,CAAC,UAAU,CAAC,CAAC;IAElF,IAAI,YAAY,IAAI,cAAc,IAAI,CAAC,eAAe,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,uJAAuJ,CACxJ,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,uBAAuB,eAAe,uBAAuB,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtG,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,KAAK,cAAc,IAAI,CAAC,YAAY,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,eAAe,KAAK,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,UAAyB,CAAC;IAC9B,IAAI,eAAe,EAAE,CAAC;QACpB,UAAU,GAAG,eAAgC,CAAC;IAChD,CAAC;SAAM,IAAI,YAAY,EAAE,CAAC;QACxB,UAAU,GAAG,cAAc,CAAC;IAC9B,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,gBAAgB,GAA8B,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,cAAc,CAAC;IAExG,MAAM,2BAA2B,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAExE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,CAAC;AACvE,CAAC"}

package/dist/internal/runPostStepLlmCall.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Post-step (audit / polish / scoping / utility) LLM calls via `@exellix/xynthesis` `executeXynthesisAction`.
+ *
+ * Centralizes:
+ *   - Auto-sized `maxTokens` via `resolveLlmCallForXynthesis` (xynthesis `resolveMaxTokens`).
+ *   - Forwarding `tokenResolutionMetadata` and `executionMode: "trace"` (when a trace collector is supplied).
+ *   - Lifting `result.invokeSummary` into a structured `LlmCallObservation`.
+ *   - Pass-through of upstream typed errors (`XynthesisInvokeError`, `XynthesisResponseParseError`).
+ *   - Wrapping raw `setTimeout`-style timeouts with `LlmCallContextError` on the production path only.
+ *
+ * Tests mock the LLM via `@exellix/xynthesis` `setSynthesisInvoker`, not this module.
+ */
+import type { DebugTraceCollector } from "../observability/debugTrace.js";
+import type { DebugTraceTask } from "../types/task-types.js";
+import type { InvokeAttemptSummary, LlmCallConfig, LlmCallObservation, LlmCallStage, OutputExpectation, XynthesisDebugTrace } from "../types/llmCall.js";
+export type RunPostStepLlmCallParams = {
+    systemPrompt: string;
+    userPrompt: string;
+    /**
+     * Optional extra material concatenated with `systemPrompt` + `userPrompt` for the auto-sizer's `inputText`.
+     */
+    extraMaterial?: string;
+    /** Per-stage default `outputExpectation` when neither `llmCall.outputExpectation` nor an action-default applies. */
+    outputExpectationDefault?: OutputExpectation;
+    /** Caller-supplied LLM config (model / cap / temperature / topP / outputExpectation / timeoutMs / maxOutputLength). */
+    llmCall?: LlmCallConfig;
+    /** Drives stage-default `outputExpectation` selection in `resolveLlmCallForXynthesis`. */
+    stage?: LlmCallStage;
+    stepId?: string;
+    structuredOutput?: boolean;
+    jobId?: string;
+    taskId?: string;
+    agentId?: string;
+    traceCollector?: DebugTraceCollector | null;
+    traceTask?: Omit<DebugTraceTask, "metadata"> & {
+        metadata?: Record<string, unknown>;
+    };
+    observationSink?: (obs: LlmCallObservation) => void;
+};
+export type RunPostStepLlmCallResult = {
+    text: string;
+    raw?: unknown;
+    usage?: unknown;
+    model?: string;
+    invokeSummary?: InvokeAttemptSummary;
+    debugTrace?: XynthesisDebugTrace;
+};
+/**
+ * Single completion: system + user → text via xynthesis `executeXynthesisAction` (nested request shape).
+ */
+export declare function runPostStepLlmCall(params: RunPostStepLlmCallParams): Promise<RunPostStepLlmCallResult>;
+//# sourceMappingURL=runPostStepLlmCall.d.ts.map

package/dist/internal/runPostStepLlmCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPostStepLlmCall.d.ts","sourceRoot":"","sources":["../../src/internal/runPostStepLlmCall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oHAAoH;IACpH,wBAAwB,CAAC,EAAE,iBAAiB,CAAC;IAC7C,uHAAuH;IACvH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACtF,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC,CAAC;AAMF;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAyJ5G"}