@x12i/graphenix-core 2.0.0

package/dist/examples/validate-minimal.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const validate_1 = require("../validate");
+const validateWorox_1 = require("../validateWorox");
+const minimal_graph_1 = require("./minimal-graph");
+const result = (0, validate_1.validateGraph)(minimal_graph_1.minimalGraph);
+if (!result.valid) {
+    console.error("Minimal graph is INVALID", result.errors);
+    process.exitCode = 1;
+}
+else {
+    console.log("Minimal graph is valid according to Graphenix format 2.0.0");
+}
+const withExtensions = {
+    ...minimal_graph_1.minimalGraph,
+    revision: "1.0.0",
+    metadata: {
+        extensions: {
+            "x12i.execution/v1": {
+                modelConfig: {}
+            }
+        }
+    },
+    graph: {
+        ...minimal_graph_1.minimalGraph.graph,
+        metadata: {
+            extensions: {
+                "x12i.execution/v1": {
+                    modelConfig: {}
+                }
+            }
+        },
+        outputs: [
+            {
+                id: "graph-output:user",
+                name: "Created User",
+                type: "type:User",
+                source: {
+                    nodeId: "node:create-user",
+                    portId: "out:user"
+                },
+                contract: {
+                    semanticKind: "final-output",
+                    required: true,
+                    schema: { type: "object" }
+                }
+            }
+        ]
+    }
+};
+const extResult = (0, validate_1.validateGraph)(withExtensions);
+if (!extResult.valid) {
+    console.error("Extensions graph is INVALID", extResult.errors);
+    process.exitCode = 1;
+}
+const noopProfile = () => ({ valid: true, errors: [] });
+const profileResult = (0, validate_1.validateGraphWithProfile)(withExtensions, noopProfile);
+if (!profileResult.valid) {
+    console.error("Profile validation failed unexpectedly", profileResult.errors);
+    process.exitCode = 1;
+}
+const failingProfile = () => ({
+    valid: false,
+    errors: [
+        {
+            source: "profile",
+            code: "TEST_ERROR",
+            message: "Profile smoke test error",
+            path: "/graph/metadata/extensions/x12i.execution~1v1"
+        }
+    ]
+});
+const profileFail = (0, validate_1.validateGraphWithProfile)(withExtensions, failingProfile);
+if (profileFail.valid || profileFail.errors[0]?.source !== "profile") {
+    console.error("Profile failure path did not behave as expected", profileFail);
+    process.exitCode = 1;
+}
+const withWoroxMetadata = {
+    ...minimal_graph_1.minimalGraph,
+    metadata: {
+        graphEntry: {
+            summary: "Smoke-test entry contract",
+            requiredExecutionPaths: [["node:validate-input"]],
+            executionSchema: {
+                type: "object",
+                properties: { ok: { type: "boolean" } },
+                required: ["ok"]
+            }
+        },
+        graphResponse: {
+            summary: "Smoke-test response contract",
+            finalOutputSchema: { type: "string", minLength: 1 }
+        }
+    }
+};
+const woroxDoc = (0, validate_1.validateGraph)(withWoroxMetadata);
+if (!woroxDoc.valid) {
+    console.error("Worox metadata document is INVALID", woroxDoc.errors);
+    process.exitCode = 1;
+}
+const execOk = (0, validateWorox_1.validateExecutionAgainstContract)(withWoroxMetadata, { ok: true });
+const execBad = (0, validateWorox_1.validateExecutionAgainstContract)(withWoroxMetadata, {});
+const outOk = (0, validateWorox_1.validateFinalOutputAgainstContract)(withWoroxMetadata, "done");
+const outBad = (0, validateWorox_1.validateFinalOutputAgainstContract)(withWoroxMetadata, "");
+if (!execOk.valid || execBad.valid || !outOk.valid || outBad.valid) {
+    console.error("Worox runtime validation smoke test failed", {
+        execOk,
+        execBad,
+        outOk,
+        outBad
+    });
+    process.exitCode = 1;
+}
+//# sourceMappingURL=validate-minimal.js.map

package/dist/examples/validate-minimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-minimal.js","sourceRoot":"","sources":["../../src/examples/validate-minimal.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./validate";
+export * from "./validateWorox";
+export * from "./crud";
+//# 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,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./validate"), exports);
+__exportStar(require("./validateWorox"), exports);
+__exportStar(require("./crud"), exports);
+//# 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,0CAAwB;AACxB,6CAA2B;AAC3B,kDAAgC;AAChC,yCAAuB"}

package/dist/types.d.ts

@@ -0,0 +1,150 @@
+export type ExtensionNamespace = string;
+export interface GraphenixExtensions {
+    [namespace: ExtensionNamespace]: unknown;
+}
+export interface GraphenixMetadata {
+    extensions?: GraphenixExtensions;
+    [key: string]: unknown;
+}
+export interface PortDefinition {
+    id: string;
+    name?: string;
+    direction: "input" | "output";
+    type: string;
+    required?: boolean;
+    default?: any | null;
+}
+export type GraphPort = PortDefinition;
+export interface EdgeEndpoint {
+    nodeId: string;
+    portId: string;
+}
+export interface Edge<TMetadata extends GraphenixMetadata = GraphenixMetadata> {
+    id: string;
+    from: EdgeEndpoint;
+    to: EdgeEndpoint;
+    metadata?: TMetadata;
+}
+export type GraphEdge<TMetadata extends GraphenixMetadata = GraphenixMetadata> = Edge<TMetadata>;
+export interface Node<TParameters = Record<string, unknown>, TMetadata extends GraphenixMetadata = GraphenixMetadata> {
+    id: string;
+    name?: string;
+    kind: string;
+    inputs?: PortDefinition[];
+    outputs?: PortDefinition[];
+    parameters?: TParameters;
+    metadata?: TMetadata;
+}
+export type GraphNode<TParameters = Record<string, unknown>, TMetadata extends GraphenixMetadata = GraphenixMetadata> = Node<TParameters, TMetadata>;
+export type GraphInputSemanticKind = "record" | "query" | "user-input" | "content" | "metadata" | "execution" | (string & {});
+export interface GraphInputResolver {
+    kind?: string;
+    graphId?: string;
+    metadataFilter?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface GraphInputContract {
+    semanticKind?: GraphInputSemanticKind;
+    required?: boolean;
+    schema?: JsonSchemaObject;
+    resolver?: GraphInputResolver;
+    [key: string]: unknown;
+}
+export type GraphOutputSemanticKind = "record" | "content" | "metadata" | "execution" | "final-output" | (string & {});
+export interface GraphOutputContract {
+    semanticKind?: GraphOutputSemanticKind;
+    required?: boolean;
+    schema?: JsonSchemaObject;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface GraphInput<TMetadata extends GraphenixMetadata = GraphenixMetadata> {
+    id: string;
+    name?: string;
+    type: string;
+    target: EdgeEndpoint;
+    contract?: GraphInputContract;
+    metadata?: TMetadata;
+}
+export interface GraphOutput<TMetadata extends GraphenixMetadata = GraphenixMetadata> {
+    id: string;
+    name?: string;
+    type: string;
+    source?: EdgeEndpoint;
+    contract?: GraphOutputContract;
+    metadata?: TMetadata;
+}
+export interface Graph<TGraphMetadata extends GraphenixMetadata = GraphenixMetadata, TNodeParameters = Record<string, unknown>, TNodeMetadata extends GraphenixMetadata = GraphenixMetadata, TEdgeMetadata extends GraphenixMetadata = GraphenixMetadata> {
+    nodes: Node<TNodeParameters, TNodeMetadata>[];
+    edges: Edge<TEdgeMetadata>[];
+    inputs: GraphInput[];
+    outputs: GraphOutput[];
+    metadata?: TGraphMetadata;
+}
+export interface TypeField {
+    name: string;
+    type: string;
+    required?: boolean;
+}
+export interface TypeBase<TMetadata extends GraphenixMetadata = GraphenixMetadata> {
+    id: string;
+    kind: "object" | "union" | "alias";
+    description?: string;
+    metadata?: TMetadata;
+}
+export interface TypeObject<TMetadata extends GraphenixMetadata = GraphenixMetadata> extends TypeBase<TMetadata> {
+    kind: "object";
+    fields: TypeField[];
+}
+export interface TypeUnion<TMetadata extends GraphenixMetadata = GraphenixMetadata> extends TypeBase<TMetadata> {
+    kind: "union";
+    options: string[];
+}
+export interface TypeAlias<TMetadata extends GraphenixMetadata = GraphenixMetadata> extends TypeBase<TMetadata> {
+    kind: "alias";
+    target: string;
+}
+export type TypeDefinition<TMetadata extends GraphenixMetadata = GraphenixMetadata> = TypeObject<TMetadata> | TypeUnion<TMetadata> | TypeAlias<TMetadata>;
+export type GraphType<TMetadata extends GraphenixMetadata = GraphenixMetadata> = TypeDefinition<TMetadata>;
+export interface SubgraphDefinition<TGraphMetadata extends GraphenixMetadata = GraphenixMetadata, TNodeParameters = Record<string, unknown>, TNodeMetadata extends GraphenixMetadata = GraphenixMetadata, TEdgeMetadata extends GraphenixMetadata = GraphenixMetadata> {
+    id: string;
+    name?: string;
+    graph: Graph<TGraphMetadata, TNodeParameters, TNodeMetadata, TEdgeMetadata>;
+    metadata?: GraphenixMetadata;
+}
+export type Subgraph<TGraphMetadata extends GraphenixMetadata = GraphenixMetadata, TNodeParameters = Record<string, unknown>, TNodeMetadata extends GraphenixMetadata = GraphenixMetadata, TEdgeMetadata extends GraphenixMetadata = GraphenixMetadata> = SubgraphDefinition<TGraphMetadata, TNodeParameters, TNodeMetadata, TEdgeMetadata>;
+export type JsonSchemaObject = Record<string, unknown>;
+export interface GraphEntryContract {
+    summary?: string;
+    requiredExecutionPaths?: unknown[];
+    executionSchema?: JsonSchemaObject;
+    notableExecutionPaths?: unknown[];
+    [key: string]: unknown;
+}
+export interface GraphResponseContract {
+    summary?: string;
+    finalOutputSchema?: JsonSchemaObject;
+    [key: string]: unknown;
+}
+export type WoroxCatalogRequest = Record<string, unknown>;
+export type WoroxCatalogBinding = Record<string, unknown>;
+export type WoroxCatalogRequests = WoroxCatalogRequest[] | Record<string, WoroxCatalogRequest>;
+export type GraphDocumentMetadata = GraphenixMetadata & {
+    graphEntry?: GraphEntryContract;
+    graphResponse?: GraphResponseContract;
+    catalogRequests?: WoroxCatalogRequests;
+};
+export interface GraphDocument<TDocumentMetadata extends GraphenixMetadata = GraphenixMetadata, TGraphMetadata extends GraphenixMetadata = GraphenixMetadata, TNodeParameters = Record<string, unknown>, TNodeMetadata extends GraphenixMetadata = GraphenixMetadata, TEdgeMetadata extends GraphenixMetadata = GraphenixMetadata> {
+    formatVersion: "2.0.0";
+    id: string;
+    revision?: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    graph: Graph<TGraphMetadata, TNodeParameters, TNodeMetadata, TEdgeMetadata>;
+    types?: TypeDefinition[];
+    subgraphs?: SubgraphDefinition<TGraphMetadata, TNodeParameters, TNodeMetadata, TEdgeMetadata>[];
+    metadata?: TDocumentMetadata;
+}
+export declare const GRAPHENIX_FORMAT_VERSION: "2.0.0";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRAPHENIX_FORMAT_VERSION = void 0;
+exports.GRAPHENIX_FORMAT_VERSION = "2.0.0";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAuQa,QAAA,wBAAwB,GAAG,OAAgB,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,21 @@
+import type { GraphDocument } from "./types";
+export interface GraphValidationError {
+    message: string;
+    path: string;
+    keyword?: string;
+    params?: Record<string, unknown>;
+    code?: string;
+    source?: "graphenix" | "profile";
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: GraphValidationError[];
+}
+export interface GraphProfileValidationResult {
+    valid: boolean;
+    errors: GraphValidationError[];
+}
+export type GraphProfileValidator<TDoc extends GraphDocument = GraphDocument> = (doc: TDoc) => GraphProfileValidationResult;
+export declare function validateGraph(document: unknown): ValidationResult;
+export declare function validateGraphWithProfile<TDoc extends GraphDocument>(doc: unknown, profileValidator: GraphProfileValidator<TDoc>): GraphProfileValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,qBAAqB,CAAC,IAAI,SAAS,aAAa,GAAG,aAAa,IAC1E,CAAC,GAAG,EAAE,IAAI,KAAK,4BAA4B,CAAC;AAmB9C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAQjE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,SAAS,aAAa,EACjE,GAAG,EAAE,OAAO,EACZ,gBAAgB,EAAE,qBAAqB,CAAC,IAAI,CAAC,GAC5C,4BAA4B,CAc9B"}

package/dist/validate.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateGraph = validateGraph;
+exports.validateGraphWithProfile = validateGraphWithProfile;
+const ajv_1 = __importDefault(require("ajv"));
+const graphenix_format_2_0_0_schema_json_1 = __importDefault(require("../schema/graphenix-format-2.0.0.schema.json"));
+const ajv = new ajv_1.default({
+    allErrors: true,
+    strict: false
+});
+const validateFn = ajv.compile(graphenix_format_2_0_0_schema_json_1.default);
+function normalizeError(error) {
+    return {
+        message: error.message ?? "Validation error",
+        path: error.instancePath || error.schemaPath,
+        keyword: error.keyword,
+        params: (error.params ?? {}),
+        source: "graphenix"
+    };
+}
+function validateGraph(document) {
+    const valid = validateFn(document);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validateFn.errors ?? []).map(normalizeError);
+    return { valid: false, errors };
+}
+function validateGraphWithProfile(doc, profileValidator) {
+    const baseResult = validateGraph(doc);
+    if (!baseResult.valid) {
+        return baseResult;
+    }
+    const profileResult = profileValidator(doc);
+    return {
+        valid: profileResult.valid,
+        errors: profileResult.errors.map((error) => ({
+            ...error,
+            source: error.source ?? "profile"
+        }))
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":";;;;;AA2CA,sCAQC;AAED,4DAiBC;AAtED,8CAA4C;AAC5C,sHAAkE;AAyBlE,MAAM,GAAG,GAAG,IAAI,aAAG,CAAC;IAClB,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,KAAK;CACd,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAgB,4CAAgB,CAAC,CAAC;AAEhE,SAAS,cAAc,CAAC,KAAkB;IACxC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,kBAAkB;QAC5C,IAAI,EAAE,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,UAAU;QAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAA4B;QACvD,MAAM,EAAE,WAAW;KACpB,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,QAAiB;IAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,SAAgB,wBAAwB,CACtC,GAAY,EACZ,gBAA6C;IAE7C,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAW,CAAC,CAAC;IACpD,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3C,GAAG,KAAK;YACR,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;SAClC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/validateWorox.d.ts

@@ -0,0 +1,22 @@
+import Ajv from "ajv";
+import type { GraphDocument, GraphDocumentMetadata } from "./types";
+import type { ValidationResult } from "./validate";
+export interface WoroxRuntimeValidationOptions {
+    /**
+     * AJV instance used to compile `executionSchema` / `finalOutputSchema`.
+     * When omitted, a shared default instance (`strict: false`, `allErrors: true`) is used.
+     */
+    ajv?: Ajv;
+}
+/**
+ * Validates `execution` against `document.metadata.graphEntry.executionSchema` when present.
+ * If there is no schema, or `graphEntry` is missing, returns `{ valid: true, errors: [] }`.
+ * This is optional tooling; graphenix planning does not require it.
+ */
+export declare function validateExecutionAgainstContract(document: GraphDocument<GraphDocumentMetadata>, execution: unknown, options?: WoroxRuntimeValidationOptions): ValidationResult;
+/**
+ * Validates `finalOutput` against `document.metadata.graphResponse.finalOutputSchema` when present.
+ * If there is no schema, or `graphResponse` is missing, returns `{ valid: true, errors: [] }`.
+ */
+export declare function validateFinalOutputAgainstContract(document: GraphDocument<GraphDocumentMetadata>, finalOutput: unknown, options?: WoroxRuntimeValidationOptions): ValidationResult;
+//# sourceMappingURL=validateWorox.d.ts.map

package/dist/validateWorox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateWorox.d.ts","sourceRoot":"","sources":["../src/validateWorox.ts"],"names":[],"mappings":"AAAA,OAAO,GAAgD,MAAM,KAAK,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAyBzE,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC9C,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,6BAA6B,GACtC,gBAAgB,CAwBlB;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC9C,WAAW,EAAE,OAAO,EACpB,OAAO,CAAC,EAAE,6BAA6B,GACtC,gBAAgB,CAwBlB"}

package/dist/validateWorox.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateExecutionAgainstContract = validateExecutionAgainstContract;
+exports.validateFinalOutputAgainstContract = validateFinalOutputAgainstContract;
+const ajv_1 = __importDefault(require("ajv"));
+const defaultAjv = new ajv_1.default({
+    allErrors: true,
+    strict: false
+});
+function normalizeError(error) {
+    return {
+        message: error.message ?? "Validation error",
+        path: error.instancePath || error.schemaPath,
+        keyword: error.keyword,
+        params: (error.params ?? {})
+    };
+}
+function runCompiled(validate, data) {
+    const valid = validate(data);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors ?? []).map(normalizeError);
+    return { valid: false, errors };
+}
+/**
+ * Validates `execution` against `document.metadata.graphEntry.executionSchema` when present.
+ * If there is no schema, or `graphEntry` is missing, returns `{ valid: true, errors: [] }`.
+ * This is optional tooling; graphenix planning does not require it.
+ */
+function validateExecutionAgainstContract(document, execution, options) {
+    const schema = document.metadata?.graphEntry?.executionSchema;
+    if (schema === undefined || schema === null || typeof schema !== "object") {
+        return { valid: true, errors: [] };
+    }
+    const ajv = options?.ajv ?? defaultAjv;
+    let validate;
+    try {
+        validate = ajv.compile(schema);
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return {
+            valid: false,
+            errors: [
+                {
+                    message: `Invalid executionSchema: ${message}`,
+                    path: "/metadata/graphEntry/executionSchema",
+                    keyword: "compile",
+                    params: {}
+                }
+            ]
+        };
+    }
+    return runCompiled(validate, execution);
+}
+/**
+ * Validates `finalOutput` against `document.metadata.graphResponse.finalOutputSchema` when present.
+ * If there is no schema, or `graphResponse` is missing, returns `{ valid: true, errors: [] }`.
+ */
+function validateFinalOutputAgainstContract(document, finalOutput, options) {
+    const schema = document.metadata?.graphResponse?.finalOutputSchema;
+    if (schema === undefined || schema === null || typeof schema !== "object") {
+        return { valid: true, errors: [] };
+    }
+    const ajv = options?.ajv ?? defaultAjv;
+    let validate;
+    try {
+        validate = ajv.compile(schema);
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return {
+            valid: false,
+            errors: [
+                {
+                    message: `Invalid finalOutputSchema: ${message}`,
+                    path: "/metadata/graphResponse/finalOutputSchema",
+                    keyword: "compile",
+                    params: {}
+                }
+            ]
+        };
+    }
+    return runCompiled(validate, finalOutput);
+}
+//# sourceMappingURL=validateWorox.js.map

package/dist/validateWorox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateWorox.js","sourceRoot":"","sources":["../src/validateWorox.ts"],"names":[],"mappings":"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"}

package/docs/interop-worox-graph.md

@@ -0,0 +1,32 @@
+# Interop: worox-graph JSON and Graphenix `Graph`
+
+How **worox-graph** graph JSON relates to the port-based `Graph` type in `@x12i/graphenix-core`.
+
+## Two representations
+
+| Area | worox-graph | Graphenix core `Graph` |
+|------|-------------|------------------------|
+| Topology | Task nodes, edges, `outputMapping`, finalizers | Nodes, edges, **ports**, `GraphInput` / `GraphOutput` |
+| Execution shape | Engine-specific (tasks, DAG scheduling) | **Execution-agnostic** static description |
+| I/O contracts | Often embedded in graph JSON and tooling | **Optional** `metadata.graphEntry` / `metadata.graphResponse` on the **document** |
+| Planning (catalog) | Optional `metadata.catalogRequests`; per task node `metadata.catalogRequest` / `metadata.catalogBinding` | Same optional keys on **`GraphDocument.metadata`** and **node `metadata`** (execution unchanged) |
+
+worox-graph focuses on runnable task graphs and visibility into execution paths. Graphenix describes a **static** graph layout (ports, graph-level inputs/outputs) without prescribing how the runtime schedules tasks.
+
+Planning-only catalog fields do not alter execution. Graphenix exposes matching optional JSON Schema `$defs` for tooling that wants a single validator story.
+
+## Where worox-graph JSON lives
+
+- **Canonical for core:** optional **`GraphDocument.metadata.graphEntry`** and **`GraphDocument.metadata.graphResponse`**. These match worox contracts used when values are copied to `variables.__graphModel`.
+- **Namespaced extensions:** worox-only payloads may also live under `metadata.extensions` when a profile namespace owns them.
+
+Graphenix core does not change execution model: the `Graph` remains port-based.
+
+## DAG nodes vs ports: is there a converter?
+
+**Not in `@x12i/graphenix-core` today.** A future optional converter could map worox task nodes ↔ port graphs. Until such a tool exists, treat worox graph JSON and Graphenix `Graph` as related **documentation and planning** layers, not automatic transforms.
+
+## See also
+
+- [`../README.md`](../README.md) — graph-level summary contracts (I/O layers 01 / 08).
+- `schema/graphenix-format-2.0.0.schema.json` — `$defs/GraphEntryContract`, `$defs/GraphResponseContract`, and optional worox planning `$defs`.

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@x12i/graphenix-core",
+  "version": "2.0.0",
+  "description": "Graphenix core tier: format 2.0.0 JSON schema, validation, and CRUD helpers.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "clean": "rimraf dist",
+    "lint": "echo \"no lint configured\"",
+    "prepare": "npm run build",
+    "test": "node ./dist/examples/validate-minimal.js"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "docs"
+  ],
+  "keywords": [
+    "graph",
+    "workflow",
+    "json-schema",
+    "validation",
+    "graphenix"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/x12i/graphenix-format.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/x12i/graphenix-format/issues"
+  },
+  "homepage": "https://github.com/x12i/graphenix-format/tree/master/packages/core#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.6.3"
+  }
+}