graphenix-format 1.2.0

package/README.md

@@ -0,0 +1,274 @@
+## `@graphenix/format`
+
+TypeScript/JavaScript utilities for working with the **Graphenix Format 1.0.0**:
+
+- **JSON Schema** for validation (`schema/graphenix-format-1.0.0.schema.json`)
+- **Runtime validator** built on [`ajv`](https://ajv.js.org)
+- Lightweight **CRUD helpers** for nodes, edges, types and subgraphs
+- First-class **TypeScript types** for graph documents
+
+---
+
+### Install
+
+```bash
+npm install @graphenix/format
+# or
+yarn add @graphenix/format
+```
+
+---
+
+### Usage
+
+#### Validate a graph document
+
+```ts
+import { validateGraph, type GraphDocument } from "@graphenix/format";
+
+const doc: GraphDocument = {
+  formatVersion: "1.0.0",
+  id: "graph:auth/user-signup",
+  graph: {
+    nodes: [],
+    edges: [],
+    inputs: [],
+    outputs: []
+  }
+};
+
+const result = validateGraph(doc);
+
+if (!result.valid) {
+  console.error(result.errors);
+}
+```
+
+Each error has:
+
+- **`message`**: human readable message
+- **`path`**: JSON Pointer to the failing instance
+- **`keyword`** and **`params`** from `ajv` for tooling.
+
+---
+
+#### Quick start: minimal Graphenix document
+
+This is a minimal but complete **Graphenix Format 1.0.0** document that you can load, validate, and then modify:
+
+```ts
+import {
+  validateGraph,
+  type GraphDocument,
+  addNode,
+  addEdge
+} from "@graphenix/format";
+
+const doc: GraphDocument = {
+  formatVersion: "1.0.0",
+  id: "graph:auth/user-signup",
+  name: "User Signup",
+  graph: {
+    nodes: [
+      {
+        id: "node:validate-input",
+        kind: "builtin:validate",
+        inputs: [
+          {
+            id: "in:payload",
+            direction: "input",
+            type: "builtin:object",
+            required: true
+          }
+        ],
+        outputs: [
+          {
+            id: "out:validated",
+            direction: "output",
+            type: "builtin:object"
+          }
+        ],
+        parameters: {
+          schemaType: "type:User"
+        }
+      }
+    ],
+    edges: [],
+    inputs: [
+      {
+        id: "graph-input:request",
+        name: "Request Body",
+        type: "builtin:object",
+        target: {
+          nodeId: "node:validate-input",
+          portId: "in:payload"
+        }
+      }
+    ],
+    outputs: [],
+    metadata: {}
+  },
+  types: [
+    {
+      id: "type:User",
+      kind: "object",
+      fields: [
+        { name: "id", type: "builtin:string", required: true },
+        { name: "email", type: "builtin:string", required: true }
+      ]
+    }
+  ]
+};
+
+// Validate against the Graphenix JSON Schema
+const res = validateGraph(doc);
+if (!res.valid) {
+  throw new Error(JSON.stringify(res.errors, null, 2));
+}
+
+// Programmatically add a new node + edge
+const withCreateNode = addNode(doc, {
+  id: "node:create-user",
+  kind: "task:http-request",
+  inputs: [
+    {
+      id: "in:validated",
+      direction: "input",
+      type: "type:User",
+      required: true
+    }
+  ],
+  outputs: [
+    {
+      id: "out:user",
+      direction: "output",
+      type: "type:User"
+    }
+  ],
+  parameters: {
+    method: "POST",
+    url: "https://example.com/users"
+  }
+});
+
+const finalDoc = addEdge(withCreateNode, {
+  id: "edge:validate-to-create",
+  from: { nodeId: "node:validate-input", portId: "out:validated" },
+  to: { nodeId: "node:create-user", portId: "in:validated" }
+});
+```
+
+This matches the structure described in `GRAPHENIX-FORMAT.md` and can be fed directly to your executor.
+
+---
+
+#### CRUD helpers
+
+CRUD helpers operate on an in-memory `GraphDocument` and return a new document by default (immutable), or mutate in-place when `mutate: true` is passed.
+
+```ts
+import {
+  addNode,
+  updateNode,
+  removeNode,
+  addEdge,
+  removeEdge,
+  addType
+} from "@graphenix/format";
+
+import type { GraphDocument } from "@graphenix/format";
+
+let doc: GraphDocument = /* ... */;
+
+// Add a node (immutable)
+doc = addNode(doc, {
+  id: "node:validate-input",
+  kind: "builtin:validate",
+  inputs: [],
+  outputs: []
+});
+
+// Update a node
+doc = updateNode(doc, "node:validate-input", {
+  name: "Validate Input"
+});
+
+// Remove a node (also removes attached edges and graph IO)
+doc = removeNode(doc, "node:validate-input");
+```
+
+All CRUD helpers accept an optional `{ mutate?: boolean }`:
+
+```ts
+addNode(doc, newNode, { mutate: true }); // modifies `doc` in place
+```
+
+Available helpers:
+
+- **Nodes**: `getNode`, `addNode`, `updateNode`, `removeNode`
+- **Edges**: `getEdge`, `addEdge`, `updateEdge`, `removeEdge`
+- **Types**: `getType`, `addType`, `updateType`, `removeType`
+- **Subgraphs**: `getSubgraph`, `addSubgraph`, `updateSubgraph`, `removeSubgraph`
+
+---
+
+### Working with subgraphs and types
+
+Subgraphs are just nested `graph` structures that can be referenced via node `kind`:
+
+```ts
+import {
+  type GraphDocument,
+  addSubgraph,
+  addNode
+} from "@graphenix/format";
+
+let doc: GraphDocument = /* existing document */;
+
+// Add a reusable subgraph
+doc = addSubgraph(doc, {
+  id: "graph:user-validation",
+  name: "User Validation",
+  graph: {
+    nodes: [],
+    edges: [],
+    inputs: [],
+    outputs: []
+  }
+});
+
+// Use it as a node in the main graph
+doc = addNode(doc, {
+  id: "node:user-validation",
+  kind: "subgraph:graph:user-validation",
+  inputs: [],
+  outputs: []
+});
+```
+
+For a full description of all fields and constraints, see `GRAPHENIX-FORMAT.md` in this repo.
+
+---
+
+### Build & test locally
+
+```bash
+# install dev dependencies
+npm install
+
+# build ESM + CJS
+npm run build
+
+# run a tiny smoke test that validates the minimal example graph
+npm test
+```
+
+The minimal example graph lives in `src/examples/minimal-graph.ts` and mirrors the example from `GRAPHENIX-FORMAT.md`.
+
+---
+
+### Notes
+
+- The package is **execution-agnostic**: it only knows about the static Graphenix format.
+- Runtime concerns (scheduling, retries, parallelism, logging, etc.) are intentionally left to your executor/runtime.
+

package/dist/crud.d.ts

@@ -0,0 +1,25 @@
+import type { GraphDocument, Node, Edge, TypeDefinition, SubgraphDefinition } from "./types";
+export interface CrudOptions {
+    /**
+     * When true, mutations are applied to the passed-in object.
+     * When false (default), a shallow-cloned document is returned.
+     */
+    mutate?: boolean;
+}
+export declare function getNode(doc: GraphDocument, nodeId: string): Node | undefined;
+export declare function addNode(doc: GraphDocument, node: Node, options?: CrudOptions): GraphDocument;
+export declare function updateNode(doc: GraphDocument, nodeId: string, patch: Partial<Node>, options?: CrudOptions): GraphDocument;
+export declare function removeNode(doc: GraphDocument, nodeId: string, options?: CrudOptions): GraphDocument;
+export declare function getEdge(doc: GraphDocument, edgeId: string): Edge | undefined;
+export declare function addEdge(doc: GraphDocument, edge: Edge, options?: CrudOptions): GraphDocument;
+export declare function updateEdge(doc: GraphDocument, edgeId: string, patch: Partial<Edge>, options?: CrudOptions): GraphDocument;
+export declare function removeEdge(doc: GraphDocument, edgeId: string, options?: CrudOptions): GraphDocument;
+export declare function getType(doc: GraphDocument, typeId: string): TypeDefinition | undefined;
+export declare function addType(doc: GraphDocument, typeDef: TypeDefinition, options?: CrudOptions): GraphDocument;
+export declare function updateType(doc: GraphDocument, typeId: string, patch: Partial<TypeDefinition>, options?: CrudOptions): GraphDocument;
+export declare function removeType(doc: GraphDocument, typeId: string, options?: CrudOptions): GraphDocument;
+export declare function getSubgraph(doc: GraphDocument, subgraphId: string): SubgraphDefinition | undefined;
+export declare function addSubgraph(doc: GraphDocument, subgraph: SubgraphDefinition, options?: CrudOptions): GraphDocument;
+export declare function updateSubgraph(doc: GraphDocument, subgraphId: string, patch: Partial<SubgraphDefinition>, options?: CrudOptions): GraphDocument;
+export declare function removeSubgraph(doc: GraphDocument, subgraphId: string, options?: CrudOptions): GraphDocument;
+//# sourceMappingURL=crud.d.ts.map

package/dist/crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../src/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,IAAI,EACJ,IAAI,EACJ,cAAc,EACd,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgBD,wBAAgB,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5E;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAQf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CASf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAef;AAID,wBAAgB,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5E;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAQf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CASf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CASf;AAID,wBAAgB,OAAO,CACrB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,GAAG,SAAS,CAE5B;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAQf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,EAC9B,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAef;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAWf;AAID,wBAAgB,WAAW,CACzB,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,GACjB,kBAAkB,GAAG,SAAS,CAEhC;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAQf;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,EAClC,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAef;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAWf"}

package/dist/crud.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNode = getNode;
+exports.addNode = addNode;
+exports.updateNode = updateNode;
+exports.removeNode = removeNode;
+exports.getEdge = getEdge;
+exports.addEdge = addEdge;
+exports.updateEdge = updateEdge;
+exports.removeEdge = removeEdge;
+exports.getType = getType;
+exports.addType = addType;
+exports.updateType = updateType;
+exports.removeType = removeType;
+exports.getSubgraph = getSubgraph;
+exports.addSubgraph = addSubgraph;
+exports.updateSubgraph = updateSubgraph;
+exports.removeSubgraph = removeSubgraph;
+function cloneIfNeeded(value, mutate) {
+    if (mutate)
+        return value;
+    return structuredClone(value);
+}
+function ensureGraph(doc) {
+    if (!doc.graph) {
+        throw new Error("GraphDocument.graph is missing");
+    }
+    return doc.graph;
+}
+// NODES
+function getNode(doc, nodeId) {
+    return ensureGraph(doc).nodes.find((n) => n.id === nodeId);
+}
+function addNode(doc, node, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    if (graph.nodes.some((n) => n.id === node.id)) {
+        throw new Error(`Node with id '${node.id}' already exists`);
+    }
+    graph.nodes.push(node);
+    return next;
+}
+function updateNode(doc, nodeId, patch, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    const idx = graph.nodes.findIndex((n) => n.id === nodeId);
+    if (idx === -1) {
+        throw new Error(`Node with id '${nodeId}' not found`);
+    }
+    graph.nodes[idx] = { ...graph.nodes[idx], ...patch, id: graph.nodes[idx].id };
+    return next;
+}
+function removeNode(doc, nodeId, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    const before = graph.nodes.length;
+    graph.nodes = graph.nodes.filter((n) => n.id !== nodeId);
+    if (graph.nodes.length === before) {
+        throw new Error(`Node with id '${nodeId}' not found`);
+    }
+    // Also remove edges and graph IO that reference this node
+    graph.edges = graph.edges.filter((e) => e.from.nodeId !== nodeId && e.to.nodeId !== nodeId);
+    graph.inputs = graph.inputs.filter((i) => i.target.nodeId !== nodeId);
+    graph.outputs = graph.outputs.filter((o) => o.source.nodeId !== nodeId);
+    return next;
+}
+// EDGES
+function getEdge(doc, edgeId) {
+    return ensureGraph(doc).edges.find((e) => e.id === edgeId);
+}
+function addEdge(doc, edge, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    if (graph.edges.some((e) => e.id === edge.id)) {
+        throw new Error(`Edge with id '${edge.id}' already exists`);
+    }
+    graph.edges.push(edge);
+    return next;
+}
+function updateEdge(doc, edgeId, patch, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    const idx = graph.edges.findIndex((e) => e.id === edgeId);
+    if (idx === -1) {
+        throw new Error(`Edge with id '${edgeId}' not found`);
+    }
+    graph.edges[idx] = { ...graph.edges[idx], ...patch, id: graph.edges[idx].id };
+    return next;
+}
+function removeEdge(doc, edgeId, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    const before = graph.edges.length;
+    graph.edges = graph.edges.filter((e) => e.id !== edgeId);
+    if (graph.edges.length === before) {
+        throw new Error(`Edge with id '${edgeId}' not found`);
+    }
+    return next;
+}
+// TYPES
+function getType(doc, typeId) {
+    return (doc.types ?? []).find((t) => t.id === typeId);
+}
+function addType(doc, typeDef, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.types)
+        next.types = [];
+    if (next.types.some((t) => t.id === typeDef.id)) {
+        throw new Error(`Type with id '${typeDef.id}' already exists`);
+    }
+    next.types.push(typeDef);
+    return next;
+}
+function updateType(doc, typeId, patch, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.types) {
+        throw new Error("No types are defined on this document");
+    }
+    const idx = next.types.findIndex((t) => t.id === typeId);
+    if (idx === -1) {
+        throw new Error(`Type with id '${typeId}' not found`);
+    }
+    next.types[idx] = {
+        ...next.types[idx],
+        ...patch,
+        id: next.types[idx].id
+    };
+    return next;
+}
+function removeType(doc, typeId, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.types) {
+        throw new Error("No types are defined on this document");
+    }
+    const before = next.types.length;
+    next.types = next.types.filter((t) => t.id !== typeId);
+    if (next.types.length === before) {
+        throw new Error(`Type with id '${typeId}' not found`);
+    }
+    return next;
+}
+// SUBGRAPHS
+function getSubgraph(doc, subgraphId) {
+    return (doc.subgraphs ?? []).find((s) => s.id === subgraphId);
+}
+function addSubgraph(doc, subgraph, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.subgraphs)
+        next.subgraphs = [];
+    if (next.subgraphs.some((s) => s.id === subgraph.id)) {
+        throw new Error(`Subgraph with id '${subgraph.id}' already exists`);
+    }
+    next.subgraphs.push(subgraph);
+    return next;
+}
+function updateSubgraph(doc, subgraphId, patch, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.subgraphs) {
+        throw new Error("No subgraphs are defined on this document");
+    }
+    const idx = next.subgraphs.findIndex((s) => s.id === subgraphId);
+    if (idx === -1) {
+        throw new Error(`Subgraph with id '${subgraphId}' not found`);
+    }
+    next.subgraphs[idx] = {
+        ...next.subgraphs[idx],
+        ...patch,
+        id: next.subgraphs[idx].id
+    };
+    return next;
+}
+function removeSubgraph(doc, subgraphId, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.subgraphs) {
+        throw new Error("No subgraphs are defined on this document");
+    }
+    const before = next.subgraphs.length;
+    next.subgraphs = next.subgraphs.filter((s) => s.id !== subgraphId);
+    if (next.subgraphs.length === before) {
+        throw new Error(`Subgraph with id '${subgraphId}' not found`);
+    }
+    return next;
+}
+//# sourceMappingURL=crud.js.map

package/dist/crud.js.map

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

package/dist/examples/minimal-graph.d.ts

@@ -0,0 +1,3 @@
+import type { GraphDocument } from "../types";
+export declare const minimalGraph: GraphDocument;
+//# sourceMappingURL=minimal-graph.d.ts.map

package/dist/examples/minimal-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal-graph.d.ts","sourceRoot":"","sources":["../../src/examples/minimal-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,eAAO,MAAM,YAAY,EAAE,aAkG1B,CAAC"}

package/dist/examples/minimal-graph.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minimalGraph = void 0;
+exports.minimalGraph = {
+    formatVersion: "1.0.0",
+    id: "graph:auth/user-signup",
+    name: "User Signup",
+    graph: {
+        nodes: [
+            {
+                id: "node:validate-input",
+                kind: "builtin:validate",
+                inputs: [
+                    {
+                        id: "in:payload",
+                        direction: "input",
+                        type: "builtin:object",
+                        required: true
+                    }
+                ],
+                outputs: [
+                    {
+                        id: "out:validated",
+                        direction: "output",
+                        type: "builtin:object"
+                    }
+                ],
+                parameters: {
+                    schemaType: "type:User"
+                }
+            },
+            {
+                id: "node:create-user",
+                kind: "task:http-request",
+                inputs: [
+                    {
+                        id: "in:validated",
+                        direction: "input",
+                        type: "type:User",
+                        required: true
+                    }
+                ],
+                outputs: [
+                    {
+                        id: "out:user",
+                        direction: "output",
+                        type: "type:User"
+                    }
+                ],
+                parameters: {
+                    method: "POST",
+                    url: "https://example.com/users"
+                }
+            }
+        ],
+        edges: [
+            {
+                id: "edge:validate-to-create",
+                from: {
+                    nodeId: "node:validate-input",
+                    portId: "out:validated"
+                },
+                to: {
+                    nodeId: "node:create-user",
+                    portId: "in:validated"
+                }
+            }
+        ],
+        inputs: [
+            {
+                id: "graph-input:request",
+                name: "Request Body",
+                type: "builtin:object",
+                target: {
+                    nodeId: "node:validate-input",
+                    portId: "in:payload"
+                }
+            }
+        ],
+        outputs: [
+            {
+                id: "graph-output:user",
+                name: "Created User",
+                type: "type:User",
+                source: {
+                    nodeId: "node:create-user",
+                    portId: "out:user"
+                }
+            }
+        ]
+    },
+    types: [
+        {
+            id: "type:User",
+            kind: "object",
+            fields: [
+                { name: "id", type: "builtin:string", required: true },
+                { name: "email", type: "builtin:string", required: true }
+            ]
+        }
+    ]
+};
+//# sourceMappingURL=minimal-graph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"minimal-graph.js","sourceRoot":"","sources":["../../src/examples/minimal-graph.ts"],"names":[],"mappings":";;;AAEa,QAAA,YAAY,GAAkB;IACzC,aAAa,EAAE,OAAO;IACtB,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE;QACL,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,qBAAqB;gBACzB,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,YAAY;wBAChB,SAAS,EAAE,OAAO;wBAClB,IAAI,EAAE,gBAAgB;wBACtB,QAAQ,EAAE,IAAI;qBACf;iBACF;gBACD,OAAO,EAAE;oBACP;wBACE,EAAE,EAAE,eAAe;wBACnB,SAAS,EAAE,QAAQ;wBACnB,IAAI,EAAE,gBAAgB;qBACvB;iBACF;gBACD,UAAU,EAAE;oBACV,UAAU,EAAE,WAAW;iBACxB;aACF;YACD;gBACE,EAAE,EAAE,kBAAkB;gBACtB,IAAI,EAAE,mBAAmB;gBACzB,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,cAAc;wBAClB,SAAS,EAAE,OAAO;wBAClB,IAAI,EAAE,WAAW;wBACjB,QAAQ,EAAE,IAAI;qBACf;iBACF;gBACD,OAAO,EAAE;oBACP;wBACE,EAAE,EAAE,UAAU;wBACd,SAAS,EAAE,QAAQ;wBACnB,IAAI,EAAE,WAAW;qBAClB;iBACF;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,MAAM;oBACd,GAAG,EAAE,2BAA2B;iBACjC;aACF;SACF;QACD,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,yBAAyB;gBAC7B,IAAI,EAAE;oBACJ,MAAM,EAAE,qBAAqB;oBAC7B,MAAM,EAAE,eAAe;iBACxB;gBACD,EAAE,EAAE;oBACF,MAAM,EAAE,kBAAkB;oBAC1B,MAAM,EAAE,cAAc;iBACvB;aACF;SACF;QACD,MAAM,EAAE;YACN;gBACE,EAAE,EAAE,qBAAqB;gBACzB,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE;oBACN,MAAM,EAAE,qBAAqB;oBAC7B,MAAM,EAAE,YAAY;iBACrB;aACF;SACF;QACD,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,mBAAmB;gBACvB,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE;oBACN,MAAM,EAAE,kBAAkB;oBAC1B,MAAM,EAAE,UAAU;iBACnB;aACF;SACF;KACF;IACD,KAAK,EAAE;QACL;YACE,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACtD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC1D;SACF;KACF;CACF,CAAC"}

package/dist/examples/validate-minimal.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-minimal.d.ts.map

package/dist/examples/validate-minimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-minimal.d.ts","sourceRoot":"","sources":["../../src/examples/validate-minimal.ts"],"names":[],"mappings":""}

package/dist/examples/validate-minimal.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const validate_1 = require("../validate");
+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 1.0.0");
+}
+//# 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":";;AAAA,0CAA4C;AAC5C,mDAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,wBAAa,EAAC,4BAAY,CAAC,CAAC;AAE3C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;AAC5E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./validate";
+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,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"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("./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,yCAAuB"}

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+export interface PortDefinition {
+    id: string;
+    name?: string;
+    direction: "input" | "output";
+    type: string;
+    required?: boolean;
+    default?: any | null;
+}
+export interface EdgeEndpoint {
+    nodeId: string;
+    portId: string;
+}
+export interface Edge {
+    id: string;
+    from: EdgeEndpoint;
+    to: EdgeEndpoint;
+    metadata?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+export interface Node {
+    id: string;
+    name?: string;
+    kind: string;
+    inputs?: PortDefinition[];
+    outputs?: PortDefinition[];
+    parameters?: Record<string, any>;
+    metadata?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+export interface GraphInput {
+    id: string;
+    name?: string;
+    type: string;
+    target: EdgeEndpoint;
+    metadata?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+export interface GraphOutput {
+    id: string;
+    name?: string;
+    type: string;
+    source: EdgeEndpoint;
+    metadata?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+export interface Graph {
+    nodes: Node[];
+    edges: Edge[];
+    inputs: GraphInput[];
+    outputs: GraphOutput[];
+    metadata?: Record<string, unknown>;
+}
+export interface TypeField {
+    name: string;
+    type: string;
+    required?: boolean;
+}
+export interface TypeBase {
+    id: string;
+    kind: "object" | "union" | "alias";
+    description?: string;
+    metadata?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+export interface TypeObject extends TypeBase {
+    kind: "object";
+    fields: TypeField[];
+}
+export interface TypeUnion extends TypeBase {
+    kind: "union";
+    options: string[];
+}
+export interface TypeAlias extends TypeBase {
+    kind: "alias";
+    target: string;
+}
+export type TypeDefinition = TypeObject | TypeUnion | TypeAlias;
+export interface SubgraphDefinition {
+    id: string;
+    name?: string;
+    graph: Graph;
+    metadata?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+export interface GraphDocument {
+    formatVersion: string;
+    id: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    graph: Graph;
+    types?: TypeDefinition[];
+    subgraphs?: SubgraphDefinition[];
+    extensions?: Record<string, unknown>;
+}
+//# 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,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validate.d.ts

@@ -0,0 +1,12 @@
+export interface ValidationError {
+    message: string;
+    path: string;
+    keyword: string;
+    params: Record<string, unknown>;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+export declare function validateGraph(document: unknown): ValidationResult;
+//# 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":"AAIA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAkBD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAQjE"}

package/dist/validate.js

@@ -0,0 +1,30 @@
+"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;
+const ajv_1 = __importDefault(require("ajv"));
+const graphenix_format_1_0_0_schema_json_1 = __importDefault(require("../schema/graphenix-format-1.0.0.schema.json"));
+const ajv = new ajv_1.default({
+    allErrors: true,
+    strict: false
+});
+const validateFn = ajv.compile(graphenix_format_1_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 ?? {})
+    };
+}
+function validateGraph(document) {
+    const valid = validateFn(document);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validateFn.errors ?? []).map(normalizeError);
+    return { valid: false, errors };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":";;;;;AAgCA,sCAQC;AAxCD,8CAA4C;AAC5C,sHAAkE;AAelE,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,4CAAa,CAAC,CAAC;AAE7D,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;KACxD,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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "graphenix-format",
+  "version": "1.2.0",
+  "description": "Graphenix graph description format: JSON schema, validation, and CRUD helpers.",
+  "license": "MIT",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "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"
+  ],
+  "keywords": [
+    "graph",
+    "workflow",
+    "json-schema",
+    "validation",
+    "graphenix"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://example.com/graphenix-format.git"
+  },
+  "bugs": {
+    "url": "https://example.com/graphenix-format/issues"
+  },
+  "homepage": "https://example.com/graphenix-format#readme",
+  "dependencies": {
+    "ajv": "^8.17.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.6.3"
+  }
+}
+

package/schema/graphenix-format-1.0.0.schema.json

@@ -0,0 +1,438 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://graphenix.dev/schema/graphenix-format-1.0.0.json",
+  "title": "Graphenix Format 1.0.0",
+  "description": "JSON Schema for the Graphenix graph description format (version 1.0.0). Execution semantics are out of scope.",
+  "type": "object",
+  "required": ["formatVersion", "id", "graph"],
+  "additionalProperties": false,
+  "properties": {
+    "formatVersion": {
+      "type": "string",
+      "description": "Semantic version of the graphenix-format used by this document (e.g. 1.0.0)."
+    },
+    "id": {
+      "type": "string",
+      "description": "Globally unique identifier for this graph within the system."
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable name for the graph."
+    },
+    "description": {
+      "type": "string",
+      "description": "Free-form description of the graph."
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Tags for classification, search, and filtering."
+    },
+    "graph": {
+      "$ref": "#/$defs/Graph"
+    },
+    "types": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/TypeDefinition"
+      },
+      "description": "Custom logical types referenced by nodes and ports."
+    },
+    "subgraphs": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/SubgraphDefinition"
+      },
+      "description": "Inlined reusable graphs."
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Namespaced extension object. Engines that do not recognize an extension namespace must ignore it.",
+      "additionalProperties": true
+    }
+  },
+  "$defs": {
+    "Graph": {
+      "type": "object",
+      "required": ["nodes", "edges", "inputs", "outputs"],
+      "additionalProperties": false,
+      "properties": {
+        "nodes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Node"
+          }
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Edge"
+          }
+        },
+        "inputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/GraphInput"
+          }
+        },
+        "outputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/GraphOutput"
+          }
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Arbitrary metadata not affecting execution semantics.",
+          "additionalProperties": true
+        }
+      }
+    },
+    "Node": {
+      "type": "object",
+      "required": ["id", "kind"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier within the containing graph."
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable name for UIs and logs."
+        },
+        "kind": {
+          "type": "string",
+          "description": "Logical type of node determining how the executor interprets it (e.g. builtin:map, task:http-request, subgraph:graph:user-validation)."
+        },
+        "inputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/PortDefinition"
+          },
+          "default": []
+        },
+        "outputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/PortDefinition"
+          },
+          "default": []
+        },
+        "parameters": {
+          "type": "object",
+          "description": "Static configuration for the node. Interpretation is executor-specific based on kind.",
+          "additionalProperties": true,
+          "default": {}
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Arbitrary metadata not affecting execution semantics (e.g. UI position).",
+          "additionalProperties": true
+        },
+        "extensions": {
+          "type": "object",
+          "description": "Namespaced extension data.",
+          "additionalProperties": true
+        }
+      }
+    },
+    "PortDefinition": {
+      "type": "object",
+      "required": ["id", "direction", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier within the node."
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable label."
+        },
+        "direction": {
+          "type": "string",
+          "enum": ["input", "output"],
+          "description": "Direction of data flow."
+        },
+        "type": {
+          "type": "string",
+          "description": "Type identifier (built-in type or custom type id)."
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Indicates if a value must be present for the node to execute.",
+          "default": false
+        },
+        "default": {
+          "description": "Default value when no incoming edge provides one. Must be compatible with the declared type.",
+          "type": ["string", "number", "boolean", "array", "object", "null"]
+        }
+      }
+    },
+    "EdgeEndpoint": {
+      "type": "object",
+      "required": ["nodeId", "portId"],
+      "additionalProperties": false,
+      "properties": {
+        "nodeId": {
+          "type": "string",
+          "description": "ID of the node."
+        },
+        "portId": {
+          "type": "string",
+          "description": "ID of the port on the referenced node."
+        }
+      }
+    },
+    "Edge": {
+      "type": "object",
+      "required": ["id", "from", "to"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier within the graph."
+        },
+        "from": {
+          "$ref": "#/$defs/EdgeEndpoint",
+          "description": "Source of the edge; must reference an existing node/output port."
+        },
+        "to": {
+          "$ref": "#/$defs/EdgeEndpoint",
+          "description": "Target of the edge; must reference an existing node/input port."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Metadata not affecting execution (e.g. edge label in UI).",
+          "additionalProperties": true
+        },
+        "extensions": {
+          "type": "object",
+          "description": "Namespaced extension data.",
+          "additionalProperties": true
+        }
+      }
+    },
+    "GraphInput": {
+      "type": "object",
+      "required": ["id", "type", "target"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier within the graph."
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable name."
+        },
+        "type": {
+          "type": "string",
+          "description": "Logical type identifier for the external input."
+        },
+        "target": {
+          "$ref": "#/$defs/EdgeEndpoint",
+          "description": "Node and input port that consume this graph input."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Metadata not affecting execution.",
+          "additionalProperties": true
+        },
+        "extensions": {
+          "type": "object",
+          "description": "Namespaced extension data.",
+          "additionalProperties": true
+        }
+      }
+    },
+    "GraphOutput": {
+      "type": "object",
+      "required": ["id", "type", "source"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier within the graph."
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable name."
+        },
+        "type": {
+          "type": "string",
+          "description": "Logical type identifier for the external output."
+        },
+        "source": {
+          "$ref": "#/$defs/EdgeEndpoint",
+          "description": "Node and output port that provide this graph output."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Metadata not affecting execution.",
+          "additionalProperties": true
+        },
+        "extensions": {
+          "type": "object",
+          "description": "Namespaced extension data.",
+          "additionalProperties": true
+        }
+      }
+    },
+    "TypeField": {
+      "type": "object",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Field name."
+        },
+        "type": {
+          "type": "string",
+          "description": "Type identifier for the field (built-in or custom)."
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Whether this field must be present.",
+          "default": false
+        }
+      }
+    },
+    "TypeObject": {
+      "type": "object",
+      "required": ["id", "kind", "fields"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique type identifier (e.g. type:User)."
+        },
+        "kind": {
+          "const": "object"
+        },
+        "description": {
+          "type": "string"
+        },
+        "fields": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TypeField"
+          }
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "extensions": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "TypeUnion": {
+      "type": "object",
+      "required": ["id", "kind", "options"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique type identifier."
+        },
+        "kind": {
+          "const": "union"
+        },
+        "description": {
+          "type": "string"
+        },
+        "options": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of type IDs or built-in types."
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "extensions": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "TypeAlias": {
+      "type": "object",
+      "required": ["id", "kind", "target"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique type identifier."
+        },
+        "kind": {
+          "const": "alias"
+        },
+        "description": {
+          "type": "string"
+        },
+        "target": {
+          "type": "string",
+          "description": "Type ID (or built-in) this type refers to."
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "extensions": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "TypeDefinition": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/TypeObject"
+        },
+        {
+          "$ref": "#/$defs/TypeUnion"
+        },
+        {
+          "$ref": "#/$defs/TypeAlias"
+        }
+      ]
+    },
+    "SubgraphDefinition": {
+      "type": "object",
+      "required": ["id", "graph"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier for the subgraph within the document."
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable name for the subgraph."
+        },
+        "graph": {
+          "$ref": "#/$defs/Graph"
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "extensions": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    }
+  }
+}
+