@exellix/graph-engine 7.7.1 → 7.7.3

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 7.7.3
+
+### Changed
+
+- **Dependencies:** `@exellix/ai-tasks` ^8.6.1 (studio skill analysis removed from ai-tasks runtime exports).
+
+### Removed (breaking for importers)
+
+- **`analyzeTaskNodeRunTaskRequest`** and re-exports of **`analyzeRunTaskRequest`**, **`buildSkillRequestAnalysisPacket`**, **`formatSkillRequestAnalysisMarkdown`**, and related analysis types from `@exellix/ai-tasks`.
+- Use **`@exellix/graph-composer`** for studio / skills-manager invoke preflight (see `@exellix/ai-tasks` `documenations/studio-skill-invoke-preflight.md`).
+
+### Kept
+
+- **`buildTaskNodeRunTaskRequest`**, **`validateTaskNodeRunTaskConfig`**, **`validateTaskNodeRunTaskInvoke`**, and **`validateRunTaskConfig`** / **`analyzeExpectedRunTaskInput`** re-exports for execution-time shape checks.
+
+## 7.7.2
+
+### Changed
+
+- Patch release line (see 7.7.3 notes for ai-tasks 8.6 alignment).
+
 ## 7.7.1
 
 ### Changed

package/README.md

@@ -90,9 +90,8 @@ Graph-engine exposes the **`@exellix/ai-tasks` ≥ 7.6** preflight surface so st
 | **`buildTaskNodeRunTaskRequest`** | Build the same outbound `RunTaskRequest` as `executeNode` (skips local skills and finalizers). |
 | **`validateTaskNodeRunTaskConfig`** | Static config checks (`agentId`, pipeline, `smartInput`, `llmCall`, …). |
 | **`validateTaskNodeRunTaskInvoke`** | Config + payload path resolution + optional template/smart-input render checks. |
-| **`analyzeTaskNodeRunTaskRequest`** | Catalox-backed skill request analysis (templates, gateway packet preview) plus optional config validation. |
 
-Lower-level helpers (`validateRunTaskConfig`, `validateRunTaskInvoke`, `analyzeRunTaskRequest`, `analyzeSkillRequest`, `formatSkillRequestAnalysisMarkdown`, Rendrix `listTokens` / `analyzeTemplateResolution`, …) are **re-exported** from the package root when you already have a `RunTaskRequest`.
+Lower-level helpers (`validateRunTaskConfig`, `validateRunTaskInvoke`, `analyzeExpectedRunTaskInput`, Rendrix `listTokens` / `analyzeTemplateResolution`, …) are **re-exported** from the package root when you already have a `RunTaskRequest`. Catalox-backed skill invoke packet analysis was removed from `@exellix/ai-tasks` — use studio / skills-manager preflight (`@x12i/funcx` analyze-gateway-invoke-request) instead.
 
 **Testing safety:** Default `npm test` uses **mocked** Catalox in catalog validation tests and does not open Firestore. Do **not** point `FIRESTORE_LIVE_TESTS` / integration flags at a **production** Firebase project; Catalox’s own docs recommend a dedicated test project for live integration runs.
 

package/dist/src/index.d.ts

@@ -70,11 +70,11 @@ export type { BuildAiTasksRunTaskRequestArgs, RunTaskMetadataPassthrough, } from
 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, 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 { buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, } from './runtime/taskNodeRunTaskPreflight.js';
+export type { BuildTaskNodeRunTaskRequestArgs, BuildTaskNodeRunTaskRequestResult, TaskNodeRunTaskPreflightSkipReason, ValidateTaskNodeRunTaskConfigArgs, ValidateTaskNodeRunTaskConfigResult, ValidateTaskNodeRunTaskInvokeArgs, ValidateTaskNodeRunTaskInvokeResult, } 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 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 type { ActivixQueryableClient, LogxerQueryableClient, LogxerLogLine, PackageRuntimeObjects, RuntimeObjects, BuildExellixGraphRuntimeObjectsInput, RuntimeObjectsObservabilitySummary, } from './runtime/runtimeObjects.js';
 export type { GetJobLogsInput, GetJobLogsResult, QueryableLogLine } from '@x12i/logxer';

package/dist/src/index.js

@@ -54,9 +54,9 @@ export { buildAiTasksRunTaskRequest, extractRunTaskMetadataPassthrough, extractR
 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, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, listTokens, analyzeTemplateResolution, renderSmartInput, extractTokenNamesFromStrings, getSkillTokens, getSkillContent, } from '@exellix/ai-tasks';
+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 { assertCanonicalGraphDocument, assertCanonicalTaskNode, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, } from './runtime/validateCanonicalGraphDocument.js';
 export { assertCanonicalGraphRuntimeObject } from './runtime/validateCanonicalGraphRuntime.js';

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

@@ -2,9 +2,8 @@
  * Graph-level preflight for `@exellix/ai-tasks` validation and analysis on task nodes.
  * Builds the same outbound {@link RunTaskRequest} as `executeNode` (without PRE strategy phases or `runTask`).
  */
-import type { Catalox } from '@x12i/catalox';
 import type { RunTaskRequest } from '@exellix/ai-tasks';
-import { type AnalyzeRunTaskRequestOptions, type AnalyzeRunTaskRequestResult, type RunTaskInvokeValidationResult, type RunTaskValidationResult, type ValidateRunTaskInvokeParams } from '@exellix/ai-tasks';
+import { type RunTaskInvokeValidationResult, type RunTaskValidationResult, type ValidateRunTaskInvokeParams } from '@exellix/ai-tasks';
 import type { GraphAiModelConfig, Job, TaskNode } from '../types/refs.js';
 import type { ExecutionStepOption, RunTaskDiagnostics, SkillKeyResolutionOptions } from '../types/options.js';
 export type TaskNodeRunTaskPreflightSkipReason = 'local_skill' | 'finalizer';
@@ -70,18 +69,3 @@ export type ValidateTaskNodeRunTaskInvokeResult = {
 } & RunTaskInvokeValidationResult);
 /** Config + payload + template path validation via ai-tasks {@link validateRunTaskInvoke}. */
 export declare function validateTaskNodeRunTaskInvoke(args: ValidateTaskNodeRunTaskInvokeArgs): Promise<ValidateTaskNodeRunTaskInvokeResult>;
-export type AnalyzeTaskNodeRunTaskRequestArgs = BuildTaskNodeRunTaskRequestArgs & {
-    catalox: Catalox;
-    analyzeOptions?: AnalyzeRunTaskRequestOptions;
-};
-export type AnalyzeTaskNodeRunTaskRequestResult = {
-    skipped: true;
-    skillKey: string;
-    reason: TaskNodeRunTaskPreflightSkipReason;
-} | ({
-    skipped: false;
-    skillKey: string;
-    request: RunTaskRequest;
-} & AnalyzeRunTaskRequestResult);
-/** Catalox-backed skill request analysis on the graph-built {@link RunTaskRequest}. */
-export declare function analyzeTaskNodeRunTaskRequest(args: AnalyzeTaskNodeRunTaskRequestArgs): Promise<AnalyzeTaskNodeRunTaskRequestResult>;

package/dist/src/runtime/taskNodeRunTaskPreflight.js

@@ -1,4 +1,4 @@
-import { analyzeRunTaskRequest, validateRunTaskConfig, validateRunTaskInvoke, } from '@exellix/ai-tasks';
+import { validateRunTaskConfig, validateRunTaskInvoke, } from '@exellix/ai-tasks';
 import { toRunTaskModelConfig } from './graphAiModelConfig.js';
 import { resolveTaskKey } from './resolveTaskKey.js';
 import { isLocalSkillKey } from './localSkills/index.js';
@@ -194,12 +194,3 @@ export async function validateTaskNodeRunTaskInvoke(args) {
     });
     return { skipped: false, skillKey: built.skillKey, request: built.request, ...validation };
 }
-/** Catalox-backed skill request analysis on the graph-built {@link RunTaskRequest}. */
-export async function analyzeTaskNodeRunTaskRequest(args) {
-    const built = await buildTaskNodeRunTaskRequest(args);
-    if (!built.runnable) {
-        return { skipped: true, skillKey: built.skillKey, reason: built.reason };
-    }
-    const analysis = await analyzeRunTaskRequest(args.catalox, built.request, args.analyzeOptions);
-    return { ...analysis, skipped: false, skillKey: built.skillKey, request: built.request };
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-engine",
-  "version": "7.7.1",
+  "version": "7.7.3",
   "type": "module",
   "description": "Graph executor SDK",
   "main": "dist/src/index.js",
@@ -52,7 +52,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@exellix/ai-tasks": "^8.5.2",
+    "@exellix/ai-tasks": "^8.6.1",
     "@x12i/activix": "8.5.0",
     "@x12i/catalox": "5.1.3",
     "@x12i/env": "4.0.1",