@agents-uni/core 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * uni CLI — command-line tools for managing agent universes.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { validateCommand } from './commands/validate.js';
+import { visualizeCommand } from './commands/visualize.js';
+import { deployCommand } from './commands/deploy.js';
+import { initCommand } from './commands/init.js';
+import { inspectCommand } from './commands/inspect.js';
+import { listUnis, getUni, cleanupUni, resetUni } from '../bridge/uni-registry.js';
+import { startDashboard } from '../dashboard/server.js';
+const program = new Command();
+program
+    .name('uni')
+    .description('Agent Universe management CLI — define, validate, visualize, and deploy agent organizations')
+    .version('0.1.0');
+program
+    .command('validate <file>')
+    .description('Validate a universe YAML spec against the schema')
+    .action(validateCommand);
+program
+    .command('visualize <file>')
+    .description('Render an ASCII relationship graph of the universe')
+    .action(visualizeCommand);
+program
+    .command('deploy <file>')
+    .description('Deploy universe spec to OpenClaw workspaces (generate SOUL.md files)')
+    .option('--dry-run', 'Show what would be generated without writing files')
+    .option('--dir <path>', 'OpenClaw base directory')
+    .option('--lang <lang>', 'SOUL.md language (zh|en)', 'zh')
+    .action(deployCommand);
+program
+    .command('init [name]')
+    .description('Initialize a new universe project interactively')
+    .action(initCommand);
+program
+    .command('inspect <file>')
+    .description('Inspect a universe spec')
+    .option('--agent <id>', 'Show details for a specific agent')
+    .action(inspectCommand);
+// ─── Dashboard ────────────────────────────────────
+program
+    .command('dashboard')
+    .description('Start the Uni Dashboard web UI')
+    .option('-p, --port <port>', 'Server port', '8089')
+    .option('--dir <path>', 'OpenClaw base directory')
+    .action(async (opts) => {
+    await startDashboard({
+        port: parseInt(opts.port, 10),
+        openclawDir: opts.dir,
+    });
+});
+// ─── Multi-Uni Management ─────────────────────────
+program
+    .command('list')
+    .description('List all registered universes')
+    .option('--dir <path>', 'OpenClaw base directory')
+    .action((opts) => {
+    const unis = listUnis(opts.dir);
+    if (unis.length === 0) {
+        console.log(chalk.gray('No universes registered. Run `uni deploy <file>` to deploy one.'));
+        return;
+    }
+    console.log(chalk.bold('\n🌌 Registered Universes\n'));
+    console.log(chalk.gray('  ID                      Type           Agents  Version  Deployed'));
+    console.log(chalk.gray('  ' + '─'.repeat(75)));
+    for (const uni of unis) {
+        const id = uni.id.padEnd(24);
+        const type = uni.type.padEnd(14);
+        const agents = String(uni.agentIds.length).padEnd(8);
+        const version = ('v' + uni.version).padEnd(9);
+        const date = new Date(uni.deployedAt).toLocaleDateString();
+        console.log(`  ${chalk.cyan(id)} ${chalk.gray(type)} ${chalk.white(agents)} ${chalk.gray(version)} ${chalk.gray(date)}`);
+    }
+    console.log('');
+});
+program
+    .command('status')
+    .description('Show deployment overview')
+    .option('--dir <path>', 'OpenClaw base directory')
+    .action((opts) => {
+    const unis = listUnis(opts.dir);
+    const totalAgents = unis.reduce((s, u) => s + u.agentIds.length, 0);
+    const types = new Map();
+    for (const u of unis) {
+        types.set(u.type, (types.get(u.type) ?? 0) + 1);
+    }
+    console.log(chalk.bold('\n🌌 Uni Status\n'));
+    console.log(`  Universes: ${chalk.cyan(String(unis.length))}`);
+    console.log(`  Agents:    ${chalk.cyan(String(totalAgents))}`);
+    if (types.size > 0) {
+        console.log(`  Types:     ${[...types.entries()].map(([t, c]) => `${t}(${c})`).join(', ')}`);
+    }
+    console.log('');
+});
+program
+    .command('cleanup <id>')
+    .description('Remove a universe and all its workspaces/agent directories')
+    .option('--dir <path>', 'OpenClaw base directory')
+    .action((id, opts) => {
+    const uni = getUni(id, opts.dir);
+    if (!uni) {
+        console.error(chalk.red(`Universe "${id}" not found.`));
+        process.exit(1);
+    }
+    console.log(chalk.yellow(`Cleaning up "${id}" (${uni.agentIds.length} agents)...`));
+    const result = cleanupUni(id, opts.dir);
+    console.log(chalk.green(`\n✓ Cleanup complete:`));
+    console.log(chalk.gray(`  Removed ${result.removedWorkspaces.length} workspaces`));
+    console.log(chalk.gray(`  Removed ${result.removedAgentDirs.length} agent directories`));
+    console.log(chalk.gray(`  Removed ${result.removedFromConfig.length} agents from openclaw.json`));
+});
+program
+    .command('reset <id>')
+    .description('Reset a universe: clear sessions and runtime files, keep SOUL.md')
+    .option('--dir <path>', 'OpenClaw base directory')
+    .action((id, opts) => {
+    const uni = getUni(id, opts.dir);
+    if (!uni) {
+        console.error(chalk.red(`Universe "${id}" not found.`));
+        process.exit(1);
+    }
+    console.log(chalk.yellow(`Resetting "${id}"...`));
+    const result = resetUni(id, opts.dir);
+    console.log(chalk.green(`\n✓ Reset complete:`));
+    console.log(chalk.gray(`  Cleared sessions for ${result.clearedSessions.length} agents`));
+    console.log(chalk.gray(`  Cleared ${result.clearedTasks.length} runtime files`));
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/agent-registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Agent Registry — manages agent lifecycle within a Universe.
+ */
+import type { AgentDefinition, Citizen, CitizenStatus } from '../types/index.js';
+export declare class AgentRegistry {
+    private citizens;
+    constructor(agents: AgentDefinition[]);
+    /** Register a new agent as a citizen */
+    register(definition: AgentDefinition): Citizen;
+    /** Remove an agent from the registry */
+    unregister(agentId: string): boolean;
+    /** Get a citizen by ID */
+    get(agentId: string): Citizen | undefined;
+    /** Get a citizen or throw */
+    getOrThrow(agentId: string): Citizen;
+    /** Get all citizens */
+    getAll(): Citizen[];
+    /** Get agents filtered by status */
+    getByStatus(status: CitizenStatus): Citizen[];
+    /** Get agents filtered by role title */
+    getByRole(roleTitle: string): Citizen[];
+    /** Get agents filtered by department */
+    getByDepartment(department: string): Citizen[];
+    /** Get agents sorted by rank (descending) */
+    getByRank(): Citizen[];
+    /** Update citizen status */
+    setStatus(agentId: string, status: CitizenStatus): void;
+    /** Update performance score */
+    setPerformanceScore(agentId: string, score: number): void;
+    /** Update agent state */
+    setState(agentId: string, key: string, value: unknown): void;
+    /** Get all agent IDs */
+    getAllIds(): string[];
+    /** Count agents by status */
+    countByStatus(): Record<CitizenStatus, number>;
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/core/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/core/agent-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEjF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,MAAM,EAAE,eAAe,EAAE;IAOrC,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO;IAkB9C,wCAAwC;IACxC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC,0BAA0B;IAC1B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIzC,6BAA6B;IAC7B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMpC,uBAAuB;IACvB,MAAM,IAAI,OAAO,EAAE;IAInB,oCAAoC;IACpC,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,EAAE;IAI7C,wCAAwC;IACxC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAIvC,wCAAwC;IACxC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE;IAI9C,6CAA6C;IAC7C,SAAS,IAAI,OAAO,EAAE;IAItB,4BAA4B;IAC5B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;IAKvD,+BAA+B;IAC/B,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzD,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAK5D,wBAAwB;IACxB,SAAS,IAAI,MAAM,EAAE;IAIrB,6BAA6B;IAC7B,aAAa,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC;CAa/C"}

package/dist/core/agent-registry.js

@@ -0,0 +1,97 @@
+/**
+ * Agent Registry — manages agent lifecycle within a Universe.
+ */
+export class AgentRegistry {
+    citizens;
+    constructor(agents) {
+        this.citizens = new Map();
+        for (const agent of agents) {
+            this.register(agent);
+        }
+    }
+    /** Register a new agent as a citizen */
+    register(definition) {
+        if (this.citizens.has(definition.id)) {
+            throw new Error(`Agent "${definition.id}" is already registered`);
+        }
+        const citizen = {
+            definition,
+            status: 'idle',
+            performanceScore: 50,
+            resources: {},
+            joinedAt: new Date().toISOString(),
+            state: {},
+        };
+        this.citizens.set(definition.id, citizen);
+        return citizen;
+    }
+    /** Remove an agent from the registry */
+    unregister(agentId) {
+        return this.citizens.delete(agentId);
+    }
+    /** Get a citizen by ID */
+    get(agentId) {
+        return this.citizens.get(agentId);
+    }
+    /** Get a citizen or throw */
+    getOrThrow(agentId) {
+        const citizen = this.citizens.get(agentId);
+        if (!citizen)
+            throw new Error(`Agent "${agentId}" not found`);
+        return citizen;
+    }
+    /** Get all citizens */
+    getAll() {
+        return [...this.citizens.values()];
+    }
+    /** Get agents filtered by status */
+    getByStatus(status) {
+        return this.getAll().filter(c => c.status === status);
+    }
+    /** Get agents filtered by role title */
+    getByRole(roleTitle) {
+        return this.getAll().filter(c => c.definition.role.title === roleTitle);
+    }
+    /** Get agents filtered by department */
+    getByDepartment(department) {
+        return this.getAll().filter(c => c.definition.role.department === department);
+    }
+    /** Get agents sorted by rank (descending) */
+    getByRank() {
+        return this.getAll().sort((a, b) => (b.definition.rank ?? 0) - (a.definition.rank ?? 0));
+    }
+    /** Update citizen status */
+    setStatus(agentId, status) {
+        const citizen = this.getOrThrow(agentId);
+        citizen.status = status;
+    }
+    /** Update performance score */
+    setPerformanceScore(agentId, score) {
+        const citizen = this.getOrThrow(agentId);
+        citizen.performanceScore = Math.max(0, Math.min(100, score));
+    }
+    /** Update agent state */
+    setState(agentId, key, value) {
+        const citizen = this.getOrThrow(agentId);
+        citizen.state[key] = value;
+    }
+    /** Get all agent IDs */
+    getAllIds() {
+        return [...this.citizens.keys()];
+    }
+    /** Count agents by status */
+    countByStatus() {
+        const counts = {
+            active: 0,
+            idle: 0,
+            suspended: 0,
+            eliminated: 0,
+            probation: 0,
+        };
+        for (const citizen of this.citizens.values()) {
+            counts[citizen.status]++;
+        }
+        return counts;
+    }
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/core/agent-registry.js.map

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

package/dist/core/event-bus.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Event Bus — the nervous system of an organization.
+ *
+ * Every meaningful change emits an event. This enables audit trails,
+ * reactive evolution, and narrative generation.
+ */
+import type { OrganizationEvent, OrganizationEventType, EventHandler } from '../types/index.js';
+export declare class EventBus {
+    private subscriptions;
+    private eventLog;
+    private maxRetention;
+    constructor(maxRetention?: number);
+    /** Subscribe to events */
+    subscribe(types: OrganizationEventType[], handler: EventHandler): string;
+    /** Unsubscribe */
+    unsubscribe(subscriptionId: string): boolean;
+    /** Emit an event */
+    emit(event: Omit<OrganizationEvent, 'id' | 'timestamp'>): Promise<OrganizationEvent>;
+    /** Quick emit helper */
+    emitSimple(type: OrganizationEventType, actors: string[], narrative: string, data?: Record<string, unknown>): Promise<OrganizationEvent>;
+    /** Get event log */
+    getLog(limit?: number): OrganizationEvent[];
+    /** Get events by type */
+    getByType(type: OrganizationEventType, limit?: number): OrganizationEvent[];
+    /** Get events involving a specific agent */
+    getByAgent(agentId: string, limit?: number): OrganizationEvent[];
+    /** Get events in a time range */
+    getByTimeRange(start: string, end: string): OrganizationEvent[];
+    /** Clear all events */
+    clear(): void;
+    /** Get event count */
+    count(): number;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAQ3B,qBAAa,QAAQ;IACnB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,SAAO;IAM/B,0BAA0B;IAC1B,SAAS,CAAC,KAAK,EAAE,qBAAqB,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM;IAMxE,kBAAkB;IAClB,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAO5C,oBAAoB;IACd,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2B1F,wBAAwB;IAClB,UAAU,CACd,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,iBAAiB,CAAC;IAI7B,oBAAoB;IACpB,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAK3C,yBAAyB;IACzB,SAAS,CAAC,IAAI,EAAE,qBAAqB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAM3E,4CAA4C;IAC5C,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAMhE,iCAAiC;IACjC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAI/D,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAIb,sBAAsB;IACtB,KAAK,IAAI,MAAM;CAGhB"}

package/dist/core/event-bus.js

@@ -0,0 +1,96 @@
+/**
+ * Event Bus — the nervous system of an organization.
+ *
+ * Every meaningful change emits an event. This enables audit trails,
+ * reactive evolution, and narrative generation.
+ */
+let eventCounter = 0;
+function generateEventId() {
+    return `evt-${Date.now()}-${++eventCounter}`;
+}
+export class EventBus {
+    subscriptions;
+    eventLog;
+    maxRetention;
+    constructor(maxRetention = 1000) {
+        this.subscriptions = [];
+        this.eventLog = [];
+        this.maxRetention = maxRetention;
+    }
+    /** Subscribe to events */
+    subscribe(types, handler) {
+        const id = `sub-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        this.subscriptions.push({ types, handler, id });
+        return id;
+    }
+    /** Unsubscribe */
+    unsubscribe(subscriptionId) {
+        const idx = this.subscriptions.findIndex(s => s.id === subscriptionId);
+        if (idx === -1)
+            return false;
+        this.subscriptions.splice(idx, 1);
+        return true;
+    }
+    /** Emit an event */
+    async emit(event) {
+        const fullEvent = {
+            ...event,
+            id: generateEventId(),
+            timestamp: new Date().toISOString(),
+        };
+        // Store in log
+        this.eventLog.push(fullEvent);
+        if (this.eventLog.length > this.maxRetention) {
+            this.eventLog = this.eventLog.slice(-this.maxRetention);
+        }
+        // Notify subscribers
+        for (const sub of this.subscriptions) {
+            if (sub.types.length === 0 || sub.types.includes(fullEvent.type)) {
+                try {
+                    await sub.handler(fullEvent);
+                }
+                catch (err) {
+                    console.error(`Event handler error (sub: ${sub.id}):`, err);
+                }
+            }
+        }
+        return fullEvent;
+    }
+    /** Quick emit helper */
+    async emitSimple(type, actors, narrative, data = {}) {
+        return this.emit({ type, actors, narrative, data });
+    }
+    /** Get event log */
+    getLog(limit) {
+        if (limit)
+            return this.eventLog.slice(-limit);
+        return [...this.eventLog];
+    }
+    /** Get events by type */
+    getByType(type, limit) {
+        const filtered = this.eventLog.filter(e => e.type === type);
+        if (limit)
+            return filtered.slice(-limit);
+        return filtered;
+    }
+    /** Get events involving a specific agent */
+    getByAgent(agentId, limit) {
+        const filtered = this.eventLog.filter(e => e.actors.includes(agentId));
+        if (limit)
+            return filtered.slice(-limit);
+        return filtered;
+    }
+    /** Get events in a time range */
+    getByTimeRange(start, end) {
+        return this.eventLog.filter(e => e.timestamp >= start && e.timestamp <= end);
+    }
+    /** Clear all events */
+    clear() {
+        this.eventLog = [];
+    }
+    /** Get event count */
+    count() {
+        return this.eventLog.length;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+export { Universe } from './universe.js';
+export { AgentRegistry } from './agent-registry.js';
+export { RelationshipGraph } from './relationship-graph.js';
+export { StateMachine, type StateMachineInstance, type TransitionRecord } from './state-machine.js';
+export { PermissionMatrix } from './permission-matrix.js';
+export { ResourcePool } from './resource-pool.js';
+export { EventBus } from './event-bus.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,8 @@
+export { Universe } from './universe.js';
+export { AgentRegistry } from './agent-registry.js';
+export { RelationshipGraph } from './relationship-graph.js';
+export { StateMachine } from './state-machine.js';
+export { PermissionMatrix } from './permission-matrix.js';
+export { ResourcePool } from './resource-pool.js';
+export { EventBus } from './event-bus.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAoD,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/permission-matrix.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Permission Matrix — the social contract of an agent organization.
+ *
+ * Explicit permissions prevent agent chaos: no agent can arbitrarily
+ * escalate privileges or bypass another agent.
+ */
+import type { PermissionAction, GovernanceConfig } from '../types/index.js';
+import type { AgentDefinition } from '../types/index.js';
+export declare class PermissionMatrix {
+    /** Map: "actor:target" → Set of allowed actions */
+    private entries;
+    /** Map: agentId → role title for role-based lookups */
+    private roleMap;
+    constructor(governance: GovernanceConfig, agents: AgentDefinition[]);
+    /** Check if actor can perform action on target */
+    isAllowed(actorId: string, targetId: string, action: PermissionAction): boolean;
+    /** Get all actions actor can perform on target */
+    getAllowedActions(actorId: string, targetId: string): PermissionAction[];
+    /** Get all agents that actor can perform a specific action on */
+    getTargetsForAction(actorId: string, action: PermissionAction, allAgentIds: string[]): string[];
+    /** Add a runtime permission (for mutable governance) */
+    grant(actor: string, target: string, action: PermissionAction): void;
+    /** Remove a runtime permission */
+    revoke(actor: string, target: string, action: PermissionAction): void;
+    /** Export as a printable matrix for visualization */
+    toMatrix(agentIds: string[]): {
+        headers: string[];
+        rows: Array<{
+            agent: string;
+            permissions: string[];
+        }>;
+    };
+    private makeKey;
+}
+//# sourceMappingURL=permission-matrix.d.ts.map

package/dist/core/permission-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-matrix.d.ts","sourceRoot":"","sources":["../../src/core/permission-matrix.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAmB,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,qBAAa,gBAAgB;IAC3B,mDAAmD;IACnD,OAAO,CAAC,OAAO,CAAqC;IACpD,uDAAuD;IACvD,OAAO,CAAC,OAAO,CAAsB;gBAEzB,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE;IAoBnE,kDAAkD;IAClD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO;IA2B/E,kDAAkD;IAClD,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAQxE,iEAAiE;IACjE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAI/F,wDAAwD;IACxD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAOpE,kCAAkC;IAClC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAKrE,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE;IAY1G,OAAO,CAAC,OAAO;CAGhB"}

package/dist/core/permission-matrix.js

@@ -0,0 +1,95 @@
+/**
+ * Permission Matrix — the social contract of an agent organization.
+ *
+ * Explicit permissions prevent agent chaos: no agent can arbitrarily
+ * escalate privileges or bypass another agent.
+ */
+export class PermissionMatrix {
+    /** Map: "actor:target" → Set of allowed actions */
+    entries;
+    /** Map: agentId → role title for role-based lookups */
+    roleMap;
+    constructor(governance, agents) {
+        this.entries = new Map();
+        this.roleMap = new Map();
+        // Build role map
+        for (const agent of agents) {
+            this.roleMap.set(agent.id, agent.role.title);
+        }
+        // Index permissions
+        for (const entry of governance.permissionMatrix) {
+            const key = this.makeKey(entry.actor, entry.target);
+            const existing = this.entries.get(key) ?? new Set();
+            for (const action of entry.actions) {
+                existing.add(action);
+            }
+            this.entries.set(key, existing);
+        }
+    }
+    /** Check if actor can perform action on target */
+    isAllowed(actorId, targetId, action) {
+        // Direct ID-based check
+        const directKey = this.makeKey(actorId, targetId);
+        if (this.entries.get(directKey)?.has(action))
+            return true;
+        // Role-based check (actor ID → role, target ID → role)
+        const actorRole = this.roleMap.get(actorId);
+        const targetRole = this.roleMap.get(targetId);
+        if (actorRole) {
+            const roleKey = this.makeKey(actorRole, targetId);
+            if (this.entries.get(roleKey)?.has(action))
+                return true;
+        }
+        if (targetRole) {
+            const targetRoleKey = this.makeKey(actorId, targetRole);
+            if (this.entries.get(targetRoleKey)?.has(action))
+                return true;
+        }
+        if (actorRole && targetRole) {
+            const bothRoleKey = this.makeKey(actorRole, targetRole);
+            if (this.entries.get(bothRoleKey)?.has(action))
+                return true;
+        }
+        return false;
+    }
+    /** Get all actions actor can perform on target */
+    getAllowedActions(actorId, targetId) {
+        const allActions = [
+            'call', 'assign', 'review', 'approve', 'reject',
+            'promote', 'demote', 'suspend', 'eliminate', 'allocate',
+        ];
+        return allActions.filter(action => this.isAllowed(actorId, targetId, action));
+    }
+    /** Get all agents that actor can perform a specific action on */
+    getTargetsForAction(actorId, action, allAgentIds) {
+        return allAgentIds.filter(targetId => this.isAllowed(actorId, targetId, action));
+    }
+    /** Add a runtime permission (for mutable governance) */
+    grant(actor, target, action) {
+        const key = this.makeKey(actor, target);
+        const existing = this.entries.get(key) ?? new Set();
+        existing.add(action);
+        this.entries.set(key, existing);
+    }
+    /** Remove a runtime permission */
+    revoke(actor, target, action) {
+        const key = this.makeKey(actor, target);
+        this.entries.get(key)?.delete(action);
+    }
+    /** Export as a printable matrix for visualization */
+    toMatrix(agentIds) {
+        const headers = agentIds;
+        const rows = agentIds.map(actorId => ({
+            agent: actorId,
+            permissions: agentIds.map(targetId => {
+                const actions = this.getAllowedActions(actorId, targetId);
+                return actions.length > 0 ? actions.join(',') : '-';
+            }),
+        }));
+        return { headers, rows };
+    }
+    makeKey(actor, target) {
+        return `${actor}:${target}`;
+    }
+}
+//# sourceMappingURL=permission-matrix.js.map

package/dist/core/permission-matrix.js.map

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