@x12i/graphenix-execute-envelope 1.0.0

package/README.md

@@ -0,0 +1,175 @@
+# @x12i/graphenix-execute-envelope
+
+**Execute request envelope** — host-level adaptation for graph execution requests.
+
+Validates incoming execute requests, builds the runtime object (excluding credentials), compiles the authoring graph into a plan, and returns `{ plan, runtime }` for the engine.
+
+Optional package: engines and compilers do not need it; backend hosts and API gateways do.
+
+**Finalization brief:** [EXECUTE-TRACE-FORMAT-FINALIZATION.md](../../docs/EXECUTE-TRACE-FORMAT-FINALIZATION.md) · compile: [COMPILE-FORMAT-FINALIZATION.md](../../docs/COMPILE-FORMAT-FINALIZATION.md).
+
+---
+
+## Who should use this
+
+| Role | Use this package? |
+| ---- | ----------------- |
+| Backend host / API gateway / Studio backend | **Yes** |
+| Compiler service (already owns compile) | Usually **No** |
+| Engine | **No** |
+
+---
+
+## Lifecycle position
+
+```txt
+Studio execute request (authoring + input)
+        │  validateStudioExecuteRequest()
+        │  buildRuntimeObject()
+        │  compileExecutablePlan()
+        │  validateExecutablePlan()
+        ▼
+{ plan, runtime }  →  engine
+        │
+        ▼
+GraphExecutionTrace  (@x12i/graphenix-trace-format)
+```
+
+Reference authoring: `createContentPipelineReferenceGraph()` — `graph:content-pipeline`.
+
+---
+
+## Install
+
+```bash
+npm install @x12i/graphenix-execute-envelope
+```
+
+---
+
+## Examples (JSON)
+
+### Studio execute request (shape)
+
+```json
+{
+  "authoringGraph": { "id": "graph:content-pipeline", "formatVersion": "2.0.0", "graph": {} },
+  "input": {
+    "brief": "Launch campaign for eco-friendly water bottles",
+    "priority": "normal"
+  },
+  "options": {
+    "jobId": "job-001",
+    "mode": "live",
+    "environment": "prod"
+  }
+}
+```
+
+Credentials stay on the request boundary — never copied into `GraphRuntimeObject`.
+
+### Runtime object (compile input)
+
+```json
+{
+  "jobId": "job-001",
+  "mode": "live",
+  "environment": "prod",
+  "input": {
+    "brief": "Launch campaign for eco-friendly water bottles",
+    "priority": "normal"
+  }
+}
+```
+
+### Compile output handoff
+
+```json
+{
+  "plan": {
+    "format": "graphenix.executable-plan/v2",
+    "source": { "graphId": "graph:content-pipeline" },
+    "nodePlans": {
+      "node:audience-insights": {
+        "executionUnits": [
+          { "unitKind": "externalPreUtility", "order": 0, "strategyKey": "synthesis" },
+          { "unitKind": "mainSkill", "order": 1, "skillKey": "professional-answer" }
+        ]
+      }
+    }
+  },
+  "runtime": { "jobId": "job-001", "mode": "live", "input": { "priority": "normal" } }
+}
+```
+
+Embedded normalized graph in the plan has **no** `node.layout` — stripped at compile.
+
+---
+
+## Example (API)
+
+```ts
+import { buildGraphExecutionRequestFromStudioExecute } from "@x12i/graphenix-execute-envelope";
+
+const { plan, runtime } = buildGraphExecutionRequestFromStudioExecute(request);
+// forward to engine — engine never sees the raw Studio request
+```
+
+### Lower-level building blocks
+
+```ts
+import {
+  validateStudioExecuteRequest,
+  buildRuntimeObject,
+  validateRuntimeObject
+} from "@x12i/graphenix-execute-envelope";
+import { compileExecutablePlan } from "@x12i/graphenix-plan-compiler";
+import { validateExecutablePlan } from "@x12i/graphenix-plan-format";
+
+validateStudioExecuteRequest(request);
+const runtime = buildRuntimeObject(request.input, request.options);
+validateRuntimeObject(runtime);
+
+const plan = compileExecutablePlan(request.authoringGraph, runtime);
+validateExecutablePlan(plan);
+```
+
+---
+
+## Key exports
+
+| API | Purpose |
+| --- | ------- |
+| `buildGraphExecutionRequestFromStudioExecute` | Full pipeline: validate → runtime → compile → validate plan |
+| `validateStudioExecuteRequest` | Request envelope validation |
+| `buildRuntimeObject` | Build `GraphRuntimeObject` from host input |
+| `validateRuntimeObject` | Runtime shape + forbidden fields |
+
+---
+
+## Security rules
+
+- Credentials are **never** copied into the runtime object
+- Request-level forbidden fields (e.g. `graphDefaultModel` in runtime) are rejected
+- Runtime must not carry authoring-only config like `modelConfig`
+- Engine receives only `{ plan, runtime }` — no Studio envelope, no API keys in runtime
+
+---
+
+## 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
+
+---
+
+## Related packages
+
+| Package | Role |
+| ------- | ---- |
+| [`@x12i/graphenix-plan-compiler`](../plan-compiler) | Compilation step |
+| [`@x12i/graphenix-trace-format`](../trace-format) | Run evidence after engine executes |
+| [backend-host role guide](../../docs/roles/backend-host.md) | Client guide |
+| [`@x12i/graphenix-executable-format`](../executable-format) | Umbrella that re-exports this package |

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

@@ -0,0 +1,6 @@
+import type { GraphExecutionRequest, StudioGraphExecuteRequest } from "@x12i/graphenix-executable-contracts";
+export declare function buildGraphExecutionRequestFromStudioExecute(request: StudioGraphExecuteRequest, options?: {
+    agentId?: string;
+    jobTypeId?: string;
+}): 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

@@ -0,0 +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"}

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

@@ -0,0 +1,38 @@
+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";
+export function buildGraphExecutionRequestFromStudioExecute(request, options = {}) {
+    const validation = validateStudioExecuteRequest(request);
+    if (!validation.valid) {
+        const summary = validation.errors
+            .map((error) => `${error.path}: ${error.message}`)
+            .join("; ");
+        throw new Error(`Invalid studio execute request: ${summary}`);
+    }
+    const runtime = buildRuntimeObject({
+        jobId: request.jobId,
+        input: request.runtime?.input,
+        mode: request.graphExecution?.mode ?? request.runtime?.mode,
+        runLogMode: request.runLogMode ?? request.runtime?.runLogMode,
+        maxRunLogEntries: request.maxRunLogEntries ?? request.runtime?.maxRunLogEntries,
+        maxRunLogDataJsonChars: request.maxRunLogDataJsonChars ??
+            request.runtime?.maxRunLogDataJsonChars,
+        runTaskDiagnostics: request.runTaskDiagnostics ?? request.runtime?.runTaskDiagnostics,
+        variables: request.runtime?.variables,
+        job: request.runtime?.job
+    }, options);
+    const plan = compileExecutablePlan(request.graph, runtime);
+    const planValidation = validateExecutablePlan(plan);
+    if (!planValidation.valid) {
+        const summary = planValidation.errors
+            .map((error) => `${error.path}: ${error.message}`)
+            .join("; ");
+        throw new Error(`Invalid executable plan: ${summary}`);
+    }
+    return {
+        plan,
+        runtime
+    };
+}
+//# sourceMappingURL=build-graph-execution-request-from-studio-execute.js.map

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

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { validateStudioExecuteRequest } from "./validators/validate-studio-execute-request.js";
+export { validateRuntimeObject, buildRuntimeObject } from "./validators/validate-runtime-object.js";
+export { buildGraphExecutionRequestFromStudioExecute } from "./adapter/build-graph-execution-request-from-studio-execute.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,2CAA2C,EAAE,MAAM,gEAAgE,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { validateStudioExecuteRequest } from "./validators/validate-studio-execute-request.js";
+export { validateRuntimeObject, buildRuntimeObject } from "./validators/validate-runtime-object.js";
+export { buildGraphExecutionRequestFromStudioExecute } from "./adapter/build-graph-execution-request-from-studio-execute.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,2CAA2C,EAAE,MAAM,gEAAgE,CAAC"}

package/dist/validators/validate-runtime-object.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutableGraphValidationResult } from "@x12i/graphenix-executable-contracts";
+import type { GraphRuntimeObject } from "@x12i/graphenix-executable-contracts";
+export declare function validateRuntimeObject(runtime: unknown): ExecutableGraphValidationResult;
+export declare function buildRuntimeObject(partial: Partial<GraphRuntimeObject> & {
+    jobId: string;
+}, options?: {
+    agentId?: string;
+    jobTypeId?: string;
+}): GraphRuntimeObject;
+//# sourceMappingURL=validate-runtime-object.d.ts.map

package/dist/validators/validate-runtime-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-runtime-object.d.ts","sourceRoot":"","sources":["../../src/validators/validate-runtime-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,+BAA+B,EAChC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAY/E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,GACf,+BAA+B,CAoEjC;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACxD,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACrD,kBAAkB,CAiBpB"}

package/dist/validators/validate-runtime-object.js

@@ -0,0 +1,59 @@
+import { execError, isRecord } from "@x12i/graphenix-executable-contracts";
+const FORBIDDEN_RUNTIME_FIELDS = [
+    "modelConfig",
+    "graphDefaultModel",
+    "preActionModel",
+    "skillModel",
+    "postActionModel",
+    "credentials"
+];
+export function validateRuntimeObject(runtime) {
+    const errors = [];
+    if (!isRecord(runtime)) {
+        return {
+            valid: false,
+            errors: [
+                execError("RUNTIME_OBJECT_INVALID", "Runtime must be an object.", "")
+            ]
+        };
+    }
+    if (typeof runtime.jobId !== "string" || runtime.jobId.length === 0) {
+        errors.push(execError("RUNTIME_OBJECT_INVALID", "runtime.jobId is required.", "/jobId"));
+    }
+    if (!isRecord(runtime.job)) {
+        errors.push(execError("RUNTIME_OBJECT_INVALID", "runtime.job is required.", "/job"));
+    }
+    else {
+        if (typeof runtime.job.id !== "string") {
+            errors.push(execError("RUNTIME_OBJECT_INVALID", "runtime.job.id is required.", "/job/id"));
+        }
+        if (typeof runtime.job.jobId !== "string") {
+            errors.push(execError("RUNTIME_OBJECT_INVALID", "runtime.job.jobId is required.", "/job/jobId"));
+        }
+    }
+    for (const field of FORBIDDEN_RUNTIME_FIELDS) {
+        if (field in runtime) {
+            errors.push(execError("RUNTIME_OBJECT_INVALID", `Runtime must not contain ${field}.`, `/${field}`));
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+export function buildRuntimeObject(partial, options = {}) {
+    return {
+        jobId: partial.jobId,
+        job: {
+            id: partial.job?.id ?? partial.jobId,
+            jobId: partial.job?.jobId ?? partial.jobId,
+            agentId: partial.job?.agentId ?? options.agentId,
+            jobTypeId: partial.job?.jobTypeId ?? options.jobTypeId
+        },
+        input: partial.input,
+        mode: partial.mode,
+        runLogMode: partial.runLogMode,
+        maxRunLogEntries: partial.maxRunLogEntries,
+        maxRunLogDataJsonChars: partial.maxRunLogDataJsonChars,
+        runTaskDiagnostics: partial.runTaskDiagnostics,
+        variables: partial.variables
+    };
+}
+//# sourceMappingURL=validate-runtime-object.js.map

package/dist/validators/validate-runtime-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-runtime-object.js","sourceRoot":"","sources":["../../src/validators/validate-runtime-object.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAE3E,MAAM,wBAAwB,GAAG;IAC/B,aAAa;IACb,mBAAmB;IACnB,gBAAgB;IAChB,YAAY;IACZ,iBAAiB;IACjB,aAAa;CACL,CAAC;AAEX,MAAM,UAAU,qBAAqB,CACnC,OAAgB;IAEhB,MAAM,MAAM,GAAqC,EAAE,CAAC;IAEpD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE;gBACN,SAAS,CACP,wBAAwB,EACxB,4BAA4B,EAC5B,EAAE,CACH;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CACT,SAAS,CACP,wBAAwB,EACxB,4BAA4B,EAC5B,QAAQ,CACT,CACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CACT,SAAS,CACP,wBAAwB,EACxB,0BAA0B,EAC1B,MAAM,CACP,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CACT,SAAS,CACP,wBAAwB,EACxB,6BAA6B,EAC7B,SAAS,CACV,CACF,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CACT,SAAS,CACP,wBAAwB,EACxB,gCAAgC,EAChC,YAAY,CACb,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,wBAAwB,EAAE,CAAC;QAC7C,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CACT,SAAS,CACP,wBAAwB,EACxB,4BAA4B,KAAK,GAAG,EACpC,IAAI,KAAK,EAAE,CACZ,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAwD,EACxD,UAAoD,EAAE;IAEtD,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,EAAE;YACH,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,OAAO,CAAC,KAAK;YACpC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK;YAC1C,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO;YAChD,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,IAAI,OAAO,CAAC,SAAS;SACvD;QACD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;QACtD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC"}

package/dist/validators/validate-studio-execute-request.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutableGraphValidationResult } from "@x12i/graphenix-executable-contracts";
+import type { StudioGraphExecuteRequest } from "@x12i/graphenix-executable-contracts";
+export declare function validateStudioExecuteRequest(request: unknown): ExecutableGraphValidationResult;
+export declare function isStudioGraphExecuteRequest(value: unknown): value is StudioGraphExecuteRequest;
+//# sourceMappingURL=validate-studio-execute-request.d.ts.map

package/dist/validators/validate-studio-execute-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-studio-execute-request.d.ts","sourceRoot":"","sources":["../../src/validators/validate-studio-execute-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,+BAA+B,EAChC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAItF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,GACf,+BAA+B,CA6DjC;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,yBAAyB,CAEpC"}

package/dist/validators/validate-studio-execute-request.js

@@ -0,0 +1,33 @@
+import { execError, isRecord } from "@x12i/graphenix-executable-contracts";
+import { validateExecutableGraph } from "@x12i/graphenix-authoring-format";
+export function validateStudioExecuteRequest(request) {
+    const errors = [];
+    if (!isRecord(request)) {
+        return {
+            valid: false,
+            errors: [
+                execError("STUDIO_EXECUTE_REQUEST_INVALID", "Studio execute request must be an object.", "")
+            ]
+        };
+    }
+    if (request.mode !== "graph") {
+        errors.push(execError("STUDIO_EXECUTE_REQUEST_INVALID", "Studio execute request mode must be graph.", "/mode"));
+    }
+    if (typeof request.jobId !== "string" || request.jobId.length === 0) {
+        errors.push(execError("STUDIO_EXECUTE_REQUEST_INVALID", "Studio execute request jobId is required.", "/jobId"));
+    }
+    if ("graphDefaultModel" in request) {
+        errors.push(execError("STUDIO_GRAPH_DEFAULT_MODEL_FORBIDDEN", "graphDefaultModel is forbidden; use graph.metadata.extensions executable profile modelConfig.", "/graphDefaultModel"));
+    }
+    if (request.graph === undefined) {
+        errors.push(execError("STUDIO_EXECUTE_REQUEST_INVALID", "Studio execute request graph is required.", "/graph"));
+        return { valid: false, errors };
+    }
+    const graphResult = validateExecutableGraph(request.graph);
+    errors.push(...graphResult.errors);
+    return { valid: errors.length === 0, errors };
+}
+export function isStudioGraphExecuteRequest(value) {
+    return validateStudioExecuteRequest(value).valid;
+}
+//# sourceMappingURL=validate-studio-execute-request.js.map

package/dist/validators/validate-studio-execute-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-studio-execute-request.js","sourceRoot":"","sources":["../../src/validators/validate-studio-execute-request.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,UAAU,4BAA4B,CAC1C,OAAgB;IAEhB,MAAM,MAAM,GAAqC,EAAE,CAAC;IAEpD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE;gBACN,SAAS,CACP,gCAAgC,EAChC,2CAA2C,EAC3C,EAAE,CACH;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CACT,SAAS,CACP,gCAAgC,EAChC,4CAA4C,EAC5C,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CACT,SAAS,CACP,gCAAgC,EAChC,2CAA2C,EAC3C,QAAQ,CACT,CACF,CAAC;IACJ,CAAC;IAED,IAAI,mBAAmB,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CACT,SAAS,CACP,sCAAsC,EACtC,+FAA+F,EAC/F,oBAAoB,CACrB,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CACT,SAAS,CACP,gCAAgC,EAChC,2CAA2C,EAC3C,QAAQ,CACT,CACF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAc;IAEd,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@x12i/graphenix-execute-envelope",
+  "version": "1.0.0",
+  "description": "Execute request envelope: runtime building and graph execution request adaptation.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "graph",
+    "graphenix",
+    "execute",
+    "envelope"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/x12i/graphenix-format.git",
+    "directory": "packages/execute-envelope"
+  },
+  "bugs": {
+    "url": "https://github.com/x12i/graphenix-format/issues"
+  },
+  "homepage": "https://github.com/x12i/graphenix-format/tree/master/packages/execute-envelope#readme",
+  "publishConfig": {
+    "access": "public",
+    "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"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.6.3"
+  }
+}