@agents-uni/core 0.1.0

package/dist/types/agent.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Agent and Role definitions — the fundamental unit of a Universe.
+ *
+ * An Agent is not just an LLM wrapper; it is a *citizen* with identity,
+ * position, responsibilities, and social standing within an organization.
+ */
+export interface AgentDefinition {
+    /** Unique identifier within the universe */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Role this agent fulfills */
+    role: RoleDefinition;
+    /** Hierarchical rank (higher = more authority). 0-100 scale. */
+    rank?: number;
+    /** Personality dimensions (0-1 scale). Used for SOUL.md generation. */
+    traits?: Record<string, number>;
+    /** What this agent can do (skill names, tool names) */
+    capabilities?: string[];
+    /** Hard constraints on behavior */
+    constraints?: string[];
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface RoleDefinition {
+    /** Role title (e.g., "中书令", "CEO", "皇贵妃") */
+    title: string;
+    /** Department or faction this role belongs to */
+    department?: string;
+    /** What this role is responsible for */
+    duties: string[];
+    /** Permitted actions (used by PermissionMatrix) */
+    permissions: string[];
+    /** SOUL.md template name for OpenClaw integration */
+    soulTemplate?: string;
+}
+/**
+ * Runtime representation of an agent within a live Universe.
+ * Extends the static definition with mutable state.
+ */
+export interface Citizen {
+    /** The underlying definition */
+    definition: AgentDefinition;
+    /** Current status */
+    status: CitizenStatus;
+    /** Performance score (0-100, rolling average) */
+    performanceScore: number;
+    /** Accumulated resources */
+    resources: Record<string, number>;
+    /** When this citizen joined the universe */
+    joinedAt: string;
+    /** Custom runtime state */
+    state: Record<string, unknown>;
+}
+export type CitizenStatus = 'active' | 'idle' | 'suspended' | 'eliminated' | 'probation';
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mDAAmD;IACnD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,gCAAgC;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,MAAM,GACN,WAAW,GACX,YAAY,GACZ,WAAW,CAAC"}

package/dist/types/agent.js

@@ -0,0 +1,8 @@
+/**
+ * Agent and Role definitions — the fundamental unit of a Universe.
+ *
+ * An Agent is not just an LLM wrapper; it is a *citizen* with identity,
+ * position, responsibilities, and social standing within an organization.
+ */
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

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

package/dist/types/event.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Organization Events — the observable side effects of organizational life.
+ *
+ * Events are first-class citizens, not an afterthought. Every meaningful
+ * change in the universe emits an event. This enables:
+ * 1. Complete audit trail
+ * 2. Reactive evolution (relationships change in response to events)
+ * 3. Narrative generation (events → human-readable story)
+ */
+export type OrganizationEventType = 'agent.joined' | 'agent.promoted' | 'agent.demoted' | 'agent.suspended' | 'agent.eliminated' | 'agent.reinstated' | 'alliance.formed' | 'alliance.broken' | 'rivalry.started' | 'rivalry.resolved' | 'resource.allocated' | 'resource.transferred' | 'resource.decayed' | 'task.created' | 'task.assigned' | 'task.completed' | 'task.failed' | 'review.approved' | 'review.rejected' | 'protocol.stateChanged' | 'governance.changed' | 'evolution.cycleCompleted' | 'race.dispatched' | 'race.submitted' | 'race.collected' | 'race.judged' | 'custom';
+export interface OrganizationEvent {
+    /** Unique event ID */
+    id: string;
+    /** Event classification */
+    type: OrganizationEventType;
+    /** When this event occurred */
+    timestamp: string;
+    /** Agents involved in this event */
+    actors: string[];
+    /** Event-specific payload */
+    data: Record<string, unknown>;
+    /** Human-readable narrative of what happened */
+    narrative: string;
+}
+export type EventHandler = (event: OrganizationEvent) => void | Promise<void>;
+export interface EventSubscription {
+    /** Event types to listen for (empty = all) */
+    types: OrganizationEventType[];
+    /** Handler function */
+    handler: EventHandler;
+    /** Unique subscription ID */
+    id: string;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/types/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,GAClB,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,GACvB,oBAAoB,GACpB,0BAA0B,GAC1B,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,uBAAuB;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/types/event.js

@@ -0,0 +1,11 @@
+/**
+ * Organization Events — the observable side effects of organizational life.
+ *
+ * Events are first-class citizens, not an afterthought. Every meaningful
+ * change in the universe emits an event. This enables:
+ * 1. Complete audit trail
+ * 2. Reactive evolution (relationships change in response to events)
+ * 3. Narrative generation (events → human-readable story)
+ */
+export {};
+//# sourceMappingURL=event.js.map

package/dist/types/event.js.map

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

package/dist/types/governance.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Governance — the rules by which an organization makes decisions.
+ *
+ * Key insight: mandatory institutional review
+ * prevents hallucination propagation. The governance model defines
+ * WHO reviews WHOM, WHO can promote/demote, and HOW decisions are made.
+ */
+export type DecisionModel = 'autocratic' | 'democratic' | 'consensus' | 'meritocratic';
+export interface GovernanceConfig {
+    /** How decisions are made in this organization */
+    decisionModel: DecisionModel;
+    /** Explicit permission entries (who can do what to whom) */
+    permissionMatrix: PermissionEntry[];
+    /** Review/approval policy */
+    reviewPolicy: ReviewPolicy;
+    /** What happens when things go wrong or stall */
+    escalationRules: EscalationRule[];
+}
+export interface PermissionEntry {
+    /** Who is acting (agent ID or role title) */
+    actor: string;
+    /** Who is being acted upon (agent ID or role title) */
+    target: string;
+    /** What actions are permitted */
+    actions: PermissionAction[];
+}
+export type PermissionAction = 'call' | 'assign' | 'review' | 'approve' | 'reject' | 'promote' | 'demote' | 'suspend' | 'eliminate' | 'allocate';
+export interface ReviewPolicy {
+    /** Is review mandatory before work proceeds? */
+    mandatory: boolean;
+    /** Which roles can serve as reviewers */
+    reviewers: string[];
+    /** Maximum review rounds before auto-approve */
+    maxRounds: number;
+    /** Auto-approve after N rounds if still unresolved */
+    autoApproveAfter?: number;
+}
+export interface EscalationRule {
+    /** Condition that triggers escalation */
+    trigger: string;
+    /** Who to escalate to (agent ID or role) */
+    escalateTo: string;
+    /** Action to take */
+    action: 'notify' | 'reassign' | 'override' | 'cancel';
+    /** Timeout before escalation kicks in (ms) */
+    timeoutMs?: number;
+}
+//# sourceMappingURL=governance.d.ts.map

package/dist/types/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/types/governance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,cAAc,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,aAAa,EAAE,aAAa,CAAC;IAC7B,4DAA4D;IAC5D,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,6BAA6B;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,iDAAiD;IACjD,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtD,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/governance.js

@@ -0,0 +1,9 @@
+/**
+ * Governance — the rules by which an organization makes decisions.
+ *
+ * Key insight: mandatory institutional review
+ * prevents hallucination propagation. The governance model defines
+ * WHO reviews WHOM, WHO can promote/demote, and HOW decisions are made.
+ */
+export {};
+//# sourceMappingURL=governance.js.map

package/dist/types/governance.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+export * from './agent.js';
+export * from './relationship.js';
+export * from './protocol.js';
+export * from './governance.js';
+export * from './resource.js';
+export * from './memory.js';
+export * from './event.js';
+export * from './universe.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,9 @@
+export * from './agent.js';
+export * from './relationship.js';
+export * from './protocol.js';
+export * from './governance.js';
+export * from './resource.js';
+export * from './memory.js';
+export * from './event.js';
+export * from './universe.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/types/memory.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Organization Memory and Evolution — how organizations learn and adapt.
+ *
+ * Individual agents have their own memory (via OpenClaw). But organizations
+ * also need collective memory: what strategies worked, which agents excel
+ * at what, how relationships evolved over time.
+ */
+export interface EvolutionConfig {
+    /** How many recent tasks to consider for performance evaluation */
+    performanceWindow: number;
+    /** Score threshold to earn promotion (0-100) */
+    promotionThreshold: number;
+    /** Score below which demotion occurs (0-100) */
+    demotionThreshold: number;
+    /** Maximum events to keep in organization memory */
+    memoryRetention: number;
+    /** How often to run evolution cycle (ms). 0 = manual only. */
+    evolutionInterval?: number;
+}
+export interface OrganizationMemory {
+    /** Key lessons the organization has learned */
+    lessons: Lesson[];
+    /** Performance history per agent */
+    performanceHistory: Record<string, PerformanceRecord[]>;
+    /** Relationship evolution timeline */
+    relationshipTimeline: RelationshipSnapshot[];
+    /** Resource distribution history */
+    resourceHistory: ResourceSnapshot[];
+}
+export interface Lesson {
+    /** Unique identifier */
+    id: string;
+    /** What was learned */
+    content: string;
+    /** Context in which it was learned */
+    context: string;
+    /** Which agents were involved */
+    agents: string[];
+    /** When this lesson was recorded */
+    learnedAt: string;
+    /** How many times this lesson has been reinforced */
+    reinforcements: number;
+}
+export interface PerformanceRecord {
+    /** Agent being evaluated */
+    agentId: string;
+    /** Task or match that was evaluated */
+    taskId: string;
+    /** Overall score (0-100) */
+    score: number;
+    /** Breakdown by dimension */
+    dimensions: Record<string, number>;
+    /** When this was recorded */
+    evaluatedAt: string;
+}
+export interface RelationshipSnapshot {
+    /** Timestamp of snapshot */
+    timestamp: string;
+    /** All relationships at this point in time */
+    relationships: Array<{
+        from: string;
+        to: string;
+        type: string;
+        weight: number;
+    }>;
+}
+export interface ResourceSnapshot {
+    /** Timestamp of snapshot */
+    timestamp: string;
+    /** Resource allocations at this point */
+    allocations: Record<string, Record<string, number>>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/types/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACxD,sCAAsC;IACtC,oBAAoB,EAAE,oBAAoB,EAAE,CAAC;IAC7C,oCAAoC;IACpC,eAAe,EAAE,gBAAgB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,MAAM;IACrB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD"}

package/dist/types/memory.js

@@ -0,0 +1,9 @@
+/**
+ * Organization Memory and Evolution — how organizations learn and adapt.
+ *
+ * Individual agents have their own memory (via OpenClaw). But organizations
+ * also need collective memory: what strategies worked, which agents excel
+ * at what, how relationships evolved over time.
+ */
+export {};
+//# sourceMappingURL=memory.js.map

package/dist/types/memory.js.map

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

package/dist/types/protocol.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Protocol definitions — state machines that govern organizational workflows.
+ *
+ * Every organizational process (task dispatch, competition, promotion)
+ * reduces to a state machine with role-gated transitions.
+ * This is the universal primitive that makes organizations predictable.
+ */
+export interface ProtocolDefinition {
+    /** Protocol identifier */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** All possible states in this protocol */
+    states: StateDefinition[];
+    /** Rules for moving between states */
+    transitions: TransitionRule[];
+    /** Which roles can act in which states */
+    roles: Record<string, string[]>;
+}
+export interface StateDefinition {
+    /** State identifier */
+    name: string;
+    /** Display label */
+    label: string;
+    /** Which role "owns" this state (responsible for advancing it) */
+    owner?: string;
+    /** Is this a terminal state? (No outgoing transitions) */
+    terminal?: boolean;
+    /** Maximum time allowed in this state (ms) before escalation */
+    timeout?: number;
+    /** Icon or emoji for visualization */
+    icon?: string;
+}
+export interface TransitionRule {
+    /** Source state */
+    from: string;
+    /** Target state */
+    to: string;
+    /** Condition expression (simple DSL: "review.approved", "score > 80") */
+    guard?: string;
+    /** Side effect to trigger on transition */
+    action?: string;
+    /** Which role is required to trigger this transition */
+    requiredRole?: string;
+    /** Human-readable label for this transition */
+    label?: string;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/types/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/types/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,sCAAsC;IACtC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/protocol.js

@@ -0,0 +1,9 @@
+/**
+ * Protocol definitions — state machines that govern organizational workflows.
+ *
+ * Every organizational process (task dispatch, competition, promotion)
+ * reduces to a state machine with role-gated transitions.
+ * This is the universal primitive that makes organizations predictable.
+ */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/types/protocol.js.map

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

package/dist/types/relationship.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Relationship types — the social fabric of a Universe.
+ *
+ * Key insight: agent collaboration quality is determined not by individual
+ * capability, but by the structure of relationships between agents.
+ * A well-designed relationship graph IS the production relationship.
+ */
+export type RelationshipType = 'superior' | 'subordinate' | 'peer' | 'competitive' | 'reviewer' | 'advisor' | 'ally' | 'rival' | 'mentor' | 'delegate' | 'serves';
+export interface RelationshipDefinition {
+    /** Source agent ID */
+    from: string;
+    /** Target agent ID */
+    to: string;
+    /** Nature of the relationship */
+    type: RelationshipType;
+    /** Strength of the relationship (0-1). Higher = stronger bond/rivalry. */
+    weight?: number;
+    /** Can this relationship change during universe evolution? */
+    mutable?: boolean;
+    /** Relationship-specific metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Runtime relationship with mutable state for evolution tracking.
+ */
+export interface LiveRelationship extends RelationshipDefinition {
+    /** Current weight (may differ from initial if mutable) */
+    currentWeight: number;
+    /** When this relationship was established */
+    establishedAt: string;
+    /** History of weight changes */
+    history: RelationshipEvent[];
+}
+export interface RelationshipEvent {
+    timestamp: string;
+    previousWeight: number;
+    newWeight: number;
+    reason: string;
+}
+//# sourceMappingURL=relationship.d.ts.map

package/dist/types/relationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship.d.ts","sourceRoot":"","sources":["../../src/types/relationship.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,aAAa,GACb,MAAM,GACN,aAAa,GACb,UAAU,GACV,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;IAC9D,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/relationship.js

@@ -0,0 +1,9 @@
+/**
+ * Relationship types — the social fabric of a Universe.
+ *
+ * Key insight: agent collaboration quality is determined not by individual
+ * capability, but by the structure of relationships between agents.
+ * A well-designed relationship graph IS the production relationship.
+ */
+export {};
+//# sourceMappingURL=relationship.js.map

package/dist/types/relationship.js.map

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

package/dist/types/resource.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Resource definitions — the alignment mechanism for agent behavior.
+ *
+ * Key insight: agents optimize for resource acquisition. By designing
+ * the resource structure, you align agent behavior with organizational goals.
+ * Finite resources create competition; renewable resources create cooperation.
+ */
+export type ResourceType = 'finite' | 'renewable' | 'positional';
+export type DistributionStrategy = 'equal' | 'merit' | 'hierarchy' | 'competitive';
+export interface ResourceDefinition {
+    /** Resource identifier */
+    name: string;
+    /** Resource behavior type */
+    type: ResourceType;
+    /** Total amount available in the universe */
+    total: number;
+    /** How this resource is distributed */
+    distribution: DistributionStrategy;
+    /** For renewable resources: refresh interval in ms */
+    refreshInterval?: number;
+    /** Decay rate per cycle (0-1). 0 = no decay, 1 = fully decays. */
+    decayRate?: number;
+    /** Human-readable description */
+    description?: string;
+}
+export interface ResourceAllocation {
+    /** Which agent holds this allocation */
+    agentId: string;
+    /** Resource name */
+    resource: string;
+    /** Amount allocated */
+    amount: number;
+    /** When this allocation was made */
+    acquiredAt: string;
+    /** When this allocation expires (for renewable/positional) */
+    expiresAt?: string;
+}
+export interface ResourceTransfer {
+    /** Source agent (or 'system' for system grants) */
+    from: string;
+    /** Target agent */
+    to: string;
+    /** Resource name */
+    resource: string;
+    /** Amount transferred */
+    amount: number;
+    /** Reason for transfer */
+    reason: string;
+    /** Timestamp */
+    timestamp: string;
+}
+//# sourceMappingURL=resource.d.ts.map

package/dist/types/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/types/resource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,WAAW,GACX,YAAY,CAAC;AAEjB,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,OAAO,GACP,WAAW,GACX,aAAa,CAAC;AAElB,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,YAAY,EAAE,oBAAoB,CAAC;IACnC,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/resource.js

@@ -0,0 +1,9 @@
+/**
+ * Resource definitions — the alignment mechanism for agent behavior.
+ *
+ * Key insight: agents optimize for resource acquisition. By designing
+ * the resource structure, you align agent behavior with organizational goals.
+ * Finite resources create competition; renewable resources create cooperation.
+ */
+export {};
+//# sourceMappingURL=resource.js.map

package/dist/types/resource.js.map

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

package/dist/types/universe.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Universe — the top-level container for an agent organization.
+ *
+ * A Universe is to agents what a society is to people:
+ * it defines the rules, relationships, resources, and evolutionary
+ * pressures that shape how agents collaborate or compete.
+ */
+import type { AgentDefinition } from './agent.js';
+import type { RelationshipDefinition } from './relationship.js';
+import type { ProtocolDefinition } from './protocol.js';
+import type { GovernanceConfig } from './governance.js';
+import type { ResourceDefinition } from './resource.js';
+import type { EvolutionConfig } from './memory.js';
+/** The user/ruler at the center of the agent network */
+export interface RulerDefinition {
+    title?: string;
+    description?: string;
+    permissions?: string[];
+}
+export type UniverseType = 'hierarchical' | 'flat' | 'competitive' | 'hybrid';
+export interface UniverseConfig {
+    /** Universe name (kebab-case identifier) */
+    name: string;
+    /** Semantic version */
+    version: string;
+    /** Human-readable description */
+    description: string;
+    /** Organizational model */
+    type: UniverseType;
+    /** The user/ruler definition — the human at the center of the agent network (optional) */
+    ruler?: RulerDefinition;
+    /** All agents in this universe */
+    agents: AgentDefinition[];
+    /** Relationships between agents */
+    relationships: RelationshipDefinition[];
+    /** Workflow protocols (state machines) */
+    protocols: ProtocolDefinition[];
+    /** Decision-making and permission rules */
+    governance: GovernanceConfig;
+    /** Shared resources (optional) */
+    resources?: ResourceDefinition[];
+    /** Evolution/adaptation rules (optional) */
+    evolution?: EvolutionConfig;
+    /** Custom universe-level metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Snapshot of a Universe at a point in time.
+ * Used for persistence, replay, and time-travel debugging.
+ */
+export interface UniverseSnapshot {
+    /** The config that created this universe */
+    config: UniverseConfig;
+    /** Current tick/cycle number */
+    tick: number;
+    /** Timestamp of snapshot */
+    timestamp: string;
+    /** Agent runtime states */
+    agentStates: Record<string, Record<string, unknown>>;
+    /** Current resource allocations */
+    resourceAllocations: Record<string, Record<string, number>>;
+    /** Active protocol states */
+    protocolStates: Record<string, string>;
+    /** Relationship current weights */
+    relationshipWeights: Array<{
+        from: string;
+        to: string;
+        weight: number;
+    }>;
+}
+//# sourceMappingURL=universe.d.ts.map

package/dist/types/universe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"universe.d.ts","sourceRoot":"","sources":["../../src/types/universe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GACpB,cAAc,GACd,MAAM,GACN,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,kCAAkC;IAClC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,mCAAmC;IACnC,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACxC,0CAA0C;IAC1C,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,2CAA2C;IAC3C,UAAU,EAAE,gBAAgB,CAAC;IAC7B,kCAAkC;IAClC,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,mCAAmC;IACnC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,mCAAmC;IACnC,mBAAmB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E"}

package/dist/types/universe.js

@@ -0,0 +1,9 @@
+/**
+ * Universe — the top-level container for an agent organization.
+ *
+ * A Universe is to agents what a society is to people:
+ * it defines the rules, relationships, resources, and evolutionary
+ * pressures that shape how agents collaborate or compete.
+ */
+export {};
+//# sourceMappingURL=universe.js.map

package/dist/types/universe.js.map

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