@exellix/ai-tasks 10.1.1 → 10.1.2

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `@exellix/ai-tasks` are documented here.
 
 The published **npm version** always matches **`version`** in [`package.json`](package.json). If this file skips a semver, treat [`BREAKING-CHANGES.md`](BREAKING-CHANGES.md) and [`RUNTASK_REQUEST.md`](RUNTASK_REQUEST.md) as the source of truth for cross-version upgrades.
 
+## [10.1.2] - 2026-06-24
+
+### Added
+
+- **AT-CR-001 (complete):** GTF-FR-001 lifecycle delegated to `@x12i/graphenix-trace-format@^2.12.0` — `unitExecutions`, `modelInvocations`, and `nodeExecutions` indexes stay in sync during node-plan execution when `RunTaskRequest.executionTrace` is present.
+
+### Changed
+
+- **Graphenix trace-format ^2.12.0:** GTF-FR-001 lifecycle (`markUnit*`, `recordModelInvocation*`, `appendUnitLifecycleEvent`) now delegated to `@x12i/graphenix-trace-format` via ai-tasks shims; other `@x12i/graphenix-*` packages remain at latest **^2.11.0**.
+- Node rollup and `fallback.applied` events still use local helpers until upstream exports them.
+
 ## [10.1.1] - 2026-06-24
 
 ### Changed

package/dist/node-execution/traceLifecycle.d.ts

@@ -1,13 +1,18 @@
+/**
+ * GTF-FR-001 lifecycle helpers — delegate to @x12i/graphenix-trace-format (≥2.12.0) with
+ * ai-tasks argument shims; fall back to local implementation on older trace-format.
+ */
+import type { ExecutionUnitPlanV2, GraphExecutionTraceV2 } from "@x12i/graphenix-executable-contracts";
 import * as local from "./traceLifecycleLocal.js";
-export declare const markUnitStarted: typeof local.markUnitStarted;
-export declare const markUnitCompleted: typeof local.markUnitCompleted;
-export declare const markUnitFailed: typeof local.markUnitFailed;
-export declare const recordModelInvocationStarted: typeof local.recordModelInvocationStarted;
-export declare const recordModelInvocationCompleted: typeof local.recordModelInvocationCompleted;
-export declare const recordModelInvocationFailed: typeof local.recordModelInvocationFailed;
+export type { UnitCompletionOutcome, UnitFailureOutcome, ModelInvocationStartArgs, ModelInvocationOutcome, } from "./traceLifecycleLocal.js";
+export declare function markUnitStarted(trace: GraphExecutionTraceV2, unit: ExecutionUnitPlanV2, at?: string): void;
+export declare function markUnitCompleted(trace: GraphExecutionTraceV2, unitId: string, outcome: local.UnitCompletionOutcome, unit?: ExecutionUnitPlanV2): void;
+export declare function markUnitFailed(trace: GraphExecutionTraceV2, unitId: string, error: unknown, outcome?: local.UnitFailureOutcome, unit?: ExecutionUnitPlanV2): void;
+export declare function recordModelInvocationStarted(trace: GraphExecutionTraceV2, args: local.ModelInvocationStartArgs): void;
+export declare function recordModelInvocationCompleted(trace: GraphExecutionTraceV2, invocationId: string, outcome: local.ModelInvocationOutcome): void;
+export declare function recordModelInvocationFailed(trace: GraphExecutionTraceV2, invocationId: string, error: unknown, outcome?: local.ModelInvocationOutcome): void;
 export declare const appendFallbackAppliedEvent: typeof local.appendFallbackAppliedEvent;
 export declare const rollupNodeExecution: typeof local.rollupNodeExecution;
-export type { UnitCompletionOutcome, UnitFailureOutcome, ModelInvocationStartArgs, ModelInvocationOutcome, } from "./traceLifecycleLocal.js";
-/** True when lifecycle helpers are re-exported from graphenix-trace-format (not local fallback). */
+/** True when GTF-FR-001 lifecycle helpers are exported from graphenix-trace-format. */
 export declare function usesUpstreamTraceLifecycle(): boolean;
 //# sourceMappingURL=traceLifecycle.d.ts.map

package/dist/node-execution/traceLifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traceLifecycle.d.ts","sourceRoot":"","sources":["../../src/node-execution/traceLifecycle.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,0BAA0B,CAAC;AAWlD,eAAO,MAAM,eAAe,8BAA0B,CAAC;AACvD,eAAO,MAAM,iBAAiB,gCAA4B,CAAC;AAC3D,eAAO,MAAM,cAAc,6BAAyB,CAAC;AACrD,eAAO,MAAM,4BAA4B,2CAAuC,CAAC;AACjF,eAAO,MAAM,8BAA8B,6CAAyC,CAAC;AACrF,eAAO,MAAM,2BAA2B,0CAAsC,CAAC;AAC/E,eAAO,MAAM,0BAA0B,yCAAqC,CAAC;AAC7E,eAAO,MAAM,mBAAmB,kCAA8B,CAAC;AAE/D,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAElC,oGAAoG;AACpG,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}
+{"version":3,"file":"traceLifecycle.d.ts","sourceRoot":"","sources":["../../src/node-execution/traceLifecycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAEvG,OAAO,KAAK,KAAK,MAAM,0BAA0B,CAAC;AAElD,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAuBlC,wBAAgB,eAAe,CAC7B,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,mBAAmB,EACzB,EAAE,CAAC,EAAE,MAAM,GACV,IAAI,CAUN;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,KAAK,CAAC,qBAAqB,EACpC,IAAI,CAAC,EAAE,mBAAmB,GACzB,IAAI,CAUN;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,KAAK,CAAC,kBAAkB,EAClC,IAAI,CAAC,EAAE,mBAAmB,GACzB,IAAI,CAcN;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,KAAK,CAAC,wBAAwB,GACnC,IAAI,CAgBN;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,KAAK,CAAC,sBAAsB,GACpC,IAAI,CAgBN;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,KAAK,CAAC,sBAAsB,GACrC,IAAI,CAUN;AAED,eAAO,MAAM,0BAA0B,yCAAmC,CAAC;AAC3E,eAAO,MAAM,mBAAmB,kCAA4B,CAAC;AAE7D,uFAAuF;AACvF,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}

package/dist/node-execution/traceLifecycle.js

@@ -1,24 +1,105 @@
-/**
- * GTF-FR-001 lifecycle helpers — prefer @x12i/graphenix-trace-format when exported (≥2.11.x),
- * fall back to local implementation until upstream ships markUnitStarted / recordModelInvocation*.
- */
 import * as GTF from "@x12i/graphenix-trace-format";
 import * as local from "./traceLifecycleLocal.js";
-const upstream = GTF;
-function pick(name) {
-    const fn = upstream[name];
-    return (typeof fn === "function" ? fn : local[name]);
-}
-export const markUnitStarted = pick("markUnitStarted");
-export const markUnitCompleted = pick("markUnitCompleted");
-export const markUnitFailed = pick("markUnitFailed");
-export const recordModelInvocationStarted = pick("recordModelInvocationStarted");
-export const recordModelInvocationCompleted = pick("recordModelInvocationCompleted");
-export const recordModelInvocationFailed = pick("recordModelInvocationFailed");
-export const appendFallbackAppliedEvent = pick("appendFallbackAppliedEvent");
-export const rollupNodeExecution = pick("rollupNodeExecution");
-/** True when lifecycle helpers are re-exported from graphenix-trace-format (not local fallback). */
+const hasUpstream = typeof GTF.markUnitStarted === "function" &&
+    typeof GTF.recordModelInvocationStarted === "function";
+function normalizeError(error) {
+    if (error instanceof Error) {
+        return { message: error.message, code: "UNIT_FAILED" };
+    }
+    if (typeof error === "string") {
+        return { message: error, code: "UNIT_FAILED" };
+    }
+    if (error && typeof error === "object" && "message" in error) {
+        const record = error;
+        return {
+            message: String(record.message ?? "Unit failed"),
+            code: typeof record.code === "string" ? record.code : "UNIT_FAILED",
+        };
+    }
+    return { message: String(error), code: "UNIT_FAILED" };
+}
+export function markUnitStarted(trace, unit, at) {
+    if (hasUpstream && typeof GTF.appendUnitLifecycleEvent === "function") {
+        GTF.appendUnitLifecycleEvent(trace, "unit.started", unit, { at, ts: at });
+        return;
+    }
+    if (hasUpstream) {
+        GTF.markUnitStarted(trace, unit, at);
+        return;
+    }
+    local.markUnitStarted(trace, unit, at);
+}
+export function markUnitCompleted(trace, unitId, outcome, unit) {
+    if (hasUpstream && typeof GTF.appendUnitLifecycleEvent === "function" && unit) {
+        GTF.appendUnitLifecycleEvent(trace, "unit.completed", unit, outcome);
+        return;
+    }
+    if (hasUpstream) {
+        GTF.markUnitCompleted(trace, unitId, outcome);
+        return;
+    }
+    local.markUnitCompleted(trace, unitId, outcome, unit);
+}
+export function markUnitFailed(trace, unitId, error, outcome, unit) {
+    const normalized = normalizeError(error);
+    if (hasUpstream && typeof GTF.appendUnitLifecycleEvent === "function" && unit) {
+        GTF.appendUnitLifecycleEvent(trace, "unit.failed", unit, {
+            ...outcome,
+            error: normalized,
+        });
+        return;
+    }
+    if (hasUpstream) {
+        GTF.markUnitFailed(trace, unitId, normalized, outcome);
+        return;
+    }
+    local.markUnitFailed(trace, unitId, error, outcome, unit);
+}
+export function recordModelInvocationStarted(trace, args) {
+    if (hasUpstream) {
+        GTF.recordModelInvocationStarted(trace, {
+            invocationId: args.invocationId,
+            unitId: args.unit.unitId,
+            nodeId: args.nodeId,
+            modelSlot: args.unit.modelSlot,
+            plannedModelSelection: args.unit.modelSelection,
+        }, args.startedAt);
+        return;
+    }
+    local.recordModelInvocationStarted(trace, args);
+}
+export function recordModelInvocationCompleted(trace, invocationId, outcome) {
+    if (hasUpstream) {
+        GTF.recordModelInvocationCompleted(trace, invocationId, {
+            durationMs: outcome.durationMs,
+            usage: outcome.usage,
+            cost: outcome.cost ? { costUsd: outcome.cost.costUsd } : undefined,
+            resolvedModel: outcome.resolvedInvocation?.modelId,
+            resolvedInvocation: outcome.resolvedInvocation,
+            previews: {
+                ...(outcome.promptPreview !== undefined ? { input: outcome.promptPreview } : {}),
+                ...(outcome.completionPreview !== undefined ? { output: outcome.completionPreview } : {}),
+            },
+        });
+        return;
+    }
+    local.recordModelInvocationCompleted(trace, invocationId, outcome);
+}
+export function recordModelInvocationFailed(trace, invocationId, error, outcome) {
+    if (hasUpstream) {
+        const normalized = normalizeError(error);
+        GTF.recordModelInvocationFailed(trace, invocationId, {
+            message: outcome?.errorMessage ?? normalized.message,
+            code: normalized.code ?? "MODEL_INVOCATION_FAILED",
+        });
+        return;
+    }
+    local.recordModelInvocationFailed(trace, invocationId, error, outcome);
+}
+export const appendFallbackAppliedEvent = local.appendFallbackAppliedEvent;
+export const rollupNodeExecution = local.rollupNodeExecution;
+/** True when GTF-FR-001 lifecycle helpers are exported from graphenix-trace-format. */
 export function usesUpstreamTraceLifecycle() {
-    return typeof upstream.markUnitStarted === "function";
+    return hasUpstream;
 }
 //# sourceMappingURL=traceLifecycle.js.map

package/dist/node-execution/traceLifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"traceLifecycle.js","sourceRoot":"","sources":["../../src/node-execution/traceLifecycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,GAAG,MAAM,8BAA8B,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,0BAA0B,CAAC;AAIlD,MAAM,QAAQ,GAAG,GAAyC,CAAC;AAE3D,SAAS,IAAI,CAA+B,IAAO;IACjD,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAoB,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC,8BAA8B,CAAC,CAAC;AACjF,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAAC,gCAAgC,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC,6BAA6B,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC,4BAA4B,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAS/D,oGAAoG;AACpG,MAAM,UAAU,0BAA0B;IACxC,OAAO,OAAO,QAAQ,CAAC,eAAe,KAAK,UAAU,CAAC;AACxD,CAAC"}
+{"version":3,"file":"traceLifecycle.js","sourceRoot":"","sources":["../../src/node-execution/traceLifecycle.ts"],"names":[],"mappings":"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"}

package/dist/node-execution/traceLifecycleLocal.js

@@ -1,6 +1,6 @@
 /**
- * Local GTF-FR-001 lifecycle implementation (fallback until @x12i/graphenix-trace-format exports these APIs).
- * Production path: re-exported via traceLifecycle.ts adapter when upstream ships helpers.
+ * Local trace lifecycle helpers for APIs not yet exported by @x12i/graphenix-trace-format:
+ * `rollupNodeExecution`, `appendFallbackAppliedEvent`, and full local fallback on older trace-format.
  */
 import { randomUUID } from "crypto";
 import { appendTraceEvent, deriveNodeStatusFromUnits } from "@x12i/graphenix-trace-format";

package/documenations/node-execution-graphenix.md

@@ -32,7 +32,7 @@ Plan `mapping` units are orchestrator-owned. Graph-engine applies `nodePlan.exec
 | Package | Role |
 | ------- | ---- |
 | `@x12i/graphenix-plan-format` ^2.11.0 | `validateNodeExecutionPlan` |
-| `@x12i/graphenix-trace-format` ^2.11.0 | `appendTraceEvent`; GTF-FR-001 lifecycle via ai-tasks adapter |
+| `@x12i/graphenix-trace-format` ^2.12.0 | GTF-FR-001 lifecycle (`markUnit*`, `recordModelInvocation*`); node rollup/fallback events via ai-tasks adapter |
 | `@x12i/graphenix-executable-contracts` ^2.11.0 | Types |
 
 ## Test helper

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/ai-tasks",
-  "version": "10.1.1",
+  "version": "10.1.2",
   "description": "Task orchestration for the Exellix stack: runTask() with local handlers or LLM-backed execution, task-scoped memory/context enrichment, and executor dispatch via @exellix/ai-skills. ERC-compliant.",
   "type": "module",
   "main": "dist/index.js",
@@ -73,7 +73,7 @@
     "@x12i/graphenix-core": "^2.11.0",
     "@x12i/graphenix-executable-contracts": "^2.11.0",
     "@x12i/graphenix-plan-format": "^2.11.0",
-    "@x12i/graphenix-trace-format": "^2.11.0",
+    "@x12i/graphenix-trace-format": "^2.12.0",
     "@x12i/logxer": "^4.6.0",
     "@x12i/optimixer": "^3.5.2",
     "@x12i/rendrix": "^4.3.0",