@agents-uni/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * agents-uni-core — Universal protocol layer for agent organizations.
+ *
+ * Core mission: 提升生产力的同时，我们需要的是更优秀的生产关系。
+ * (While improving productivity, what we need is better production relationships.)
+ *
+ * @module agents-uni-core
+ */
+export * from './types/index.js';
+export { Universe, AgentRegistry, RelationshipGraph, StateMachine, PermissionMatrix, ResourcePool, EventBus, } from './core/index.js';
+export type { StateMachineInstance, TransitionRecord } from './core/index.js';
+export { PerformanceTracker, PromotionEngine, MemoryConsolidator, RelationshipEvolver, } from './evolution/index.js';
+export type { PromotionDecision, RelationshipChange } from './evolution/index.js';
+export { parseSpecFile, parseSpecString, validateSpec, compileUniverse } from './spec/index.js';
+export { generateSoul, generateAllSouls, deployToOpenClaw, registerAgentsInOpenClaw, checkWorkspaces, TaskDispatcher, FileWorkspaceIO, MemoryWorkspaceIO, registerUni, listUnis, getUni, unregisterUni, cleanupUni, updateUni, resetUni, } from './bridge/index.js';
+export type { SoulGeneratorOptions, RulerDefinition, DeployOptions, DeployResult, DispatchTask, AgentSubmission, DispatchResult, DispatcherOptions, WorkspaceIO, EvaluationCriterion, UniRegistryEntry, UniRegistry, } from './bridge/index.js';
+export { startDashboard, createDashboardRoutes, } from './dashboard/index.js';
+export type { DashboardConfig, DashboardExtension, PanelDefinition, } from './dashboard/index.js';
+export { validateUniverseSpec } from './schema/index.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;;;;;;;GAOG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG9E,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGlF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGhG,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,MAAM,EACN,aAAa,EACb,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * agents-uni-core — Universal protocol layer for agent organizations.
+ *
+ * Core mission: 提升生产力的同时，我们需要的是更优秀的生产关系。
+ * (While improving productivity, what we need is better production relationships.)
+ *
+ * @module agents-uni-core
+ */
+// Types (the "language" of agent organizations)
+export * from './types/index.js';
+// Core runtime engine
+export { Universe, AgentRegistry, RelationshipGraph, StateMachine, PermissionMatrix, ResourcePool, EventBus, } from './core/index.js';
+// Evolution engine
+export { PerformanceTracker, PromotionEngine, MemoryConsolidator, RelationshipEvolver, } from './evolution/index.js';
+// Spec processing
+export { parseSpecFile, parseSpecString, validateSpec, compileUniverse } from './spec/index.js';
+// OpenClaw bridge
+export { generateSoul, generateAllSouls, deployToOpenClaw, registerAgentsInOpenClaw, checkWorkspaces, TaskDispatcher, FileWorkspaceIO, MemoryWorkspaceIO, registerUni, listUnis, getUni, unregisterUni, cleanupUni, updateUni, resetUni, } from './bridge/index.js';
+// Dashboard
+export { startDashboard, createDashboardRoutes, } from './dashboard/index.js';
+// Schema
+export { validateUniverseSpec } from './schema/index.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;;;;;;;GAOG;AAEH,gDAAgD;AAChD,cAAc,kBAAkB,CAAC;AAEjC,sBAAsB;AACtB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAGzB,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEhG,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,MAAM,EACN,aAAa,EACb,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAgB3B,YAAY;AACZ,OAAO,EACL,cAAc,EACd,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAO9B,SAAS;AACT,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,13 @@
+import universeSchema from './universe.schema.json';
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    keyword: string;
+}
+export declare function validateUniverseSpec(data: unknown): ValidationResult;
+export { universeSchema };
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,cAAc,MAAM,wBAAwB,CAAuB;AAM1E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAcpE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,18 @@
+import Ajv from 'ajv';
+import universeSchema from './universe.schema.json' with { type: 'json' };
+const ajv = new Ajv({ allErrors: true, verbose: true, validateSchema: false });
+const validateUniverse = ajv.compile(universeSchema);
+export function validateUniverseSpec(data) {
+    const valid = validateUniverse(data);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validateUniverse.errors ?? []).map(err => ({
+        path: err.instancePath || '/',
+        message: err.message ?? 'Unknown validation error',
+        keyword: err.keyword,
+    }));
+    return { valid: false, errors };
+}
+export { universeSchema };
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,cAAc,MAAM,wBAAwB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE1E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;AAE/E,MAAM,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AAarD,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAErC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAsB,CAAC,gBAAgB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5E,IAAI,EAAE,GAAG,CAAC,YAAY,IAAI,GAAG;QAC7B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,0BAA0B;QAClD,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/schema/universe.schema.json

@@ -0,0 +1,214 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://agents-uni-core/universe.schema.json",
+    "title": "Universe Specification",
+    "description": "Schema for defining agent organization universes",
+    "type": "object",
+    "required": ["name", "version", "description", "type", "agents", "relationships", "protocols", "governance"],
+    "properties": {
+        "name": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$",
+            "description": "Universe name (kebab-case)"
+        },
+        "version": {
+            "type": "string",
+            "pattern": "^\\d+\\.\\d+\\.\\d+$"
+        },
+        "description": {
+            "type": "string"
+        },
+        "type": {
+            "type": "string",
+            "enum": ["hierarchical", "flat", "competitive", "hybrid"]
+        },
+        "agents": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/agent" }
+        },
+        "relationships": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/relationship" }
+        },
+        "protocols": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/protocol" }
+        },
+        "governance": { "$ref": "#/$defs/governance" },
+        "resources": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/resource" }
+        },
+        "evolution": { "$ref": "#/$defs/evolution" },
+        "metadata": {
+            "type": "object"
+        }
+    },
+    "$defs": {
+        "agent": {
+            "type": "object",
+            "required": ["id", "name", "role"],
+            "properties": {
+                "id": { "type": "string", "pattern": "^[a-z0-9_-]+$" },
+                "name": { "type": "string" },
+                "role": {
+                    "type": "object",
+                    "required": ["title", "duties", "permissions"],
+                    "properties": {
+                        "title": { "type": "string" },
+                        "department": { "type": "string" },
+                        "duties": { "type": "array", "items": { "type": "string" } },
+                        "permissions": { "type": "array", "items": { "type": "string" } },
+                        "soulTemplate": { "type": "string" }
+                    }
+                },
+                "rank": { "type": "number", "minimum": 0, "maximum": 100 },
+                "traits": {
+                    "type": "object",
+                    "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 }
+                },
+                "capabilities": { "type": "array", "items": { "type": "string" } },
+                "constraints": { "type": "array", "items": { "type": "string" } },
+                "metadata": { "type": "object" }
+            }
+        },
+        "relationship": {
+            "type": "object",
+            "required": ["from", "to", "type"],
+            "properties": {
+                "from": { "type": "string" },
+                "to": { "type": "string" },
+                "type": {
+                    "type": "string",
+                    "enum": ["superior", "subordinate", "peer", "competitive", "reviewer", "advisor", "ally", "rival", "mentor", "delegate"]
+                },
+                "weight": { "type": "number", "minimum": 0, "maximum": 1 },
+                "mutable": { "type": "boolean" },
+                "metadata": { "type": "object" }
+            }
+        },
+        "protocol": {
+            "type": "object",
+            "required": ["name", "description", "states", "transitions"],
+            "properties": {
+                "name": { "type": "string" },
+                "description": { "type": "string" },
+                "states": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "type": "object",
+                        "required": ["name", "label"],
+                        "properties": {
+                            "name": { "type": "string" },
+                            "label": { "type": "string" },
+                            "owner": { "type": "string" },
+                            "terminal": { "type": "boolean" },
+                            "timeout": { "type": "number" },
+                            "icon": { "type": "string" }
+                        }
+                    }
+                },
+                "transitions": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "required": ["from", "to"],
+                        "properties": {
+                            "from": { "type": "string" },
+                            "to": { "type": "string" },
+                            "guard": { "type": "string" },
+                            "action": { "type": "string" },
+                            "requiredRole": { "type": "string" },
+                            "label": { "type": "string" }
+                        }
+                    }
+                },
+                "roles": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "type": "array",
+                        "items": { "type": "string" }
+                    }
+                }
+            }
+        },
+        "governance": {
+            "type": "object",
+            "required": ["decisionModel", "permissionMatrix", "reviewPolicy"],
+            "properties": {
+                "decisionModel": {
+                    "type": "string",
+                    "enum": ["autocratic", "democratic", "consensus", "meritocratic"]
+                },
+                "permissionMatrix": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "required": ["actor", "target", "actions"],
+                        "properties": {
+                            "actor": { "type": "string" },
+                            "target": { "type": "string" },
+                            "actions": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string",
+                                    "enum": ["call", "assign", "review", "approve", "reject", "promote", "demote", "suspend", "eliminate", "allocate"]
+                                }
+                            }
+                        }
+                    }
+                },
+                "reviewPolicy": {
+                    "type": "object",
+                    "required": ["mandatory", "reviewers", "maxRounds"],
+                    "properties": {
+                        "mandatory": { "type": "boolean" },
+                        "reviewers": { "type": "array", "items": { "type": "string" } },
+                        "maxRounds": { "type": "number", "minimum": 1 },
+                        "autoApproveAfter": { "type": "number" }
+                    }
+                },
+                "escalationRules": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "required": ["trigger", "escalateTo", "action"],
+                        "properties": {
+                            "trigger": { "type": "string" },
+                            "escalateTo": { "type": "string" },
+                            "action": { "type": "string", "enum": ["notify", "reassign", "override", "cancel"] },
+                            "timeoutMs": { "type": "number" }
+                        }
+                    }
+                }
+            }
+        },
+        "resource": {
+            "type": "object",
+            "required": ["name", "type", "total", "distribution"],
+            "properties": {
+                "name": { "type": "string" },
+                "type": { "type": "string", "enum": ["finite", "renewable", "positional"] },
+                "total": { "type": "number", "minimum": 0 },
+                "distribution": { "type": "string", "enum": ["equal", "merit", "hierarchy", "competitive"] },
+                "refreshInterval": { "type": "number" },
+                "decayRate": { "type": "number", "minimum": 0, "maximum": 1 },
+                "description": { "type": "string" }
+            }
+        },
+        "evolution": {
+            "type": "object",
+            "required": ["performanceWindow", "promotionThreshold", "demotionThreshold", "memoryRetention"],
+            "properties": {
+                "performanceWindow": { "type": "number", "minimum": 1 },
+                "promotionThreshold": { "type": "number", "minimum": 0, "maximum": 100 },
+                "demotionThreshold": { "type": "number", "minimum": 0, "maximum": 100 },
+                "memoryRetention": { "type": "number", "minimum": 1 },
+                "evolutionInterval": { "type": "number" }
+            }
+        }
+    }
+}

package/dist/spec/compiler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Spec Compiler — transforms a parsed YAML spec into a live Universe.
+ */
+import type { UniverseConfig } from '../types/index.js';
+import { Universe } from '../core/universe.js';
+export interface CompileOptions {
+    /** Skip validation (for trusted specs) */
+    skipValidation?: boolean;
+    /** Auto-initialize the universe after compilation */
+    autoInit?: boolean;
+}
+/**
+ * Compile a UniverseConfig into a live Universe instance.
+ */
+export declare function compileUniverse(config: UniverseConfig, options?: CompileOptions): Promise<Universe>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/spec/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/spec/compiler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAmBnB"}

package/dist/spec/compiler.js

@@ -0,0 +1,26 @@
+/**
+ * Spec Compiler — transforms a parsed YAML spec into a live Universe.
+ */
+import { Universe } from '../core/universe.js';
+import { validateSpec } from './validator.js';
+/**
+ * Compile a UniverseConfig into a live Universe instance.
+ */
+export async function compileUniverse(config, options = {}) {
+    // Validate unless explicitly skipped
+    if (!options.skipValidation) {
+        const result = validateSpec(config);
+        if (!result.valid) {
+            const errorMsg = result.errors
+                .map(e => `  ${e.path}: ${e.message}`)
+                .join('\n');
+            throw new Error(`Universe spec validation failed:\n${errorMsg}`);
+        }
+    }
+    const universe = new Universe(config);
+    if (options.autoInit) {
+        await universe.initialize();
+    }
+    return universe;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/spec/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../src/spec/compiler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAS9C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAsB,EACtB,UAA0B,EAAE;IAE5B,qCAAqC;IACrC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM;iBAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBACrC,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEtC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/spec/index.d.ts

@@ -0,0 +1,4 @@
+export { parseSpecFile, parseSpecString } from './parser.js';
+export { validateSpec } from './validator.js';
+export { compileUniverse } from './compiler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spec/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/spec/index.js

@@ -0,0 +1,4 @@
+export { parseSpecFile, parseSpecString } from './parser.js';
+export { validateSpec } from './validator.js';
+export { compileUniverse } from './compiler.js';
+//# sourceMappingURL=index.js.map

package/dist/spec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spec/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/spec/parser.d.ts

@@ -0,0 +1,11 @@
+import type { UniverseConfig } from '../types/index.js';
+/**
+ * Parse a YAML universe spec file into a typed UniverseConfig object.
+ * Does NOT validate — call validator separately for schema checking.
+ */
+export declare function parseSpecFile(filePath: string): UniverseConfig;
+/**
+ * Parse a YAML string into a UniverseConfig.
+ */
+export declare function parseSpecString(yamlContent: string): UniverseConfig;
+//# sourceMappingURL=parser.d.ts.map

package/dist/spec/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/spec/parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAG9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAwBnE"}

package/dist/spec/parser.js

@@ -0,0 +1,89 @@
+import { parse as parseYaml } from 'yaml';
+import { readFileSync } from 'node:fs';
+/**
+ * Parse a YAML universe spec file into a typed UniverseConfig object.
+ * Does NOT validate — call validator separately for schema checking.
+ */
+export function parseSpecFile(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    return parseSpecString(content);
+}
+/**
+ * Parse a YAML string into a UniverseConfig.
+ */
+export function parseSpecString(yamlContent) {
+    const raw = parseYaml(yamlContent);
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('Invalid YAML: root must be an object');
+    }
+    // Normalize defaults
+    const config = {
+        name: raw.name,
+        version: raw.version ?? '0.1.0',
+        description: raw.description ?? '',
+        type: raw.type ?? 'hybrid',
+        ruler: raw.ruler ? normalizeRuler(raw.ruler) : undefined,
+        agents: normalizeAgents(raw.agents ?? []),
+        relationships: raw.relationships ?? [],
+        protocols: raw.protocols ?? [],
+        governance: normalizeGovernance(raw.governance ?? {}),
+        resources: raw.resources,
+        evolution: raw.evolution,
+        metadata: raw.metadata,
+    };
+    return config;
+}
+function normalizeRuler(raw) {
+    return {
+        title: raw.title,
+        description: raw.description,
+        permissions: raw.permissions ?? [],
+    };
+}
+function normalizeAgents(agents) {
+    return agents.map((raw) => {
+        const agent = raw;
+        return {
+            id: agent.id,
+            name: agent.name,
+            role: normalizeRole(agent.role),
+            rank: agent.rank,
+            traits: agent.traits,
+            capabilities: agent.capabilities,
+            constraints: agent.constraints,
+            metadata: agent.metadata,
+        };
+    });
+}
+function normalizeRole(role) {
+    if (!role) {
+        return { title: 'unknown', duties: [], permissions: [] };
+    }
+    return {
+        title: role.title ?? 'unknown',
+        department: role.department,
+        duties: role.duties ?? [],
+        permissions: role.permissions ?? [],
+        soulTemplate: role.soulTemplate,
+    };
+}
+function normalizeGovernance(gov) {
+    return {
+        decisionModel: gov.decisionModel ?? 'autocratic',
+        permissionMatrix: gov.permissionMatrix ?? [],
+        reviewPolicy: normalizeReviewPolicy(gov.reviewPolicy),
+        escalationRules: gov.escalationRules ?? [],
+    };
+}
+function normalizeReviewPolicy(policy) {
+    if (!policy) {
+        return { mandatory: false, reviewers: [], maxRounds: 1 };
+    }
+    return {
+        mandatory: policy.mandatory ?? false,
+        reviewers: policy.reviewers ?? [],
+        maxRounds: policy.maxRounds ?? 1,
+        autoApproveAfter: policy.autoApproveAfter,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/spec/parser.js.map

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

package/dist/spec/validator.d.ts

@@ -0,0 +1,9 @@
+import type { UniverseConfig } from '../types/index.js';
+import { type ValidationResult } from '../schema/index.js';
+/**
+ * Validate a universe spec at two levels:
+ * 1. JSON Schema validation (structure)
+ * 2. Semantic validation (references, consistency)
+ */
+export declare function validateSpec(config: UniverseConfig): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/spec/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/spec/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAwB,KAAK,gBAAgB,EAAwB,MAAM,oBAAoB,CAAC;AAEvG;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAcrE"}

package/dist/spec/validator.js

@@ -0,0 +1,105 @@
+import { validateUniverseSpec } from '../schema/index.js';
+/**
+ * Validate a universe spec at two levels:
+ * 1. JSON Schema validation (structure)
+ * 2. Semantic validation (references, consistency)
+ */
+export function validateSpec(config) {
+    // Level 1: JSON Schema
+    const schemaResult = validateUniverseSpec(config);
+    if (!schemaResult.valid) {
+        return schemaResult;
+    }
+    // Level 2: Semantic validation
+    const semanticErrors = validateSemantics(config);
+    if (semanticErrors.length > 0) {
+        return { valid: false, errors: semanticErrors };
+    }
+    return { valid: true, errors: [] };
+}
+function validateSemantics(config) {
+    const errors = [];
+    const agentIds = new Set(config.agents.map(a => a.id));
+    // Check relationship references
+    for (const rel of config.relationships) {
+        if (!agentIds.has(rel.from)) {
+            errors.push({
+                path: `/relationships`,
+                message: `Relationship references unknown agent: "${rel.from}"`,
+                keyword: 'reference',
+            });
+        }
+        if (!agentIds.has(rel.to)) {
+            errors.push({
+                path: `/relationships`,
+                message: `Relationship references unknown agent: "${rel.to}"`,
+                keyword: 'reference',
+            });
+        }
+    }
+    // Check protocol state references in transitions
+    for (const protocol of config.protocols) {
+        const stateNames = new Set(protocol.states.map(s => s.name));
+        for (const transition of protocol.transitions) {
+            if (!stateNames.has(transition.from)) {
+                errors.push({
+                    path: `/protocols/${protocol.name}/transitions`,
+                    message: `Transition references unknown state: "${transition.from}"`,
+                    keyword: 'reference',
+                });
+            }
+            if (!stateNames.has(transition.to)) {
+                errors.push({
+                    path: `/protocols/${protocol.name}/transitions`,
+                    message: `Transition references unknown state: "${transition.to}"`,
+                    keyword: 'reference',
+                });
+            }
+        }
+        // Check that terminal states have no outgoing transitions
+        const terminalStates = new Set(protocol.states.filter(s => s.terminal).map(s => s.name));
+        for (const transition of protocol.transitions) {
+            if (terminalStates.has(transition.from)) {
+                errors.push({
+                    path: `/protocols/${protocol.name}/transitions`,
+                    message: `Terminal state "${transition.from}" has outgoing transition`,
+                    keyword: 'terminal',
+                });
+            }
+        }
+    }
+    // Check permission matrix references
+    for (const entry of config.governance.permissionMatrix) {
+        const validActors = new Set([...agentIds, ...config.agents.map(a => a.role.title)]);
+        if (!validActors.has(entry.actor)) {
+            errors.push({
+                path: `/governance/permissionMatrix`,
+                message: `Permission entry references unknown actor: "${entry.actor}"`,
+                keyword: 'reference',
+            });
+        }
+        if (!validActors.has(entry.target)) {
+            errors.push({
+                path: `/governance/permissionMatrix`,
+                message: `Permission entry references unknown target: "${entry.target}"`,
+                keyword: 'reference',
+            });
+        }
+    }
+    // Check unique agent IDs
+    const idCounts = new Map();
+    for (const agent of config.agents) {
+        idCounts.set(agent.id, (idCounts.get(agent.id) ?? 0) + 1);
+    }
+    for (const [id, count] of idCounts) {
+        if (count > 1) {
+            errors.push({
+                path: `/agents`,
+                message: `Duplicate agent ID: "${id}" (found ${count} times)`,
+                keyword: 'uniqueness',
+            });
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validator.js.map

package/dist/spec/validator.js.map

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