@exellix/ai-tasks 7.8.0

package/dist/utils/normalizeSmartInputConfig.js

@@ -0,0 +1,30 @@
+function strictFromSmartInput(smartInput) {
+    if (typeof smartInput !== "object" || smartInput === null || !("strict" in smartInput)) {
+        return undefined;
+    }
+    const strict = smartInput.strict;
+    return typeof strict === "boolean" ? strict : undefined;
+}
+/** Canonical Rendrix shape for gateway / ai-skills (legacy `paths: string[]` expanded). */
+export function normalizeSmartInputConfig(smartInput) {
+    const strict = strictFromSmartInput(smartInput);
+    const paths = smartInput.paths;
+    if (!Array.isArray(paths)) {
+        return strict !== undefined ? { paths: [], strict } : { paths: [] };
+    }
+    if (paths.length === 0) {
+        return strict !== undefined ? { paths: [], strict } : { paths: [] };
+    }
+    const first = paths[0];
+    if (typeof first === "string") {
+        return {
+            paths: paths.map((p) => ({ title: p, path: p })),
+            ...(strict !== undefined ? { strict } : {}),
+        };
+    }
+    return {
+        paths: paths,
+        ...(strict !== undefined ? { strict } : {}),
+    };
+}
+//# sourceMappingURL=normalizeSmartInputConfig.js.map

package/dist/utils/normalizeSmartInputConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeSmartInputConfig.js","sourceRoot":"","sources":["../../src/utils/normalizeSmartInputConfig.ts"],"names":[],"mappings":"AAGA,SAAS,oBAAoB,CAAC,UAA6B;IACzD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,EAAE,CAAC;QACvF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAI,UAAmC,CAAC,MAAM,CAAC;IAC3D,OAAO,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yBAAyB,CAAC,UAA6B;IACrE,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAY,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,KAAK,EAAG,KAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9D,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAkC;QACzC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/utils/outputValidation.d.ts

@@ -0,0 +1,19 @@
+import type { OutputSchema } from "../types/task-types.js";
+/** Stable machine-readable codes for graph `outputValidation` and observability. */
+export type OutputValidationErrorCode = "TYPE_MISMATCH" | "MISSING_REQUIRED" | "MIN_ITEMS" | "MAX_ITEMS" | "ADDITIONAL_PROPERTY";
+export type OutputValidationErrorItem = {
+    path: string;
+    message: string;
+    code: OutputValidationErrorCode;
+};
+export type OutputValidationResult = {
+    ok: boolean;
+    errors: OutputValidationErrorItem[];
+    /**
+     * When set by the task runtime, matches `metadata.taskId` for the same `runTask()` invocation.
+     */
+    correlationId?: string;
+};
+/** Validates `parsed` against `OutputSchema`. Does not set `correlationId` — only `runTask()` attaches that on `metadata.outputValidation`. */
+export declare function validateParsedOutput(parsed: unknown, schema: OutputSchema): OutputValidationResult;
+//# sourceMappingURL=outputValidation.d.ts.map

package/dist/utils/outputValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputValidation.d.ts","sourceRoot":"","sources":["../../src/utils/outputValidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,oFAAoF;AACpF,MAAM,MAAM,yBAAyB,GACjC,eAAe,GACf,kBAAkB,GAClB,WAAW,GACX,WAAW,GACX,qBAAqB,CAAC;AAE1B,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,yBAAyB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAwEF,+IAA+I;AAC/I,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,sBAAsB,CAIlG"}

package/dist/utils/outputValidation.js

@@ -0,0 +1,75 @@
+function typeOf(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+function pushErr(errors, path, message, code) {
+    errors.push({ path, message, code });
+}
+function validate(value, schema, path, errors) {
+    const t = typeOf(value);
+    switch (schema.type) {
+        case "any":
+            return;
+        case "string":
+        case "number":
+        case "boolean":
+        case "null": {
+            if (t !== schema.type)
+                pushErr(errors, path, `expected ${schema.type}, got ${t}`, "TYPE_MISMATCH");
+            return;
+        }
+        case "array": {
+            if (t !== "array") {
+                pushErr(errors, path, `expected array, got ${t}`, "TYPE_MISMATCH");
+                return;
+            }
+            const arr = value;
+            if (schema.minItems !== undefined && arr.length < schema.minItems) {
+                pushErr(errors, path, `expected minItems ${schema.minItems}, got ${arr.length}`, "MIN_ITEMS");
+            }
+            if (schema.maxItems !== undefined && arr.length > schema.maxItems) {
+                pushErr(errors, path, `expected maxItems ${schema.maxItems}, got ${arr.length}`, "MAX_ITEMS");
+            }
+            if (schema.items) {
+                for (let i = 0; i < arr.length; i++)
+                    validate(arr[i], schema.items, `${path}[${i}]`, errors);
+            }
+            return;
+        }
+        case "object": {
+            if (t !== "object") {
+                pushErr(errors, path, `expected object, got ${t}`, "TYPE_MISMATCH");
+                return;
+            }
+            const obj = value;
+            const required = Array.isArray(schema.required) ? schema.required : [];
+            for (const k of required) {
+                if (!(k in obj))
+                    pushErr(errors, `${path}.${k}`, "missing required property", "MISSING_REQUIRED");
+            }
+            const props = schema.properties ?? {};
+            for (const [k, s] of Object.entries(props)) {
+                if (k in obj)
+                    validate(obj[k], s, `${path}.${k}`, errors);
+            }
+            if (schema.additionalProperties === false) {
+                const allowed = new Set(Object.keys(props));
+                for (const k of Object.keys(obj)) {
+                    if (!allowed.has(k))
+                        pushErr(errors, `${path}.${k}`, "additional property not allowed", "ADDITIONAL_PROPERTY");
+                }
+            }
+            return;
+        }
+    }
+}
+/** Validates `parsed` against `OutputSchema`. Does not set `correlationId` — only `runTask()` attaches that on `metadata.outputValidation`. */
+export function validateParsedOutput(parsed, schema) {
+    const errors = [];
+    validate(parsed, schema, "parsed", errors);
+    return { ok: errors.length === 0, errors };
+}
+//# sourceMappingURL=outputValidation.js.map

package/dist/utils/outputValidation.js.map

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

package/dist/utils/runTaskRequestShape.d.ts

@@ -0,0 +1,16 @@
+import type { ExecutionStep, RunTaskRequest } from "../types/task-types.js";
+/** When set, `runTask` logs structured JSON lines for ignored pipeline steps. */
+export declare function isRunTaskRequestWarningsEnabled(): boolean;
+/**
+ * Pure analysis: duplicate mirrors and other shapes hosts should migrate away from.
+ * Does not mutate the request.
+ */
+export declare function collectRunTaskRequestWarnings(_req: RunTaskRequest): string[];
+/**
+ * Pipeline steps that are ignored or partially executed at runtime (see RUNTASK_REQUEST.md).
+ */
+export declare function collectExecutionPipelineWarnings(pipeline: ExecutionStep[] | undefined): string[];
+/** Canonical request clone (applies taskConfiguration compile when present). */
+export declare function normalizeRunTaskRequest(req: RunTaskRequest): RunTaskRequest;
+export declare function emitRunTaskRequestWarnings(req: RunTaskRequest): void;
+//# sourceMappingURL=runTaskRequestShape.d.ts.map

package/dist/utils/runTaskRequestShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTaskRequestShape.d.ts","sourceRoot":"","sources":["../../src/utils/runTaskRequestShape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM5E,iFAAiF;AACjF,wBAAgB,+BAA+B,IAAI,OAAO,CAGzD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAE5E;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,GACpC,MAAM,EAAE,CA0BV;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,cAAc,CAE3E;AAwBD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAqBpE"}

package/dist/utils/runTaskRequestShape.js

@@ -0,0 +1,80 @@
+import { SYNTHESIZED_CONTEXT } from "../types/task-types.js";
+import { compileTaskConfigurationOnRunTaskRequest } from "../compile/compileTaskConfiguration.js";
+const WARN_ENV_KEYS = new Set(["1", "true", "yes"]);
+/** When set, `runTask` logs structured JSON lines for ignored pipeline steps. */
+export function isRunTaskRequestWarningsEnabled() {
+    const v = process.env.AI_TASKS_REQUEST_WARNINGS?.trim().toLowerCase();
+    return v !== undefined && WARN_ENV_KEYS.has(v);
+}
+/**
+ * Pure analysis: duplicate mirrors and other shapes hosts should migrate away from.
+ * Does not mutate the request.
+ */
+export function collectRunTaskRequestWarnings(_req) {
+    return [];
+}
+/**
+ * Pipeline steps that are ignored or partially executed at runtime (see RUNTASK_REQUEST.md).
+ */
+export function collectExecutionPipelineWarnings(pipeline) {
+    if (!pipeline?.length)
+        return [];
+    const warnings = [];
+    const pre = pipeline.filter((s) => s.phase === "pre");
+    const synthPre = pre.filter((s) => s.type === SYNTHESIZED_CONTEXT);
+    if (synthPre.length > 1) {
+        warnings.push(`executionPipeline: ${synthPre.length} PRE steps with type "${SYNTHESIZED_CONTEXT}"; only the first is executed — consolidate extra PRE steps.`);
+    }
+    for (const s of pre) {
+        if (s.type !== SYNTHESIZED_CONTEXT) {
+            warnings.push(`executionPipeline: PRE step type "${String(s.type)}" is not supported — runTask throws at execution (only "${SYNTHESIZED_CONTEXT}" is allowed).`);
+        }
+    }
+    const post = pipeline.filter((s) => s.phase === "post");
+    for (const s of post) {
+        if (s.type !== "audit" && s.type !== "polish") {
+            warnings.push(`executionPipeline: POST step type "${String(s.type)}" is not supported — ignored (only "audit" and "polish").`);
+        }
+    }
+    return warnings;
+}
+/** Canonical request clone (applies taskConfiguration compile when present). */
+export function normalizeRunTaskRequest(req) {
+    return compileTaskConfigurationOnRunTaskRequest(req).request;
+}
+function collectRunTaskObservabilityHints(req) {
+    if (req.executionMode === "trace")
+        return [];
+    const hints = [];
+    const pipe = req.executionPipeline;
+    if (pipe?.some((s) => s.phase === "pre" && s.type === SYNTHESIZED_CONTEXT)) {
+        hints.push('Observability: PRE "synthesized-context" invokes xynthesis; use executionMode: "trace" for synthesis diagnostics.');
+    }
+    if (pipe?.some((s) => s.phase === "post" && (s.type === "audit" || s.type === "polish"))) {
+        hints.push('Observability: POST audit/polish invokes xynthesis; use executionMode: "trace" for per-step LLM observations.');
+    }
+    if (req.aiScoping && req.aiScoping.length > 0) {
+        hints.push('Observability: aiScoping runs scoped LLM calls via xynthesis; use executionMode: "trace" where supported.');
+    }
+    return hints;
+}
+export function emitRunTaskRequestWarnings(req) {
+    if (!isRunTaskRequestWarningsEnabled())
+        return;
+    const shapeMessages = [...collectRunTaskRequestWarnings(req), ...collectExecutionPipelineWarnings(req.executionPipeline)];
+    for (const message of shapeMessages) {
+        console.warn(JSON.stringify({
+            source: "@exellix/ai-tasks",
+            kind: "RunTaskRequestShape",
+            message,
+        }));
+    }
+    for (const message of collectRunTaskObservabilityHints(req)) {
+        console.warn(JSON.stringify({
+            source: "@exellix/ai-tasks",
+            kind: "RunTaskObservabilityHint",
+            message,
+        }));
+    }
+}
+//# sourceMappingURL=runTaskRequestShape.js.map

package/dist/utils/runTaskRequestShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTaskRequestShape.js","sourceRoot":"","sources":["../../src/utils/runTaskRequestShape.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,wCAAwC,EAAE,MAAM,wCAAwC,CAAC;AAElG,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAEpD,iFAAiF;AACjF,MAAM,UAAU,+BAA+B;IAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtE,OAAO,CAAC,KAAK,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAoB;IAChE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC9C,QAAqC;IAErC,IAAI,CAAC,QAAQ,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CACX,sBAAsB,QAAQ,CAAC,MAAM,yBAAyB,mBAAmB,8DAA8D,CAChJ,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CACX,qCAAqC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,2DAA2D,mBAAmB,gBAAgB,CAClJ,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CACX,sCAAsC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,2DAA2D,CAChH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,uBAAuB,CAAC,GAAmB;IACzD,OAAO,wCAAwC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED,SAAS,gCAAgC,CAAC,GAAmB;IAC3D,IAAI,GAAG,CAAC,aAAa,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,iBAAiB,CAAC;IACnC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,EAAE,CAAC;QAC3E,KAAK,CAAC,IAAI,CACR,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,EAAE,CAAC;QACzF,KAAK,CAAC,IAAI,CACR,+GAA+G,CAChH,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CACR,2GAA2G,CAC5G,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAmB;IAC5D,IAAI,CAAC,+BAA+B,EAAE;QAAE,OAAO;IAC/C,MAAM,aAAa,GAAG,CAAC,GAAG,6BAA6B,CAAC,GAAG,CAAC,EAAE,GAAG,gCAAgC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC1H,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CACV,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,mBAAmB;YAC3B,IAAI,EAAE,qBAAqB;YAC3B,OAAO;SACR,CAAC,CACH,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,gCAAgC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,IAAI,CACV,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,mBAAmB;YAC3B,IAAI,EAAE,0BAA0B;YAChC,OAAO;SACR,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/utils/skillTemplateVariables.d.ts

@@ -0,0 +1,20 @@
+import type { SmartInputConfig, RunTaskSmartInput, XynthesizedMemory } from "../types/task-types.js";
+/**
+ * Forwards the job/graph template bucket unchanged (shallow clone).
+ * Used by `runTask` MAIN — does not fold `input`, `jobContext`, or `executionMemory.taskVariables` into `variables`.
+ */
+export declare function passthroughJobTemplateVariables(variables: unknown): Record<string, unknown>;
+/**
+ * Merges caller fields into a single template `variables` map (optional host helper — **not** used on `runTask` MAIN).
+ *
+ * Normative precedence: see `RUNTASK_REQUEST.md`. Graph-engine 5.13+ should compile scopes into
+ * `variables` (job) + `executionMemory.taskVariables` instead of relying on this merge at invoke time.
+ */
+export declare function mergeSkillTemplateVariables(req: {
+    variables?: Record<string, unknown>;
+    input?: unknown;
+    jobContext?: Record<string, unknown>;
+    xynthesized?: XynthesizedMemory;
+    smartInput?: SmartInputConfig | RunTaskSmartInput;
+}): Record<string, unknown>;
+//# sourceMappingURL=skillTemplateVariables.d.ts.map

package/dist/utils/skillTemplateVariables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillTemplateVariables.d.ts","sourceRoot":"","sources":["../../src/utils/skillTemplateVariables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAErG;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK3F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;CACnD,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmD1B"}

package/dist/utils/skillTemplateVariables.js

@@ -0,0 +1,63 @@
+/**
+ * Forwards the job/graph template bucket unchanged (shallow clone).
+ * Used by `runTask` MAIN — does not fold `input`, `jobContext`, or `executionMemory.taskVariables` into `variables`.
+ */
+export function passthroughJobTemplateVariables(variables) {
+    if (variables && typeof variables === "object" && !Array.isArray(variables)) {
+        return { ...variables };
+    }
+    return {};
+}
+/**
+ * Merges caller fields into a single template `variables` map (optional host helper — **not** used on `runTask` MAIN).
+ *
+ * Normative precedence: see `RUNTASK_REQUEST.md`. Graph-engine 5.13+ should compile scopes into
+ * `variables` (job) + `executionMemory.taskVariables` instead of relying on this merge at invoke time.
+ */
+export function mergeSkillTemplateVariables(req) {
+    const job = req.jobContext && typeof req.jobContext === "object" && !Array.isArray(req.jobContext)
+        ? { ...req.jobContext }
+        : {};
+    const vars = req.variables && typeof req.variables === "object" && !Array.isArray(req.variables)
+        ? { ...req.variables }
+        : {};
+    const out = { ...job, ...vars };
+    if (out.xynthesized === undefined && req.xynthesized !== undefined) {
+        out.xynthesized = req.xynthesized;
+    }
+    if (out.smartInput === undefined && req.smartInput !== undefined) {
+        out.smartInput = req.smartInput;
+    }
+    const rawInput = req.input;
+    if (rawInput == null) {
+        return out;
+    }
+    if (typeof rawInput === "object" && !Array.isArray(rawInput)) {
+        const inp = rawInput;
+        const existing = out.inputs;
+        out.inputs =
+            existing && typeof existing === "object" && !Array.isArray(existing)
+                ? { ...existing, ...inp }
+                : { ...inp };
+        if (typeof inp.question === "string" && out.question === undefined) {
+            out.question = inp.question;
+        }
+        return out;
+    }
+    if (typeof rawInput === "string") {
+        if (out.question === undefined) {
+            out.question = rawInput;
+        }
+        if (out.inputs === undefined) {
+            out.inputs = { question: rawInput };
+        }
+        else if (typeof out.inputs === "object" && !Array.isArray(out.inputs)) {
+            const ins = out.inputs;
+            if (ins.question === undefined) {
+                out.inputs = { ...ins, question: rawInput };
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=skillTemplateVariables.js.map

package/dist/utils/skillTemplateVariables.js.map

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

package/dist/utils/xynthesizedSmartInputPaths.d.ts

@@ -0,0 +1,16 @@
+import type { SmartInputConfig, RunTaskSmartInput } from "../types/task-types.js";
+/** Allowed top-level scopes under `xynthesized` for smart-input dot paths. */
+export declare const XYNTHESIZED_SMART_INPUT_SCOPES: readonly ["job", "task", "execution"];
+export type XynthesizedSmartInputScope = (typeof XYNTHESIZED_SMART_INPUT_SCOPES)[number];
+/**
+ * Validates that a smart-input path under `xynthesized.*` uses an allowed scope (job | task | execution).
+ */
+export declare function assertXynthesizedSmartInputPath(path: string, skillKey: string, pathIndex?: number): void;
+/** Validates all `xynthesized.*` entries in a smart-input config. */
+export declare function assertXynthesizedSmartInputPaths(smartInput: SmartInputConfig | RunTaskSmartInput, skillKey: string): void;
+/**
+ * Resolves `xynthesized.<scope>...` smart-input paths against in-flight `xynthesized` memory.
+ * Non-xynthesized paths are returned unchanged.
+ */
+export declare function resolveXynthesizedSmartInputPath(path: string, xynthesized: Record<string, unknown> | undefined): unknown;
+//# sourceMappingURL=xynthesizedSmartInputPaths.d.ts.map

package/dist/utils/xynthesizedSmartInputPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xynthesizedSmartInputPaths.d.ts","sourceRoot":"","sources":["../../src/utils/xynthesizedSmartInputPaths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAMlF,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B,uCAAwC,CAAC;AAEpF,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzF;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAeN;AAMD,qEAAqE;AACrE,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,gBAAgB,GAAG,iBAAiB,EAChD,QAAQ,EAAE,MAAM,GACf,IAAI,CAKN;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC/C,OAAO,CAaT"}

package/dist/utils/xynthesizedSmartInputPaths.js

@@ -0,0 +1,56 @@
+import { formatSmartInputValidationMessage, throwSmartInputValidationError, } from "../errors/smartInputValidationError.js";
+/** Allowed top-level scopes under `xynthesized` for smart-input dot paths. */
+export const XYNTHESIZED_SMART_INPUT_SCOPES = ["job", "task", "execution"];
+/**
+ * Validates that a smart-input path under `xynthesized.*` uses an allowed scope (job | task | execution).
+ */
+export function assertXynthesizedSmartInputPath(path, skillKey, pathIndex) {
+    if (!path.startsWith("xynthesized."))
+        return;
+    const rest = path.slice("xynthesized.".length);
+    const scope = rest.split(".")[0] ?? "";
+    if (!XYNTHESIZED_SMART_INPUT_SCOPES.includes(scope)) {
+        const details = {
+            code: "UNSUPPORTED_XYNTHESIZED_SCOPE",
+            skillKey,
+            pathIndex,
+            path,
+            xynthesizedScope: scope,
+            allowedXynthesizedScopes: XYNTHESIZED_SMART_INPUT_SCOPES,
+        };
+        throwSmartInputValidationError(details, formatSmartInputValidationMessage(details));
+    }
+}
+function pathFromEntry(entry) {
+    return typeof entry === "string" ? entry : entry.path;
+}
+/** Validates all `xynthesized.*` entries in a smart-input config. */
+export function assertXynthesizedSmartInputPaths(smartInput, skillKey) {
+    for (let i = 0; i < smartInput.paths.length; i++) {
+        const entry = smartInput.paths[i];
+        assertXynthesizedSmartInputPath(pathFromEntry(entry), skillKey, i);
+    }
+}
+/**
+ * Resolves `xynthesized.<scope>...` smart-input paths against in-flight `xynthesized` memory.
+ * Non-xynthesized paths are returned unchanged.
+ */
+export function resolveXynthesizedSmartInputPath(path, xynthesized) {
+    if (!path.startsWith("xynthesized.") || !xynthesized)
+        return undefined;
+    const rest = path.slice("xynthesized.".length);
+    const segments = rest.split(".").filter(Boolean);
+    if (segments.length === 0)
+        return undefined;
+    const scope = segments[0];
+    if (!XYNTHESIZED_SMART_INPUT_SCOPES.includes(scope))
+        return undefined;
+    let cur = xynthesized[scope];
+    for (const seg of segments.slice(1)) {
+        if (cur == null || typeof cur !== "object" || Array.isArray(cur))
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur;
+}
+//# sourceMappingURL=xynthesizedSmartInputPaths.js.map

package/dist/utils/xynthesizedSmartInputPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xynthesizedSmartInputPaths.js","sourceRoot":"","sources":["../../src/utils/xynthesizedSmartInputPaths.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,wCAAwC,CAAC;AAEhD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAU,CAAC;AAIpF;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAAY,EACZ,QAAgB,EAChB,SAAkB;IAElB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAE,8BAAoD,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,+BAAwC;YAC9C,QAAQ;YACR,SAAS;YACT,IAAI;YACJ,gBAAgB,EAAE,KAAK;YACvB,wBAAwB,EAAE,8BAA8B;SACzD,CAAC;QACF,8BAA8B,CAAC,OAAO,EAAE,iCAAiC,CAAC,OAAO,CAAC,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAgC;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AACxD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gCAAgC,CAC9C,UAAgD,EAChD,QAAgB;IAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,+BAA+B,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,IAAY,EACZ,WAAgD;IAEhD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAA+B,CAAC;IACxD,IAAI,CAAE,8BAAoD,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7F,IAAI,GAAG,GAAY,WAAW,CAAC,KAAK,CAAC,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACnF,GAAG,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/xynthesizedWrite.d.ts

@@ -0,0 +1,10 @@
+import type { XynthesizedMemory, XynthesizedOutputConfig } from "../types/task-types.js";
+/**
+ * Applies one PRE synthesis write to in-flight xynthesized memory and returns a patch slice for the response.
+ */
+export declare function applyXynthesizedOutputWrite(current: XynthesizedMemory | undefined, outCfg: XynthesizedOutputConfig, synthesizedResult: unknown): {
+    nextXynthesized: XynthesizedMemory;
+    patchSlice: XynthesizedMemory;
+};
+export declare function mergeXynthesizedPatchSlices(acc: XynthesizedMemory | undefined, slice: XynthesizedMemory): XynthesizedMemory;
+//# sourceMappingURL=xynthesizedWrite.d.ts.map

package/dist/utils/xynthesizedWrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xynthesizedWrite.d.ts","sourceRoot":"","sources":["../../src/utils/xynthesizedWrite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAEjB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAgChC;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,MAAM,EAAE,uBAAuB,EAC/B,iBAAiB,EAAE,OAAO,GACzB;IAAE,eAAe,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAuBvE;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAClC,KAAK,EAAE,iBAAiB,GACvB,iBAAiB,CAUnB"}

package/dist/utils/xynthesizedWrite.js

@@ -0,0 +1,61 @@
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function deepMergePlain(a, b) {
+    const out = { ...a };
+    for (const [k, v] of Object.entries(b)) {
+        const av = out[k];
+        if (isPlainObject(av) && isPlainObject(v)) {
+            out[k] = deepMergePlain(av, v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+function scopeRecord(current, scope) {
+    const prev = scope === "job"
+        ? current?.job
+        : scope === "task"
+            ? current?.task
+            : current?.execution;
+    return { ...(prev ?? {}) };
+}
+/**
+ * Applies one PRE synthesis write to in-flight xynthesized memory and returns a patch slice for the response.
+ */
+export function applyXynthesizedOutputWrite(current, outCfg, synthesizedResult) {
+    const scope = outCfg.destination;
+    const mode = outCfg.mode ?? "replace";
+    const outputKey = outCfg.outputKey;
+    const scopeRecordCopy = scopeRecord(current, scope);
+    if (mode === "replace") {
+        scopeRecordCopy[outputKey] = synthesizedResult;
+    }
+    else {
+        const prevVal = scopeRecordCopy[outputKey];
+        if (isPlainObject(prevVal) && isPlainObject(synthesizedResult)) {
+            scopeRecordCopy[outputKey] = deepMergePlain(prevVal, synthesizedResult);
+        }
+        else {
+            scopeRecordCopy[outputKey] = synthesizedResult;
+        }
+    }
+    const written = scopeRecordCopy[outputKey];
+    const patchSlice = { [scope]: { [outputKey]: written } };
+    const nextXynthesized = { ...current, [scope]: scopeRecordCopy };
+    return { nextXynthesized, patchSlice };
+}
+export function mergeXynthesizedPatchSlices(acc, slice) {
+    const out = { ...acc };
+    const scopes = ["job", "task", "execution"];
+    for (const scope of scopes) {
+        const bucket = slice[scope];
+        if (bucket && Object.keys(bucket).length > 0) {
+            out[scope] = { ...(acc?.[scope] ?? {}), ...bucket };
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=xynthesizedWrite.js.map

package/dist/utils/xynthesizedWrite.js.map

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

package/dist/validation/analyzeExpectedRunTaskInput.d.ts

@@ -0,0 +1,41 @@
+import type { RunTaskRequest, RunTaskSmartInput } from "../types/task-types.js";
+import type { AnalyzeExpectedRunTaskInputResult, ExpectedRunTaskInputPath } from "./types.js";
+export type RunTaskTemplateResolver = {
+    resolveRawTemplate(skillKey: string, section: "instructions" | "prompt"): Promise<string | undefined>;
+};
+export type AnalyzeExpectedRunTaskInputParams = {
+    skillKey: string;
+    smartInput?: RunTaskSmartInput;
+    /** Inline template text (skips resolver when set for that section). */
+    instructions?: string;
+    prompt?: string;
+    /** When set, loads raw instructions/prompt from ai-skills content (same as PRE synthesis). */
+    templateResolver?: RunTaskTemplateResolver;
+};
+/**
+ * Lists dot-paths the task expects at invoke time:
+ * - explicit `smartInput.paths`
+ * - path tokens from skill instructions/prompt templates (Rendrix `listTokens`)
+ */
+export declare function analyzeExpectedRunTaskInput(params: AnalyzeExpectedRunTaskInputParams): Promise<AnalyzeExpectedRunTaskInputResult>;
+export type CheckExpectedInputAgainstRequestParams = {
+    request: RunTaskRequest;
+    expected: AnalyzeExpectedRunTaskInputResult;
+    /** When true, also run Rendrix `analyzeTemplateResolution` on prompt/instructions text. */
+    templateTexts?: {
+        instructions?: string;
+        prompt?: string;
+    };
+};
+/**
+ * Compare expected paths against a concrete `RunTaskRequest` payload (no LLM).
+ */
+export declare function checkExpectedInputAgainstRequest(params: CheckExpectedInputAgainstRequestParams): {
+    missingInputPaths: ExpectedRunTaskInputPath[];
+    resolvedInputPaths: Array<ExpectedRunTaskInputPath & {
+        resolved: boolean;
+        valuePreview?: string;
+    }>;
+    templateUnresolvedPaths: string[];
+};
+//# sourceMappingURL=analyzeExpectedRunTaskInput.d.ts.map

package/dist/validation/analyzeExpectedRunTaskInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeExpectedRunTaskInput.d.ts","sourceRoot":"","sources":["../../src/validation/analyzeExpectedRunTaskInput.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAOhF,OAAO,KAAK,EACV,iCAAiC,EACjC,wBAAwB,EAEzB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,uBAAuB,GAAG;IACpC,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GAAG,QAAQ,GACjC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC5C,CAAC;AAgEF;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,iCAAiC,CAAC,CAoB5C;AAED,MAAM,MAAM,sCAAsC,GAAG;IACnD,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,2FAA2F;IAC3F,aAAa,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,CAAC;AAEF;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,sCAAsC,GAC7C;IACD,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;IAC9C,kBAAkB,EAAE,KAAK,CAAC,wBAAwB,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnG,uBAAuB,EAAE,MAAM,EAAE,CAAC;CACnC,CAmCA"}