@hazeljs/organism 2.0.6

package/dist/economy/resource-allocator.d.ts

@@ -0,0 +1,39 @@
+import type { AgentResourceWallet, OrganismLimits, OrganismRecord, ResourceRequest, RuntimeAgentRecord } from '../types/organism.types';
+import { OrganismEventEmitter } from '../events/organism-events';
+export interface AllocationRequest {
+    agentId: string;
+    requestedResources: ResourceRequest;
+    expectedUtility: number;
+    confidence: number;
+    urgency: number;
+    reputationScore?: number;
+    missionPriority?: number;
+}
+export interface AllocationResult {
+    approved: boolean;
+    wallet: AgentResourceWallet;
+    score: number;
+    reason: string;
+}
+/**
+ * Deterministic weighted resource allocator.
+ */
+export declare class ResourceAllocator {
+    private readonly events;
+    private readonly organismId;
+    private readonly now;
+    private spawnTimestamps;
+    constructor(events: OrganismEventEmitter, organismId: string, now?: () => Date);
+    score(request: AllocationRequest): number;
+    canSpawn(record: OrganismRecord, liveAgentCount: number): {
+        ok: boolean;
+        reason: string;
+    };
+    recordSpawn(): void;
+    allocate(record: OrganismRecord, request: AllocationRequest): AllocationResult;
+    release(record: OrganismRecord, agent: RuntimeAgentRecord): void;
+    assertWithinLimits(_limits: OrganismLimits): void;
+}
+export declare function createEmptyWallet(): AgentResourceWallet;
+export declare function throwIfDenied(result: AllocationResult): void;
+//# sourceMappingURL=resource-allocator.d.ts.map

package/dist/economy/resource-allocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-allocator.d.ts","sourceRoot":"","sources":["../../src/economy/resource-allocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAqB,MAAM,2BAA2B,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,eAAe,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,eAAe,CAAgB;gBAGpB,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,IAAuB;IAGrD,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IASzC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IA2BzF,WAAW,IAAI,IAAI;IAInB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;IAwE9E,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAchE,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;CAGlD;AAMD,wBAAgB,iBAAiB,IAAI,mBAAmB,CAOvD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAI5D"}

package/dist/economy/resource-allocator.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceAllocator = void 0;
+exports.createEmptyWallet = createEmptyWallet;
+exports.throwIfDenied = throwIfDenied;
+const organism_errors_1 = require("../errors/organism.errors");
+const organism_events_1 = require("../events/organism-events");
+/**
+ * Deterministic weighted resource allocator.
+ */
+class ResourceAllocator {
+    constructor(events, organismId, now = () => new Date()) {
+        this.events = events;
+        this.organismId = organismId;
+        this.now = now;
+        this.spawnTimestamps = [];
+    }
+    score(request) {
+        const utility = clamp(request.expectedUtility, 0, 1);
+        const confidence = clamp(request.confidence, 0, 1);
+        const urgency = clamp(request.urgency, 0, 1);
+        const reputation = clamp(request.reputationScore ?? 0.5, 0, 1);
+        const priority = clamp(request.missionPriority ?? 0.5, 0, 1);
+        return utility * 0.3 + confidence * 0.2 + urgency * 0.2 + reputation * 0.2 + priority * 0.1;
+    }
+    canSpawn(record, liveAgentCount) {
+        if (record.emergencyStopped) {
+            return { ok: false, reason: 'Emergency stop active' };
+        }
+        if (record.status === 'paused' || record.status === 'terminated') {
+            return { ok: false, reason: `Organism is ${record.status}` };
+        }
+        if (liveAgentCount >= record.limits.maxAgents) {
+            return { ok: false, reason: `maxAgents (${record.limits.maxAgents}) reached` };
+        }
+        const now = this.now().getTime();
+        this.spawnTimestamps = this.spawnTimestamps.filter((t) => now - t < 60000);
+        if (this.spawnTimestamps.length >= record.limits.maxSpawnRatePerMinute) {
+            return {
+                ok: false,
+                reason: `maxSpawnRatePerMinute (${record.limits.maxSpawnRatePerMinute}) exceeded`,
+            };
+        }
+        if (record.pool.costSpentThisHour >= record.limits.maxTotalCostPerHour) {
+            return {
+                ok: false,
+                reason: `maxTotalCostPerHour ($${record.limits.maxTotalCostPerHour}) exceeded`,
+            };
+        }
+        return { ok: true, reason: 'ok' };
+    }
+    recordSpawn() {
+        this.spawnTimestamps.push(this.now().getTime());
+    }
+    allocate(record, request) {
+        const score = this.score(request);
+        const tokens = request.requestedResources.tokens ?? 0;
+        const money = request.requestedResources.money ?? 0;
+        if (tokens > record.pool.tokensRemaining) {
+            const result = {
+                approved: false,
+                wallet: {},
+                score,
+                reason: `Insufficient tokens (need ${tokens}, have ${record.pool.tokensRemaining})`,
+            };
+            void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_RESOURCE_DENIED, this.organismId, {
+                agentId: request.agentId,
+                ...result,
+            });
+            return result;
+        }
+        if (money > record.pool.moneyRemaining.amount) {
+            const result = {
+                approved: false,
+                wallet: {},
+                score,
+                reason: `Insufficient money (need ${money}, have ${record.pool.moneyRemaining.amount})`,
+            };
+            void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_RESOURCE_DENIED, this.organismId, {
+                agentId: request.agentId,
+                ...result,
+            });
+            return result;
+        }
+        if (score < 0.15 && (tokens > 0 || money > 0)) {
+            const result = {
+                approved: false,
+                wallet: {},
+                score,
+                reason: `Allocation score too low (${score.toFixed(3)})`,
+            };
+            void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_RESOURCE_DENIED, this.organismId, {
+                agentId: request.agentId,
+                ...result,
+            });
+            return result;
+        }
+        record.pool.tokensRemaining -= tokens;
+        record.pool.moneyRemaining.amount -= money;
+        const wallet = {
+            tokensRemaining: tokens || undefined,
+            moneyRemaining: money > 0 ? { amount: money, currency: record.pool.moneyRemaining.currency } : undefined,
+            computeUnitsRemaining: request.requestedResources.computeUnits,
+            toolCallsRemaining: request.requestedResources.toolCalls,
+        };
+        const result = {
+            approved: true,
+            wallet,
+            score,
+            reason: 'Allocated',
+        };
+        void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_RESOURCE_ALLOCATED, this.organismId, {
+            agentId: request.agentId,
+            wallet,
+            score,
+        });
+        return result;
+    }
+    release(record, agent) {
+        const tokens = agent.wallet.tokensRemaining ?? 0;
+        const money = agent.wallet.moneyRemaining?.amount ?? 0;
+        record.pool.tokensRemaining += tokens;
+        record.pool.moneyRemaining.amount += money;
+        agent.wallet = {
+            tokensRemaining: 0,
+            moneyRemaining: {
+                amount: 0,
+                currency: record.pool.moneyRemaining.currency,
+            },
+        };
+    }
+    assertWithinLimits(_limits) {
+        // reserved for future hard asserts
+    }
+}
+exports.ResourceAllocator = ResourceAllocator;
+function clamp(n, min, max) {
+    return Math.max(min, Math.min(max, n));
+}
+function createEmptyWallet() {
+    return {
+        tokensRemaining: 0,
+        moneyRemaining: { amount: 0, currency: 'USD' },
+        computeUnitsRemaining: 0,
+        toolCallsRemaining: 0,
+    };
+}
+function throwIfDenied(result) {
+    if (!result.approved) {
+        throw new organism_errors_1.OrganismResourceDeniedError(result.reason);
+    }
+}
+//# sourceMappingURL=resource-allocator.js.map

package/dist/economy/resource-allocator.js.map

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

package/dist/economy/utility-engine.d.ts

@@ -0,0 +1,16 @@
+import type { AgentOutcomeReport, AgentReputation, RuntimeAgentRecord, UtilityScore, UtilityWeights } from '../types/organism.types';
+import { OrganismEventEmitter } from '../events/organism-events';
+export declare class UtilityEngine {
+    private readonly events;
+    private readonly organismId;
+    private readonly weights;
+    constructor(events: OrganismEventEmitter, organismId: string, weights?: UtilityWeights);
+    evaluate(agent: RuntimeAgentRecord, report?: AgentOutcomeReport): UtilityScore;
+}
+export declare class ReputationEngine {
+    private readonly events;
+    private readonly organismId;
+    constructor(events: OrganismEventEmitter, organismId: string);
+    update(agent: RuntimeAgentRecord, report: AgentOutcomeReport): AgentReputation;
+}
+//# sourceMappingURL=utility-engine.d.ts.map

package/dist/economy/utility-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-engine.d.ts","sourceRoot":"","sources":["../../src/economy/utility-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAqB,MAAM,2BAA2B,CAAC;AAEpF,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAwB;IAGpD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY;CAuC/E;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM;IAGrC,MAAM,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,GAAG,eAAe;CAkC/E"}

package/dist/economy/utility-engine.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReputationEngine = exports.UtilityEngine = void 0;
+const organism_types_1 = require("../types/organism.types");
+const organism_events_1 = require("../events/organism-events");
+class UtilityEngine {
+    constructor(events, organismId, weights = organism_types_1.DEFAULT_UTILITY_WEIGHTS) {
+        this.events = events;
+        this.organismId = organismId;
+        this.weights = weights;
+    }
+    evaluate(agent, report) {
+        const valueGenerated = report?.metrics?.valueGenerated ?? agent.valueGenerated;
+        const cost = report?.metrics?.cost ?? agent.costConsumed;
+        const riskPenalty = report?.metrics?.riskPenalty ?? 0;
+        const confidence = report?.metrics?.confidence ?? agent.utility.confidence;
+        const missionContribution = clamp(valueGenerated / Math.max(1, valueGenerated + cost * 10), 0, 1);
+        const efficiency = cost <= 0 ? 1 : clamp(valueGenerated / (valueGenerated + cost * 50), 0, 1);
+        const reliability = clamp(agent.reputation.dimensions.reliability, 0, 1);
+        const policyCompliance = clamp(agent.reputation.dimensions.policyCompliance, 0, 1);
+        const collaboration = clamp(agent.reputation.dimensions.collaboration, 0, 1);
+        const score = missionContribution * this.weights.missionContribution +
+            reliability * this.weights.reliability +
+            efficiency * this.weights.efficiency +
+            policyCompliance * this.weights.policyCompliance +
+            collaboration * this.weights.collaboration -
+            riskPenalty;
+        const utility = {
+            score: clamp(score, 0, 1),
+            valueGenerated,
+            cost,
+            riskPenalty,
+            confidence: clamp(confidence, 0, 1),
+        };
+        void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_UTILITY_CALCULATED, this.organismId, {
+            agentId: agent.id,
+            utility,
+        });
+        return utility;
+    }
+}
+exports.UtilityEngine = UtilityEngine;
+class ReputationEngine {
+    constructor(events, organismId) {
+        this.events = events;
+        this.organismId = organismId;
+    }
+    update(agent, report) {
+        const value = report.metrics?.valueGenerated ?? 0;
+        const confidence = report.metrics?.confidence ?? 0.5;
+        const cost = report.metrics?.cost ?? 0;
+        const usefulnessDelta = clamp(value / 1000, -0.1, 0.15);
+        const efficiencyDelta = cost > value * 0.1 ? -0.05 : 0.03;
+        const reliabilityDelta = confidence >= 0.7 ? 0.04 : -0.03;
+        const dims = { ...agent.reputation.dimensions };
+        dims.usefulness = clamp(dims.usefulness + usefulnessDelta, 0, 1);
+        dims.efficiency = clamp(dims.efficiency + efficiencyDelta, 0, 1);
+        dims.reliability = clamp(dims.reliability + reliabilityDelta, 0, 1);
+        const score = dims.usefulness * 0.3 +
+            dims.reliability * 0.25 +
+            dims.efficiency * 0.2 +
+            dims.policyCompliance * 0.15 +
+            dims.collaboration * 0.1;
+        const reputation = {
+            agentId: agent.id,
+            score: clamp(score, 0, 1),
+            dimensions: dims,
+        };
+        void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_REPUTATION_CHANGED, this.organismId, {
+            agentId: agent.id,
+            reputation,
+        });
+        return reputation;
+    }
+}
+exports.ReputationEngine = ReputationEngine;
+function clamp(n, min, max) {
+    return Math.max(min, Math.min(max, n));
+}
+//# sourceMappingURL=utility-engine.js.map

package/dist/economy/utility-engine.js.map

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

package/dist/economy/utility-forecaster.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Phase 4 — utility forecasting and opportunity-cost estimates.
+ */
+import type { OpportunityCostEstimate, OrganismRecord, ResourceRequest, RuntimeAgentRecord, UtilityForecast } from '../types/organism.types';
+import { OrganismEventEmitter } from '../events/organism-events';
+export declare class UtilityForecaster {
+    private readonly events;
+    private readonly organismId;
+    constructor(events: OrganismEventEmitter, organismId: string);
+    /**
+     * Deterministic forecast: expected value × confidence − opportunity cost,
+     * adjusted by reputation and scarcity.
+     */
+    forecast(input: {
+        agent: RuntimeAgentRecord;
+        record: OrganismRecord;
+        requested: ResourceRequest;
+        expectedValue: number;
+        confidence: number;
+        urgency?: number;
+    }): UtilityForecast;
+    opportunityCost(record: OrganismRecord, requested: ResourceRequest): OpportunityCostEstimate;
+}
+//# sourceMappingURL=utility-forecaster.d.ts.map

package/dist/economy/utility-forecaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-forecaster.d.ts","sourceRoot":"","sources":["../../src/economy/utility-forecaster.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAqB,MAAM,2BAA2B,CAAC;AAEpF,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM;IAGrC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE;QACd,KAAK,EAAE,kBAAkB,CAAC;QAC1B,MAAM,EAAE,cAAc,CAAC;QACvB,SAAS,EAAE,eAAe,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,eAAe;IA8BnB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,GAAG,uBAAuB;CAuB7F"}

package/dist/economy/utility-forecaster.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Phase 4 — utility forecasting and opportunity-cost estimates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UtilityForecaster = void 0;
+const organism_events_1 = require("../events/organism-events");
+class UtilityForecaster {
+    constructor(events, organismId) {
+        this.events = events;
+        this.organismId = organismId;
+    }
+    /**
+     * Deterministic forecast: expected value × confidence − opportunity cost,
+     * adjusted by reputation and scarcity.
+     */
+    forecast(input) {
+        const { agent, record, requested, expectedValue, confidence } = input;
+        const urgency = input.urgency ?? 0.5;
+        const opportunity = this.opportunityCost(record, requested);
+        const reputationBoost = 0.5 + agent.reputation.score * 0.5;
+        const adjustedValue = expectedValue * clamp(confidence, 0, 1) * reputationBoost;
+        const estimatedCost = (requested.tokens ?? 0) * 0.00001 + (requested.money ?? 0) + opportunity.total * 0.1;
+        const netExpectedValue = adjustedValue - opportunity.total - estimatedCost;
+        const expectedUtility = clamp((netExpectedValue / Math.max(1, expectedValue + opportunity.total)) * (0.5 + urgency * 0.5), 0, 1);
+        const forecast = {
+            agentId: agent.id,
+            expectedUtility,
+            expectedValue,
+            estimatedCost,
+            opportunityCost: opportunity.total,
+            netExpectedValue,
+            confidence: clamp(confidence, 0, 1),
+            reasoningSummary: `net=${netExpectedValue.toFixed(2)} (value=${adjustedValue.toFixed(2)} - opp=${opportunity.total.toFixed(2)} - cost=${estimatedCost.toFixed(2)}); scarcity=${opportunity.scarcityMultiplier.toFixed(2)}`,
+        };
+        void this.events.emit(organism_events_1.OrganismEventType.ORGANISM_UTILITY_FORECAST, this.organismId, forecast);
+        return forecast;
+    }
+    opportunityCost(record, requested) {
+        const tokenBudget = Math.max(1, (record.resources.tokenBudget ?? record.pool.tokensRemaining) || 1);
+        const moneyBudget = Math.max(1, (record.resources.monthlyBudget?.amount ?? record.pool.moneyRemaining.amount) || 1);
+        const tokenUtil = 1 - record.pool.tokensRemaining / tokenBudget;
+        const moneyUtil = 1 - record.pool.moneyRemaining.amount / moneyBudget;
+        const utilization = Math.max(tokenUtil, moneyUtil);
+        const scarcityMultiplier = utilization < 0.7 ? 1 : 1 + (utilization - 0.7) * 5;
+        const tokens = (requested.tokens ?? 0) * 0.00002 * scarcityMultiplier;
+        const money = (requested.money ?? 0) * scarcityMultiplier;
+        return {
+            tokens,
+            money,
+            scarcityMultiplier,
+            total: tokens + money,
+        };
+    }
+}
+exports.UtilityForecaster = UtilityForecaster;
+function clamp(n, min, max) {
+    return Math.max(min, Math.min(max, n));
+}
+//# sourceMappingURL=utility-forecaster.js.map

package/dist/economy/utility-forecaster.js.map

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

package/dist/errors/organism.errors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @hazeljs/organism errors
+ */
+export declare class OrganismError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+export declare class OrganismLimitError extends OrganismError {
+    constructor(message: string);
+}
+export declare class OrganismResourceDeniedError extends OrganismError {
+    constructor(message: string);
+}
+export declare class OrganismConstitutionError extends OrganismError {
+    constructor(message: string);
+}
+export declare class OrganismStateError extends OrganismError {
+    constructor(message: string);
+}
+export declare class OrganismNotFoundError extends OrganismError {
+    constructor(message: string);
+}
+//# sourceMappingURL=organism.errors.d.ts.map

package/dist/errors/organism.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organism.errors.d.ts","sourceRoot":"","sources":["../../src/errors/organism.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAmB;CAKrD;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors/organism.errors.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * @hazeljs/organism errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrganismNotFoundError = exports.OrganismStateError = exports.OrganismConstitutionError = exports.OrganismResourceDeniedError = exports.OrganismLimitError = exports.OrganismError = void 0;
+class OrganismError extends Error {
+    constructor(message, code = 'ORGANISM_ERROR') {
+        super(message);
+        this.name = 'OrganismError';
+        this.code = code;
+    }
+}
+exports.OrganismError = OrganismError;
+class OrganismLimitError extends OrganismError {
+    constructor(message) {
+        super(message, 'ORGANISM_LIMIT');
+        this.name = 'OrganismLimitError';
+    }
+}
+exports.OrganismLimitError = OrganismLimitError;
+class OrganismResourceDeniedError extends OrganismError {
+    constructor(message) {
+        super(message, 'ORGANISM_RESOURCE_DENIED');
+        this.name = 'OrganismResourceDeniedError';
+    }
+}
+exports.OrganismResourceDeniedError = OrganismResourceDeniedError;
+class OrganismConstitutionError extends OrganismError {
+    constructor(message) {
+        super(message, 'ORGANISM_CONSTITUTION');
+        this.name = 'OrganismConstitutionError';
+    }
+}
+exports.OrganismConstitutionError = OrganismConstitutionError;
+class OrganismStateError extends OrganismError {
+    constructor(message) {
+        super(message, 'ORGANISM_STATE');
+        this.name = 'OrganismStateError';
+    }
+}
+exports.OrganismStateError = OrganismStateError;
+class OrganismNotFoundError extends OrganismError {
+    constructor(message) {
+        super(message, 'ORGANISM_NOT_FOUND');
+        this.name = 'OrganismNotFoundError';
+    }
+}
+exports.OrganismNotFoundError = OrganismNotFoundError;
+//# sourceMappingURL=organism.errors.js.map

package/dist/errors/organism.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organism.errors.js","sourceRoot":"","sources":["../../src/errors/organism.errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,MAAa,aAAc,SAAQ,KAAK;IAEtC,YAAY,OAAe,EAAE,IAAI,GAAG,gBAAgB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAPD,sCAOC;AAED,MAAa,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED,MAAa,2BAA4B,SAAQ,aAAa;IAC5D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AALD,kEAKC;AAED,MAAa,yBAA0B,SAAQ,aAAa;IAC1D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AALD,8DAKC;AAED,MAAa,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED,MAAa,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC"}

package/dist/events/organism-events.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Organism domain events (namespaced; separate from AgentEventType).
+ */
+export declare enum OrganismEventType {
+    ORGANISM_CREATED = "organism.created",
+    ORGANISM_RESTORED = "organism.restored",
+    ORGANISM_STARTED = "organism.started",
+    ORGANISM_PAUSED = "organism.paused",
+    ORGANISM_RESUMED = "organism.resumed",
+    ORGANISM_COMPLETED = "organism.completed",
+    ORGANISM_TERMINATED = "organism.terminated",
+    ORGANISM_EMERGENCY_STOP = "organism.emergency_stop",
+    ENVIRONMENT_SIGNAL_RECEIVED = "environment.signal.received",
+    ORGANISM_NEED_DETECTED = "organism.need.detected",
+    ORGANISM_AGENT_BORN = "organism.agent.born",
+    ORGANISM_AGENT_SPECIALIZED = "organism.agent.specialized",
+    ORGANISM_AGENT_REPRODUCED = "organism.agent.reproduced",
+    ORGANISM_AGENT_MUTATED = "organism.agent.mutated",
+    ORGANISM_AGENT_SUSPENDED = "organism.agent.suspended",
+    ORGANISM_AGENT_TERMINATED = "organism.agent.terminated",
+    ORGANISM_RESOURCE_ALLOCATED = "organism.resource.allocated",
+    ORGANISM_RESOURCE_DENIED = "organism.resource.denied",
+    ORGANISM_RESOURCE_BID = "organism.resource.bid",
+    ORGANISM_MARKET_CLEARED = "organism.market.cleared",
+    ORGANISM_NEGOTIATION = "organism.negotiation",
+    ORGANISM_UTILITY_FORECAST = "organism.utility.forecast",
+    ORGANISM_REPUTATION_CHANGED = "organism.reputation.changed",
+    ORGANISM_UTILITY_CALCULATED = "organism.utility.calculated",
+    ORGANISM_GENERATION_CREATED = "organism.generation.created",
+    ORGANISM_STRATEGY_PROMOTED = "organism.strategy.promoted",
+    ORGANISM_CONSTITUTION_VIOLATION = "organism.constitution.violation",
+    ORGANISM_MISSION_PROGRESS = "organism.mission.progress",
+    ORGANISM_MISSION_COMPLETED = "organism.mission.completed",
+    ORGANISM_DECISION = "organism.decision"
+}
+export interface OrganismEvent<T = unknown> {
+    type: OrganismEventType;
+    organismId: string;
+    timestamp: Date;
+    data: T;
+    metadata?: Record<string, unknown>;
+}
+type EventHandler<T = unknown> = (event: OrganismEvent<T>) => void | Promise<void>;
+export declare class OrganismEventEmitter {
+    private handlers;
+    private wildcardHandlers;
+    private history;
+    private maxHistory;
+    constructor(options?: {
+        maxHistory?: number;
+    });
+    on<T = unknown>(type: OrganismEventType, handler: EventHandler<T>): void;
+    onAny(handler: EventHandler): void;
+    off(type: OrganismEventType, handler: EventHandler): void;
+    offAny(handler: EventHandler): void;
+    emit<T = unknown>(type: OrganismEventType, organismId: string, data: T, metadata?: Record<string, unknown>): Promise<OrganismEvent<T>>;
+    getHistory(limit?: number): OrganismEvent[];
+    clearHistory(): void;
+}
+export {};
+//# sourceMappingURL=organism-events.d.ts.map

package/dist/events/organism-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organism-events.d.ts","sourceRoot":"","sources":["../../src/events/organism-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,iBAAiB;IAC3B,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAC3C,uBAAuB,4BAA4B;IAEnD,2BAA2B,gCAAgC;IAC3D,sBAAsB,2BAA2B;IAEjD,mBAAmB,wBAAwB;IAC3C,0BAA0B,+BAA+B;IACzD,yBAAyB,8BAA8B;IACvD,sBAAsB,2BAA2B;IACjD,wBAAwB,6BAA6B;IACrD,yBAAyB,8BAA8B;IAEvD,2BAA2B,gCAAgC;IAC3D,wBAAwB,6BAA6B;IACrD,qBAAqB,0BAA0B;IAC/C,uBAAuB,4BAA4B;IACnD,oBAAoB,yBAAyB;IAC7C,yBAAyB,8BAA8B;IAEvD,2BAA2B,gCAAgC;IAC3D,2BAA2B,gCAAgC;IAE3D,2BAA2B,gCAAgC;IAC3D,0BAA0B,+BAA+B;IAEzD,+BAA+B,oCAAoC;IACnE,yBAAyB,8BAA8B;IACvD,0BAA0B,+BAA+B;IAEzD,iBAAiB,sBAAsB;CACxC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,KAAK,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAmD;IACnE,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAIjD,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAOxE,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIlC,GAAG,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAIzD,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI7B,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAyB5B,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAK3C,YAAY,IAAI,IAAI;CAGrB"}