@x12i/graphenix-execute-envelope 1.0.0 → 1.1.1

package/README.md

@@ -26,8 +26,8 @@ Optional package: engines and compilers do not need it; backend hosts and API ga
 Studio execute request (authoring + input)
         │  validateStudioExecuteRequest()
         │  buildRuntimeObject()
-        │  compileExecutablePlan()
-        │  validateExecutablePlan()
+        │  compileExecutablePlanV2()
+        │  validateExecutablePlanV2()
         ▼
 { plan, runtime }  →  engine
         │
@@ -51,21 +51,36 @@ npm install @x12i/graphenix-execute-envelope
 
 ### Studio execute request (shape)
 
+Use `createContentPipelineReferenceGraph()` for real node ids — not an empty `"graph": {}` placeholder.
+
 ```json
 {
-  "authoringGraph": { "id": "graph:content-pipeline", "formatVersion": "2.0.0", "graph": {} },
-  "input": {
-    "brief": "Launch campaign for eco-friendly water bottles",
-    "priority": "normal"
+  "mode": "graph",
+  "jobId": "job-001",
+  "graph": {
+    "id": "graph:content-pipeline",
+    "formatVersion": "2.0.0",
+    "graph": {
+      "id": "graph:content-pipeline",
+      "nodes": [
+        { "id": "node:audience-insights", "type": "task" },
+        { "id": "node:competitor-angles", "type": "task" },
+        { "id": "node:seo-keywords", "type": "task" },
+        { "id": "node:content-package", "type": "finalizer" }
+      ]
+    }
   },
-  "options": {
-    "jobId": "job-001",
-    "mode": "live",
-    "environment": "prod"
+  "runtime": {
+    "input": {
+      "brief": "Launch campaign for eco-friendly water bottles",
+      "priority": "normal"
+    }
   }
 }
 ```
 
+Full authoring JSON: `packages/authoring-format/fixtures/graph-content-pipeline.authoring.json`.
+
 Credentials stay on the request boundary — never copied into `GraphRuntimeObject`.
 
 ### Runtime object (compile input)
@@ -109,10 +124,20 @@ Embedded normalized graph in the plan has **no** `node.layout` — stripped at c
 ## Example (API)
 
 ```ts
+import { createContentPipelineReferenceGraph } from "@x12i/graphenix-authoring-format";
 import { buildGraphExecutionRequestFromStudioExecute } from "@x12i/graphenix-execute-envelope";
 
-const { plan, runtime } = buildGraphExecutionRequestFromStudioExecute(request);
-// forward to engine — engine never sees the raw Studio request
+const authoring = createContentPipelineReferenceGraph();
+const { plan, runtime } = buildGraphExecutionRequestFromStudioExecute(
+  {
+    mode: "graph",
+    jobId: "job-001",
+    graph: authoring,
+    runtime: { input: { priority: "normal" } }
+  },
+  { profileRegistry: { version: "3.2.0", registryHash: "sha256:profiles-cp" } }
+);
+// forward { plan, runtime } to engine
 ```
 
 ### Lower-level building blocks
@@ -123,15 +148,17 @@ import {
   buildRuntimeObject,
   validateRuntimeObject
 } from "@x12i/graphenix-execute-envelope";
-import { compileExecutablePlan } from "@x12i/graphenix-plan-compiler";
-import { validateExecutablePlan } from "@x12i/graphenix-plan-format";
+import { compileExecutablePlanV2 } from "@x12i/graphenix-plan-compiler";
+import { validateExecutablePlanV2 } from "@x12i/graphenix-plan-format";
 
 validateStudioExecuteRequest(request);
 const runtime = buildRuntimeObject(request.input, request.options);
 validateRuntimeObject(runtime);
 
-const plan = compileExecutablePlan(request.authoringGraph, runtime);
-validateExecutablePlan(plan);
+const plan = compileExecutablePlanV2(request.authoringGraph, runtime, {
+  profileRegistry: { version: "3.2.0", registryHash: "sha256:profiles-host" }
+});
+validateExecutablePlanV2(plan);
 ```
 
 ---
@@ -158,10 +185,10 @@ validateExecutablePlan(plan);
 
 ## Dependencies
 
-- `@x12i/graphenix-authoring-format` ^1.0.0
-- `@x12i/graphenix-plan-compiler` ^1.0.0
-- `@x12i/graphenix-plan-format` ^1.0.0
-- `@x12i/graphenix-executable-contracts` ^1.0.0
+- `@x12i/graphenix-authoring-format` ^1.0.2
+- `@x12i/graphenix-plan-compiler` ^1.1.0
+- `@x12i/graphenix-plan-format` ^1.1.0
+- `@x12i/graphenix-executable-contracts` ^1.1.0
 
 ---
 

package/dist/adapter/build-graph-execution-request-from-studio-execute.d.ts

@@ -1,6 +1,7 @@
-import type { GraphExecutionRequest, StudioGraphExecuteRequest } from "@x12i/graphenix-executable-contracts";
+import type { CompileExecutablePlanV2Options, GraphExecutionRequest, StudioGraphExecuteRequest } from "@x12i/graphenix-executable-contracts";
 export declare function buildGraphExecutionRequestFromStudioExecute(request: StudioGraphExecuteRequest, options?: {
     agentId?: string;
     jobTypeId?: string;
+    profileRegistry?: CompileExecutablePlanV2Options["profileRegistry"];
 }): GraphExecutionRequest;
 //# sourceMappingURL=build-graph-execution-request-from-studio-execute.d.ts.map

package/dist/adapter/build-graph-execution-request-from-studio-execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-graph-execution-request-from-studio-execute.d.ts","sourceRoot":"","sources":["../../src/adapter/build-graph-execution-request-from-studio-execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,sCAAsC,CAAC;AAM9C,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,qBAAqB,CAyCvB"}
+{"version":3,"file":"build-graph-execution-request-from-studio-execute.d.ts","sourceRoot":"","sources":["../../src/adapter/build-graph-execution-request-from-studio-execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,sCAAsC,CAAC;AAM9C,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,8BAA8B,CAAC,iBAAiB,CAAC,CAAC;CAChE,GACL,qBAAqB,CA8CvB"}

package/dist/adapter/build-graph-execution-request-from-studio-execute.js

@@ -1,7 +1,7 @@
 import { validateStudioExecuteRequest } from "../validators/validate-studio-execute-request.js";
 import { buildRuntimeObject } from "../validators/validate-runtime-object.js";
-import { compileExecutablePlan } from "@x12i/graphenix-plan-compiler";
-import { validateExecutablePlan } from "@x12i/graphenix-plan-format";
+import { compileExecutablePlanV2 } from "@x12i/graphenix-plan-compiler";
+import { validateExecutablePlanV2 } from "@x12i/graphenix-plan-format";
 export function buildGraphExecutionRequestFromStudioExecute(request, options = {}) {
     const validation = validateStudioExecuteRequest(request);
     if (!validation.valid) {
@@ -22,8 +22,13 @@ export function buildGraphExecutionRequestFromStudioExecute(request, options = {
         variables: request.runtime?.variables,
         job: request.runtime?.job
     }, options);
-    const plan = compileExecutablePlan(request.graph, runtime);
-    const planValidation = validateExecutablePlan(plan);
+    const plan = compileExecutablePlanV2(request.graph, runtime, {
+        profileRegistry: options.profileRegistry ?? {
+            version: "3.2.0",
+            registryHash: "sha256:profiles-execute-envelope"
+        }
+    });
+    const planValidation = validateExecutablePlanV2(plan);
     if (!planValidation.valid) {
         const summary = planValidation.errors
             .map((error) => `${error.path}: ${error.message}`)

package/dist/adapter/build-graph-execution-request-from-studio-execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-graph-execution-request-from-studio-execute.js","sourceRoot":"","sources":["../../src/adapter/build-graph-execution-request-from-studio-execute.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,UAAU,2CAA2C,CACzD,OAAkC,EAClC,UAGI,EAAE;IAEN,MAAM,UAAU,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM;aAC9B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACjD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAChC;QACE,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK;QAC7B,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI;QAC3D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,UAAU;QAC7D,gBAAgB,EACd,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,gBAAgB;QAC/D,sBAAsB,EACpB,OAAO,CAAC,sBAAsB;YAC9B,OAAO,CAAC,OAAO,EAAE,sBAAsB;QACzC,kBAAkB,EAChB,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,OAAO,EAAE,kBAAkB;QACnE,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS;QACrC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG;KAC1B,EACD,OAAO,CACR,CAAC;IAEF,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM;aAClC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACjD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"build-graph-execution-request-from-studio-execute.js","sourceRoot":"","sources":["../../src/adapter/build-graph-execution-request-from-studio-execute.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,MAAM,UAAU,2CAA2C,CACzD,OAAkC,EAClC,UAII,EAAE;IAEN,MAAM,UAAU,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM;aAC9B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACjD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAChC;QACE,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK;QAC7B,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI;QAC3D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,UAAU;QAC7D,gBAAgB,EACd,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,gBAAgB;QAC/D,sBAAsB,EACpB,OAAO,CAAC,sBAAsB;YAC9B,OAAO,CAAC,OAAO,EAAE,sBAAsB;QACzC,kBAAkB,EAChB,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,OAAO,EAAE,kBAAkB;QACnE,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS;QACrC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG;KAC1B,EACD,OAAO,CACR,CAAC;IAEF,MAAM,IAAI,GAAG,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE;QAC3D,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI;YAC1C,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,kCAAkC;SACjD;KACF,CAAC,CAAC;IACH,MAAM,cAAc,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM;aAClC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACjD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/test/content-pipeline-envelope.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=content-pipeline-envelope.test.d.ts.map

package/dist/test/content-pipeline-envelope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-pipeline-envelope.test.d.ts","sourceRoot":"","sources":["../../src/test/content-pipeline-envelope.test.ts"],"names":[],"mappings":""}

package/dist/test/content-pipeline-envelope.test.js

@@ -0,0 +1,26 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { createContentPipelineReferenceGraph } from "@x12i/graphenix-authoring-format";
+import { buildGraphExecutionRequestFromStudioExecute } from "../adapter/build-graph-execution-request-from-studio-execute.js";
+import { EXECUTABLE_PLAN_FORMAT_V2 } from "@x12i/graphenix-executable-contracts";
+const PROFILE_REGISTRY = {
+    version: "3.2.0",
+    registryHash: "sha256:profiles-cp-envelope"
+};
+describe("execute-envelope content pipeline", () => {
+    it("buildGraphExecutionRequestFromStudioExecute compiles CP graph to v2 plan", () => {
+        const authoring = createContentPipelineReferenceGraph();
+        const { plan, runtime } = buildGraphExecutionRequestFromStudioExecute({
+            mode: "graph",
+            jobId: "job-cp-envelope",
+            graph: authoring,
+            runtime: { input: { priority: "normal" } }
+        }, { profileRegistry: PROFILE_REGISTRY });
+        assert.equal(plan.format, EXECUTABLE_PLAN_FORMAT_V2);
+        assert.equal(plan.source.graphId, "graph:content-pipeline");
+        assert.equal(runtime.jobId, "job-cp-envelope");
+        assert.ok(plan.nodePlans["node:audience-insights"]);
+        assert.equal(runtime.input?.priority, "normal");
+    });
+});
+//# sourceMappingURL=content-pipeline-envelope.test.js.map

package/dist/test/content-pipeline-envelope.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-pipeline-envelope.test.js","sourceRoot":"","sources":["../../src/test/content-pipeline-envelope.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,mCAAmC,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EAAE,2CAA2C,EAAE,MAAM,iEAAiE,CAAC;AAC9H,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,MAAM,gBAAgB,GAAG;IACvB,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE,6BAA6B;CAC5C,CAAC;AAEF,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,SAAS,GAAG,mCAAmC,EAAE,CAAC;QACxD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,2CAA2C,CACnE;YACE,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,iBAAiB;YACxB,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;SAC3C,EACD,EAAE,eAAe,EAAE,gBAAgB,EAAE,CACtC,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/graphenix-execute-envelope",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Execute request envelope: runtime building and graph execution request adaptation.",
   "license": "MIT",
   "type": "module",
@@ -15,7 +15,8 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "clean": "rimraf dist"
+    "clean": "rimraf dist",
+    "test": "npm run build && node --test dist/test/*.test.js"
   },
   "files": [
     "dist",
@@ -41,10 +42,10 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@x12i/graphenix-authoring-format": "^1.0.0",
-    "@x12i/graphenix-executable-contracts": "^1.0.0",
-    "@x12i/graphenix-plan-compiler": "^1.0.0",
-    "@x12i/graphenix-plan-format": "^1.0.0"
+    "@x12i/graphenix-authoring-format": "^1.2.1",
+    "@x12i/graphenix-executable-contracts": "^1.1.0",
+    "@x12i/graphenix-plan-compiler": "^1.1.1",
+    "@x12i/graphenix-plan-format": "^1.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",