@exellix/ai-tasks 10.1.0 → 10.1.2

package/dist/node-execution/traceLifecycleLocal.js

@@ -0,0 +1,312 @@
+/**
+ * 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";
+import { traceError } from "./mapObservationToTrace.js";
+function appendUnique(ids, id) {
+    if (!ids.includes(id))
+        ids.push(id);
+}
+function nextSequence(trace) {
+    return (trace.events?.length ?? 0) + 1;
+}
+function appendLifecycleEvent(trace, event) {
+    appendTraceEvent(trace, {
+        ...event,
+        sequence: event.sequence ?? nextSequence(trace),
+    }, { mutate: true });
+}
+function ensureNodeRunning(trace, nodeId, ts) {
+    const node = trace.nodeExecutions[nodeId];
+    if (!node)
+        return;
+    if (node.status === "pending") {
+        trace.nodeExecutions[nodeId] = { ...node, status: "running", startedAt: ts };
+        appendUnique(trace.graphExecution.startedNodeIds, nodeId);
+        appendLifecycleEvent(trace, {
+            id: `evt:${randomUUID()}`,
+            ts,
+            level: "info",
+            type: "node.started",
+            nodeId,
+        });
+    }
+}
+export function markUnitStarted(trace, unit, at) {
+    const ts = at ?? new Date().toISOString();
+    const unitId = unit.unitId;
+    const existing = trace.unitExecutions[unitId];
+    if (!existing)
+        return;
+    const strategyKey = unit.strategyKey ?? unit.actionKey;
+    trace.unitExecutions[unitId] = {
+        ...existing,
+        status: "running",
+        startedAt: ts,
+        ...(typeof strategyKey === "string" ? { strategyKey } : {}),
+    };
+    appendUnique(trace.graphExecution.startedUnitIds, unitId);
+    ensureNodeRunning(trace, unit.nodeId, ts);
+    appendLifecycleEvent(trace, {
+        id: `evt:${randomUUID()}`,
+        ts,
+        level: "info",
+        type: "unit.started",
+        nodeId: unit.nodeId,
+        unitId,
+        unitKind: unit.unitKind,
+        evidence: {
+            unitKind: unit.unitKind,
+            invokeMode: unit.invokeMode,
+            strategyKey: unit.strategyKey,
+            skillKey: unit.skillKey,
+            modelSlot: unit.modelSlot,
+        },
+    });
+}
+export function markUnitCompleted(trace, unitId, outcome, unit) {
+    const ts = outcome.completedAt ?? new Date().toISOString();
+    const existing = trace.unitExecutions[unitId];
+    if (!existing)
+        return;
+    trace.unitExecutions[unitId] = {
+        ...existing,
+        status: "completed",
+        completedAt: ts,
+        durationMs: outcome.durationMs,
+        ...(outcome.modelInvocationIds !== undefined
+            ? { modelInvocationIds: outcome.modelInvocationIds }
+            : {}),
+    };
+    appendUnique(trace.graphExecution.completedUnitIds, unitId);
+    appendLifecycleEvent(trace, {
+        id: `evt:${randomUUID()}`,
+        ts,
+        level: "info",
+        type: "unit.completed",
+        nodeId: existing.nodeId,
+        unitId,
+        unitKind: existing.unitKind,
+        evidence: {
+            durationMs: outcome.durationMs,
+            modelInvocationIds: outcome.modelInvocationIds,
+            unitKind: unit?.unitKind ?? existing.unitKind,
+        },
+    });
+}
+export function markUnitFailed(trace, unitId, error, outcome, unit) {
+    const ts = outcome?.completedAt ?? new Date().toISOString();
+    const durationMs = outcome?.durationMs ?? 0;
+    const errorMessage = outcome?.errorMessage ??
+        (error instanceof Error ? error.message : typeof error === "string" ? error : String(error));
+    const existing = trace.unitExecutions[unitId];
+    if (!existing)
+        return;
+    trace.unitExecutions[unitId] = {
+        ...existing,
+        status: "failed",
+        completedAt: ts,
+        durationMs,
+        error: traceError(errorMessage, "UNIT_FAILED"),
+    };
+    appendUnique(trace.graphExecution.failedUnitIds, unitId);
+    appendLifecycleEvent(trace, {
+        id: `evt:${randomUUID()}`,
+        ts,
+        level: "error",
+        type: "unit.failed",
+        nodeId: existing.nodeId,
+        unitId,
+        unitKind: existing.unitKind,
+        evidence: {
+            errorMessage,
+            durationMs,
+            unitKind: unit?.unitKind ?? existing.unitKind,
+        },
+    });
+}
+function plannedResolvedInvocation(unit, trace) {
+    const selection = unit.modelSelection ?? { kind: "profileChoice", key: "vol/default" };
+    return {
+        provider: "pending",
+        modelId: "pending",
+        profileChoiceKey: selection.kind === "profileChoice" ? selection.key : undefined,
+        registryVersion: trace.profileRegistry?.version,
+        registryHash: trace.profileRegistry?.registryHash,
+        resolutionSource: "profileRegistry",
+    };
+}
+export function recordModelInvocationStarted(trace, args) {
+    const ts = args.startedAt ?? new Date().toISOString();
+    const { unit, invocationId, nodeId } = args;
+    const selection = unit.modelSelection ?? { kind: "profileChoice", key: "vol/default" };
+    trace.modelInvocations[invocationId] = {
+        invocationId,
+        nodeId,
+        unitId: unit.unitId,
+        slot: unit.modelSlot ?? "skillModel",
+        attempt: args.attempt ?? 1,
+        status: "started",
+        startedAt: ts,
+        plannedSelection: selection,
+        resolvedInvocation: plannedResolvedInvocation(unit, trace),
+    };
+    appendLifecycleEvent(trace, {
+        id: `evt:${randomUUID()}`,
+        ts,
+        level: "info",
+        type: "model.invocation.started",
+        nodeId,
+        unitId: unit.unitId,
+        modelSlot: unit.modelSlot,
+        evidence: { invocationId, modelSlot: unit.modelSlot },
+    });
+}
+function applyDataPolicyPreviews(trace, outcome) {
+    const policy = trace.diagnostics?.dataPolicy;
+    if (!policy?.storePrompts) {
+        return {};
+    }
+    const max = policy.maxPreviewChars ?? 512;
+    const clip = (s) => s === undefined ? undefined : s.length > max ? s.slice(0, max) : s;
+    return {
+        promptPreview: clip(outcome.promptPreview),
+        completionPreview: clip(outcome.completionPreview),
+    };
+}
+export function recordModelInvocationCompleted(trace, invocationId, outcome) {
+    const ts = outcome.completedAt ?? new Date().toISOString();
+    const existing = trace.modelInvocations[invocationId];
+    if (!existing)
+        return;
+    const previews = applyDataPolicyPreviews(trace, outcome);
+    trace.modelInvocations[invocationId] = {
+        ...existing,
+        status: "completed",
+        completedAt: ts,
+        durationMs: outcome.durationMs,
+        ...(outcome.usage ? { usage: outcome.usage } : {}),
+        ...(outcome.cost
+            ? {
+                cost: {
+                    costUsd: outcome.cost.costUsd,
+                    costStatus: outcome.cost.costStatus ?? "unknown",
+                },
+            }
+            : {}),
+        ...(outcome.resolvedInvocation ? { resolvedInvocation: outcome.resolvedInvocation } : {}),
+        ...previews,
+    };
+    const unitId = existing.unitId;
+    const unitExec = trace.unitExecutions[unitId];
+    if (unitExec) {
+        const ids = [...(unitExec.modelInvocationIds ?? [])];
+        appendUnique(ids, invocationId);
+        trace.unitExecutions[unitId] = { ...unitExec, modelInvocationIds: ids };
+    }
+    appendLifecycleEvent(trace, {
+        id: `evt:${randomUUID()}`,
+        ts,
+        level: "info",
+        type: "model.invocation.completed",
+        nodeId: existing.nodeId,
+        unitId: existing.unitId,
+        modelSlot: existing.slot,
+        evidence: { invocationId, durationMs: outcome.durationMs },
+    });
+}
+export function recordModelInvocationFailed(trace, invocationId, error, outcome) {
+    const ts = outcome?.completedAt ?? new Date().toISOString();
+    const durationMs = outcome?.durationMs ?? 0;
+    const errorMessage = outcome?.errorMessage ??
+        (error instanceof Error ? error.message : typeof error === "string" ? error : String(error));
+    const existing = trace.modelInvocations[invocationId];
+    if (!existing)
+        return;
+    trace.modelInvocations[invocationId] = {
+        ...existing,
+        status: "failed",
+        completedAt: ts,
+        durationMs,
+        error: traceError(errorMessage, "MODEL_INVOCATION_FAILED"),
+    };
+    appendLifecycleEvent(trace, {
+        id: `evt:${randomUUID()}`,
+        ts,
+        level: "error",
+        type: "model.invocation.failed",
+        nodeId: existing.nodeId,
+        unitId: existing.unitId,
+        modelSlot: existing.slot,
+        evidence: { invocationId, errorMessage },
+    });
+}
+export function appendFallbackAppliedEvent(trace, unit, extra) {
+    const ts = new Date().toISOString();
+    appendLifecycleEvent(trace, {
+        id: `evt:${randomUUID()}`,
+        ts,
+        level: "info",
+        type: "fallback.applied",
+        nodeId: unit.nodeId,
+        unitId: unit.unitId,
+        evidence: {
+            unitKind: unit.unitKind,
+            ...extra,
+        },
+    });
+}
+export function rollupNodeExecution(trace, nodeId) {
+    const nodeTrace = trace.nodeExecutions[nodeId];
+    if (!nodeTrace)
+        return;
+    const status = deriveNodeStatusFromUnits(trace, nodeId);
+    const units = nodeTrace.unitIds
+        .map((id) => trace.unitExecutions[id])
+        .filter((u) => !!u);
+    const startedTimes = units
+        .map((u) => u.startedAt)
+        .filter((t) => typeof t === "string")
+        .sort();
+    const completedTimes = units
+        .map((u) => u.completedAt)
+        .filter((t) => typeof t === "string")
+        .sort();
+    const startedAt = nodeTrace.startedAt ?? startedTimes[0];
+    const completedAt = status === "completed" || status === "failed" || status === "skipped"
+        ? (completedTimes[completedTimes.length - 1] ?? new Date().toISOString())
+        : undefined;
+    let durationMs = units.reduce((sum, u) => sum + (u.durationMs ?? 0), 0);
+    if (startedAt && completedAt) {
+        durationMs = Math.max(0, new Date(completedAt).getTime() - new Date(startedAt).getTime());
+    }
+    trace.nodeExecutions[nodeId] = {
+        ...nodeTrace,
+        status,
+        ...(startedAt ? { startedAt } : {}),
+        ...(completedAt ? { completedAt, durationMs } : {}),
+    };
+    if (status === "completed") {
+        appendUnique(trace.graphExecution.completedNodeIds, nodeId);
+        appendLifecycleEvent(trace, {
+            id: `evt:${randomUUID()}`,
+            ts: completedAt ?? new Date().toISOString(),
+            level: "info",
+            type: "node.completed",
+            nodeId,
+        });
+    }
+    else if (status === "failed") {
+        appendUnique(trace.graphExecution.failedNodeIds, nodeId);
+        appendLifecycleEvent(trace, {
+            id: `evt:${randomUUID()}`,
+            ts: completedAt ?? new Date().toISOString(),
+            level: "error",
+            type: "node.failed",
+            nodeId,
+        });
+    }
+}
+//# sourceMappingURL=traceLifecycleLocal.js.map

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

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

package/documenations/node-execution-graphenix.md

@@ -31,9 +31,9 @@ Plan `mapping` units are orchestrator-owned. Graph-engine applies `nodePlan.exec
 
 | Package | Role |
 | ------- | ---- |
-| `@x12i/graphenix-plan-format` ^2.10.0 | `validateNodeExecutionPlan` |
-| `@x12i/graphenix-trace-format` ^2.10.0 | `appendTraceEvent`, lifecycle index sync via ai-tasks `traceLifecycle` |
-| `@x12i/graphenix-executable-contracts` ^2.10.0 | Types |
+| `@x12i/graphenix-plan-format` ^2.11.0 | `validateNodeExecutionPlan` |
+| `@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,96 +1,96 @@
-{
-  "name": "@exellix/ai-tasks",
-  "version": "10.1.0",
-  "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",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": "./dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "CHANGELOG.md",
-    "RUNTASK_REQUEST.md",
-    "documenations",
-    ".docs",
-    ".env.example",
-    ".metadata"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "ts-node src/index.ts",
-    "prepublishOnly": "node scripts/assert-publishable-deps.mjs && npm run build && node scripts/ensure-nx-content-md-variants.mjs",
-    "deps:latest": "npx npm-check-updates -u && npm install",
-    "test": "node scripts/ensure-xynthesis-dist.mjs && node scripts/ensure-ai-skills-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node scripts/copy-test-fixtures.mjs && node --test --test-force-exit --test-concurrency=1 dist-test/test/trace/*.js dist-test/test/node-execution/**/*.js dist-test/test/aiScoping/*.js dist-test/test/intermediateSteps/*.js dist-test/test/post-steps/**/*.js dist-test/test/planWebScopeQuestions/*.js dist-test/test/synthesis/*.js dist-test/test/fact-guard/*.js dist-test/test/utils/*.js dist-test/test/errors/*.js dist-test/test/validation/*.js dist-test/test/web-scope/*.js dist-test/test/task-strategies/*.js dist-test/test/observability/*.js dist-test/test/run-task/*.js dist-test/test/internal/*.js dist-test/test/execution-strategies/*.js dist-test/test/invocation/*.js dist-test/test/e2e/*.js",
-    "test:e2e:intermediateSteps": "node scripts/run-with-env.mjs RUN_INTERMEDIATE_STEPS_E2E=1 npm run test",
-    "test:e2e:synthesis": "node scripts/run-synthesis-e2e.mjs",
-    "test:e2e:webScope": "node scripts/run-web-scope-e2e.mjs",
-    "test:fact-guard": "node scripts/ensure-xynthesis-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node --test --test-force-exit dist-test/test/fact-guard/*.js dist-test/test/post-steps/runPostStepLlmCall.factGuard.test.js",
-    "test:live": "node scripts/run-live-ai-e2e.mjs",
-    "publish:task-strategies": "tsx scripts/publish-ai-task-strategies-catalog.ts"
-  },
-  "keywords": [
-    "ai",
-    "tasks",
-    "llm",
-    "skills",
-    "orchestration",
-    "erc",
-    "env-ready"
-  ],
-  "author": "exellix",
-  "license": "exellix-license",
-  "repository": {
-    "type": "git",
-    "url": "git+ssh://git@github.com/exellix/ai-tasks.git"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "overrides": {
-    "@x12i/catalox": "^5.9.8",
-    "@x12i/catalox-contracts": "^5.9.8"
-  },
-  "dependencies": {
-    "@exellix/ai-skills": "^6.12.5",
-    "@exellix/fact-guard-adapters": "^1.0.1",
-    "@exellix/fact-guard-enrichment": "^1.0.1",
-    "@exellix/fact-guard-policies": "^1.0.1",
-    "@exellix/fact-guard-types": "^1.0.1",
-    "@exellix/fact-guard-validation": "^1.0.1",
-    "@exellix/xynthesis": "^4.8.4",
-    "@x12i/activix": "^8.6.3",
-    "@x12i/ai-profiles": "^3.4.0",
-    "@x12i/catalox": "^5.9.8",
-    "@x12i/execution-memory-manager": "^1.2.0",
-    "@x12i/funcx": "^4.9.13",
-    "@x12i/graphenix-core": "^2.10.0",
-    "@x12i/graphenix-executable-contracts": "^2.10.0",
-    "@x12i/graphenix-plan-format": "^2.10.0",
-    "@x12i/graphenix-trace-format": "^2.10.0",
-    "@x12i/logxer": "^4.6.0",
-    "@x12i/optimixer": "^3.5.2",
-    "@x12i/rendrix": "^4.3.0",
-    "@x12i/search-adapter": "^1.5.1",
-    "@x12i/web-scoper": "^1.1.1",
-    "handlebars": "^4.7.8",
-    "nx-cache": "^1.0.2"
-  },
-  "devDependencies": {
-    "@types/node": "^18.0.0 || ^20.0.0",
-    "@x12i/catalox-contracts": "^5.9.8",
-    "@x12i/graphenix-authoring-format": "^2.10.0",
-    "@x12i/graphenix-plan-compiler": "^2.10.0",
-    "@x12i/graphenix-task-node-format": "^2.10.0",
-    "dotenv": "^16.0.0",
-    "ts-node": "^10.9.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.0.0"
-  }
-}
+{
+  "name": "@exellix/ai-tasks",
+  "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",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "RUNTASK_REQUEST.md",
+    "documenations",
+    ".docs",
+    ".env.example",
+    ".metadata"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "node scripts/assert-publishable-deps.mjs && npm run build && node scripts/ensure-nx-content-md-variants.mjs",
+    "deps:latest": "npx npm-check-updates -u && npm install",
+    "test": "node scripts/ensure-xynthesis-dist.mjs && node scripts/ensure-ai-skills-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node scripts/copy-test-fixtures.mjs && node --test --test-force-exit --test-concurrency=1 dist-test/test/trace/*.js dist-test/test/node-execution/**/*.js dist-test/test/aiScoping/*.js dist-test/test/intermediateSteps/*.js dist-test/test/post-steps/**/*.js dist-test/test/planWebScopeQuestions/*.js dist-test/test/synthesis/*.js dist-test/test/fact-guard/*.js dist-test/test/utils/*.js dist-test/test/errors/*.js dist-test/test/validation/*.js dist-test/test/web-scope/*.js dist-test/test/task-strategies/*.js dist-test/test/observability/*.js dist-test/test/run-task/*.js dist-test/test/internal/*.js dist-test/test/execution-strategies/*.js dist-test/test/invocation/*.js dist-test/test/e2e/*.js",
+    "test:e2e:intermediateSteps": "node scripts/run-with-env.mjs RUN_INTERMEDIATE_STEPS_E2E=1 npm run test",
+    "test:e2e:synthesis": "node scripts/run-synthesis-e2e.mjs",
+    "test:e2e:webScope": "node scripts/run-web-scope-e2e.mjs",
+    "test:fact-guard": "node scripts/ensure-xynthesis-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node --test --test-force-exit dist-test/test/fact-guard/*.js dist-test/test/post-steps/runPostStepLlmCall.factGuard.test.js",
+    "test:live": "node scripts/run-live-ai-e2e.mjs",
+    "publish:task-strategies": "tsx scripts/publish-ai-task-strategies-catalog.ts"
+  },
+  "keywords": [
+    "ai",
+    "tasks",
+    "llm",
+    "skills",
+    "orchestration",
+    "erc",
+    "env-ready"
+  ],
+  "author": "exellix",
+  "license": "exellix-license",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/exellix/ai-tasks.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "overrides": {
+    "@x12i/catalox": "^5.9.8",
+    "@x12i/catalox-contracts": "^5.9.8"
+  },
+  "dependencies": {
+    "@exellix/ai-skills": "^6.12.5",
+    "@exellix/fact-guard-adapters": "^1.0.1",
+    "@exellix/fact-guard-enrichment": "^1.0.1",
+    "@exellix/fact-guard-policies": "^1.0.1",
+    "@exellix/fact-guard-types": "^1.0.1",
+    "@exellix/fact-guard-validation": "^1.0.1",
+    "@exellix/xynthesis": "^4.8.4",
+    "@x12i/activix": "^8.6.3",
+    "@x12i/ai-profiles": "^3.4.0",
+    "@x12i/catalox": "^5.9.8",
+    "@x12i/execution-memory-manager": "^1.2.0",
+    "@x12i/funcx": "^4.9.13",
+    "@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.12.0",
+    "@x12i/logxer": "^4.6.0",
+    "@x12i/optimixer": "^3.5.2",
+    "@x12i/rendrix": "^4.3.0",
+    "@x12i/search-adapter": "^1.5.1",
+    "@x12i/web-scoper": "^1.1.1",
+    "handlebars": "^4.7.8",
+    "nx-cache": "^1.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^18.0.0 || ^20.0.0",
+    "@x12i/catalox-contracts": "^5.9.8",
+    "@x12i/graphenix-authoring-format": "^2.11.0",
+    "@x12i/graphenix-plan-compiler": "^2.11.0",
+    "@x12i/graphenix-task-node-format": "^2.11.0",
+    "dotenv": "^16.0.0",
+    "ts-node": "^10.9.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}