@exellix/graph-engine 8.6.0 → 8.7.0

package/README.md

@@ -55,7 +55,7 @@ npm install @exellix/graph-engine
 
 **Upstream tasks SDK:** This package depends on **`@exellix/ai-tasks` ^8.6.8** and **`@x12i/funcx` 4.4.4** (see **`package.json`**). Graph-engine emits **`RunTaskRequest`** shapes that match the ai-tasks **8.x** closed schema (mandatory **`executionStrategies`**, three-slot **`modelConfig`**, **`xynthesized`**, optional **`smartInput`**, no legacy root mirrors). Pin compatible versions in your app lockfile. Optional CI improvement: fail or warn when the resolved ai-tasks major/minor drifts outside an allowlist (not enforced in-repo today).
 
-### Execution matrix hosts (`@exellix/exellix-runtime`) — documentation only for the engine
+### Execution matrix hosts (`@x12i/exellix-runtime`) — documentation only for the engine
 
 Matrix **claim**, **rows**, and **retry policy** live outside this package. If your host wires **matrix → graph run**, see [.docs/execution-matrix-handoff.md](.docs/execution-matrix-handoff.md) for how **you** should inject `runtime.executeGraph`, compile **`GraphModelObject` → plan**, resolve **`metadata.graphEntry` per model**, seed **`runtime.executionMemory`**, and pass **`runtime.jobId`**. Helpers such as **`buildMatrixJobForGraphRun`** align **`id`** and **`job.jobId`** on the `job` object so you can call **`runtime.executeGraph({ plan, runtime: { jobId: job.jobId, job, … } })`**. Those exports are **optional helpers for callers**; they do **not** expand graph-engine’s role beyond **executing the single run** when invoked.
 
@@ -329,7 +329,7 @@ When **`taskConfiguration.aiTaskProfile.inputSynthesis`** is enabled, graph-engi
 
 1. **Engine PRE/POST strategy utilities (ai-tasks only):** `taskConfiguration.aiTaskProfile.preStrategyKey` / `postStrategyKey` → extra **`runTask`** calls via **`@exellix/ai-tasks`** before/after MAIN; outputs stored at **`execution.xynthesis.pre`** / **`execution.xynthesis.post`** (historical slot names).
 2. **`executionPipeline` inside ai-tasks:** e.g. PRE **`synthesized-context`** + MAIN direct — still **one** outbound MAIN `runTask` handled inside `@exellix/ai-tasks`.
-3. **Narrix web scope inside ai-tasks:** when **`taskConfiguration.aiTaskProfile.webScoping.enabled`** is true, graph-engine forwards a `narrix` payload with `enableWebScope` / `webScopeQuestions`. The actual web fetch + skip rules run **inside `@exellix/ai-tasks`** (`@exellix/narrix-web-scoper`); graph-engine has **no local web phase** in 5.x.
+3. **Narrix web scope inside ai-tasks:** when **`taskConfiguration.aiTaskProfile.webScoping.enabled`** is true, graph-engine forwards a `narrix` payload with `enableWebScope` / `webScopeQuestions`. The actual web fetch + skip rules run **inside `@exellix/ai-tasks`** (`@x12i/narrix-web-scoper`); graph-engine has **no local web phase** in 5.x.
 
 `synthesize` finalizers are a fourth outbound task-call shape: the finalizer is still a graph model node, but its terminal utility `runTask` uses the same run identity, diagnostics, `llmCall`, and resolved model config as the rest of the graph run.
 

package/dist/src/contract/graphRunContract.d.ts

@@ -0,0 +1,37 @@
+export type GraphRunPersistencyLink = {
+    /** Relation descriptor key (result entity → source entity). */
+    relationKey?: string;
+    /** Dot-path on the new record where the source recordId/entityId FK is written. */
+    fkPath?: string;
+    type?: 'oneToOne' | 'oneToMany' | 'manyToOne' | 'manyToMany';
+    /** Content type the relation targets on the source (default: source job contentType). */
+    targetContentType?: string;
+};
+export type GraphRunPersistency = {
+    /** Target object type; default `same-as-input`. */
+    entityId: string | 'same-as-input';
+    /** Result collection content type; default {@link DEFAULT_GRAPH_RUN_PERSISTENCY_CONTENT_TYPE}. */
+    contentType: string;
+    /** When true (default), always insert a new result record with a new recordId. */
+    newRecord?: boolean;
+    /** Cross-object link intent; auto-derived when {@link entityId} differs from the job source. */
+    link?: GraphRunPersistencyLink;
+};
+export type GraphRunContract = {
+    graphId: string;
+    persistency: GraphRunPersistency | null;
+    graphVersion?: string;
+};
+/** Parse a work/job/graph persistency object (partial fields allowed). */
+export declare function parseGraphRunPersistency(raw: unknown): GraphRunPersistency | null;
+/** Work/job overrides win over graph defaults; partial overrides merge field-by-field. */
+export declare function mergeGraphRunPersistency(base: GraphRunPersistency | null, override: GraphRunPersistency | null): GraphRunPersistency | null;
+/** Apply a run/work/job persistency override onto a resolved graph contract. */
+export declare function applyGraphRunContractOverride(contract: GraphRunContract, persistencyOverride: unknown): GraphRunContract;
+/** Read graph document version from published graph JSON (`version` or `metadata.version`). */
+export declare function readGraphDocumentVersion(graphDoc: unknown): string | undefined;
+/** Resolve graph-run contract from published graph JSON (GRX-NOTE-001). */
+export declare function resolveGraphRunContract(graphId: string, graphDoc: unknown): GraphRunContract;
+export declare function loadGraphRunContracts(graphIds: string[], graphLoader: {
+    loadGraph(graphId: string): Promise<unknown>;
+}): Promise<GraphRunContract[]>;

package/dist/src/contract/graphRunContract.js

@@ -0,0 +1,130 @@
+import { DEFAULT_GRAPH_RUN_PERSISTENCY_CONTENT_TYPE } from './persistencyDefaults.js';
+const RELATION_TYPES = new Set(['oneToOne', 'oneToMany', 'manyToOne', 'manyToMany']);
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    return value;
+}
+function readLink(raw) {
+    const link = asRecord(raw);
+    if (!link)
+        return undefined;
+    const out = {};
+    if (typeof link.relationKey === 'string' && link.relationKey.length > 0) {
+        out.relationKey = link.relationKey;
+    }
+    if (typeof link.fkPath === 'string' && link.fkPath.length > 0) {
+        out.fkPath = link.fkPath;
+    }
+    if (typeof link.type === 'string' && RELATION_TYPES.has(link.type)) {
+        out.type = link.type;
+    }
+    if (typeof link.targetContentType === 'string' && link.targetContentType.length > 0) {
+        out.targetContentType = link.targetContentType;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function normalizePersistency(raw) {
+    const entityIdRaw = raw.entityId;
+    const entityId = entityIdRaw === 'same-as-input'
+        ? 'same-as-input'
+        : typeof entityIdRaw === 'string' && entityIdRaw.length > 0
+            ? entityIdRaw
+            : 'same-as-input';
+    const contentTypeRaw = raw.contentType;
+    const contentType = typeof contentTypeRaw === 'string' && contentTypeRaw.length > 0
+        ? contentTypeRaw
+        : DEFAULT_GRAPH_RUN_PERSISTENCY_CONTENT_TYPE;
+    const newRecord = raw.newRecord === false ? false : true;
+    const link = readLink(raw.link);
+    return {
+        entityId,
+        contentType,
+        newRecord,
+        ...(link ? { link } : {}),
+    };
+}
+/** Parse a work/job/graph persistency object (partial fields allowed). */
+export function parseGraphRunPersistency(raw) {
+    const rec = asRecord(raw);
+    if (!rec)
+        return null;
+    return normalizePersistency(rec);
+}
+/** Work/job overrides win over graph defaults; partial overrides merge field-by-field. */
+export function mergeGraphRunPersistency(base, override) {
+    if (!override)
+        return base;
+    if (!base)
+        return override;
+    return {
+        entityId: override.entityId,
+        contentType: override.contentType,
+        newRecord: override.newRecord !== undefined ? override.newRecord : base.newRecord,
+        link: override.link ? { ...base.link, ...override.link } : base.link,
+    };
+}
+function mergeRawPersistency(base, rawOverride) {
+    const overrideRec = asRecord(rawOverride);
+    if (!overrideRec)
+        return base;
+    const merged = {
+        ...(base
+            ? {
+                entityId: base.entityId,
+                contentType: base.contentType,
+                ...(base.newRecord === false ? { newRecord: false } : {}),
+                ...(base.link ? { link: { ...base.link } } : {}),
+            }
+            : {}),
+        ...overrideRec,
+    };
+    const overrideLink = asRecord(overrideRec.link);
+    if (base?.link && overrideLink) {
+        merged.link = { ...base.link, ...overrideLink };
+    }
+    return normalizePersistency(merged);
+}
+/** Apply a run/work/job persistency override onto a resolved graph contract. */
+export function applyGraphRunContractOverride(contract, persistencyOverride) {
+    return {
+        ...contract,
+        persistency: mergeRawPersistency(contract.persistency, persistencyOverride),
+    };
+}
+function readPersistency(graph) {
+    const response = asRecord(graph.response);
+    const fromResponse = asRecord(response?.persistency);
+    if (fromResponse) {
+        return normalizePersistency(fromResponse);
+    }
+    const metadata = asRecord(graph.metadata);
+    const graphResponse = asRecord(metadata?.graphResponse);
+    const legacy = asRecord(graphResponse?.persistency);
+    if (legacy) {
+        return normalizePersistency(legacy);
+    }
+    return null;
+}
+/** Read graph document version from published graph JSON (`version` or `metadata.version`). */
+export function readGraphDocumentVersion(graphDoc) {
+    const graph = asRecord(graphDoc) ?? {};
+    const metadata = asRecord(graph.metadata);
+    if (typeof graph.version === 'string')
+        return graph.version;
+    if (typeof metadata?.version === 'string')
+        return metadata.version;
+    return undefined;
+}
+/** Resolve graph-run contract from published graph JSON (GRX-NOTE-001). */
+export function resolveGraphRunContract(graphId, graphDoc) {
+    const graph = asRecord(graphDoc) ?? {};
+    return {
+        graphId,
+        persistency: readPersistency(graph),
+        graphVersion: readGraphDocumentVersion(graph),
+    };
+}
+export async function loadGraphRunContracts(graphIds, graphLoader) {
+    return Promise.all(graphIds.map(async (graphId) => resolveGraphRunContract(graphId, await graphLoader.loadGraph(graphId))));
+}

package/dist/src/contract/persistencyDefaults.d.ts

@@ -0,0 +1,2 @@
+/** Default result content type for graph-run persistency. */
+export declare const DEFAULT_GRAPH_RUN_PERSISTENCY_CONTENT_TYPE = "inferences";

package/dist/src/contract/persistencyDefaults.js

@@ -0,0 +1,2 @@
+/** Default result content type for graph-run persistency. */
+export const DEFAULT_GRAPH_RUN_PERSISTENCY_CONTENT_TYPE = 'inferences';

package/dist/src/index.d.ts

@@ -79,7 +79,7 @@ export type { BuildTaskNodeRunTaskRequestArgs, BuildTaskNodeRunTaskRequestResult
 /** Re-exported from `@exellix/ai-tasks` — preflight validation without `runTask`. */
 export { validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, collectSmartInputValidationIssues, buildRunTaskValidationContext, validateParsedOutput, listTokens, analyzeTemplateResolution, renderSmartInput, extractTokenNamesFromStrings, getSkillTokens, getSkillContent, } from '@exellix/ai-tasks';
 export type { RunTaskValidationIssue, RunTaskValidationResult, RunTaskInvokeValidationResult, ExpectedRunTaskInputPath, AnalyzeExpectedRunTaskInputResult, ValidateRunTaskInvokeParams, RunTaskTemplateResolver, OutputValidationResult, } from '@exellix/ai-tasks';
-export { buildExellixGraphRuntimeObjects, setRuntimeObjectsLastJobId, summarizeRuntimeObjectsForPlayground, EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME, EXELLIX_AI_TASKS_PACKAGE_NAME, } from './runtime/runtimeObjects.js';
+export { buildExellixGraphRuntimeObjects, setRuntimeObjectsLastJobId, summarizeRuntimeObjectsForPlayground, X12I_GRAPH_RUNTIME_PACKAGE_NAME, X12I_AI_TASKS_PACKAGE_NAME, } from './runtime/runtimeObjects.js';
 export type { ActivixQueryableClient, LogxerQueryableClient, LogxerLogLine, PackageRuntimeObjects, RuntimeObjects, BuildExellixGraphRuntimeObjectsInput, RuntimeObjectsObservabilitySummary, } from './runtime/runtimeObjects.js';
 export type { GetJobLogsInput, GetJobLogsResult, QueryableLogLine } from '@x12i/logxer';
 export { assertCanonicalGraphDocument, assertCanonicalTaskNode, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, } from './runtime/validateCanonicalGraphDocument.js';
@@ -120,5 +120,7 @@ export type { CreatePlaygroundReporterOptions, PlaygroundDebugArtifact, Playgrou
 export { getNodeScopingQuestion, getNodeMemoryShape, getNodeNarrixDiscovery, fetchNodeScopingData, inspectNode, resolveNodeSkillKey, getGraphNodes, getGraphCatalogs, inspectGraph, collectPredicatePaths, executionMemoryPathTail, executionMemoryTailsMatch, getNodeExecutionMemoryWriteTails, getNodeControlDependencies, getNodeSideEffects, inspectFinalizer, inspectNodeContract, inspectGraphContracts, EXELLIX_VIRTUAL_GRAPH_ENTRY_NODE_ID, EXELLIX_VIRTUAL_GRAPH_RESPONSE_NODE_ID, EXELLIX_VIRTUAL_BOUNDARY_NODE_METADATA_KEY, EXELLIX_VIRTUAL_BOUNDARY_EDGE_FLAG_KEY, getVirtualGraphEntryLayer, getVirtualGraphResponseLayer, materializeVirtualBoundaryDiagram, stripMaterializedVirtualBoundaryDiagram, validateCatalogPlanning, isCatalogBinding, isCatalogRequestEntry, inspectGraphModelSelection, } from './inspection/index.js';
 export type { GraphModelSelectionInspection, NodeModelSelection, ModelSelectionSource, NodeScopingQuestion, NodeScopeSource, NodeScopeTarget, NodeScopingData, NodeMemoryShape, MemoryPath, NodeNarrixDiscovery, NodeInspection, GraphInspection, NodeIOEdge, GraphCatalogs, CatalogBindingSummary, CatalogPlanningValidationIssue, GraphVirtualIO, GraphVirtualIONode, GraphVirtualIOEdge, GraphVirtualIONodeRole, VirtualGraphEntryLayer, VirtualGraphResponseLayer, MaterializeVirtualBoundaryDiagramOptions, MaterializedVirtualBoundaryDiagram, MaterializedVirtualBoundaryDiagramMeta, InspectNodeContractOptions, LocalSkillKey, NodeExecutionType, FactProvenance, ProvenancedSection, NodeInputBindingEntry, ScopedDataDependency, NodeInputContract, ExecutionMemoryWriteSpec, NodeOutputContract, NodeSideEffects, ControlBranchEntry, NodeControlContract, NodeValidationContract, FinalizerContractInspection, NodeContractInspection, GraphContractsInspection, } from './inspection/index.js';
 export type { NarrixPreProcessorConfig, NarrixModeKey, NarrixRunInput, NarrixScope, ResolvedNarrixWirePayload, LocalTaskHandler, LocalTaskContext, } from './types/narrix.js';
+export { resolveGraphRunContract, loadGraphRunContracts, readGraphDocumentVersion, parseGraphRunPersistency, mergeGraphRunPersistency, applyGraphRunContractOverride, type GraphRunContract, type GraphRunPersistency, type GraphRunPersistencyLink, } from './contract/graphRunContract.js';
+export { DEFAULT_GRAPH_RUN_PERSISTENCY_CONTENT_TYPE } from './contract/persistencyDefaults.js';
 export { shutdownMemorixRuntime } from './runtime/localSkills/memorixRuntime.js';
 export type { ScopedDataReaderConfig, ScopedDataReaderOutput, ScopedDataReaderPackOutput, ScopedAnswerAssemblerConfig, ScopedAnswerAssemblerOutput, ScopedAnswerWriterConfig, ScopedAnswerWriterOutput, } from './runtime/localSkills/index.js';

package/dist/src/index.js

@@ -60,7 +60,7 @@ export { runTaskResponseSucceeded } from './runtime/runTaskResponse.js';
 export { buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, } from './runtime/taskNodeRunTaskPreflight.js';
 /** Re-exported from `@exellix/ai-tasks` — preflight validation without `runTask`. */
 export { validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, collectSmartInputValidationIssues, buildRunTaskValidationContext, validateParsedOutput, listTokens, analyzeTemplateResolution, renderSmartInput, extractTokenNamesFromStrings, getSkillTokens, getSkillContent, } from '@exellix/ai-tasks';
-export { buildExellixGraphRuntimeObjects, setRuntimeObjectsLastJobId, summarizeRuntimeObjectsForPlayground, EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME, EXELLIX_AI_TASKS_PACKAGE_NAME, } from './runtime/runtimeObjects.js';
+export { buildExellixGraphRuntimeObjects, setRuntimeObjectsLastJobId, summarizeRuntimeObjectsForPlayground, X12I_GRAPH_RUNTIME_PACKAGE_NAME, X12I_AI_TASKS_PACKAGE_NAME, } from './runtime/runtimeObjects.js';
 export { assertCanonicalGraphDocument, assertCanonicalTaskNode, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, } from './runtime/validateCanonicalGraphDocument.js';
 export { assertCanonicalGraphRuntimeObject } from './runtime/validateCanonicalGraphRuntime.js';
 export { GRAPH_ENTRY_STUDIO_ONLY_KEYS, GRAPH_METADATA_STUDIO_ONLY_KEYS, stripGraphModelStudioFields, primaryRuntimeInputFromStudioDocument, getGraphEntryStudioOnlyKeyViolations, getGraphMetadataStudioOnlyKeyViolations, } from './runtime/graphModelStudioSeparation.js';
@@ -88,5 +88,8 @@ export { composeEventEmitters } from './runtime/events.js';
 export { createPlaygroundReporter } from './playground/index.js';
 // Graph Inspection API
 export { getNodeScopingQuestion, getNodeMemoryShape, getNodeNarrixDiscovery, fetchNodeScopingData, inspectNode, resolveNodeSkillKey, getGraphNodes, getGraphCatalogs, inspectGraph, collectPredicatePaths, executionMemoryPathTail, executionMemoryTailsMatch, getNodeExecutionMemoryWriteTails, getNodeControlDependencies, getNodeSideEffects, inspectFinalizer, inspectNodeContract, inspectGraphContracts, EXELLIX_VIRTUAL_GRAPH_ENTRY_NODE_ID, EXELLIX_VIRTUAL_GRAPH_RESPONSE_NODE_ID, EXELLIX_VIRTUAL_BOUNDARY_NODE_METADATA_KEY, EXELLIX_VIRTUAL_BOUNDARY_EDGE_FLAG_KEY, getVirtualGraphEntryLayer, getVirtualGraphResponseLayer, materializeVirtualBoundaryDiagram, stripMaterializedVirtualBoundaryDiagram, validateCatalogPlanning, isCatalogBinding, isCatalogRequestEntry, inspectGraphModelSelection, } from './inspection/index.js';
+// Graph-run contract (GRX-NOTE-001) — persistency intent from published graph JSON
+export { resolveGraphRunContract, loadGraphRunContracts, readGraphDocumentVersion, parseGraphRunPersistency, mergeGraphRunPersistency, applyGraphRunContractOverride, } from './contract/graphRunContract.js';
+export { DEFAULT_GRAPH_RUN_PERSISTENCY_CONTENT_TYPE } from './contract/persistencyDefaults.js';
 export { shutdownMemorixRuntime } from './runtime/localSkills/memorixRuntime.js';
 // Web context rendering — consume execution.webContext → markdown for prompts (Layer 04)

package/dist/src/integrations/activixExellixShared.js

@@ -1,4 +1,4 @@
-import { EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME } from '../runtime/runtimeObjects.js';
+import { X12I_GRAPH_RUNTIME_PACKAGE_NAME } from '../runtime/runtimeObjects.js';
 /** Recommended Mongo indexes for exellix-graph Activix streams (see `@x12i/activix` README). */
 export const ACTIVIX_EXELLIX_RUN_CONTEXT_INDEXES = [
     { keys: { 'runContext.jobId': 1 } },
@@ -55,5 +55,5 @@ export function buildNodeActivixRunContext(args) {
     };
 }
 export function activixExellixCollectionRegistryOwner() {
-    return { package: EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME };
+    return { package: X12I_GRAPH_RUNTIME_PACKAGE_NAME };
 }

package/dist/src/runtime/executionMatrixHost.d.ts

@@ -1,5 +1,5 @@
 /**
- * Host helpers for execution-matrix style orchestrators (e.g. `@exellix/exellix-runtime`).
+ * Host helpers for execution-matrix style orchestrators (e.g. `@x12i/exellix-runtime`).
  *
  * Graph-engine does not call matrix claim APIs; the host injects `executeGraph` and supplies
  * a `{ plan, runtime }` request with per-graph `GraphEntryContract` + seeded
@@ -83,7 +83,7 @@ export declare function buildMatrixJobForGraphRun(input: {
 export declare function isExecuteGraphResultFailed(result: ExecuteGraphResult): boolean;
 /**
  * Creates a long-lived graph runtime and exposes `executeGraph` for injection into matrix claim
- * processors (`ProcessMatrixClaimDeps.executeGraph` in `@exellix/exellix-runtime`, etc.).
+ * processors (`ProcessMatrixClaimDeps.executeGraph` in `@x12i/exellix-runtime`, etc.).
  */
 export declare function createMatrixHostGraphExecutor(options: ExellixGraphRuntimeOptions): {
     executeGraph: (input: ExecuteGraphInput) => Promise<ExecuteGraphResult>;

package/dist/src/runtime/executionMatrixHost.js

@@ -1,5 +1,5 @@
 /**
- * Host helpers for execution-matrix style orchestrators (e.g. `@exellix/exellix-runtime`).
+ * Host helpers for execution-matrix style orchestrators (e.g. `@x12i/exellix-runtime`).
  *
  * Graph-engine does not call matrix claim APIs; the host injects `executeGraph` and supplies
  * a `{ plan, runtime }` request with per-graph `GraphEntryContract` + seeded
@@ -92,7 +92,7 @@ export function isExecuteGraphResultFailed(result) {
 }
 /**
  * Creates a long-lived graph runtime and exposes `executeGraph` for injection into matrix claim
- * processors (`ProcessMatrixClaimDeps.executeGraph` in `@exellix/exellix-runtime`, etc.).
+ * processors (`ProcessMatrixClaimDeps.executeGraph` in `@x12i/exellix-runtime`, etc.).
  */
 export function createMatrixHostGraphExecutor(options) {
     const { executeGraph } = createExellixGraphRuntime(options);

package/dist/src/runtime/graphEngineLogMeta.js

@@ -1,10 +1,10 @@
-import { EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME } from './runtimeObjects.js';
+import { X12I_GRAPH_RUNTIME_PACKAGE_NAME } from './runtimeObjects.js';
 /** Canonical filter key for graph-engine's own log lines. */
 export const GRAPH_ENGINE_RUNTIME_SERVICE = 'graph-engine';
 /** Wrapper attribution when graph-engine proxies a downstream Logxer record. */
 export const GRAPH_ENGINE_PROXY_RUNTIME_IDENTITY = {
     service: GRAPH_ENGINE_RUNTIME_SERVICE,
-    libraryPackage: EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME,
+    libraryPackage: X12I_GRAPH_RUNTIME_PACKAGE_NAME,
 };
 function isRecord(value) {
     return value != null && typeof value === 'object' && !Array.isArray(value);

package/dist/src/runtime/graphEngineLogxer.js

@@ -1,6 +1,6 @@
 const logxer = await import('@x12i/logxer');
 import { ExellixGraphErrorCode } from '../errors/exellixGraphErrorCodes.js';
-import { EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME } from './runtimeObjects.js';
+import { X12I_GRAPH_RUNTIME_PACKAGE_NAME } from './runtimeObjects.js';
 import { normalizeGraphEngineLogMeta, } from './graphEngineLogMeta.js';
 export { GRAPH_ENGINE_RUNTIME_SERVICE, GRAPH_ENGINE_PROXY_RUNTIME_IDENTITY, extractOriginRuntimeIdentity, normalizeGraphEngineLogMeta, } from './graphEngineLogMeta.js';
 /** Env prefix for package-level log level: `GRAPH_ENGINE_LOGS_LEVEL` (canonical). */
@@ -116,7 +116,7 @@ function wrapGraphEngineLogxer(inner) {
 /** Factory for a graph-engine Logxer instance (logxer 4.5+ stack pass-through). */
 export function createGraphEngineLogxer(options) {
     const inner = logxer.createLogxer({
-        packageName: EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME,
+        packageName: X12I_GRAPH_RUNTIME_PACKAGE_NAME,
         envPrefix: GRAPH_ENGINE_LOGXER_ENV_PREFIX,
         debugNamespace: 'graph-engine',
     }, buildGraphEngineLogxerConfig(options?.logging));

package/dist/src/runtime/runtimeObjects.d.ts

@@ -4,9 +4,9 @@
  */
 import type { GetJobLogsInput, GetJobLogsResult, QueryableLogLine } from '@x12i/logxer';
 /** Published npm name of this package (root layer in composed observability). */
-export declare const EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME: "@exellix/graph-engine";
+export declare const X12I_GRAPH_RUNTIME_PACKAGE_NAME: "@exellix/graph-engine";
 /** Task layer package name in {@link RuntimeObjects.packagesRuntimeObjects}. */
-export declare const EXELLIX_AI_TASKS_PACKAGE_NAME: "@exellix/ai-tasks";
+export declare const X12I_AI_TASKS_PACKAGE_NAME: "@exellix/ai-tasks";
 export type ActivixQueryableClient = {
     getJobActivities(input: {
         jobId: string;
@@ -43,15 +43,15 @@ export type BuildExellixGraphRuntimeObjectsInput = {
     graphLogxerClient?: LogxerQueryableClient;
     /**
      * Partial subtree from `@exellix/ai-tasks` when that package exports `runtimeObjects`.
-     * Nested `packagesRuntimeObjects` are appended after the ai-tasks row without overwriting entries.
+     * Nested `packagesRuntimeObjects` are appended after the x12i-tasks row without overwriting entries.
      */
     aiTasksRuntimeObjects?: Pick<RuntimeObjects, 'activixClient' | 'logxerClient'> & {
         packagesRuntimeObjects?: PackageRuntimeObjects[];
     };
 };
 /**
- * Builds the composed {@link RuntimeObjects} for exellix-graph: graph-level clients at the root,
- * then an `@exellix/ai-tasks` package row plus any nested package rows from ai-tasks (flattened as siblings).
+ * Builds the composed {@link RuntimeObjects} for x12i-graph: graph-level clients at the root,
+ * then an `@exellix/ai-tasks` package row plus any nested package rows from x12i-tasks (flattened as siblings).
  */
 export declare function buildExellixGraphRuntimeObjects(input: BuildExellixGraphRuntimeObjectsInput): RuntimeObjects;
 /**

package/dist/src/runtime/runtimeObjects.js

@@ -1,17 +1,17 @@
 /** Published npm name of this package (root layer in composed observability). */
-export const EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME = '@exellix/graph-engine';
+export const X12I_GRAPH_RUNTIME_PACKAGE_NAME = '@exellix/graph-engine';
 /** Task layer package name in {@link RuntimeObjects.packagesRuntimeObjects}. */
-export const EXELLIX_AI_TASKS_PACKAGE_NAME = '@exellix/ai-tasks';
+export const X12I_AI_TASKS_PACKAGE_NAME = '@exellix/ai-tasks';
 /**
- * Builds the composed {@link RuntimeObjects} for exellix-graph: graph-level clients at the root,
- * then an `@exellix/ai-tasks` package row plus any nested package rows from ai-tasks (flattened as siblings).
+ * Builds the composed {@link RuntimeObjects} for x12i-graph: graph-level clients at the root,
+ * then an `@exellix/ai-tasks` package row plus any nested package rows from x12i-tasks (flattened as siblings).
  */
 export function buildExellixGraphRuntimeObjects(input) {
     const ai = input.aiTasksRuntimeObjects;
     const tail = [...(ai?.packagesRuntimeObjects ?? [])];
     const packagesRuntimeObjects = [
         {
-            name: EXELLIX_AI_TASKS_PACKAGE_NAME,
+            name: X12I_AI_TASKS_PACKAGE_NAME,
             activixClient: ai?.activixClient,
             logxerClient: ai?.logxerClient,
         },

package/dist/src/types/aiTaskProfile.d.ts

@@ -1,5 +1,5 @@
 /**
- * Optional task metadata aligned with `@x12i/graph-composer` authoring / `reportTaskNodeProtocolGaps`.
+ * Optional task metadata aligned with `@exellix/graph-composer` authoring / `reportTaskNodeProtocolGaps`.
  * Web scope is authored via {@link AiTaskProfileMetadata.webQueryTemplate} (Graphenix 2.7.3+ PRE `webScope` unit).
  */
 export type AiTaskProfileInputSynthesis = {
@@ -18,7 +18,7 @@ export type AiTaskProfileInputSynthesis = {
 };
 /**
  * PRE/POST strategies, optional web query template, optional input synthesis for AI task nodes.
- * `@x12i/graph-composer` requires `preStrategyKey` / `postStrategyKey` for validated AI nodes.
+ * `@exellix/graph-composer` requires `preStrategyKey` / `postStrategyKey` for validated AI nodes.
  *
  * **Web scope (Graphenix 2.7.3+):** Non-empty `webQueryTemplate` (or `webQueryTemplates[]`) compiles to a PRE
  * `webScope` unit; graph-engine does not merge web intent into `taskConfiguration.narrix`.

package/dist/src/types/aiTaskProfile.js

@@ -1,5 +1,5 @@
 /**
- * Optional task metadata aligned with `@x12i/graph-composer` authoring / `reportTaskNodeProtocolGaps`.
+ * Optional task metadata aligned with `@exellix/graph-composer` authoring / `reportTaskNodeProtocolGaps`.
  * Web scope is authored via {@link AiTaskProfileMetadata.webQueryTemplate} (Graphenix 2.7.3+ PRE `webScope` unit).
  */
 export function hasWebScopeAuthoring(profile) {

package/docs/handoff/graphs-studio-graphenix-2.7.3.md

@@ -1,13 +1,13 @@
-# graphs-studio — Graphenix 2.7.3 alignment handoff
-
-Shipped with **@exellix/graph-engine@8.6.0** / **@exellix/graph-composer@2.12.0**.
-
-Full checklist: see Exellix monorepo `docs/handoff/graphs-studio-graphenix-2.7.3.md` (canonical copy). Summary:
-
-1. **Web scope:** `taskConfiguration.aiTaskProfile.webQueryTemplate` — remove `webScoping` and narrix web keys.
-2. **Graph entry:** no `graphEntry.inputs` (CR-006); use `requiredExecutionPaths` + jobs-ui data sources.
-3. **Persistency:** `response.persistency` with `newRecord` + optional `link` (Graphenix 2.7.3).
-4. **Preflight:** show `nodePlan.invokeContract.pipeline`, not root `RunTaskRequest.narrix`.
-5. **CRS-FRS-005:** PRE synthesis export parity still pending in studio (separate track).
-
-Pin: `graph-engine ^8.6.0`, `graph-composer ^2.12.0`, `ai-tasks ^10.0.12+`, `graphenix ^2.7.3`.
+# graphs-studio — Graphenix 2.7.3 alignment handoff
+
+Shipped with **@exellix/graph-engine@8.6.0** / **@exellix/graph-composer@2.12.0**.
+
+Full checklist: see Exellix monorepo `docs/handoff/graphs-studio-graphenix-2.7.3.md` (canonical copy). Summary:
+
+1. **Web scope:** `taskConfiguration.aiTaskProfile.webQueryTemplate` — remove `webScoping` and narrix web keys.
+2. **Graph entry:** no `graphEntry.inputs` (CR-006); use `requiredExecutionPaths` + jobs-ui data sources.
+3. **Persistency:** `response.persistency` with `newRecord` + optional `link` (Graphenix 2.7.3).
+4. **Preflight:** show `nodePlan.invokeContract.pipeline`, not root `RunTaskRequest.narrix`.
+5. **CRS-FRS-005:** PRE synthesis export parity still pending in studio (separate track).
+
+Pin: `graph-engine ^8.6.0`, `graph-composer ^2.12.0`, `ai-tasks ^10.0.12+`, `graphenix ^2.7.3`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-engine",
-  "version": "8.6.0",
+  "version": "8.7.0",
   "type": "module",
   "description": "Graph executor SDK",
   "main": "dist/src/index.js",
@@ -27,7 +27,7 @@
     "prebuild": "node scripts/clean-dist.mjs",
     "build": "tsc",
     "test": "npm run build && npm run check:no-legacy && tsx --test --test-force-exit --test-timeout=180000 --test-concurrency=2 tests/model-alias-canonical.test.ts tests/model-alias-execute.test.ts tests/model-alias-strategy.test.ts tests/model-alias-subnets.test.ts tests/ai-tasks-error-propagation.test.ts tests/reports-fixtures-pre-synthesis.test.ts tests/passthrough-parity.test.ts tests/step-retry-llm-call.test.ts tests/run-log-diagnostics.test.ts",
-    "test:full": "npm run build && npm run check:no-legacy && tsx --test --test-force-exit --test-timeout=180000 --test-concurrency=2 tests/graph-engine.test.ts tests/passthrough-parity.test.ts tests/task-node-run-task-preflight.test.ts tests/reports-fixtures-pre-synthesis.test.ts tests/model-alias-canonical.test.ts tests/model-alias-execute.test.ts tests/model-alias-strategy.test.ts tests/model-alias-subnets.test.ts tests/compile-host-patches.test.ts tests/reference-fixtures-compile.test.ts tests/step-retry-llm-call.test.ts",
+    "test:full": "npm run build && npm run check:no-legacy && tsx --test --test-force-exit --test-timeout=180000 --test-concurrency=2 tests/graph-engine.test.ts tests/graph-run-contract.test.ts tests/passthrough-parity.test.ts tests/task-node-run-task-preflight.test.ts tests/reports-fixtures-pre-synthesis.test.ts tests/model-alias-canonical.test.ts tests/model-alias-execute.test.ts tests/model-alias-strategy.test.ts tests/model-alias-subnets.test.ts tests/compile-host-patches.test.ts tests/reference-fixtures-compile.test.ts tests/step-retry-llm-call.test.ts",
     "test:live": "npm run run:pre-synthesis",
     "test:subnets-graph-fixture": "npm run build && node --test tests/subnets-graph.fixture.test.mjs",
     "test:subnets-graph-live": "npm run build && node --env-file=.env --test tests/subnets-graph.live.test.mjs",
@@ -46,7 +46,8 @@
   "license": "exellix-license",
   "repository": {
     "type": "git",
-    "url": "git@github.com:exellix/graph-engine.git"
+    "url": "git+ssh://git@github.com/exellix/exellix-engine-mono-repo.git",
+    "directory": "graph-engine"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -57,23 +58,23 @@
     "@exellix/ai-tasks": "^10.0.13",
     "@x12i/activix": "^8.6.3",
     "@x12i/catalox": "^5.9.8",
-    "@x12i/env": "^4.0.1",
+    "@x12i/env": "^4.0.3",
     "@x12i/funcx": "^4.9.13",
     "@x12i/graphenix": "^2.5.0",
-    "@x12i/graphenix-authoring-format": "^2.7.3",
-    "@x12i/graphenix-core": "^2.7.3",
-    "@x12i/graphenix-executable-contracts": "^2.7.3",
-    "@x12i/graphenix-executable-format": "^2.7.3",
-    "@x12i/graphenix-execute-envelope": "^2.7.3",
+    "@x12i/graphenix-authoring-format": "^2.8.1",
+    "@x12i/graphenix-core": "^2.8.1",
+    "@x12i/graphenix-executable-contracts": "^2.8.1",
+    "@x12i/graphenix-executable-format": "^2.8.1",
+    "@x12i/graphenix-execute-envelope": "^2.8.1",
     "@x12i/graphenix-format": "^2.0.0",
-    "@x12i/graphenix-plan-compiler": "^2.7.3",
-    "@x12i/graphenix-plan-format": "^2.7.3",
-    "@x12i/graphenix-task-node-format": "^2.7.3",
-    "@x12i/graphenix-trace-format": "^2.7.3",
+    "@x12i/graphenix-plan-compiler": "^2.8.1",
+    "@x12i/graphenix-plan-format": "^2.8.1",
+    "@x12i/graphenix-task-node-format": "^2.8.1",
+    "@x12i/graphenix-trace-format": "^2.8.1",
     "@x12i/logxer": "^4.6.0",
-    "@x12i/memorix-descriptors": "1.10.0",
-    "@x12i/memorix-retrieval": "1.14.0",
-    "@x12i/memorix-writer": "1.3.0",
+    "@x12i/memorix-descriptors": "^1.10.0",
+    "@x12i/memorix-retrieval": "^1.15.0",
+    "@x12i/memorix-writer": "^1.3.0",
     "@x12i/rendrix": "^4.3.0",
     "@x12i/runx": "^1.3.2"
   },