@exellix/ai-tasks 7.8.0

package/dist/types/evidence-types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Generic evidence collection contract (domain-agnostic).
+ *
+ * This contract is intentionally independent of NARRIX semantics.
+ * It is designed for staged graph execution where nodes can collect
+ * reusable evidence for downstream consumption.
+ */
+export type EvidenceRequestInputKind = "query" | "url" | "entity" | "mixed";
+export type EvidenceRequestStatus = "success" | "partial" | "empty" | "failed";
+export type EvidenceRequest = {
+    kind?: string;
+    query?: string;
+    url?: string;
+    entity?: Record<string, unknown>;
+    hints?: string[];
+};
+export type EvidencePolicy = {
+    maxRequests?: number;
+    maxSourcesPerRequest?: number;
+    maxTotalSources?: number;
+    freshnessDays?: number;
+    allowedDomains?: string[];
+    blockedDomains?: string[];
+    includeSnippets?: boolean;
+    includeRawContent?: boolean | "markdown";
+    maxSnippetCharsPerSource?: number;
+    maxTotalSnippetChars?: number;
+};
+export type EvidenceFactSchemaField = {
+    key: string;
+    description?: string;
+    required?: boolean;
+};
+export type EvidenceExtractionConfig = {
+    factSchema?: EvidenceFactSchemaField[];
+    returnSummary?: boolean;
+    returnFacts?: boolean;
+    returnCoverage?: boolean;
+};
+export type EvidenceCollectionContext = {
+    preparedContext?: Record<string, unknown>;
+    variables?: Record<string, unknown>;
+};
+export type EvidenceCollectionInput = {
+    requests?: EvidenceRequest[];
+    policy?: EvidencePolicy;
+    extraction?: EvidenceExtractionConfig;
+    context?: EvidenceCollectionContext;
+};
+export type EvidenceCoverage = {
+    sufficient?: boolean;
+    missing?: string[];
+};
+export type EvidenceBundleRequestResult = {
+    requestId: string;
+    inputKind: EvidenceRequestInputKind;
+    normalizedQuery?: string;
+    normalizedUrl?: string;
+    status: EvidenceRequestStatus;
+    sourceCount: number;
+    factCount?: number;
+    coverage?: EvidenceCoverage;
+};
+export type EvidenceFact = {
+    key: string;
+    value: unknown;
+    confidence?: number;
+    sourceRefs?: string[];
+};
+export type EvidenceSource = {
+    sourceId: string;
+    url: string;
+    title?: string;
+    domain?: string;
+    retrievedAt?: string;
+    snippet?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+};
+export type EvidenceBundleValue = {
+    requests: EvidenceBundleRequestResult[];
+    facts?: EvidenceFact[];
+    sources?: EvidenceSource[];
+    summary?: string;
+    meta?: {
+        totalRequests: number;
+        totalSources: number;
+        totalFacts?: number;
+        durationMs?: number;
+    };
+};
+export type EvidenceBundleError = {
+    code: string;
+    message: string;
+    requestId?: string;
+};
+export type EvidenceBundleWarning = {
+    code: string;
+    message: string;
+    requestId?: string;
+};
+export type EvidenceBundle = {
+    ok: boolean;
+    value?: EvidenceBundleValue;
+    errors?: EvidenceBundleError[];
+    warnings?: EvidenceBundleWarning[];
+};
+//# sourceMappingURL=evidence-types.d.ts.map

package/dist/types/evidence-types.d.ts.map

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

package/dist/types/evidence-types.js

@@ -0,0 +1,9 @@
+/**
+ * Generic evidence collection contract (domain-agnostic).
+ *
+ * This contract is intentionally independent of NARRIX semantics.
+ * It is designed for staged graph execution where nodes can collect
+ * reusable evidence for downstream consumption.
+ */
+export {};
+//# sourceMappingURL=evidence-types.js.map

package/dist/types/evidence-types.js.map

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

package/dist/types/executionType.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Gateway execution classification forwarded on `RunSkillRequest.executionType`.
+ * Direct MAIN uses {@link ExecutionType.DIRECT}.
+ */
+export declare const ExecutionType: {
+    readonly DIRECT: "direct";
+};
+export type ExecutionTypeValue = (typeof ExecutionType)[keyof typeof ExecutionType];
+//# sourceMappingURL=executionType.d.ts.map

package/dist/types/executionType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionType.d.ts","sourceRoot":"","sources":["../../src/types/executionType.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,aAAa;;CAEhB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/dist/types/executionType.js

@@ -0,0 +1,8 @@
+/**
+ * Gateway execution classification forwarded on `RunSkillRequest.executionType`.
+ * Direct MAIN uses {@link ExecutionType.DIRECT}.
+ */
+export const ExecutionType = {
+    DIRECT: "direct",
+};
+//# sourceMappingURL=executionType.js.map

package/dist/types/executionType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionType.js","sourceRoot":"","sources":["../../src/types/executionType.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Type definitions and re-exports
+ *
+ * Central location for all type exports from the SDK.
+ */
+export type { RunTaskRequest, RunTaskResponse, RunTaskTraceResponse, DebugTraceTask } from "./task-types.js";
+export type { RunSkillResponse } from "./task-types.js";
+export type { RunTaskResponseTraceMetadata, AiScopingFailureRecord, ExecutionStrategyInvocation, ExecutionStrategyPhase, ExecutionStrategyWrapperKey, } from "./task-types.js";
+export type { LlmCallConfig, LlmCallObservation, LlmCallStage, LlmCallRequestSnapshot, LlmCallError, OutputExpectation, MaxTokensResolution, InvokeAttemptSummary, UsageDiagnostics, RoutingDiagnostics, XynthesisDebugTrace, SkillDiagnosticsTrace, SkillTraceUsage, RunSkillDiagnostics, } from "./llmCall.js";
+export { LlmCallContextError, XynthesisInvokeError, XynthesisResponseParseError, SkillExecutionTraceError, } from "./llmCall.js";
+export { SmartInputValidationError, SMART_INPUT_VALIDATION_ERROR_NAME, isSmartInputValidationError, formatSmartInputValidationMessage, throwSmartInputValidationError, } from "../errors/smartInputValidationError.js";
+export type { SmartInputValidationErrorCode, SmartInputValidationErrorDetails, } from "../errors/smartInputValidationError.js";
+export type { DecideWebScopeOutput, DecideWebScopeReasonCode, DecideWebScopeMissingSignal, } from "./decision-contracts.js";
+export { DecideWebScopeReasonCode as DecideWebScopeReasonCodes, DecideWebScopeMissingSignal as DecideWebScopeMissingSignals, } from "./decision-contracts.js";
+export type { EvidenceCollectionInput, EvidenceBundle, EvidenceRequest, EvidencePolicy, EvidenceExtractionConfig, EvidenceRequestInputKind, EvidenceRequestStatus, EvidenceBundleValue, EvidenceBundleRequestResult, EvidenceSource, EvidenceFact, EvidenceCoverage, EvidenceBundleError, EvidenceBundleWarning, } from "./evidence-types.js";
+export { ExecutionType } from "./executionType.js";
+export type { ExecutionTypeValue } from "./executionType.js";
+export { NARRIX_THEN_DIRECT } from "./task-types.js";
+export type { SynthesisInput, SynthesizedItem, SynthesizedContext, SynthesizedPromptPayload, ContextSynthesizer, } from "@exellix/xynthesis";
+export type { TaskStrategyCatalogDefinition, TaskStrategyItemData } from "../task-strategies/types.js";
+export type { XynthesizedMemory, SmartInputConfig, SmartInputRenderOptions, SmartInputRenderResult, RunTaskSmartInput, XynthesizedDestinationScope, XynthesizedOutputConfig, TaskMemoryNarrixEntry, NarrixScope, NarrixWebScopeQuestion, NarrixPreProcessorConfig, ExecutionHistory, UtilityExecutionPolicy, RunUtilityRequest, RunUtilityResponse, XynthesisFinalizeUtilityRequest, XynthesisFinalizeUtilityInput, AIScopingInstruction, AIScopedItem, AIScoped, IntermediateStep, IntermediateSteps, RunTaskResponseWithSteps, ExecutionPhase, ExecutionStep, ContextSourcePolicy, WebEvidenceConfig, SynthesisConfig, SynthesisInputStrategy, PostCoreTaskStrategyKey, SynthesisMode, TaskCore, SynthesizedContextArtifact, QuestionDrivenSynthesizedContext, AnySynthesizedContextArtifact, SynthesizedInputArtifact, AuditConfig, AuditCheck, AuditResult, AuditCheckResult, AuditLLMOutput, AuditPostStepMetadata, PolishConfig, PolishChecklistItem, PolishLLMOutput, PolishPostStepMetadata, RunTaskResponsePostStepsMetadata, OutputSchema, AiTasksObservabilityDigest, } from "./task-types.js";
+export { SYNTHESIZED_CONTEXT } from "./task-types.js";
+export type { NarrixModeKey } from "../task-strategies/canonicalNarrixModes.js";
+export type { InputStrategyKey, ExecutionStrategyKey } from "../task-strategies/canonicalInputExecutionStrategies.js";
+export type { NarrixRunInput, NarrixEnrichedAttachment } from "../narrix/types.js";
+export type { ExellixSkillsClientOptions as WorexClientSkillsOptions, RunSkillRequest, ModelConfig, TemplateRenderOptions, GatewayTemplateTokens, } from "@exellix/ai-skills";
+export type { JobHistory, TaskHistory } from "@x12i/execution-memory-manager";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,12 @@
+/**
+ * Type definitions and re-exports
+ *
+ * Central location for all type exports from the SDK.
+ */
+export { LlmCallContextError, XynthesisInvokeError, XynthesisResponseParseError, SkillExecutionTraceError, } from "./llmCall.js";
+export { SmartInputValidationError, SMART_INPUT_VALIDATION_ERROR_NAME, isSmartInputValidationError, formatSmartInputValidationMessage, throwSmartInputValidationError, } from "../errors/smartInputValidationError.js";
+export { DecideWebScopeReasonCode as DecideWebScopeReasonCodes, DecideWebScopeMissingSignal as DecideWebScopeMissingSignals, } from "./decision-contracts.js";
+export { ExecutionType } from "./executionType.js";
+export { NARRIX_THEN_DIRECT } from "./task-types.js";
+export { SYNTHESIZED_CONTEXT } from "./task-types.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,2BAA2B,EAC3B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,wCAAwC,CAAC;AAUhD,OAAO,EACL,wBAAwB,IAAI,yBAAyB,EACrD,2BAA2B,IAAI,4BAA4B,GAC5D,MAAM,yBAAyB,CAAC;AAiBjC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AA4DrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/llmCall.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Shared LLM call configuration + observation types.
+ *
+ * Lean wrapper over upstream primitives from `@exellix/xynthesis` and `@exellix/ai-skills`.
+ *
+ * - `LlmCallConfig` is the caller-facing knob shape every stage accepts (PRE / MAIN / POST / scoping / utility).
+ * - `LlmCallObservation` is a discriminated union over the upstream payload (xynthesis `InvokeAttemptSummary` /
+ *   ai-skills `RunSkillDiagnostics`) so consumers see one coherent surface without duplicate types.
+ * - Upstream typed errors are re-exported as-is. `LlmCallContextError` is the thin ai-tasks-side wrapper for the
+ *   few sites where the upstream still throws untyped (e.g. `runSkill` outside trace mode, AIGateway repair fallback,
+ *   `setTimeout` "Scoping call timeout" path).
+ *
+ * `usage`, `routing`, `costUsd`, `modelUsed` on success arrive for free in `RunSynthesisResult.invokeSummary` —
+ * we never invent a parallel set of types here.
+ */
+import type { OutputExpectation, MaxTokensResolution } from "@exellix/xynthesis/ai-actions";
+import type { InvokeAttemptSummary, UsageDiagnostics, RoutingDiagnostics, DebugTrace as XynthesisDebugTrace } from "@exellix/xynthesis";
+import type { SkillDiagnosticsTrace, SkillTraceUsage, RunSkillDiagnostics } from "@exellix/ai-skills";
+import { XynthesisInvokeError, XynthesisResponseParseError } from "@exellix/xynthesis/ai-actions";
+import { SkillExecutionTraceError } from "@exellix/ai-skills";
+/**
+ * Caller-facing config for any LLM call ai-tasks orchestrates (per stage / per call).
+ *
+ * `maxTokensCap` is a HARD CEILING on xynthesis `resolveMaxTokens` (`callerMaxTokens` in upstream). The auto-sizer
+ * still runs and may pick a smaller value; the cap only constrains the upper bound.
+ *
+ * `outputExpectation` drives the auto-sizer: it tells xynthesis how big the output is expected to be, in absolute
+ * words or as a ratio of the input. When omitted, ai-tasks picks a per-stage default via xynthesis
+ * `resolveOutputExpectation(actionType)` or a stage-local default (e.g. AI scoping uses a small absolute size).
+ */
+export interface LlmCallConfig {
+    /** Model id / pick (forwarded to xynthesis `resolveModel` / ai-skills `runSkill`). */
+    model?: string;
+    /** Hard ceiling on the auto-resolved max tokens (acts as `callerMaxTokens` in xynthesis `resolveMaxTokens`). */
+    maxTokensCap?: number;
+    /** Sampling temperature. Honored on MAIN today (ai-skills `ModelConfig`); pending in xynthesis (Track C). */
+    temperature?: number;
+    /** Top-p nucleus sampling. Same honoring as `temperature`. */
+    topP?: number;
+    /** Char-based output truncation applied AFTER the call returns. */
+    maxOutputLength?: number;
+    /** Per-call timeout in milliseconds. */
+    timeoutMs?: number;
+    /**
+     * Drives xynthesis `resolveMaxTokens`. When omitted, ai-tasks picks a per-stage default via
+     * `resolveOutputExpectation(actionType)` (synthesis / audit / fix / craft-final / pick-best) or a
+     * stage-local default (scoping uses a small absolute size).
+     */
+    outputExpectation?: OutputExpectation;
+}
+/**
+ * Stage tag used in observations so consumers can filter by where the call originated.
+ * Aligns with the per-stage call sites in ai-tasks.
+ */
+export type LlmCallStage = "pre-synthesis-markdown" | "pre-synthesis-question" | "pre-synthesis-structured" | "main-skill" | "post-audit" | "post-audit-merge" | "post-polish" | "ai-scoping" | "plan-web-scope-questions" | "utility-finalize" | "structured-repair";
+/**
+ * Snapshot of the request as it was resolved on the ai-tasks side, including the result of
+ * xynthesis `resolveMaxTokens` (when applicable) so consumers can see what was asked vs what was used.
+ */
+export type LlmCallRequestSnapshot = LlmCallConfig & {
+    /** Resolution from xynthesis `resolveMaxTokens` (when ai-tasks ran the auto-sizer for this call). */
+    tokenResolution?: MaxTokensResolution;
+};
+/**
+ * Single LLM call observation; discriminated by `source` so consumers can lift the right typed payload.
+ *
+ * - `xynthesis`: covers PRE synthesis, POST audit / polish, AI scoping, utility finalize, structured-repair.
+ *   Carries `summary: InvokeAttemptSummary` (always present on success) and optionally `debugTrace`
+ *   (when `executionMode: "trace"` was forwarded).
+ * - `ai-skills`: covers MAIN skill execution. Carries `diagnostics: RunSkillDiagnostics` (only when
+ *   `executionMode: "trace"` was forwarded; else absent).
+ */
+export type LlmCallObservation = {
+    source: "xynthesis";
+    stage: LlmCallStage;
+    stepId?: string;
+    request: LlmCallRequestSnapshot;
+    /** Always present on success. On failure, lifted from `XynthesisInvokeError.invokeSummary` when available. */
+    summary?: InvokeAttemptSummary;
+    /** Verbatim from xynthesis when `executionMode: "trace"` was forwarded. */
+    debugTrace?: XynthesisDebugTrace;
+    durationMs: number;
+    ok: boolean;
+    error?: {
+        name: string;
+        message: string;
+    };
+} | {
+    source: "ai-skills";
+    stage: "main-skill";
+    stepId?: string;
+    request: LlmCallRequestSnapshot;
+    /** Present only when `executionMode: "trace"` was forwarded; carries `trace` + `invokeRequest` echo. */
+    diagnostics?: RunSkillDiagnostics;
+    durationMs: number;
+    ok: boolean;
+    error?: {
+        name: string;
+        message: string;
+    };
+};
+/**
+ * Thin ai-tasks-side error wrapper for the few sites where the upstream still throws an untyped error
+ * (e.g. `runSkill` outside trace mode, AIGateway repair fallback, `setTimeout` "Scoping call timeout").
+ *
+ * Carries the same `LlmCallObservation` shape so trace consumers handle it uniformly with
+ * `XynthesisInvokeError` / `XynthesisResponseParseError` / `SkillExecutionTraceError`.
+ */
+export declare class LlmCallContextError extends Error {
+    readonly observation: LlmCallObservation;
+    readonly cause?: unknown;
+    constructor(message: string, observation: LlmCallObservation, cause?: unknown);
+}
+/**
+ * Union of typed errors any LLM-orchestrated call site in ai-tasks can throw. Catchers can narrow on `name`
+ * or `instanceof` per upstream class.
+ */
+export type LlmCallError = XynthesisInvokeError | XynthesisResponseParseError | SkillExecutionTraceError | LlmCallContextError;
+export { XynthesisInvokeError, XynthesisResponseParseError, SkillExecutionTraceError };
+export type { OutputExpectation, MaxTokensResolution, InvokeAttemptSummary, UsageDiagnostics, RoutingDiagnostics, XynthesisDebugTrace, SkillDiagnosticsTrace, SkillTraceUsage, RunSkillDiagnostics, };
+//# sourceMappingURL=llmCall.d.ts.map

package/dist/types/llmCall.d.ts.map

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

package/dist/types/llmCall.js

@@ -0,0 +1,39 @@
+/**
+ * Shared LLM call configuration + observation types.
+ *
+ * Lean wrapper over upstream primitives from `@exellix/xynthesis` and `@exellix/ai-skills`.
+ *
+ * - `LlmCallConfig` is the caller-facing knob shape every stage accepts (PRE / MAIN / POST / scoping / utility).
+ * - `LlmCallObservation` is a discriminated union over the upstream payload (xynthesis `InvokeAttemptSummary` /
+ *   ai-skills `RunSkillDiagnostics`) so consumers see one coherent surface without duplicate types.
+ * - Upstream typed errors are re-exported as-is. `LlmCallContextError` is the thin ai-tasks-side wrapper for the
+ *   few sites where the upstream still throws untyped (e.g. `runSkill` outside trace mode, AIGateway repair fallback,
+ *   `setTimeout` "Scoping call timeout" path).
+ *
+ * `usage`, `routing`, `costUsd`, `modelUsed` on success arrive for free in `RunSynthesisResult.invokeSummary` —
+ * we never invent a parallel set of types here.
+ */
+import { XynthesisInvokeError, XynthesisResponseParseError } from "@exellix/xynthesis/ai-actions";
+import { SkillExecutionTraceError } from "@exellix/ai-skills";
+/**
+ * Thin ai-tasks-side error wrapper for the few sites where the upstream still throws an untyped error
+ * (e.g. `runSkill` outside trace mode, AIGateway repair fallback, `setTimeout` "Scoping call timeout").
+ *
+ * Carries the same `LlmCallObservation` shape so trace consumers handle it uniformly with
+ * `XynthesisInvokeError` / `XynthesisResponseParseError` / `SkillExecutionTraceError`.
+ */
+export class LlmCallContextError extends Error {
+    observation;
+    cause;
+    constructor(message, observation, cause) {
+        super(message);
+        this.name = "LlmCallContextError";
+        this.observation = observation;
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+    }
+}
+// Re-export upstream typed errors so consumers can `import { XynthesisInvokeError } from "@exellix/ai-tasks"`.
+export { XynthesisInvokeError, XynthesisResponseParseError, SkillExecutionTraceError };
+//# sourceMappingURL=llmCall.js.map

package/dist/types/llmCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmCall.js","sourceRoot":"","sources":["../../src/types/llmCall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AA8F9D;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,WAAW,CAAqB;IAChC,KAAK,CAAW;IACzB,YAAY,OAAe,EAAE,WAA+B,EAAE,KAAe;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACvB,IAA4B,CAAC,KAAK,GAAG,KAAK,CAAC;QAC9C,CAAC;IACH,CAAC;CACF;AAYD,+GAA+G;AAC/G,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/types/task-configuration.d.ts

@@ -0,0 +1,60 @@
+import type { ModelConfig } from "@exellix/ai-skills";
+import type { TaskStrategyKey } from "../task-strategies/canonicalTaskStrategies.js";
+import type { LlmCallConfig } from "./llmCall.js";
+import type { ExecutionStep, SynthesisMode } from "./task-types.js";
+/** Token on `aiTaskStrategies.pre` that enables PRE `synthesized-context` (not an input-strategy key). */
+export declare const AI_TASK_PRE_ENABLE_SYNTHESIS: "synthesis";
+/**
+ * Graph TaskNode `taskConfiguration.aiTaskStrategies` (authoring).
+ * Compiled by {@link compileTaskConfigurationOnRunTaskRequest} into `executionPipeline` + `includeContextInPrompt`.
+ */
+export interface AiTaskStrategiesAuthoring {
+    /**
+     * PRE enablement and/or input-strategy hint.
+     * - `"synthesis"` or array containing `"synthesis"` → insert PRE `synthesized-context`.
+     * - A pre-core strategy key alone (`task-memory-only`, `policy`, …) sets `synthesisInputStrategy` only (does not enable PRE unless `inputSynthesis.enabled`).
+     */
+    pre?: string | string[];
+    /** Explicit pre-core input strategy for the PRE step (`SynthesisConfig.synthesisInputStrategy`). */
+    preInputStrategy?: TaskStrategyKey | (string & {});
+    post?: string | string[];
+}
+export interface InputSynthesisAuthoring {
+    enabled?: boolean;
+    sources?: string[];
+    destination?: "job" | "task" | "execution";
+    outputKey?: string;
+    mode?: "replace" | "merge";
+    synthesisMode?: SynthesisMode;
+    alsoWriteLegacySynthesizedContext?: boolean;
+}
+export interface AiTaskProfileAuthoring {
+    inputSynthesis?: InputSynthesisAuthoring;
+    webScoping?: Record<string, unknown>;
+    preStrategyKey?: string;
+    postStrategyKey?: string;
+}
+/**
+ * Graph node `taskConfiguration` blob forwarded by graph-engine on {@link RunTaskRequest}.
+ * Stripped after compile; lifted fields on the request take precedence when already set.
+ */
+export interface TaskConfigurationAuthoring {
+    aiTaskStrategies?: AiTaskStrategiesAuthoring;
+    aiTaskProfile?: AiTaskProfileAuthoring;
+    /** Explicit pipeline; must not conflict with generated PRE from `inputSynthesis` / `aiTaskStrategies.pre: synthesis`. */
+    executionPipeline?: ExecutionStep[];
+    modelConfig?: ModelConfig;
+    llmCall?: LlmCallConfig;
+    timeoutMs?: number;
+    narrix?: Record<string, unknown>;
+    executionStrategies?: import("./task-types.js").ExecutionStrategyInvocation[];
+    [key: string]: unknown;
+}
+export type CompileTaskConfigurationResult = {
+    request: import("./task-types.js").RunTaskRequest;
+    /** True when a PRE synthesized-context step was added or already present from compile. */
+    preSynthesisEnabled: boolean;
+    /** Warnings for hosts (non-fatal). */
+    warnings: string[];
+};
+//# sourceMappingURL=task-configuration.d.ts.map

package/dist/types/task-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-configuration.d.ts","sourceRoot":"","sources":["../../src/types/task-configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEpE,0GAA0G;AAC1G,eAAO,MAAM,4BAA4B,EAAG,WAAoB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,eAAe,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,iCAAiC,CAAC,EAAE,OAAO,CAAC;CAC7C;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,yHAAyH;IACzH,iBAAiB,CAAC,EAAE,aAAa,EAAE,CAAC;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,mBAAmB,CAAC,EAAE,OAAO,iBAAiB,EAAE,2BAA2B,EAAE,CAAC;IAC9E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,OAAO,iBAAiB,EAAE,cAAc,CAAC;IAClD,0FAA0F;IAC1F,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC"}

package/dist/types/task-configuration.js

@@ -0,0 +1,3 @@
+/** Token on `aiTaskStrategies.pre` that enables PRE `synthesized-context` (not an input-strategy key). */
+export const AI_TASK_PRE_ENABLE_SYNTHESIS = "synthesis";
+//# sourceMappingURL=task-configuration.js.map

package/dist/types/task-configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-configuration.js","sourceRoot":"","sources":["../../src/types/task-configuration.ts"],"names":[],"mappings":"AAKA,0GAA0G;AAC1G,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAoB,CAAC"}