@exellix/ai-tasks 10.1.1 → 10.1.3

package/CHANGELOG.md

@@ -4,6 +4,23 @@ 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.3] - 2026-06-24
+
+### Changed
+
+- **GTF-FR-002:** Remove local `traceLifecycleLocal.ts`; all trace lifecycle helpers delegate to `@x12i/graphenix-trace-format@^2.12.1` (`rollupNodeExecution`, `appendFallbackAppliedEvent`, unit/model invocation lifecycle).
+
+## [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/mapObservationToTrace.js

@@ -34,7 +34,7 @@ export function mapObservationToModelInvocationOutcome(obs, unit, trace) {
                 }
                 : {}),
             ...(typeof usageRecord?.costUsd === "number"
-                ? { cost: { costUsd: usageRecord.costUsd, costStatus: "known" } }
+                ? { cost: { costUsd: usageRecord.costUsd } }
                 : {}),
             ...(resolvedInvocation ? { resolvedInvocation } : {}),
         };
@@ -65,7 +65,7 @@ export function mapObservationToModelInvocationOutcome(obs, unit, trace) {
             }
             : {}),
         ...(typeof summary?.costUsd === "number"
-            ? { cost: { costUsd: summary.costUsd, costStatus: "known" } }
+            ? { cost: { costUsd: summary.costUsd } }
             : {}),
         ...(resolvedInvocation ? { resolvedInvocation } : {}),
     };

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

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

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

@@ -1,13 +1,31 @@
-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 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). */
+/**
+ * Trace lifecycle — delegates to @x12i/graphenix-trace-format (≥2.12.1).
+ * Thin adapters for ai-tasks call shapes (full unit object, unknown errors).
+ */
+import type { ExecutionUnitPlanV2, GraphExecutionTraceV2 } from "@x12i/graphenix-executable-contracts";
+import { appendFallbackAppliedEvent, rollupNodeExecution, type MarkUnitCompletedOutcome, type MarkUnitFailedOutcome, type RecordModelInvocationCompletedOutcome } from "@x12i/graphenix-trace-format";
+export { appendFallbackAppliedEvent, rollupNodeExecution, type MarkUnitCompletedOutcome, type MarkUnitFailedOutcome, type RecordModelInvocationCompletedOutcome, };
+export type UnitCompletionOutcome = MarkUnitCompletedOutcome;
+export type UnitFailureOutcome = MarkUnitFailedOutcome;
+/** Mapper output / completion args — superset of GTF outcome for ai-tasks observations. */
+export type ModelInvocationOutcome = RecordModelInvocationCompletedOutcome & {
+    completedAt?: string;
+    promptPreview?: string;
+    completionPreview?: string;
+    errorMessage?: string;
+};
+export type ModelInvocationStartArgs = {
+    invocationId: string;
+    unit: ExecutionUnitPlanV2;
+    nodeId: string;
+    startedAt?: string;
+};
+export declare function markUnitStarted(trace: GraphExecutionTraceV2, unit: ExecutionUnitPlanV2, at?: string): void;
+export declare function markUnitCompleted(trace: GraphExecutionTraceV2, unitId: string, outcome: UnitCompletionOutcome, unit?: ExecutionUnitPlanV2): void;
+export declare function markUnitFailed(trace: GraphExecutionTraceV2, unitId: string, error: unknown, outcome?: UnitFailureOutcome, unit?: ExecutionUnitPlanV2): void;
+export declare function recordModelInvocationStarted(trace: GraphExecutionTraceV2, args: ModelInvocationStartArgs): void;
+export declare function recordModelInvocationCompleted(trace: GraphExecutionTraceV2, invocationId: string, outcome: ModelInvocationOutcome): void;
+export declare function recordModelInvocationFailed(trace: GraphExecutionTraceV2, invocationId: string, error: unknown, outcome?: ModelInvocationOutcome): void;
+/** @deprecated All lifecycle helpers are exported from graphenix-trace-format ≥2.12.1. */
 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;AACvG,OAAO,EACL,0BAA0B,EAO1B,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,qCAAqC,EAC3C,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,qCAAqC,GAC3C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEvD,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,GAAG,qCAAqC,GAAG;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAmBF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,mBAAmB,EACzB,EAAE,CAAC,EAAE,MAAM,GACV,IAAI,CAEN;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,qBAAqB,EAC9B,IAAI,CAAC,EAAE,mBAAmB,GACzB,IAAI,CAMN;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,kBAAkB,EAC5B,IAAI,CAAC,EAAE,mBAAmB,GACzB,IAAI,CAUN;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,wBAAwB,GAC7B,IAAI,CAYN;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAYN;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,sBAAsB,GAC/B,IAAI,CAMN;AAED,0FAA0F;AAC1F,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}

package/dist/node-execution/traceLifecycle.js

@@ -1,24 +1,73 @@
-/**
- * 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). */
+import { appendFallbackAppliedEvent, appendUnitLifecycleEvent, markUnitCompleted as gtfMarkUnitCompleted, markUnitFailed as gtfMarkUnitFailed, recordModelInvocationCompleted as gtfRecordModelInvocationCompleted, recordModelInvocationFailed as gtfRecordModelInvocationFailed, recordModelInvocationStarted as gtfRecordModelInvocationStarted, rollupNodeExecution, } from "@x12i/graphenix-trace-format";
+export { appendFallbackAppliedEvent, rollupNodeExecution, };
+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) {
+    appendUnitLifecycleEvent(trace, "unit.started", unit, { at, ts: at });
+}
+export function markUnitCompleted(trace, unitId, outcome, unit) {
+    if (unit) {
+        appendUnitLifecycleEvent(trace, "unit.completed", unit, outcome);
+        return;
+    }
+    gtfMarkUnitCompleted(trace, unitId, outcome);
+}
+export function markUnitFailed(trace, unitId, error, outcome, unit) {
+    const normalized = normalizeError(error);
+    if (unit) {
+        appendUnitLifecycleEvent(trace, "unit.failed", unit, {
+            ...outcome,
+            error: normalized,
+        });
+        return;
+    }
+    gtfMarkUnitFailed(trace, unitId, normalized, outcome);
+}
+export function recordModelInvocationStarted(trace, args) {
+    gtfRecordModelInvocationStarted(trace, {
+        invocationId: args.invocationId,
+        unitId: args.unit.unitId,
+        nodeId: args.nodeId,
+        modelSlot: args.unit.modelSlot,
+        plannedModelSelection: args.unit.modelSelection,
+    }, args.startedAt);
+}
+export function recordModelInvocationCompleted(trace, invocationId, outcome) {
+    gtfRecordModelInvocationCompleted(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 } : {}),
+        },
+    });
+}
+export function recordModelInvocationFailed(trace, invocationId, error, outcome) {
+    const normalized = normalizeError(error);
+    gtfRecordModelInvocationFailed(trace, invocationId, {
+        message: outcome?.errorMessage ?? normalized.message,
+        code: normalized.code ?? "MODEL_INVOCATION_FAILED",
+    });
+}
+/** @deprecated All lifecycle helpers are exported from graphenix-trace-format ≥2.12.1. */
 export function usesUpstreamTraceLifecycle() {
-    return typeof upstream.markUnitStarted === "function";
+    return true;
 }
 //# 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/dist/node-execution/unitTrace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unitTrace.d.ts","sourceRoot":"","sources":["../../src/node-execution/unitTrace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAa9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAU1E;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,GACxB;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAShD;AAYD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,YAAY,EAAE,kBAAkB,EAAE,GACjC,IAAI,CA8CN;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,EAAE,OAAO,GACb,IAAI,CAiBN;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAGN;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,EACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAKN;AAED,0DAA0D;AAC1D,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAKR;AAED,yCAAyC;AACzC,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAMN;AAED,qCAAqC;AACrC,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,GACb,IAAI,CAIN"}
+{"version":3,"file":"unitTrace.d.ts","sourceRoot":"","sources":["../../src/node-execution/unitTrace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAa9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAU1E;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,GACxB;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAShD;AAYD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,YAAY,EAAE,kBAAkB,EAAE,GACjC,IAAI,CA6CN;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,EAAE,OAAO,GACb,IAAI,CAiBN;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAGN;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,EACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAKN;AAED,0DAA0D;AAC1D,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAKR;AAED,yCAAyC;AACzC,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAMN;AAED,qCAAqC;AACrC,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,mBAAmB,EACzB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,GACb,IAAI,CAIN"}

package/dist/node-execution/unitTrace.js

@@ -56,7 +56,6 @@ export function completeUnitTrace(ctx, unit, startedAtMs, invocationId, observat
                 unit,
                 nodeId: ctx.nodeId,
                 startedAt: completedAt,
-                attempt: i + 1,
             });
             const extraOutcome = mapObservationToModelInvocationOutcome(observations[i], unit, ctx.trace);
             recordModelInvocationCompleted(ctx.trace, extraId, {

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

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

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.1 | GTF lifecycle (`markUnit*`, `recordModelInvocation*`, `rollupNodeExecution`, `appendFallbackAppliedEvent`) |
 | `@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.3",
   "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.1",
     "@x12i/logxer": "^4.6.0",
     "@x12i/optimixer": "^3.5.2",
     "@x12i/rendrix": "^4.3.0",