@exellix/graph-engine 6.0.0

package/dist/src/errors/ExellixGraphError.d.ts

@@ -0,0 +1,38 @@
+import { ExellixGraphErrorCode } from './exellixGraphErrorCodes.js';
+/**
+ * Structured error for exellix-graph operations
+ */
+export declare class ExellixGraphError extends Error {
+    readonly code: ExellixGraphErrorCode;
+    readonly context?: {
+        jobId?: string;
+        graphId?: string;
+        nodeId?: string;
+        nodeType?: string;
+        skillKey?: string;
+        goalNodeId?: string;
+        [key: string]: any;
+    } | undefined;
+    constructor(code: ExellixGraphErrorCode, message: string, context?: {
+        jobId?: string;
+        graphId?: string;
+        nodeId?: string;
+        nodeType?: string;
+        skillKey?: string;
+        goalNodeId?: string;
+        [key: string]: any;
+    } | undefined);
+    toJSON(): {
+        code: ExellixGraphErrorCode;
+        message: string;
+        context: {
+            [key: string]: any;
+            jobId?: string;
+            graphId?: string;
+            nodeId?: string;
+            nodeType?: string;
+            skillKey?: string;
+            goalNodeId?: string;
+        } | undefined;
+    };
+}

package/dist/src/errors/ExellixGraphError.js

@@ -0,0 +1,21 @@
+/**
+ * Structured error for exellix-graph operations
+ */
+export class ExellixGraphError extends Error {
+    code;
+    context;
+    constructor(code, message, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = 'ExellixGraphError';
+        Object.setPrototypeOf(this, ExellixGraphError.prototype);
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            context: this.context,
+        };
+    }
+}

package/dist/src/errors/exellixGraphErrorCodes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Error codes for ExellixGraphError
+ */
+export declare enum ExellixGraphErrorCode {
+    /** Caller must supply `jobId`, or `job.jobId`, or `job.id` for run correlation. */
+    JOB_ID_REQUIRED = "JOB_ID_REQUIRED",
+    NODE_SKILLKEY_MISSING = "NODE_SKILLKEY_MISSING",
+    BACKWARD_GOAL_REQUIRED = "BACKWARD_GOAL_REQUIRED",
+    GRAPH_LOAD_FAILED = "GRAPH_LOAD_FAILED",
+    GRAPH_EXECUTION_FAILED = "GRAPH_EXECUTION_FAILED",
+    NODE_EXECUTION_FAILED = "NODE_EXECUTION_FAILED",
+    TASK_NOT_FOUND = "TASK_NOT_FOUND",
+    INVALID_GRAPH = "INVALID_GRAPH",
+    /** Graph JSON has forbidden top-level keys; document metadata must be under `metadata` only. */
+    NON_CANONICAL_GRAPH_DOCUMENT = "NON_CANONICAL_GRAPH_DOCUMENT",
+    /**
+     * A task node uses a legacy authoring alias that 5.x rejects at load time.
+     * Examples: `node.data.skillKey`, `node.metadata.skillKey`, `node.data.variables`,
+     * `node.metadata.variables`, execution keys on `metadata` (belong on `taskConfiguration`),
+     * web-scope keys on `taskConfiguration.narrix`.
+     */
+    NON_CANONICAL_TASK_NODE = "NON_CANONICAL_TASK_NODE",
+    INVALID_NODE = "INVALID_NODE",
+    /**
+     * `metadata.graphEntry.dataFilters` structured gate (`exellix.dataFilters.v1`) evaluated false
+     * against `runtime.executionMemory.input` at graph-run start.
+     */
+    GRAPH_ENTRY_DATA_FILTERS_REJECTED = "GRAPH_ENTRY_DATA_FILTERS_REJECTED",
+    /** MAIN readiness guard rejected empty execution input or synthesis context before runTask. */
+    MAIN_READINESS_FAILED = "MAIN_READINESS_FAILED"
+}

package/dist/src/errors/exellixGraphErrorCodes.js

@@ -0,0 +1,32 @@
+/**
+ * Error codes for ExellixGraphError
+ */
+export var ExellixGraphErrorCode;
+(function (ExellixGraphErrorCode) {
+    /** Caller must supply `jobId`, or `job.jobId`, or `job.id` for run correlation. */
+    ExellixGraphErrorCode["JOB_ID_REQUIRED"] = "JOB_ID_REQUIRED";
+    ExellixGraphErrorCode["NODE_SKILLKEY_MISSING"] = "NODE_SKILLKEY_MISSING";
+    ExellixGraphErrorCode["BACKWARD_GOAL_REQUIRED"] = "BACKWARD_GOAL_REQUIRED";
+    ExellixGraphErrorCode["GRAPH_LOAD_FAILED"] = "GRAPH_LOAD_FAILED";
+    ExellixGraphErrorCode["GRAPH_EXECUTION_FAILED"] = "GRAPH_EXECUTION_FAILED";
+    ExellixGraphErrorCode["NODE_EXECUTION_FAILED"] = "NODE_EXECUTION_FAILED";
+    ExellixGraphErrorCode["TASK_NOT_FOUND"] = "TASK_NOT_FOUND";
+    ExellixGraphErrorCode["INVALID_GRAPH"] = "INVALID_GRAPH";
+    /** Graph JSON has forbidden top-level keys; document metadata must be under `metadata` only. */
+    ExellixGraphErrorCode["NON_CANONICAL_GRAPH_DOCUMENT"] = "NON_CANONICAL_GRAPH_DOCUMENT";
+    /**
+     * A task node uses a legacy authoring alias that 5.x rejects at load time.
+     * Examples: `node.data.skillKey`, `node.metadata.skillKey`, `node.data.variables`,
+     * `node.metadata.variables`, execution keys on `metadata` (belong on `taskConfiguration`),
+     * web-scope keys on `taskConfiguration.narrix`.
+     */
+    ExellixGraphErrorCode["NON_CANONICAL_TASK_NODE"] = "NON_CANONICAL_TASK_NODE";
+    ExellixGraphErrorCode["INVALID_NODE"] = "INVALID_NODE";
+    /**
+     * `metadata.graphEntry.dataFilters` structured gate (`exellix.dataFilters.v1`) evaluated false
+     * against `runtime.executionMemory.input` at graph-run start.
+     */
+    ExellixGraphErrorCode["GRAPH_ENTRY_DATA_FILTERS_REJECTED"] = "GRAPH_ENTRY_DATA_FILTERS_REJECTED";
+    /** MAIN readiness guard rejected empty execution input or synthesis context before runTask. */
+    ExellixGraphErrorCode["MAIN_READINESS_FAILED"] = "MAIN_READINESS_FAILED";
+})(ExellixGraphErrorCode || (ExellixGraphErrorCode = {}));

package/dist/src/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @exellix/graph-engine - Graph executor SDK (canonical 5.x)
+ *
+ * Core responsibilities:
+ * 1. Load graph (via injected loader)
+ * 2. Plan with graphenix
+ * 3. Execute nodes via ai-tasks
+ * 4. Commit outputs to graphenix
+ * 5. Repeat until done/fail
+ *
+ * Single canonical entry point: {@link createExellixGraphRuntime} returns
+ * `{ executeGraph({ model, runtime }: GraphExecutionRequest) }`. The legacy functional `executeGraph`
+ * and the `ExellixGraphClient` class were removed in 5.0.
+ */
+export type { HostExecuteGraphRunOptions, MainReadinessPolicy, ExecutionStepOption, StepRetryPolicy, ActivixNodeActivityExellixConfig, SkillKeyResolutionOptions, RunTaskRequest as ExellixGraphRunTaskRequest, RunTaskResponse as ExellixGraphRunTaskResponse, } from './types/options.js';
+export type { AiTaskProfileMetadata, AiTaskProfileWebScoping, AiTaskProfileInputSynthesis, } from './types/aiTaskProfile.js';
+export type { ExecutionStrategyInvocation, ExecutionStrategyPhase, ExecutionStrategyWrapperKey, SmartInputConfig, TaskStrategyItemData, XynthesizedDestinationScope, XynthesizedMemory, XynthesizedOutputConfig, } from './types/aiTasksDerivedTypes.js';
+export type { Graph, GraphModelObject, GraphAiModelConfig, GraphModelAliasConfig, GraphRuntimeNodeConfig, TaskNodeRuntimeObject, GraphDocumentMetadata, GraphEntryContract, GraphEntryExecutionInputSpec, GraphEntryInputKind, GraphEntryInputSpecBase, GraphEntryInputSpec, GraphEntryValueInputKind, GraphEntryValueInputSpec, GraphResponseDefinition, GraphResponseMissingBehavior, GraphResponseSelector, GraphResponseShape, GraphResponseContract, GraphResponseMapping, GraphResponseMappingMissingBehavior, GraphResponseMappingSelector, GraphResponseMappingTarget, GraphExecutionDefaults, GraphExecutionMode, GraphOutputMode, GraphFlowOutline, GraphCoreObjective, GraphNodesResponses, GraphNode, TaskNode, TaskNodeConditions, TaskNodeConditionWhen, TaskNodeJsonCondition, TaskNodeJsConditionFunction, TaskNodeAiCondition, TaskNodeConditionParameters, ModelConfigSelection, ModelConfigCase, TaskNodePureMetadata, TaskNodeExecutionPipelineStep, TaskOutputValidation, FinalizerNode, FinalizerInputBinding, OutputSchema, AggregateFinalizerConfig, BundleFinalizerConfig, SelectFinalizerConfig, SynthesizeFinalizerConfig, UtilityExecutionPolicy, Job, CatalogPlanningKind, CatalogRequestStatus, CatalogBinding, ScopedQuestionCatalogRequestEntry, DiscoveryDefinitionCatalogRequestEntry, DiscoveryDefinitionCatalogRequest, DiscoveryDefinitionPlanningFields, CatalogRequestEntry, StructuredDataFiltersV1, ConditionsDataFilters, } from './types/refs.js';
+export { mergeGraphDocumentModel, EXELLIX_GRAPH_MODEL_VARIABLE_KEY, EXELLIX_STRUCTURED_DATA_FILTERS_V1, } from './types/refs.js';
+export type { TaskNodeTaskConfiguration, TaskNodeScopedDataReaderPackSlot, } from './types/taskNodeConfiguration.js';
+export { getTaskConfiguration } from './types/taskNodeConfiguration.js';
+export type { NodeExecutionResult, NodeTraceEntry, StepAttemptRecord, StepFailureClassification, DebugNodeTraceEntry, DebugTaskRecord, ExecuteGraphStepResponse, } from './types/results.js';
+export type { RunLogEntry, RunLogLevel, RunLogScope, RunLogMode, RunLogBuildOptions, RunLogBuildResult, } from './types/runLog.js';
+export { AI_TASKS_RUN_LOG_METADATA_KEY, AI_TASKS_LOGXER_RUN_ID_METADATA_KEY, DEFAULT_MAX_RUN_LOG_ENTRIES, DEFAULT_MAX_RUN_LOG_DATA_JSON_CHARS, } from './types/runLog.js';
+export { buildRunLog, resolveRunLogLimits, truncateRunLogData, parseRunLogEntryTs, normalizeExternalRunLogEntries, extractTaskRunLogFromMetadata, extractLogxerCorrelationFromMetadata, } from './runtime/buildRunLog.js';
+export type { GraphExecutionEvent, NodeExecutionEvent, } from './types/events.js';
+export { ExellixGraphError } from './errors/ExellixGraphError.js';
+export { ExellixGraphErrorCode } from './errors/exellixGraphErrorCodes.js';
+export { resolveTaskKey } from './runtime/resolveTaskKey.js';
+export { readExecutionVariableBuckets, seedGraphVariableBucketsOnExecution, mirrorTaskVariablesOnExecution, seedGraphVariableBucketsFromRuntime, buildMemoryResolutionRootFromExecution, buildPredicateEvalContextForNode, } from './runtime/variables.js';
+export type { ExecutionVariableBuckets } from './runtime/executionVariableBuckets.js';
+export { resolveTaskNodeInputsForRunTask, resolveTaskNodeTaskVariableForRunTask, resolveTaskNodeInputBindingsForRunTask, } from './runtime/resolveTaskNodeInputs.js';
+export { readTaskNodeInputsConfig, readTaskNodeModelInputSurface, isNodeInputsConfigSelectorType, } from './runtime/readTaskNodeInputsConfig.js';
+export type { TaskNodeInputsConfigCarrier } from './runtime/readTaskNodeInputsConfig.js';
+export { mergeMemory } from './runtime/memory.js';
+export { selectByPath, writeByPath, parsePath } from './runtime/pathExpr.js';
+export type { PathSegment } from './runtime/pathExpr.js';
+export { evaluateStructuredDataFilters, evaluateDataFilterPredicate, getStructuredDataFilterPathViolations, isStructuredDataFiltersV1, } from './runtime/dataFiltersEvaluation.js';
+export { evaluateTaskNodeConditions, evaluateConditionWhen, applyConditionNegate, } from './runtime/taskNodeConditionsEvaluation.js';
+export type { TaskNodeConditionsEvalDeps, TaskNodeConditionsEvalResult, TaskNodeConditionEvalContext, } from './runtime/taskNodeConditionsEvaluation.js';
+export { resolveModelConfigForNode, resolveGraphAiModelConfigAliases, } from './runtime/resolveModelConfigForNode.js';
+export { isGraphAiModelConfig, isModelConfigSelection, isEmptyConditionWhen, conditionWhenSignature, countDefaultModelConfigCases, } from './runtime/modelConfigSelection.js';
+export { GRAPH_ENGINE_MEMORY_PATH_ROOTS, splitGraphEngineMemoryPath, isAllowedGraphEngineMemoryPath, graphEngineMemoryPathValidationMessage, } from './runtime/graphEngineMemoryPaths.js';
+export { buildRunTaskMainInput, extractCallerInputsBag, buildGraphEngineMemoryResolutionRoot, buildGraphEngineMemoryResolutionRootFromWorkingMemory, resolveGraphEngineMemoryPathValue, } from './runtime/resolveGraphEngineMemoryPaths.js';
+export { mirrorRuntimeInputRawOnExecutionMemory, mirrorStructuredInputOntoExecutionMemory, } from './runtime/materializeStructuredRunTaskInput.js';
+export { buildRunTaskTaskConfigurationForward } from './runtime/buildRunTaskTaskConfigurationForward.js';
+export { normalizeSmartInputPath, collectSmartInputPaths, normalizeSmartInputConfigForRunTask, } from './runtime/smartInputPaths.js';
+export { evaluateTaskNodeMainReadiness, buildMainReadinessResolutionRoot, resolveMainReadinessPolicy, collectInputSynthesisSourcePaths, } from './runtime/taskNodeMainReadiness.js';
+export type { MainReadinessCheckId, MainReadinessEvaluation } from './runtime/taskNodeMainReadiness.js';
+export { resolveCanonicalModelUsed } from './runtime/canonicalModelUsed.js';
+export { buildAiTasksObservabilityRecord } from './runtime/aiTasksObservability.js';
+export type { GraphEngineMemoryResolutionRoot } from './runtime/resolveGraphEngineMemoryPaths.js';
+export { collectAiTasksNodeExtensionIssues, assertAiTasksNodeExtensionsValid, } from './inspection/validateAiTasksNodeExtensions.js';
+export type { AiTasksNodeExtensionIssue } from './inspection/validateAiTasksNodeExtensions.js';
+export type { EvaluateStructuredDataFiltersResult, EvaluateStructuredDataFiltersOptions, } from './runtime/dataFiltersEvaluation.js';
+/** Execution-matrix host: resolve graph entry, seed execution, stable job ids, runtime binder. */
+export { resolveGraphEntryFromGraph, createResolveGraphEntryFromLoader, buildExecutionSeedFromGraphEntry, validateExecutionSeedPaths, buildStableMatrixJobId, buildMatrixJobForGraphRun, buildGraphExecutionRequest, isExecuteGraphResultFailed, createMatrixHostGraphExecutor, } from './runtime/executionMatrixHost.js';
+export type { BuildExecutionSeedSources, BuildExecutionSeedResult } from './runtime/executionMatrixHost.js';
+export { assertHostJobId, newGraphRunTaskId } from './runtime/graphRunIdentity.js';
+export { buildAiTasksRunTaskRequest, extractRunTaskMetadataPassthrough, extractRunTaskStrategyOverrides, resolveJobTypeId, resolveTaskTypeId, } from './runtime/buildAiTasksRunTaskRequest.js';
+export type { BuildAiTasksRunTaskRequestArgs, RunTaskMetadataPassthrough, } from './runtime/buildAiTasksRunTaskRequest.js';
+export { buildTaskNodeJobContext } from './runtime/buildTaskNodeJobContext.js';
+export { resolveNarrixForTaskNode } from './runtime/resolveNarrixForTaskNode.js';
+export { runTaskResponseSucceeded } from './runtime/runTaskResponse.js';
+export { buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, analyzeTaskNodeRunTaskRequest, } from './runtime/taskNodeRunTaskPreflight.js';
+export type { BuildTaskNodeRunTaskRequestArgs, BuildTaskNodeRunTaskRequestResult, TaskNodeRunTaskPreflightSkipReason, ValidateTaskNodeRunTaskConfigArgs, ValidateTaskNodeRunTaskConfigResult, ValidateTaskNodeRunTaskInvokeArgs, ValidateTaskNodeRunTaskInvokeResult, AnalyzeTaskNodeRunTaskRequestArgs, AnalyzeTaskNodeRunTaskRequestResult, } from './runtime/taskNodeRunTaskPreflight.js';
+/** Re-exported from `@exellix/ai-tasks` — preflight validation and analysis without `runTask`. */
+export { validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, collectSmartInputValidationIssues, buildRunTaskValidationContext, analyzeRunTaskRequest, validateParsedOutput, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, listTokens, analyzeTemplateResolution, renderSmartInput, extractTokenNamesFromStrings, getSkillTokens, getSkillContent, } from '@exellix/ai-tasks';
+export type { RunTaskValidationIssue, RunTaskValidationResult, RunTaskInvokeValidationResult, ExpectedRunTaskInputPath, AnalyzeExpectedRunTaskInputResult, ValidateRunTaskInvokeParams, RunTaskTemplateResolver, AnalyzeRunTaskRequestOptions, AnalyzeRunTaskRequestResult, AnalyzeSkillRequestOptions, AnalyzeSkillRequestResult, SkillRequestAnalysisReport, OutputValidationResult, } from '@exellix/ai-tasks';
+export { buildExellixGraphRuntimeObjects, setRuntimeObjectsLastJobId, summarizeRuntimeObjectsForPlayground, EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME, EXELLIX_AI_TASKS_PACKAGE_NAME, } from './runtime/runtimeObjects.js';
+export type { ActivixQueryableClient, LogxerQueryableClient, LogxerLogLine, PackageRuntimeObjects, RuntimeObjects, BuildExellixGraphRuntimeObjectsInput, RuntimeObjectsObservabilitySummary, } from './runtime/runtimeObjects.js';
+export { assertCanonicalGraphDocument, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, } from './runtime/validateCanonicalGraphDocument.js';
+export { computeGraphDocumentContentSha256, stableStringifyGraphDocument, } from './runtime/graphDocumentFingerprint.js';
+export { migrateLegacyGraphResponse, migrateLegacyGraphResponseDefinition, } from './runtime/graphResponseMigration.js';
+export type { MigrateGraphResponseResult } from './runtime/graphResponseMigration.js';
+export { applyAiTaskProfileWebScopingToNarrix, mapAiTaskProfileQuestionsToWebScopeQuestions, } from './runtime/applyAiTaskProfileWebScopingToNarrix.js';
+export { createExellixGraphRuntime } from './runtime/ExellixGraphRuntime.js';
+export type { RunTaskRequest, RunTaskResponse, TasksClientLike, GraphLoader as RuntimeGraphLoader, ExecuteGraphInput, GraphExecutionRequest, GraphRuntimeObject, GraphKnowledgeResolver, GraphKnowledgeResolverContext, ExecuteGraphResult, ExellixGraphRuntimeOptions, } from './runtime/ExellixGraphRuntime.js';
+export type { PlanStatus, GraphPlan, GraphEngine, GraphEngineFactory, } from './runtime/GraphEngine.js';
+export { InMemoryGraphLoader, DepGraphEngineFactory } from '../testkit/index.js';
+export { FileGraphLoader } from './loaders/FileGraphLoader.js';
+export type { FileGraphLoaderOptions } from './loaders/FileGraphLoader.js';
+export { createActivityTrackerIntegration } from './integrations/ActivityTrackerIntegration.js';
+export type { ActivityTrackerLike } from './integrations/ActivityTrackerIntegration.js';
+export { createActivixNodeActivityIntegration } from './integrations/ActivixNodeActivityIntegration.js';
+export type { CreateActivixNodeActivityIntegrationOptions } from './integrations/ActivixNodeActivityIntegration.js';
+export { createActivixGraphRunIntegration } from './integrations/ActivixGraphRunIntegration.js';
+export type { CreateActivixGraphRunIntegrationOptions } from './integrations/ActivixGraphRunIntegration.js';
+export { createActivixFromEnv, resolveActivixExellixCollectionNamesFromEnv, } from './integrations/createActivixFromEnv.js';
+export { createActivixExellixIntegration } from './integrations/createActivixExellixIntegration.js';
+export type { CreateActivixExellixIntegrationOptions } from './integrations/createActivixExellixIntegration.js';
+export { validateGraphPlanningCatalogDescriptorsInCatalox } from './integrations/cataloxGraphCatalog.js';
+export type { GraphCatalogValidationIssue } from './integrations/cataloxGraphCatalog.js';
+export { composeEventEmitters } from './runtime/events.js';
+export { createPlaygroundReporter } from './playground/index.js';
+export type { CreatePlaygroundReporterOptions, PlaygroundDebugArtifact, PlaygroundDebugArtifactKind, PlaygroundDebugSnapshot, PlaygroundReporter, PlaygroundStep, } from './playground/PlaygroundReporter.js';
+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, } from './inspection/index.js';
+export type { 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, WebScopeQuestion, LocalTaskHandler, LocalTaskContext } from './types/narrix.js';
+export type { ScopedDataReaderConfig, ScopedDataReaderOutput, ScopedDataReaderPackOutput, ScopedAnswerAssemblerConfig, ScopedAnswerAssemblerOutput, ScopedAnswerWriterConfig, ScopedAnswerWriterOutput, } from './runtime/localSkills/index.js';

package/dist/src/index.js

@@ -0,0 +1,75 @@
+/**
+ * @exellix/graph-engine - Graph executor SDK (canonical 5.x)
+ *
+ * Core responsibilities:
+ * 1. Load graph (via injected loader)
+ * 2. Plan with graphenix
+ * 3. Execute nodes via ai-tasks
+ * 4. Commit outputs to graphenix
+ * 5. Repeat until done/fail
+ *
+ * Single canonical entry point: {@link createExellixGraphRuntime} returns
+ * `{ executeGraph({ model, runtime }: GraphExecutionRequest) }`. The legacy functional `executeGraph`
+ * and the `ExellixGraphClient` class were removed in 5.0.
+ */
+export { mergeGraphDocumentModel, EXELLIX_GRAPH_MODEL_VARIABLE_KEY, EXELLIX_STRUCTURED_DATA_FILTERS_V1, } from './types/refs.js';
+export { getTaskConfiguration } from './types/taskNodeConfiguration.js';
+export { AI_TASKS_RUN_LOG_METADATA_KEY, AI_TASKS_LOGXER_RUN_ID_METADATA_KEY, DEFAULT_MAX_RUN_LOG_ENTRIES, DEFAULT_MAX_RUN_LOG_DATA_JSON_CHARS, } from './types/runLog.js';
+export { buildRunLog, resolveRunLogLimits, truncateRunLogData, parseRunLogEntryTs, normalizeExternalRunLogEntries, extractTaskRunLogFromMetadata, extractLogxerCorrelationFromMetadata, } from './runtime/buildRunLog.js';
+// Errors
+export { ExellixGraphError } from './errors/ExellixGraphError.js';
+export { ExellixGraphErrorCode } from './errors/exellixGraphErrorCodes.js';
+// Runtime utilities (exported for advanced use cases)
+export { resolveTaskKey } from './runtime/resolveTaskKey.js';
+export { readExecutionVariableBuckets, seedGraphVariableBucketsOnExecution, mirrorTaskVariablesOnExecution, seedGraphVariableBucketsFromRuntime, buildMemoryResolutionRootFromExecution, buildPredicateEvalContextForNode, } from './runtime/variables.js';
+export { resolveTaskNodeInputsForRunTask, resolveTaskNodeTaskVariableForRunTask, resolveTaskNodeInputBindingsForRunTask, } from './runtime/resolveTaskNodeInputs.js';
+export { readTaskNodeInputsConfig, readTaskNodeModelInputSurface, isNodeInputsConfigSelectorType, } from './runtime/readTaskNodeInputsConfig.js';
+export { mergeMemory } from './runtime/memory.js';
+export { selectByPath, writeByPath, parsePath } from './runtime/pathExpr.js';
+export { evaluateStructuredDataFilters, evaluateDataFilterPredicate, getStructuredDataFilterPathViolations, isStructuredDataFiltersV1, } from './runtime/dataFiltersEvaluation.js';
+export { evaluateTaskNodeConditions, evaluateConditionWhen, applyConditionNegate, } from './runtime/taskNodeConditionsEvaluation.js';
+export { resolveModelConfigForNode, resolveGraphAiModelConfigAliases, } from './runtime/resolveModelConfigForNode.js';
+export { isGraphAiModelConfig, isModelConfigSelection, isEmptyConditionWhen, conditionWhenSignature, countDefaultModelConfigCases, } from './runtime/modelConfigSelection.js';
+export { GRAPH_ENGINE_MEMORY_PATH_ROOTS, splitGraphEngineMemoryPath, isAllowedGraphEngineMemoryPath, graphEngineMemoryPathValidationMessage, } from './runtime/graphEngineMemoryPaths.js';
+export { buildRunTaskMainInput, extractCallerInputsBag, buildGraphEngineMemoryResolutionRoot, buildGraphEngineMemoryResolutionRootFromWorkingMemory, resolveGraphEngineMemoryPathValue, } from './runtime/resolveGraphEngineMemoryPaths.js';
+export { mirrorRuntimeInputRawOnExecutionMemory, mirrorStructuredInputOntoExecutionMemory, } from './runtime/materializeStructuredRunTaskInput.js';
+export { buildRunTaskTaskConfigurationForward } from './runtime/buildRunTaskTaskConfigurationForward.js';
+export { normalizeSmartInputPath, collectSmartInputPaths, normalizeSmartInputConfigForRunTask, } from './runtime/smartInputPaths.js';
+export { evaluateTaskNodeMainReadiness, buildMainReadinessResolutionRoot, resolveMainReadinessPolicy, collectInputSynthesisSourcePaths, } from './runtime/taskNodeMainReadiness.js';
+export { resolveCanonicalModelUsed } from './runtime/canonicalModelUsed.js';
+export { buildAiTasksObservabilityRecord } from './runtime/aiTasksObservability.js';
+export { collectAiTasksNodeExtensionIssues, assertAiTasksNodeExtensionsValid, } from './inspection/validateAiTasksNodeExtensions.js';
+/** Execution-matrix host: resolve graph entry, seed execution, stable job ids, runtime binder. */
+export { resolveGraphEntryFromGraph, createResolveGraphEntryFromLoader, buildExecutionSeedFromGraphEntry, validateExecutionSeedPaths, buildStableMatrixJobId, buildMatrixJobForGraphRun, buildGraphExecutionRequest, isExecuteGraphResultFailed, createMatrixHostGraphExecutor, } from './runtime/executionMatrixHost.js';
+export { assertHostJobId, newGraphRunTaskId } from './runtime/graphRunIdentity.js';
+export { buildAiTasksRunTaskRequest, extractRunTaskMetadataPassthrough, extractRunTaskStrategyOverrides, resolveJobTypeId, resolveTaskTypeId, } from './runtime/buildAiTasksRunTaskRequest.js';
+export { buildTaskNodeJobContext } from './runtime/buildTaskNodeJobContext.js';
+export { resolveNarrixForTaskNode } from './runtime/resolveNarrixForTaskNode.js';
+export { runTaskResponseSucceeded } from './runtime/runTaskResponse.js';
+export { buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, analyzeTaskNodeRunTaskRequest, } from './runtime/taskNodeRunTaskPreflight.js';
+/** Re-exported from `@exellix/ai-tasks` — preflight validation and analysis without `runTask`. */
+export { validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, collectSmartInputValidationIssues, buildRunTaskValidationContext, analyzeRunTaskRequest, validateParsedOutput, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, 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 { assertCanonicalGraphDocument, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, } from './runtime/validateCanonicalGraphDocument.js';
+export { computeGraphDocumentContentSha256, stableStringifyGraphDocument, } from './runtime/graphDocumentFingerprint.js';
+export { migrateLegacyGraphResponse, migrateLegacyGraphResponseDefinition, } from './runtime/graphResponseMigration.js';
+export { applyAiTaskProfileWebScopingToNarrix, mapAiTaskProfileQuestionsToWebScopeQuestions, } from './runtime/applyAiTaskProfileWebScopingToNarrix.js';
+// New runtime with injection seam
+export { createExellixGraphRuntime } from './runtime/ExellixGraphRuntime.js';
+// Testkit (in-memory loader, dep engine, recording client — sample NARRIX tasks: `@exellix/graph-engine/testkit`)
+export { InMemoryGraphLoader, DepGraphEngineFactory } from '../testkit/index.js';
+// Graph loaders
+export { FileGraphLoader } from './loaders/FileGraphLoader.js';
+// Integrations
+export { createActivityTrackerIntegration } from './integrations/ActivityTrackerIntegration.js';
+export { createActivixNodeActivityIntegration } from './integrations/ActivixNodeActivityIntegration.js';
+export { createActivixGraphRunIntegration } from './integrations/ActivixGraphRunIntegration.js';
+export { createActivixFromEnv, resolveActivixExellixCollectionNamesFromEnv, } from './integrations/createActivixFromEnv.js';
+export { createActivixExellixIntegration } from './integrations/createActivixExellixIntegration.js';
+export { validateGraphPlanningCatalogDescriptorsInCatalox } from './integrations/cataloxGraphCatalog.js';
+export { composeEventEmitters } from './runtime/events.js';
+// Playground (full-visibility MD report)
+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, } from './inspection/index.js';
+// Web context rendering — consume execution.webContext → markdown for prompts (Layer 04)

package/dist/src/inspection/contractInspection.d.ts

@@ -0,0 +1,21 @@
+import type { Graph, GraphNode } from '../types/refs.js';
+import type { FinalizerContractInspection, GraphContractsInspection, NodeContractInspection, NodeSideEffects } from './contractTypes.js';
+export declare function getNodeSideEffects(node: GraphNode): NodeSideEffects;
+/**
+ * Finalizer-only contract inspection. Returns null if the node is not a finalizer.
+ */
+export declare function inspectFinalizer(node: GraphNode, options?: {
+    graph?: Graph;
+}): FinalizerContractInspection | null;
+export type InspectNodeContractOptions = {
+    upstreamWritePaths?: string[];
+    graph?: Graph;
+};
+/**
+ * Unified per-node contract: execution class, grouped I/O, side effects, validation, optional control graph.
+ */
+export declare function inspectNodeContract(node: GraphNode, options?: InspectNodeContractOptions): NodeContractInspection;
+/**
+ * Graph-level contract view: full node contracts plus execution order and I/O edges.
+ */
+export declare function inspectGraphContracts(graph: Graph): GraphContractsInspection;