@agents-uni/core 0.1.0

package/dist/bridge/workspace-io.js

@@ -0,0 +1,99 @@
+/**
+ * Workspace I/O — file-based communication protocol between dispatcher and agents.
+ *
+ * Design principle: agents communicate through files, not HTTP.
+ * This aligns with OpenClaw's file-driven model where each agent has a workspace
+ * directory. The dispatcher writes TASK.md, the agent reads it, executes, and
+ * writes SUBMISSION.md. Simple, debuggable, zero infrastructure.
+ *
+ * File protocol:
+ *   TASK.md       — written by dispatcher, read by agent
+ *   SUBMISSION.md — written by agent, read by dispatcher
+ */
+import { readFileSync, writeFileSync, unlinkSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ─── File Implementation ────────────────────────
+const TASK_FILENAME = 'TASK.md';
+const SUBMISSION_FILENAME = 'SUBMISSION.md';
+/**
+ * Default file-system implementation of WorkspaceIO.
+ *
+ * Reads and writes to ~/.openclaw/workspace-{agentId}/ by default.
+ */
+export class FileWorkspaceIO {
+    baseDir;
+    pattern;
+    constructor(options = {}) {
+        this.baseDir = options.openclawDir ?? join(process.env.HOME ?? process.env.USERPROFILE ?? '.', '.openclaw');
+        this.pattern = options.workspacePattern ?? 'workspace-{agentId}';
+    }
+    workspacePath(agentId) {
+        const dirName = this.pattern.replace('{agentId}', agentId);
+        return join(this.baseDir, dirName);
+    }
+    async writeTask(agentId, content) {
+        const dir = this.workspacePath(agentId);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, TASK_FILENAME), content, 'utf-8');
+    }
+    async readSubmission(agentId) {
+        const filePath = join(this.workspacePath(agentId), SUBMISSION_FILENAME);
+        if (!existsSync(filePath))
+            return null;
+        try {
+            return readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    async clearTask(agentId) {
+        const filePath = join(this.workspacePath(agentId), TASK_FILENAME);
+        if (existsSync(filePath)) {
+            try {
+                unlinkSync(filePath);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    async clearSubmission(agentId) {
+        const filePath = join(this.workspacePath(agentId), SUBMISSION_FILENAME);
+        if (existsSync(filePath)) {
+            try {
+                unlinkSync(filePath);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    async hasSubmission(agentId) {
+        return existsSync(join(this.workspacePath(agentId), SUBMISSION_FILENAME));
+    }
+}
+// ─── In-Memory Implementation (for testing) ─────
+/**
+ * In-memory WorkspaceIO for unit tests — no file system needed.
+ */
+export class MemoryWorkspaceIO {
+    tasks = new Map();
+    submissions = new Map();
+    async writeTask(agentId, content) {
+        this.tasks.set(agentId, content);
+    }
+    async readSubmission(agentId) {
+        return this.submissions.get(agentId) ?? null;
+    }
+    async clearTask(agentId) {
+        this.tasks.delete(agentId);
+    }
+    async clearSubmission(agentId) {
+        this.submissions.delete(agentId);
+    }
+    async hasSubmission(agentId) {
+        return this.submissions.has(agentId);
+    }
+    /** Test helper: simulate an agent submitting work */
+    simulateSubmission(agentId, output) {
+        this.submissions.set(agentId, output);
+    }
+}
+//# sourceMappingURL=workspace-io.js.map

package/dist/bridge/workspace-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-io.js","sourceRoot":"","sources":["../../src/bridge/workspace-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAwBjC,mDAAmD;AAEnD,MAAM,aAAa,GAAG,SAAS,CAAC;AAChC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAS5C;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,CAAS;IAChB,OAAO,CAAS;IAEjC,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CACxC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,EAClD,WAAW,CACZ,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,gBAAgB,IAAI,qBAAqB,CAAC;IACnE,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,OAAe;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACxC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACxE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;QAClE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACxE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF;AAED,mDAAmD;AAEnD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACnB,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClC,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEjD,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,OAAe;QAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,qDAAqD;IACrD,kBAAkB,CAAC,OAAe,EAAE,MAAc;QAChD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/cli/commands/deploy.d.ts

@@ -0,0 +1,6 @@
+export declare function deployCommand(file: string, opts: {
+    dryRun?: boolean;
+    dir?: string;
+    lang?: string;
+}): void;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/cli/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,IAAI,CAgDN"}

package/dist/cli/commands/deploy.js

@@ -0,0 +1,48 @@
+import chalk from 'chalk';
+import { resolve } from 'node:path';
+import { parseSpecFile } from '../../spec/parser.js';
+import { deployToOpenClaw } from '../../bridge/openclaw-adapter.js';
+export function deployCommand(file, opts) {
+    try {
+        const config = parseSpecFile(file);
+        console.log(chalk.blue(`Deploying ${config.name} to OpenClaw...`));
+        const result = deployToOpenClaw(config, {
+            dryRun: opts.dryRun,
+            openclawDir: opts.dir,
+            specPath: resolve(file),
+            soulOptions: {
+                language: opts.lang ?? 'zh',
+                includeRelationships: true,
+                includePermissions: true,
+            },
+        });
+        if (opts.dryRun) {
+            console.log(chalk.yellow('DRY RUN — no files written'));
+        }
+        console.log(chalk.green(`\n✓ Deployed ${result.agents.length} agents:`));
+        for (const agentId of result.agents) {
+            console.log(chalk.gray(`  - ${agentId}`));
+        }
+        console.log(chalk.green(`\n✓ Generated ${result.files.length} files:`));
+        for (const file of result.files) {
+            console.log(chalk.gray(`  ${file.path}`));
+        }
+        if (result.registered.length > 0) {
+            console.log(chalk.green(`\n✓ Registered ${result.registered.length} agents in openclaw.json:`));
+            for (const agentId of result.registered) {
+                console.log(chalk.gray(`  - ${agentId}`));
+            }
+        }
+        if (result.warnings.length > 0) {
+            console.log(chalk.yellow(`\n⚠ ${result.warnings.length} warning(s):`));
+            for (const w of result.warnings) {
+                console.log(chalk.yellow(`  - ${w}`));
+            }
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=deploy.js.map

package/dist/cli/commands/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,IAAuD;IAEvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAEnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC;QAEnE,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE;YACtC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,GAAG;YACrB,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC;YACvB,WAAW,EAAE;gBACX,QAAQ,EAAG,IAAI,CAAC,IAAoB,IAAI,IAAI;gBAC5C,oBAAoB,EAAE,IAAI;gBAC1B,kBAAkB,EAAE,IAAI;aACzB;SACF,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC;QACzE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,UAAU,CAAC,MAAM,2BAA2B,CAAC,CAAC,CAAC;YAChG,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC,CAAC;YACvE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(name?: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAeA,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiE9D"}

package/dist/cli/commands/init.js

@@ -0,0 +1,137 @@
+import chalk from 'chalk';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+const TEMPLATES = {
+    government: { label: '三省六部 (Hierarchical governance)', file: 'government.yaml' },
+    corporation: { label: '现代企业 (Corporate hierarchy)', file: 'corporation.yaml' },
+    competitive: { label: '竞技场 (Competitive arena)', file: 'competitive.yaml' },
+    flat: { label: '扁平团队 (Flat team)', file: 'flat.yaml' },
+    military: { label: '军事指挥 (Military command)', file: 'military.yaml' },
+};
+export async function initCommand(name) {
+    const projectName = name ?? 'my-universe';
+    console.log(chalk.bold(`\n  Creating universe: ${projectName}\n`));
+    // Show available templates
+    console.log(chalk.underline('  Available templates:'));
+    for (const [key, val] of Object.entries(TEMPLATES)) {
+        console.log(`    ${chalk.cyan(key.padEnd(15))} ${val.label}`);
+    }
+    console.log('');
+    // Default to competitive template
+    const templateKey = 'competitive';
+    console.log(chalk.gray(`  Using template: ${templateKey}`));
+    // Create project directory
+    const projectDir = join(process.cwd(), projectName);
+    mkdirSync(projectDir, { recursive: true });
+    // Copy template
+    try {
+        const templateDir = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'templates');
+        const templatePath = join(templateDir, TEMPLATES[templateKey].file);
+        const templateContent = readFileSync(templatePath, 'utf-8');
+        // Replace name in template
+        const customized = templateContent.replace(/^name: ".*"$/m, `name: "${projectName}"`);
+        writeFileSync(join(projectDir, 'universe.yaml'), customized);
+    }
+    catch {
+        // Fallback: generate minimal template
+        const minimal = generateMinimalTemplate(projectName);
+        writeFileSync(join(projectDir, 'universe.yaml'), minimal);
+    }
+    // Create package.json
+    const packageJson = {
+        name: projectName,
+        version: '0.1.0',
+        description: `Agent universe: ${projectName}`,
+        type: 'module',
+        scripts: {
+            validate: 'uni validate universe.yaml',
+            visualize: 'uni visualize universe.yaml',
+            deploy: 'uni deploy universe.yaml',
+        },
+        dependencies: {
+            'agents-uni-core': '^0.1.0',
+        },
+    };
+    writeFileSync(join(projectDir, 'package.json'), JSON.stringify(packageJson, null, 2));
+    // Create README
+    const readme = `# ${projectName}\n\nAn agent universe built with [agents-uni-core](https://github.com/agents-uni-core).\n\n## Commands\n\n\`\`\`bash\nnpm run validate   # Validate universe spec\nnpm run visualize  # Visualize relationships\nnpm run deploy     # Deploy to OpenClaw\n\`\`\`\n`;
+    writeFileSync(join(projectDir, 'README.md'), readme);
+    console.log(chalk.green(`\n✓ Created universe project at ./${projectName}`));
+    console.log(chalk.gray('  Files:'));
+    console.log(chalk.gray('    universe.yaml   — Universe specification'));
+    console.log(chalk.gray('    package.json    — Project config'));
+    console.log(chalk.gray('    README.md       — Documentation'));
+    console.log(chalk.blue(`\n  Next steps:`));
+    console.log(chalk.white(`    cd ${projectName}`));
+    console.log(chalk.white(`    npm install`));
+    console.log(chalk.white(`    uni validate universe.yaml`));
+}
+function generateMinimalTemplate(name) {
+    return `name: "${name}"
+version: "0.1.0"
+description: "A custom agent universe"
+type: hybrid
+
+agents:
+  - id: leader
+    name: Leader
+    role:
+      title: Team Lead
+      duties:
+        - Coordinate team activities
+        - Review outputs
+      permissions: [call, assign, review]
+    rank: 80
+
+  - id: worker-1
+    name: Worker 1
+    role:
+      title: Worker
+      duties:
+        - Execute assigned tasks
+      permissions: [submit_work]
+    rank: 40
+
+  - id: worker-2
+    name: Worker 2
+    role:
+      title: Worker
+      duties:
+        - Execute assigned tasks
+      permissions: [submit_work]
+    rank: 40
+
+relationships:
+  - { from: leader, to: worker-1, type: superior }
+  - { from: leader, to: worker-2, type: superior }
+  - { from: worker-1, to: worker-2, type: peer }
+
+protocols:
+  - name: task-flow
+    description: "Basic task execution flow"
+    states:
+      - { name: Open, label: Open }
+      - { name: InProgress, label: In Progress }
+      - { name: Done, label: Done, terminal: true }
+    transitions:
+      - { from: Open, to: InProgress, requiredRole: leader }
+      - { from: InProgress, to: Done }
+    roles:
+      leader: [Open]
+
+governance:
+  decisionModel: autocratic
+  permissionMatrix:
+    - { actor: leader, target: worker-1, actions: [call, assign] }
+    - { actor: leader, target: worker-2, actions: [call, assign] }
+  reviewPolicy:
+    mandatory: false
+    reviewers: [leader]
+    maxRounds: 1
+  escalationRules: []
+`;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

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

package/dist/cli/commands/inspect.d.ts

@@ -0,0 +1,4 @@
+export declare function inspectCommand(file: string, opts: {
+    agent?: string;
+}): void;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/cli/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/inspect.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8E3E"}

package/dist/cli/commands/inspect.js

@@ -0,0 +1,77 @@
+import chalk from 'chalk';
+import { parseSpecFile } from '../../spec/parser.js';
+export function inspectCommand(file, opts) {
+    try {
+        const config = parseSpecFile(file);
+        if (opts.agent) {
+            // Inspect specific agent
+            const agent = config.agents.find(a => a.id === opts.agent);
+            if (!agent) {
+                console.error(chalk.red(`Agent "${opts.agent}" not found`));
+                console.log(chalk.gray('Available agents: ' + config.agents.map(a => a.id).join(', ')));
+                process.exit(1);
+            }
+            console.log(chalk.bold(`\n  Agent: ${agent.name} (${agent.id})`));
+            console.log(chalk.gray(`  Role: ${agent.role.title}`));
+            if (agent.role.department)
+                console.log(chalk.gray(`  Department: ${agent.role.department}`));
+            if (agent.rank !== undefined)
+                console.log(chalk.gray(`  Rank: ${agent.rank}`));
+            console.log(chalk.underline('\n  Duties:'));
+            for (const duty of agent.role.duties) {
+                console.log(`    - ${duty}`);
+            }
+            console.log(chalk.underline('\n  Permissions:'));
+            for (const perm of agent.role.permissions) {
+                console.log(`    - ${chalk.green(perm)}`);
+            }
+            if (agent.traits) {
+                console.log(chalk.underline('\n  Traits:'));
+                for (const [trait, value] of Object.entries(agent.traits)) {
+                    const bar = '█'.repeat(Math.round(value * 10)) + '░'.repeat(10 - Math.round(value * 10));
+                    console.log(`    ${trait}: ${bar} ${(value * 100).toFixed(0)}%`);
+                }
+            }
+            // Show relationships
+            const rels = config.relationships.filter(r => r.from === agent.id || r.to === agent.id);
+            if (rels.length > 0) {
+                console.log(chalk.underline('\n  Relationships:'));
+                for (const rel of rels) {
+                    const direction = rel.from === agent.id ? '→' : '←';
+                    const other = rel.from === agent.id ? rel.to : rel.from;
+                    console.log(`    ${direction} ${chalk.cyan(other)}: ${rel.type}`);
+                }
+            }
+            // Show permission matrix entries
+            const perms = config.governance.permissionMatrix.filter(p => p.actor === agent.id || p.target === agent.id);
+            if (perms.length > 0) {
+                console.log(chalk.underline('\n  Permission Matrix:'));
+                for (const perm of perms) {
+                    const direction = perm.actor === agent.id ? 'can' : 'receives';
+                    const other = perm.actor === agent.id ? perm.target : perm.actor;
+                    console.log(`    ${direction} ${perm.actions.join(', ')} ${perm.actor === agent.id ? '→' : '←'} ${chalk.cyan(other)}`);
+                }
+            }
+        }
+        else {
+            // Overview
+            console.log(chalk.bold(`\n  Universe: ${config.name} v${config.version}`));
+            console.log(chalk.gray(`  ${config.description}`));
+            console.log(`  Type: ${config.type}`);
+            console.log(`  Agents: ${config.agents.length}`);
+            console.log(`  Relationships: ${config.relationships.length}`);
+            console.log(`  Protocols: ${config.protocols.length}`);
+            console.log(`  Resources: ${config.resources?.length ?? 0}`);
+            console.log(`  Governance: ${config.governance.decisionModel}`);
+            console.log('');
+            console.log(chalk.gray('  Use --agent <id> to inspect a specific agent'));
+            console.log(chalk.gray('  Agents: ' + config.agents.map(a => a.id).join(', ')));
+        }
+        console.log('');
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=inspect.js.map

package/dist/cli/commands/inspect.js.map

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

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,2 @@
+export declare function validateCommand(file: string): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAyBlD"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,30 @@
+import chalk from 'chalk';
+import { parseSpecFile } from '../../spec/parser.js';
+import { validateSpec } from '../../spec/validator.js';
+export function validateCommand(file) {
+    try {
+        console.log(chalk.blue(`Validating ${file}...`));
+        const config = parseSpecFile(file);
+        const result = validateSpec(config);
+        if (result.valid) {
+            console.log(chalk.green('✓ Valid universe spec'));
+            console.log(chalk.gray(`  Name: ${config.name}`));
+            console.log(chalk.gray(`  Type: ${config.type}`));
+            console.log(chalk.gray(`  Agents: ${config.agents.length}`));
+            console.log(chalk.gray(`  Relationships: ${config.relationships.length}`));
+            console.log(chalk.gray(`  Protocols: ${config.protocols.length}`));
+        }
+        else {
+            console.log(chalk.red(`✗ Invalid spec — ${result.errors.length} error(s):`));
+            for (const err of result.errors) {
+                console.log(chalk.red(`  ${err.path}: ${err.message} [${err.keyword}]`));
+            }
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC;YAC7E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/commands/visualize.d.ts

@@ -0,0 +1,2 @@
+export declare function visualizeCommand(file: string): void;
+//# sourceMappingURL=visualize.d.ts.map

package/dist/cli/commands/visualize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualize.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/visualize.ts"],"names":[],"mappings":"AAgBA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA2DnD"}

package/dist/cli/commands/visualize.js

@@ -0,0 +1,69 @@
+import chalk from 'chalk';
+import { parseSpecFile } from '../../spec/parser.js';
+const TYPE_SYMBOLS = {
+    superior: '──▶',
+    subordinate: '◀──',
+    peer: '◆───◆',
+    competitive: '⚔',
+    reviewer: '🔍▶',
+    advisor: '💡▶',
+    ally: '🤝',
+    rival: '⚡',
+    mentor: '📚▶',
+    delegate: '📋▶',
+};
+export function visualizeCommand(file) {
+    try {
+        const config = parseSpecFile(file);
+        console.log(chalk.bold(`\n  Universe: ${config.name} (${config.type})`));
+        console.log(chalk.gray(`  ${config.description}`));
+        console.log('');
+        // Agents section
+        console.log(chalk.bold.underline('  Agents'));
+        const sortedAgents = [...config.agents].sort((a, b) => (b.rank ?? 0) - (a.rank ?? 0));
+        for (const agent of sortedAgents) {
+            const rankBar = agent.rank !== undefined
+                ? chalk.yellow('█'.repeat(Math.round(agent.rank / 10)))
+                : '';
+            console.log(`    ${chalk.cyan(agent.id.padEnd(20))} ${chalk.white(agent.name)} (${agent.role.title}) ${rankBar}`);
+        }
+        console.log('');
+        // Relationships section
+        console.log(chalk.bold.underline('  Relationships'));
+        for (const rel of config.relationships) {
+            const symbol = TYPE_SYMBOLS[rel.type] ?? '──';
+            const weight = rel.weight !== undefined ? chalk.gray(` [${rel.weight}]`) : '';
+            console.log(`    ${chalk.cyan(rel.from)} ${symbol} ${chalk.cyan(rel.to)} ${chalk.gray(rel.type)}${weight}`);
+        }
+        console.log('');
+        // Protocols section
+        console.log(chalk.bold.underline('  Protocols'));
+        for (const proto of config.protocols) {
+            console.log(`    ${chalk.magenta(proto.name)}: ${proto.description}`);
+            const stateFlow = proto.states
+                .map(s => s.terminal ? chalk.red(s.label) : chalk.green(s.label))
+                .join(' → ');
+            console.log(`      ${stateFlow}`);
+        }
+        console.log('');
+        // Resources section
+        if (config.resources && config.resources.length > 0) {
+            console.log(chalk.bold.underline('  Resources'));
+            for (const res of config.resources) {
+                console.log(`    ${chalk.yellow(res.name)}: ${res.type} (total: ${res.total}, dist: ${res.distribution})`);
+            }
+            console.log('');
+        }
+        // Governance summary
+        console.log(chalk.bold.underline('  Governance'));
+        console.log(`    Model: ${config.governance.decisionModel}`);
+        console.log(`    Review: ${config.governance.reviewPolicy.mandatory ? 'mandatory' : 'optional'}`);
+        console.log(`    Permissions: ${config.governance.permissionMatrix.length} entries`);
+        console.log('');
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=visualize.js.map

package/dist/cli/commands/visualize.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * uni CLI — command-line tools for managing agent universes.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG"}