@hazeljs/organism 2.0.6

package/dist/events/organism-events.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Organism domain events (namespaced; separate from AgentEventType).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrganismEventEmitter = exports.OrganismEventType = void 0;
+var OrganismEventType;
+(function (OrganismEventType) {
+    OrganismEventType["ORGANISM_CREATED"] = "organism.created";
+    OrganismEventType["ORGANISM_RESTORED"] = "organism.restored";
+    OrganismEventType["ORGANISM_STARTED"] = "organism.started";
+    OrganismEventType["ORGANISM_PAUSED"] = "organism.paused";
+    OrganismEventType["ORGANISM_RESUMED"] = "organism.resumed";
+    OrganismEventType["ORGANISM_COMPLETED"] = "organism.completed";
+    OrganismEventType["ORGANISM_TERMINATED"] = "organism.terminated";
+    OrganismEventType["ORGANISM_EMERGENCY_STOP"] = "organism.emergency_stop";
+    OrganismEventType["ENVIRONMENT_SIGNAL_RECEIVED"] = "environment.signal.received";
+    OrganismEventType["ORGANISM_NEED_DETECTED"] = "organism.need.detected";
+    OrganismEventType["ORGANISM_AGENT_BORN"] = "organism.agent.born";
+    OrganismEventType["ORGANISM_AGENT_SPECIALIZED"] = "organism.agent.specialized";
+    OrganismEventType["ORGANISM_AGENT_REPRODUCED"] = "organism.agent.reproduced";
+    OrganismEventType["ORGANISM_AGENT_MUTATED"] = "organism.agent.mutated";
+    OrganismEventType["ORGANISM_AGENT_SUSPENDED"] = "organism.agent.suspended";
+    OrganismEventType["ORGANISM_AGENT_TERMINATED"] = "organism.agent.terminated";
+    OrganismEventType["ORGANISM_RESOURCE_ALLOCATED"] = "organism.resource.allocated";
+    OrganismEventType["ORGANISM_RESOURCE_DENIED"] = "organism.resource.denied";
+    OrganismEventType["ORGANISM_RESOURCE_BID"] = "organism.resource.bid";
+    OrganismEventType["ORGANISM_MARKET_CLEARED"] = "organism.market.cleared";
+    OrganismEventType["ORGANISM_NEGOTIATION"] = "organism.negotiation";
+    OrganismEventType["ORGANISM_UTILITY_FORECAST"] = "organism.utility.forecast";
+    OrganismEventType["ORGANISM_REPUTATION_CHANGED"] = "organism.reputation.changed";
+    OrganismEventType["ORGANISM_UTILITY_CALCULATED"] = "organism.utility.calculated";
+    OrganismEventType["ORGANISM_GENERATION_CREATED"] = "organism.generation.created";
+    OrganismEventType["ORGANISM_STRATEGY_PROMOTED"] = "organism.strategy.promoted";
+    OrganismEventType["ORGANISM_CONSTITUTION_VIOLATION"] = "organism.constitution.violation";
+    OrganismEventType["ORGANISM_MISSION_PROGRESS"] = "organism.mission.progress";
+    OrganismEventType["ORGANISM_MISSION_COMPLETED"] = "organism.mission.completed";
+    OrganismEventType["ORGANISM_DECISION"] = "organism.decision";
+})(OrganismEventType || (exports.OrganismEventType = OrganismEventType = {}));
+class OrganismEventEmitter {
+    constructor(options = {}) {
+        this.handlers = new Map();
+        this.wildcardHandlers = new Set();
+        this.history = [];
+        this.maxHistory = options.maxHistory ?? 500;
+    }
+    on(type, handler) {
+        if (!this.handlers.has(type)) {
+            this.handlers.set(type, new Set());
+        }
+        this.handlers.get(type).add(handler);
+    }
+    onAny(handler) {
+        this.wildcardHandlers.add(handler);
+    }
+    off(type, handler) {
+        this.handlers.get(type)?.delete(handler);
+    }
+    offAny(handler) {
+        this.wildcardHandlers.delete(handler);
+    }
+    async emit(type, organismId, data, metadata) {
+        const event = {
+            type,
+            organismId,
+            timestamp: new Date(),
+            data,
+            metadata,
+        };
+        this.history.push(event);
+        if (this.history.length > this.maxHistory) {
+            this.history.splice(0, this.history.length - this.maxHistory);
+        }
+        const typed = this.handlers.get(type);
+        if (typed) {
+            for (const handler of typed) {
+                await handler(event);
+            }
+        }
+        for (const handler of this.wildcardHandlers) {
+            await handler(event);
+        }
+        return event;
+    }
+    getHistory(limit) {
+        if (limit == null)
+            return [...this.history];
+        return this.history.slice(-limit);
+    }
+    clearHistory() {
+        this.history = [];
+    }
+}
+exports.OrganismEventEmitter = OrganismEventEmitter;
+//# sourceMappingURL=organism-events.js.map

package/dist/events/organism-events.js.map

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

package/dist/evolution/evolution-engine.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Phase 3 — generation evaluation and strategy promotion.
+ */
+import type { EvolutionaryHistoryEntry, GenerationEvaluationResult, RuntimeAgentRecord, UtilityWeights } from '../types/organism.types';
+import { OrganismEventEmitter } from '../events/organism-events';
+import type { OrganismRepository } from '../persistence/organism-repository';
+import { MutationEngine } from './mutation-engine';
+import type { AgentGeneDefinition } from '../types/organism.types';
+export declare class GenerationManager {
+    private history;
+    private populations;
+    registerPopulation(populationId: string, agentIds: string[]): void;
+    getPopulation(populationId: string): string[];
+    record(entry: EvolutionaryHistoryEntry): void;
+    getHistory(limit?: number): EvolutionaryHistoryEntry[];
+}
+export declare class EvolutionEngine {
+    private readonly events;
+    private readonly repo;
+    private readonly generations;
+    private readonly mutationEngine;
+    private readonly organismId;
+    private readonly weights;
+    private readonly now;
+    constructor(events: OrganismEventEmitter, repo: OrganismRepository, generations: GenerationManager, mutationEngine: MutationEngine, organismId: string, weights?: UtilityWeights, now?: () => Date);
+    scoreAgent(agent: RuntimeAgentRecord): number;
+    evaluateGeneration(input: {
+        population: string[];
+        populationId?: string;
+    }): Promise<GenerationEvaluationResult>;
+    /**
+     * Promote winner strategy into a loser via controlled mutation (safe config only).
+     */
+    promoteStrategy(input: {
+        winnerId: string;
+        targetId: string;
+        gene: AgentGeneDefinition;
+        reason?: string;
+    }): Promise<RuntimeAgentRecord>;
+}
+//# sourceMappingURL=evolution-engine.d.ts.map

package/dist/evolution/evolution-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution-engine.d.ts","sourceRoot":"","sources":["../../src/evolution/evolution-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAE1B,kBAAkB,EAClB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAqB,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,WAAW,CAA+B;IAElD,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAIlE,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAI7C,MAAM,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI;IAO7C,UAAU,CAAC,KAAK,SAAK,GAAG,wBAAwB,EAAE;CAGnD;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBANH,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,kBAAkB,EACxB,WAAW,EAAE,iBAAiB,EAC9B,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAwC,EACjD,GAAG,GAAE,MAAM,IAAuB;IAGrD,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM;IAevC,kBAAkB,CAAC,KAAK,EAAE;QAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAkEvC;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,mBAAmB,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAkBhC"}

package/dist/evolution/evolution-engine.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Phase 3 — generation evaluation and strategy promotion.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvolutionEngine = exports.GenerationManager = void 0;
+const organism_types_1 = require("../types/organism.types");
+const organism_events_1 = require("../events/organism-events");
+class GenerationManager {
+    constructor() {
+        this.history = [];
+        this.populations = new Map();
+    }
+    registerPopulation(populationId, agentIds) {
+        this.populations.set(populationId, [...agentIds]);
+    }
+    getPopulation(populationId) {
+        return [...(this.populations.get(populationId) ?? [])];
+    }
+    record(entry) {
+        this.history.push(entry);
+        if (this.history.length > 200) {
+            this.history.splice(0, this.history.length - 200);
+        }
+    }
+    getHistory(limit = 50) {
+        return this.history.slice(-limit);
+    }
+}
+exports.GenerationManager = GenerationManager;
+class EvolutionEngine {
+    constructor(events, repo, generations, mutationEngine, organismId, weights = organism_types_1.DEFAULT_UTILITY_WEIGHTS, now = () => new Date()) {
+        this.events = events;
+        this.repo = repo;
+        this.generations = generations;
+        this.mutationEngine = mutationEngine;
+        this.organismId = organismId;
+        this.weights = weights;
+        this.now = now;
+    }
+    scoreAgent(agent) {
+        const missionContribution = clamp(agent.utility.score, 0, 1);
+        const reliability = agent.reputation.dimensions.reliability;
+        const efficiency = agent.reputation.dimensions.efficiency;
+        const policyCompliance = agent.reputation.dimensions.policyCompliance;
+        const collaboration = agent.reputation.dimensions.collaboration;
+        return (missionContribution * this.weights.missionContribution +
+            reliability * this.weights.reliability +
+            efficiency * this.weights.efficiency +
+            policyCompliance * this.weights.policyCompliance +
+            collaboration * this.weights.collaboration);
+    }
+    async evaluateGeneration(input) {
+        const populationId = input.populationId ?? `pop_${Date.now().toString(36)}`;
+        this.generations.registerPopulation(populationId, input.population);
+        const members = [];
+        const scores = {};
+        for (const agentId of input.population) {
+            const agent = await this.repo.getAgent(this.organismId, agentId);
+            if (!agent || agent.status === 'terminated')
+                continue;
+            const score = this.scoreAgent(agent);
+            scores[agentId] = score;
+            members.push({
+                agentId,
+                score,
+                utility: agent.utility.score,
+                reputation: agent.reputation.score,
+                cost: agent.costConsumed,
+                policyCompliance: agent.reputation.dimensions.policyCompliance,
+            });
+        }
+        if (!members.length) {
+            return {
+                populationId,
+                winner: input.population[0] ?? '',
+                scores,
+                members,
+            };
+        }
+        members.sort((a, b) => b.score - a.score);
+        const winner = members[0].agentId;
+        const winnerAgent = await this.repo.getAgent(this.organismId, winner);
+        const promotedStrategyId = winnerAgent?.strategyId;
+        const result = {
+            populationId,
+            winner,
+            scores,
+            members,
+            promotedStrategyId,
+        };
+        this.generations.record({
+            at: this.now(),
+            populationId,
+            winnerAgentId: winner,
+            scores: { ...scores },
+            promotedStrategyId,
+        });
+        await this.events.emit(organism_events_1.OrganismEventType.ORGANISM_GENERATION_CREATED, this.organismId, {
+            populationId,
+            population: input.population,
+        });
+        await this.events.emit(organism_events_1.OrganismEventType.ORGANISM_STRATEGY_PROMOTED, this.organismId, {
+            winner,
+            promotedStrategyId,
+            scores,
+            populationId,
+        });
+        return result;
+    }
+    /**
+     * Promote winner strategy into a loser via controlled mutation (safe config only).
+     */
+    async promoteStrategy(input) {
+        const winner = await this.repo.getAgent(this.organismId, input.winnerId);
+        const target = await this.repo.getAgent(this.organismId, input.targetId);
+        if (!winner || !target) {
+            throw new Error('Winner or target agent not found');
+        }
+        const request = {
+            reason: input.reason ?? `Promote strategy from ${winner.id}`,
+            mutation: {
+                strategyConfig: { ...winner.strategyConfig, promotedFrom: winner.id },
+                modelConfig: { ...winner.modelConfig },
+                promptChanges: [`Adopt winning strategy patterns from ${winner.name}#${winner.id}`],
+            },
+        };
+        return this.mutationEngine.mutate(target, request, input.gene);
+    }
+}
+exports.EvolutionEngine = EvolutionEngine;
+function clamp(n, min, max) {
+    return Math.max(min, Math.min(max, n));
+}
+//# sourceMappingURL=evolution-engine.js.map

package/dist/evolution/evolution-engine.js.map

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

package/dist/evolution/mutation-engine.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Phase 3 — constrained, auditable mutation (no arbitrary source rewrite).
+ */
+import type { AgentGeneDefinition, AgentMutation, RuntimeAgentRecord } from '../types/organism.types';
+import { OrganismEventEmitter } from '../events/organism-events';
+import type { OrganismRepository } from '../persistence/organism-repository';
+export interface MutationRequest {
+    reason: string;
+    mutation: AgentMutation;
+}
+export declare class MutationEngine {
+    private readonly events;
+    private readonly repo;
+    private readonly organismId;
+    private readonly now;
+    constructor(events: OrganismEventEmitter, repo: OrganismRepository, organismId: string, now?: () => Date);
+    assertAllowed(gene: AgentGeneDefinition, mutation: AgentMutation): void;
+    apply(agent: RuntimeAgentRecord, request: MutationRequest, gene: AgentGeneDefinition): RuntimeAgentRecord;
+    mutate(agent: RuntimeAgentRecord, request: MutationRequest, gene: AgentGeneDefinition): Promise<RuntimeAgentRecord>;
+}
+//# sourceMappingURL=mutation-engine.d.ts.map

package/dist/evolution/mutation-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-engine.d.ts","sourceRoot":"","sources":["../../src/evolution/mutation-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAEb,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAqB,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;CACzB;AAUD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAHH,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,IAAuB;IAGrD,aAAa,CAAC,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAcvE,KAAK,CACH,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,mBAAmB,GACxB,kBAAkB;IAyCf,MAAM,CACV,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC;CAW/B"}

package/dist/evolution/mutation-engine.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Phase 3 — constrained, auditable mutation (no arbitrary source rewrite).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MutationEngine = void 0;
+const organism_errors_1 = require("../errors/organism.errors");
+const organism_events_1 = require("../events/organism-events");
+const DEFAULT_ALLOWED = [
+    'promptChanges',
+    'addedCapabilities',
+    'removedCapabilities',
+    'modelConfig',
+    'strategyConfig',
+];
+class MutationEngine {
+    constructor(events, repo, organismId, now = () => new Date()) {
+        this.events = events;
+        this.repo = repo;
+        this.organismId = organismId;
+        this.now = now;
+    }
+    assertAllowed(gene, mutation) {
+        if (gene.mutation && gene.mutation.enabled === false) {
+            throw new organism_errors_1.OrganismLimitError(`Gene ${gene.id} has mutation disabled`);
+        }
+        const allowed = new Set(gene.mutation?.allowedProperties ?? DEFAULT_ALLOWED);
+        for (const key of Object.keys(mutation)) {
+            if (mutation[key] !== undefined && !allowed.has(key)) {
+                throw new organism_errors_1.OrganismLimitError(`Mutation property "${key}" is not allowed for gene ${gene.id}`);
+            }
+        }
+    }
+    apply(agent, request, gene) {
+        if (agent.status === 'terminated' || agent.status === 'failed') {
+            throw new organism_errors_1.OrganismStateError(`Cannot mutate agent ${agent.id} in status ${agent.status}`);
+        }
+        this.assertAllowed(gene, request.mutation);
+        const m = request.mutation;
+        if (m.promptChanges?.length) {
+            const appendix = m.promptChanges.map((c) => `- ${c}`).join('\n');
+            agent.systemPrompt = `${agent.systemPrompt ?? ''}\n## Mutation\n${appendix}`.trim();
+        }
+        if (m.addedCapabilities?.length) {
+            agent.capabilities = Array.from(new Set([...agent.capabilities, ...m.addedCapabilities]));
+        }
+        if (m.removedCapabilities?.length) {
+            const remove = new Set(m.removedCapabilities.map((c) => c.toLowerCase()));
+            agent.capabilities = agent.capabilities.filter((c) => !remove.has(c.toLowerCase()));
+        }
+        if (m.modelConfig) {
+            agent.modelConfig = { ...agent.modelConfig, ...m.modelConfig };
+        }
+        if (m.strategyConfig) {
+            agent.strategyConfig = { ...agent.strategyConfig, ...m.strategyConfig };
+        }
+        const resultingStrategyId = `${agent.strategyId ?? agent.geneId}:m${agent.mutations.length + 1}`;
+        const record = {
+            id: `mut_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`,
+            at: this.now(),
+            mutation: { ...m },
+            reason: request.reason,
+            parentStrategyId: agent.strategyId,
+            resultingStrategyId,
+        };
+        agent.mutations = [...agent.mutations, record];
+        agent.strategyId = resultingStrategyId;
+        agent.lastMutationAt = record.at;
+        return agent;
+    }
+    async mutate(agent, request, gene) {
+        const updated = this.apply({ ...agent, mutations: [...agent.mutations] }, request, gene);
+        await this.repo.saveAgent(this.organismId, updated);
+        await this.events.emit(organism_events_1.OrganismEventType.ORGANISM_AGENT_MUTATED, this.organismId, {
+            agentId: updated.id,
+            reason: request.reason,
+            mutation: request.mutation,
+            strategyId: updated.strategyId,
+        });
+        return updated;
+    }
+}
+exports.MutationEngine = MutationEngine;
+//# sourceMappingURL=mutation-engine.js.map

package/dist/evolution/mutation-engine.js.map

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

package/dist/genealogy/genealogy-manager.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Genealogy helpers — parent/child tree formatting and queries.
+ */
+import type { AgentGenealogy, RuntimeAgentRecord } from '../types/organism.types';
+import type { OrganismRepository } from '../persistence/organism-repository';
+export declare class GenealogyManager {
+    private readonly repo;
+    private readonly organismId;
+    constructor(repo: OrganismRepository, organismId: string);
+    list(): Promise<AgentGenealogy[]>;
+    getLineage(agentId: string): Promise<AgentGenealogy[]>;
+    countLiveChildren(parentId: string, agents: RuntimeAgentRecord[]): Promise<number>;
+    /**
+     * ASCII tree suitable for CLI / debug logs.
+     */
+    formatTree(agents: RuntimeAgentRecord[], genealogy: AgentGenealogy[]): string;
+}
+//# sourceMappingURL=genealogy-manager.d.ts.map

package/dist/genealogy/genealogy-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genealogy-manager.d.ts","sourceRoot":"","sources":["../../src/genealogy/genealogy-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,MAAM;IAG/B,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIjC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAYtD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IASxF;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM;CA4B9E"}

package/dist/genealogy/genealogy-manager.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Genealogy helpers — parent/child tree formatting and queries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenealogyManager = void 0;
+class GenealogyManager {
+    constructor(repo, organismId) {
+        this.repo = repo;
+        this.organismId = organismId;
+    }
+    async list() {
+        return this.repo.listGenealogy(this.organismId);
+    }
+    async getLineage(agentId) {
+        const all = await this.list();
+        const byId = new Map(all.map((g) => [g.agentId, g]));
+        const chain = [];
+        let current = byId.get(agentId);
+        while (current) {
+            chain.unshift(current);
+            current = current.parentAgentId ? byId.get(current.parentAgentId) : undefined;
+        }
+        return chain;
+    }
+    async countLiveChildren(parentId, agents) {
+        const live = new Set(agents.filter((a) => a.status !== 'terminated' && a.status !== 'failed').map((a) => a.id));
+        const gene = (await this.list()).find((g) => g.agentId === parentId);
+        if (!gene)
+            return 0;
+        return gene.children.filter((id) => live.has(id)).length;
+    }
+    /**
+     * ASCII tree suitable for CLI / debug logs.
+     */
+    formatTree(agents, genealogy) {
+        const byId = new Map(agents.map((a) => [a.id, a]));
+        const geneById = new Map(genealogy.map((g) => [g.agentId, g]));
+        const roots = genealogy.filter((g) => !g.parentAgentId || !geneById.has(g.parentAgentId));
+        const lines = [];
+        const walk = (node, prefix, isLast) => {
+            const agent = byId.get(node.agentId);
+            const label = agent
+                ? `${agent.name} #${agent.id} gen=${node.generation} [${agent.status}]`
+                : `${node.agentId} gen=${node.generation}`;
+            const branch = prefix === '' ? '' : isLast ? '└── ' : '├── ';
+            lines.push(`${prefix}${branch}${label}`);
+            const childPrefix = prefix === '' ? '' : prefix + (isLast ? '    ' : '│   ');
+            const children = node.children
+                .map((id) => geneById.get(id))
+                .filter((g) => !!g);
+            children.forEach((child, i) => {
+                walk(child, childPrefix, i === children.length - 1);
+            });
+        };
+        if (!roots.length) {
+            return '(empty genealogy)';
+        }
+        roots.forEach((root, i) => walk(root, '', i === roots.length - 1));
+        return lines.join('\n');
+    }
+}
+exports.GenealogyManager = GenealogyManager;
+//# sourceMappingURL=genealogy-manager.js.map

package/dist/genealogy/genealogy-manager.js.map

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

package/dist/governance/constitution.d.ts

@@ -0,0 +1,20 @@
+import type { PolicyRule } from '@hazeljs/agent';
+import type { ConstitutionDefinition, ConstitutionRule } from '../types/organism.types';
+import { OrganismEventEmitter } from '../events/organism-events';
+/**
+ * Compiles constitution rules into PolicyEngine-compatible rules and
+ * evaluates lifecycle actions against critical/high constraints.
+ */
+export declare class ConstitutionEnforcer {
+    private readonly constitution;
+    private readonly events;
+    private readonly organismId;
+    constructor(constitution: ConstitutionDefinition | undefined, events: OrganismEventEmitter, organismId: string);
+    getRules(): ConstitutionRule[];
+    /** Map critical/high textual rules into deny/approval PolicyEngine rules. */
+    toPolicyRules(): PolicyRule[];
+    assertAllows(action: string, context?: Record<string, unknown>): void;
+    /** Child may only inherit a subset of parent permissions / capabilities. */
+    subsetCapabilities(parent: string[], requested: string[]): string[];
+}
+//# sourceMappingURL=constitution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constitution.d.ts","sourceRoot":"","sources":["../../src/governance/constitution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAExF,OAAO,EAAE,oBAAoB,EAAqB,MAAM,2BAA2B,CAAC;AAEpF;;;GAGG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAFV,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM;IAGrC,QAAQ,IAAI,gBAAgB,EAAE;IAI9B,6EAA6E;IAC7E,aAAa,IAAI,UAAU,EAAE;IA+C7B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IA8CzE,4EAA4E;IAC5E,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAIpE"}

package/dist/governance/constitution.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConstitutionEnforcer = void 0;
+const organism_errors_1 = require("../errors/organism.errors");
+const organism_events_1 = require("../events/organism-events");
+/**
+ * Compiles constitution rules into PolicyEngine-compatible rules and
+ * evaluates lifecycle actions against critical/high constraints.
+ */
+class ConstitutionEnforcer {
+    constructor(constitution, events, organismId) {
+        this.constitution = constitution;
+        this.events = events;
+        this.organismId = organismId;
+    }
+    getRules() {
+        return this.constitution?.rules ?? [];
+    }
+    /** Map critical/high textual rules into deny/approval PolicyEngine rules. */
+    toPolicyRules() {
+        const rules = this.getRules();
+        const out = [];
+        for (const rule of rules) {
+            if (rule.severity !== 'critical' && rule.severity !== 'high')
+                continue;
+            const lower = rule.rule.toLowerCase();
+            if (lower.includes('pii') || lower.includes('personally identifiable')) {
+                out.push({
+                    id: `constitution:${rule.id}`,
+                    tool: '*',
+                    effect: 'deny',
+                    whenInputIncludes: 'ssn',
+                    reason: rule.rule,
+                    priority: 100,
+                });
+                out.push({
+                    id: `constitution:${rule.id}:email`,
+                    tool: '*',
+                    effect: 'mask',
+                    maskFields: ['email', 'phone', 'ssn', 'address'],
+                    reason: rule.rule,
+                    priority: 90,
+                });
+            }
+            if (lower.includes('refund') && (lower.includes('approval') || lower.includes('human'))) {
+                out.push({
+                    id: `constitution:${rule.id}`,
+                    tool: 'refund',
+                    effect: 'require_approval',
+                    reason: rule.rule,
+                    priority: 100,
+                });
+            }
+            if (lower.includes('budget') || lower.includes('never exceed')) {
+                out.push({
+                    id: `constitution:${rule.id}`,
+                    tool: '*',
+                    effect: 'require_approval',
+                    whenInputIncludes: 'override_budget',
+                    reason: rule.rule,
+                    priority: 100,
+                });
+            }
+        }
+        return out;
+    }
+    assertAllows(action, context = {}) {
+        for (const rule of this.getRules()) {
+            if (rule.severity !== 'critical' && rule.severity !== 'high')
+                continue;
+            const lower = rule.rule.toLowerCase();
+            if ((lower.includes('pii') || lower.includes('personally identifiable')) &&
+                context.exposesPii === true) {
+                void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_CONSTITUTION_VIOLATION, this.organismId, {
+                    ruleId: rule.id,
+                    action,
+                    rule: rule.rule,
+                });
+                throw new organism_errors_1.OrganismConstitutionError(`Constitution violation (${rule.id}): ${rule.rule}`);
+            }
+            if (lower.includes('budget') && context.exceedsBudget === true) {
+                void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_CONSTITUTION_VIOLATION, this.organismId, {
+                    ruleId: rule.id,
+                    action,
+                    rule: rule.rule,
+                });
+                throw new organism_errors_1.OrganismConstitutionError(`Constitution violation (${rule.id}): ${rule.rule}`);
+            }
+            if (lower.includes('refund') &&
+                typeof context.refundAmount === 'number' &&
+                context.refundAmount > 200 &&
+                context.humanApproved !== true) {
+                const match = lower.match(/\$?(\d+)/);
+                const limit = match ? Number(match[1]) : 200;
+                if (context.refundAmount > limit) {
+                    void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_CONSTITUTION_VIOLATION, this.organismId, { ruleId: rule.id, action, rule: rule.rule });
+                    throw new organism_errors_1.OrganismConstitutionError(`Constitution violation (${rule.id}): ${rule.rule}`);
+                }
+            }
+        }
+    }
+    /** Child may only inherit a subset of parent permissions / capabilities. */
+    subsetCapabilities(parent, requested) {
+        const allowed = new Set(parent);
+        return requested.filter((c) => allowed.has(c));
+    }
+}
+exports.ConstitutionEnforcer = ConstitutionEnforcer;
+//# sourceMappingURL=constitution.js.map