@openexpertise/schema 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenExpertise
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { parseExperienceYaml } from './parser.js';
+export { validateExperienceSpec, ValidationError } from './validator.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,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { parseExperienceYaml } from './parser.js';
+export { validateExperienceSpec, ValidationError } from './validator.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,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/parser.d.ts

@@ -0,0 +1,8 @@
+import type { ExperienceSpec } from './types.js';
+export declare class ParseError extends Error {
+    readonly line?: number | undefined;
+    readonly column?: number | undefined;
+    constructor(message: string, line?: number | undefined, column?: number | undefined);
+}
+export declare function parseExperienceYaml(source: string): ExperienceSpec;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,CAAC,EAAE,MAAM;aACb,MAAM,CAAC,EAAE,MAAM;gBAF/B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,MAAM,CAAC,EAAE,MAAM,YAAA;CAKlC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAgBlE"}

package/dist/parser.js

@@ -0,0 +1,25 @@
+import { parseDocument } from 'yaml';
+export class ParseError extends Error {
+    line;
+    column;
+    constructor(message, line, column) {
+        super(message);
+        this.line = line;
+        this.column = column;
+        this.name = 'ParseError';
+    }
+}
+export function parseExperienceYaml(source) {
+    const doc = parseDocument(source, { prettyErrors: true });
+    if (doc.errors.length > 0) {
+        const first = doc.errors[0];
+        const pos = first.linePos?.[0];
+        throw new ParseError(`YAML parse error at line ${pos?.line ?? '?'}, column ${pos?.col ?? '?'}: ${first.message}`, pos?.line, pos?.col);
+    }
+    const parsed = doc.toJS();
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new ParseError('experience.yaml must be a YAML mapping at the top level');
+    }
+    return parsed;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAa,MAAM,MAAM,CAAA;AAG/C,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IAHlB,YACE,OAAe,EACC,IAAa,EACb,MAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,SAAI,GAAJ,IAAI,CAAS;QACb,WAAM,GAAN,MAAM,CAAS;QAG/B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAc,CAAA;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,IAAI,UAAU,CAClB,4BAA4B,GAAG,EAAE,IAAI,IAAI,GAAG,YAAY,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,EAC3F,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,GAAG,CACT,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACzB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,UAAU,CAAC,yDAAyD,CAAC,CAAA;IACjF,CAAC;IACD,OAAO,MAAwB,CAAA;AACjC,CAAC"}

package/dist/schemas/experience.schema.json

@@ -0,0 +1,260 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openexpertise.dev/schemas/experience-v0.1.0.json",
+  "title": "ExperienceSpec",
+  "_comment": "TODO Plan 2: tighten node oneOf variants with additionalProperties: false so typos like 'impl_path' don't pass validation and fail later at runtime.",
+  "type": "object",
+  "required": ["name", "version", "state", "graph"],
+  "additionalProperties": false,
+  "properties": {
+    "name": { "type": "string", "minLength": 1 },
+    "description": { "type": "string" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+    "state": {
+      "type": "object",
+      "required": ["schema"],
+      "additionalProperties": false,
+      "properties": {
+        "schema": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/stateField" }
+        },
+        "store": { "type": "string" }
+      }
+    },
+    "phases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string" },
+          "title": { "type": "string" }
+        }
+      }
+    },
+    "graph": {
+      "type": "object",
+      "required": ["nodes", "edges"],
+      "additionalProperties": false,
+      "properties": {
+        "nodes": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/node" }
+        },
+        "edges": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/edge" }
+        },
+        "pipelines": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "items", "stages"],
+            "additionalProperties": false,
+            "properties": {
+              "id": { "type": "string" },
+              "items": { "type": "string" },
+              "stages": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+              "phase": { "type": "string" }
+            }
+          }
+        },
+        "loops": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "body"],
+            "additionalProperties": false,
+            "properties": {
+              "id": { "type": "string" },
+              "body": { "type": "string" },
+              "until": { "type": "string" },
+              "max_iters": { "type": "integer", "minimum": 1 },
+              "budget": { "type": "integer", "minimum": 0 },
+              "phase": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "concurrency": { "type": "integer", "minimum": 1 }
+      }
+    }
+  },
+  "$defs": {
+    "stateField": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["string", "number", "boolean", "object", "array", "null"]
+        },
+        "description": { "type": "string" },
+        "merge": { "enum": ["array_append", "set_once", "last_wins"] }
+      }
+    },
+    "edge": {
+      "type": "object",
+      "required": ["from", "to"],
+      "additionalProperties": false,
+      "properties": {
+        "from": { "type": "string" },
+        "to": { "type": "string" },
+        "when": { "type": "string" }
+      }
+    },
+    "errorPolicy": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["policy"],
+          "properties": { "policy": { "const": "skip" } },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["policy"],
+          "properties": { "policy": { "const": "fail_run" } },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["policy", "attempts"],
+          "properties": {
+            "policy": { "const": "retry" },
+            "attempts": { "type": "integer", "minimum": 1, "maximum": 20 },
+            "backoff": { "enum": ["linear", "exponential"] },
+            "base_ms": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "nodeBase": {
+      "type": "object",
+      "required": ["id", "kind"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*$" },
+        "phase": { "type": "string" },
+        "reads": { "type": "array", "items": { "type": "string" } },
+        "writes": { "type": "array", "items": { "type": "string" } },
+        "on_error": { "$ref": "#/$defs/errorPolicy" },
+        "for_each": {
+          "type": "object",
+          "required": ["source"],
+          "properties": {
+            "source": { "type": "string" },
+            "concurrency": { "type": "integer", "minimum": 1 }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    "node": {
+      "oneOf": [
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["impl"],
+              "properties": {
+                "kind": { "const": "tool" },
+                "impl": { "type": "string" },
+                "args": { "type": "object" }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["prompt"],
+              "properties": {
+                "kind": { "const": "agent" },
+                "prompt": { "type": "string" },
+                "model": { "type": "string" },
+                "schema": {},
+                "args": { "type": "object" }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["impl"],
+              "properties": {
+                "kind": { "const": "skill" },
+                "impl": { "type": "string" },
+                "inputs": { "type": "object" },
+                "model": { "type": "string" },
+                "schema": {}
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["source"],
+              "properties": {
+                "kind": { "const": "dataset" },
+                "source": { "type": "object" }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["impl"],
+              "properties": {
+                "kind": { "const": "experience" },
+                "impl": { "type": "string" },
+                "args": { "type": "object" },
+                "state_scope": { "enum": ["shared", "isolated"] }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["provider", "prompt"],
+              "properties": {
+                "kind": { "const": "cli-agent" },
+                "provider": { "enum": ["claude-code", "codex", "gemini"] },
+                "prompt": { "type": "string", "minLength": 1 },
+                "model": { "type": "string" },
+                "workdir": { "type": "string" },
+                "output_format": { "enum": ["text", "json"] },
+                "schema": {},
+                "timeout_ms": { "type": "integer", "minimum": 1000 },
+                "extra_args": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          ]
+        }
+      ]
+    }
+  }
+}

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+export type NodeKind = 'agent' | 'skill' | 'tool' | 'dataset' | 'experience' | 'cli-agent';
+export type MergeStrategy = 'array_append' | 'set_once' | 'last_wins';
+export interface ForEachClause {
+    source: string;
+    concurrency?: number;
+}
+export interface PipelineGroupSpec {
+    id: string;
+    items: string;
+    stages: string[];
+    phase?: string;
+}
+export interface LoopSpec {
+    id: string;
+    body: string;
+    until?: string;
+    max_iters?: number;
+    budget?: number;
+    phase?: string;
+}
+export type StateFieldSchema = {
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null';
+    description?: string;
+    items?: StateFieldSchema | {
+        $ref: string;
+    };
+    properties?: Record<string, StateFieldSchema>;
+    required?: string[];
+    merge?: MergeStrategy;
+} | {
+    $ref: string;
+};
+export interface StateSpec {
+    schema: Record<string, StateFieldSchema>;
+    store?: string;
+}
+export interface PhaseSpec {
+    id: string;
+    title?: string;
+}
+export interface ToolNodeSpec {
+    id: string;
+    kind: 'tool';
+    phase?: string;
+    impl: string;
+    args?: Record<string, unknown>;
+    reads?: string[];
+    writes?: string[];
+    on_error?: ErrorPolicy;
+    for_each?: ForEachClause;
+}
+export interface AgentNodeSpec {
+    id: string;
+    kind: 'agent';
+    phase?: string;
+    prompt: string;
+    model?: string;
+    schema?: string | Record<string, unknown>;
+    reads?: string[];
+    writes?: string[];
+    args?: Record<string, unknown>;
+    on_error?: ErrorPolicy;
+    for_each?: ForEachClause;
+}
+export interface SkillNodeSpec {
+    id: string;
+    kind: 'skill';
+    phase?: string;
+    impl: string;
+    inputs?: Record<string, unknown>;
+    model?: string;
+    schema?: string | Record<string, unknown>;
+    reads?: string[];
+    writes?: string[];
+    on_error?: ErrorPolicy;
+    for_each?: ForEachClause;
+}
+export interface DatasetNodeSpec {
+    id: string;
+    kind: 'dataset';
+    phase?: string;
+    source: DatasetSource;
+    reads?: string[];
+    writes?: string[];
+    on_error?: ErrorPolicy;
+    for_each?: ForEachClause;
+}
+export interface ExperienceNodeSpec {
+    id: string;
+    kind: 'experience';
+    phase?: string;
+    impl: string;
+    args?: Record<string, unknown>;
+    state_scope?: 'shared' | 'isolated';
+    reads?: string[];
+    writes?: string[];
+    on_error?: ErrorPolicy;
+    for_each?: ForEachClause;
+}
+export interface CliAgentNodeSpec {
+    id: string;
+    kind: 'cli-agent';
+    phase?: string;
+    provider: 'claude-code' | 'codex' | 'gemini';
+    prompt: string;
+    model?: string;
+    workdir?: string;
+    output_format?: 'text' | 'json';
+    schema?: Record<string, unknown>;
+    timeout_ms?: number;
+    extra_args?: string[];
+    reads?: string[];
+    writes?: string[];
+    on_error?: ErrorPolicy;
+    for_each?: ForEachClause;
+}
+export type DatasetSource = {
+    type: 'file';
+    uri: string;
+    format?: 'json' | 'jsonl' | 'csv' | 'parquet';
+    transform?: string;
+} | {
+    type: 'sqlite';
+    uri: string;
+    query: string;
+} | {
+    type: 'http';
+    url: string;
+    method?: 'GET' | 'POST';
+    body?: unknown;
+} | {
+    type: 'mcp-resource';
+    server: string;
+    uri: string;
+};
+export type NodeSpec = ToolNodeSpec | AgentNodeSpec | SkillNodeSpec | DatasetNodeSpec | ExperienceNodeSpec | CliAgentNodeSpec;
+export type ErrorPolicy = {
+    policy: 'skip';
+} | {
+    policy: 'fail_run';
+} | {
+    policy: 'retry';
+    attempts: number;
+    backoff?: 'linear' | 'exponential';
+    base_ms?: number;
+};
+export interface EdgeSpec {
+    from: string;
+    to: string;
+    when?: string;
+}
+export interface GraphSpec {
+    nodes: NodeSpec[];
+    edges: EdgeSpec[];
+    pipelines?: PipelineGroupSpec[];
+    loops?: LoopSpec[];
+}
+export interface RuntimeSpec {
+    concurrency?: number;
+}
+export interface ExperienceSpec {
+    name: string;
+    description?: string;
+    version: string;
+    state: StateSpec;
+    phases?: PhaseSpec[];
+    graph: GraphSpec;
+    runtime?: RuntimeSpec;
+}
+//# 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":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAA;AAE1F,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAA;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAKD,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,gBAAgB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAA;CACzB;AAID,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAA;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAA;CACzB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAChG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzD,MAAM,MAAM,QAAQ,GAChB,YAAY,GACZ,aAAa,GACb,aAAa,GACb,eAAe,GACf,kBAAkB,GAClB,gBAAgB,CAAA;AAEpB,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC/B,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;IACpB,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// TypeScript types for the experience.yaml format v0.1.0.
+// These are hand-authored to match `src/schemas/experience.schema.json`.
+// Keep the two in sync — see tests/parser.test.ts for the consistency check.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,yEAAyE;AACzE,6EAA6E"}

package/dist/validator.d.ts

@@ -0,0 +1,7 @@
+import type { ExperienceSpec } from './types.js';
+export declare class ValidationError extends Error {
+    readonly errors: string[];
+    constructor(message: string, errors?: string[]);
+}
+export declare function validateExperienceSpec(spec: unknown): asserts spec is ExperienceSpec;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAUhD,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,MAAM,EAAE,MAAM,EAAE;gBADhC,OAAO,EAAE,MAAM,EACC,MAAM,GAAE,MAAM,EAAO;CAKxC;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,cAAc,CAqDpF"}

package/dist/validator.js

@@ -0,0 +1,60 @@
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const schemaPath = resolve(__dirname, 'schemas/experience.schema.json');
+const schema = JSON.parse(readFileSync(schemaPath, 'utf8'));
+const ajv = new Ajv({ allErrors: true, strict: false });
+addFormats(ajv);
+const validateJsonSchema = ajv.compile(schema);
+export class ValidationError extends Error {
+    errors;
+    constructor(message, errors = []) {
+        super(message);
+        this.errors = errors;
+        this.name = 'ValidationError';
+    }
+}
+export function validateExperienceSpec(spec) {
+    if (!validateJsonSchema(spec)) {
+        const messages = (validateJsonSchema.errors ?? []).map((e) => `${e.instancePath || '(root)'}: ${e.message ?? 'invalid'}`);
+        throw new ValidationError(`Schema validation failed:\n${messages.join('\n')}`, messages);
+    }
+    // Beyond JSON Schema: referential integrity checks
+    const s = spec;
+    const nodeIds = new Set(s.graph.nodes.map((n) => n.id));
+    // Duplicate node ids first — every subsequent check assumes a structurally
+    // valid graph where the Set didn't silently dedupe collisions.
+    if (nodeIds.size !== s.graph.nodes.length) {
+        throw new ValidationError('Duplicate node ids in graph.nodes');
+    }
+    const definedNodeList = [...nodeIds].join(', ');
+    for (const edge of s.graph.edges) {
+        if (!nodeIds.has(edge.from)) {
+            throw new ValidationError(`Edge \`${edge.from} → ${edge.to}\` references node \`${edge.from}\` which doesn't exist. ` +
+                `Add it to \`graph.nodes:\` or fix the typo. ` +
+                `Defined nodes: ${definedNodeList || '(none)'}`);
+        }
+        if (!nodeIds.has(edge.to)) {
+            throw new ValidationError(`Edge \`${edge.from} → ${edge.to}\` references node \`${edge.to}\` which doesn't exist. ` +
+                `Add it to \`graph.nodes:\` or fix the typo. ` +
+                `Defined nodes: ${definedNodeList || '(none)'}`);
+        }
+    }
+    const declaredFields = new Set(Object.keys(s.state.schema));
+    for (const node of s.graph.nodes) {
+        for (const field of node.writes ?? []) {
+            if (!declaredFields.has(field)) {
+                throw new ValidationError(`Node "${node.id}" writes undeclared state field "${field}". Declare it in state.schema.`);
+            }
+        }
+        for (const field of node.reads ?? []) {
+            if (!declaredFields.has(field)) {
+                throw new ValidationError(`Node "${node.id}" reads undeclared state field "${field}". Declare it in state.schema.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@openexpertise/schema",
+  "version": "0.1.0",
+  "description": "TypeScript types + JSON Schema + parser/validator for the OpenExpertise experience.yaml format.",
+  "keywords": [
+    "openexpertise",
+    "workflow",
+    "dag",
+    "llm",
+    "yaml",
+    "schema",
+    "json-schema",
+    "validation"
+  ],
+  "author": "OpenExpertise contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xingchengxu/OpenExpertise.git",
+    "directory": "packages/schema"
+  },
+  "bugs": {
+    "url": "https://github.com/xingchengxu/OpenExpertise/issues"
+  },
+  "homepage": "https://github.com/xingchengxu/OpenExpertise#readme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./schema": "./src/schemas/experience.schema.json"
+  },
+  "files": [
+    "dist",
+    "src/schemas",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.0",
+    "yaml": "^2.5.0"
+  },
+  "scripts": {
+    "build": "tsc -b && node -e \"require('node:fs').cpSync('src/schemas','dist/schemas',{recursive:true})\"",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/schemas/experience.schema.json

@@ -0,0 +1,260 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openexpertise.dev/schemas/experience-v0.1.0.json",
+  "title": "ExperienceSpec",
+  "_comment": "TODO Plan 2: tighten node oneOf variants with additionalProperties: false so typos like 'impl_path' don't pass validation and fail later at runtime.",
+  "type": "object",
+  "required": ["name", "version", "state", "graph"],
+  "additionalProperties": false,
+  "properties": {
+    "name": { "type": "string", "minLength": 1 },
+    "description": { "type": "string" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+    "state": {
+      "type": "object",
+      "required": ["schema"],
+      "additionalProperties": false,
+      "properties": {
+        "schema": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/stateField" }
+        },
+        "store": { "type": "string" }
+      }
+    },
+    "phases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string" },
+          "title": { "type": "string" }
+        }
+      }
+    },
+    "graph": {
+      "type": "object",
+      "required": ["nodes", "edges"],
+      "additionalProperties": false,
+      "properties": {
+        "nodes": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/node" }
+        },
+        "edges": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/edge" }
+        },
+        "pipelines": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "items", "stages"],
+            "additionalProperties": false,
+            "properties": {
+              "id": { "type": "string" },
+              "items": { "type": "string" },
+              "stages": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+              "phase": { "type": "string" }
+            }
+          }
+        },
+        "loops": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "body"],
+            "additionalProperties": false,
+            "properties": {
+              "id": { "type": "string" },
+              "body": { "type": "string" },
+              "until": { "type": "string" },
+              "max_iters": { "type": "integer", "minimum": 1 },
+              "budget": { "type": "integer", "minimum": 0 },
+              "phase": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "concurrency": { "type": "integer", "minimum": 1 }
+      }
+    }
+  },
+  "$defs": {
+    "stateField": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["string", "number", "boolean", "object", "array", "null"]
+        },
+        "description": { "type": "string" },
+        "merge": { "enum": ["array_append", "set_once", "last_wins"] }
+      }
+    },
+    "edge": {
+      "type": "object",
+      "required": ["from", "to"],
+      "additionalProperties": false,
+      "properties": {
+        "from": { "type": "string" },
+        "to": { "type": "string" },
+        "when": { "type": "string" }
+      }
+    },
+    "errorPolicy": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["policy"],
+          "properties": { "policy": { "const": "skip" } },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["policy"],
+          "properties": { "policy": { "const": "fail_run" } },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["policy", "attempts"],
+          "properties": {
+            "policy": { "const": "retry" },
+            "attempts": { "type": "integer", "minimum": 1, "maximum": 20 },
+            "backoff": { "enum": ["linear", "exponential"] },
+            "base_ms": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "nodeBase": {
+      "type": "object",
+      "required": ["id", "kind"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*$" },
+        "phase": { "type": "string" },
+        "reads": { "type": "array", "items": { "type": "string" } },
+        "writes": { "type": "array", "items": { "type": "string" } },
+        "on_error": { "$ref": "#/$defs/errorPolicy" },
+        "for_each": {
+          "type": "object",
+          "required": ["source"],
+          "properties": {
+            "source": { "type": "string" },
+            "concurrency": { "type": "integer", "minimum": 1 }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    "node": {
+      "oneOf": [
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["impl"],
+              "properties": {
+                "kind": { "const": "tool" },
+                "impl": { "type": "string" },
+                "args": { "type": "object" }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["prompt"],
+              "properties": {
+                "kind": { "const": "agent" },
+                "prompt": { "type": "string" },
+                "model": { "type": "string" },
+                "schema": {},
+                "args": { "type": "object" }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["impl"],
+              "properties": {
+                "kind": { "const": "skill" },
+                "impl": { "type": "string" },
+                "inputs": { "type": "object" },
+                "model": { "type": "string" },
+                "schema": {}
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["source"],
+              "properties": {
+                "kind": { "const": "dataset" },
+                "source": { "type": "object" }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["impl"],
+              "properties": {
+                "kind": { "const": "experience" },
+                "impl": { "type": "string" },
+                "args": { "type": "object" },
+                "state_scope": { "enum": ["shared", "isolated"] }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/nodeBase" },
+            {
+              "type": "object",
+              "required": ["provider", "prompt"],
+              "properties": {
+                "kind": { "const": "cli-agent" },
+                "provider": { "enum": ["claude-code", "codex", "gemini"] },
+                "prompt": { "type": "string", "minLength": 1 },
+                "model": { "type": "string" },
+                "workdir": { "type": "string" },
+                "output_format": { "enum": ["text", "json"] },
+                "schema": {},
+                "timeout_ms": { "type": "integer", "minimum": 1000 },
+                "extra_args": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          ]
+        }
+      ]
+    }
+  }
+}