@hazeljs/organism 2.0.6

package/dist/core/organism-runtime.d.ts

@@ -0,0 +1,199 @@
+/**
+ * OrganismRuntime — mission-defined self-organizing agent society control plane.
+ * Composes AgentRuntime; does not replace the Agent OS kernel.
+ */
+import { AgentRuntime, type LLMProvider } from '@hazeljs/agent';
+import type { AgentGeneDefinition, AgentGenealogy, AgentMutation, AgentOutcomeReport, ConstitutionDefinition, EnvironmentDefinition, EnvironmentSignal, GenerationEvaluationResult, MarketClearingResult, MarketConfig, MissionDefinition, NegotiationOffer, NegotiationResult, OrganismCycleConfig, OrganismDecision, OrganismGraph, OrganismInspectState, OrganismLimits, OrganismRecord, ReproduceRequest, ResourceBid, ResourceDefinition, ResourceRequest, RuntimeAgentRecord, SignalNeedMapping, SurvivalConfig, UtilityForecast, UtilityWeights } from '../types/organism.types';
+import { OrganismEventEmitter } from '../events/organism-events';
+import { type OrganismRepository } from '../persistence/organism-repository';
+import { CapabilityRegistry } from './capability-registry';
+import { type ReproductionConfig } from '../lifecycle/reproduction-engine';
+import { OrganismAgentContext } from './organism-context';
+import { OrganismClock } from './clock';
+import { OrganismMetrics } from '../observability/metrics';
+type Newable = new (...args: unknown[]) => unknown;
+export interface CreateOrganismOptions {
+    id?: string;
+    mission: MissionDefinition | Newable;
+    genes?: Array<AgentGeneDefinition | Newable>;
+    environment?: EnvironmentDefinition | Newable;
+    constitution?: ConstitutionDefinition | Newable;
+    resources?: ResourceDefinition | Newable;
+    limits?: Partial<OrganismLimits>;
+    cycles?: OrganismCycleConfig;
+    signalNeedMappings?: SignalNeedMapping[];
+    survival?: Partial<SurvivalConfig>;
+    utilityWeights?: Partial<UtilityWeights>;
+    reproduction?: Partial<ReproductionConfig>;
+    market?: Partial<MarketConfig>;
+    repository?: OrganismRepository;
+    agentRuntime?: AgentRuntime;
+    llmProvider?: LLMProvider;
+    debug?: boolean;
+    simulation?: boolean;
+    /** Relevance threshold for perception (0-1). */
+    relevanceThreshold?: number;
+}
+export interface SimulateOptions {
+    duration: string | number;
+    environment?: {
+        clock?: 'accelerated' | 'real';
+    };
+    signals?: Array<Partial<EnvironmentSignal> & Pick<EnvironmentSignal, 'type' | 'source'>>;
+    stepMs?: number;
+    onEvent?: (line: string) => void;
+}
+export declare class OrganismRuntime {
+    readonly id: string;
+    readonly events: OrganismEventEmitter;
+    readonly metrics: OrganismMetrics;
+    readonly capabilities: CapabilityRegistry;
+    readonly clock: OrganismClock;
+    private record;
+    private readonly repo;
+    private readonly perception;
+    private readonly needDetector;
+    private readonly decisionEngine;
+    private readonly allocator;
+    private readonly utilityEngine;
+    private readonly reputationEngine;
+    private readonly survivalEngine;
+    private readonly forecaster;
+    private marketEngine;
+    private birthEngine;
+    private terminationEngine;
+    private reproductionEngine;
+    private genealogyManager;
+    private mutationEngine;
+    private evolutionEngine;
+    private generationManager;
+    private constitutionEnforcer;
+    private agentRuntime;
+    private cycleTimers;
+    private pendingApprovals;
+    private agentCache;
+    private reproductionConfig;
+    private debug;
+    private log;
+    private constructor();
+    static create(options: CreateOrganismOptions): Promise<OrganismRuntime>;
+    /** Resolve decorator-decorated organism class into create options. */
+    static fromClass(target: Newable, overrides?: Partial<CreateOrganismOptions>): Promise<OrganismRuntime>;
+    private static mergeDecoratorOptions;
+    private initialize;
+    private wireEngines;
+    /** Rebuild agent cache + capability index from durable repository (multi-replica hydrate). */
+    private hydrateAgentsFromRepository;
+    private reregisterAgentDna;
+    get status(): OrganismRecord['status'];
+    getMission(): MissionDefinition;
+    start(): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    terminate(): Promise<void>;
+    emergencyStop(): Promise<void>;
+    observe(raw: Partial<EnvironmentSignal> & Pick<EnvironmentSignal, 'type' | 'source'>): Promise<OrganismDecision | undefined>;
+    private applyDecision;
+    private spawnFromProposal;
+    /** Public spawn API for explicit births (still requires structured proposal). */
+    spawnAgent(input: {
+        reason: string;
+        objective: string;
+        needId: string;
+        requiredCapabilities: string[];
+        parentAgentId?: string;
+        specialize?: string[];
+        geneId?: string;
+        confidence?: number;
+        terminationCriteria?: string[];
+        tokens?: number;
+    }): Promise<RuntimeAgentRecord>;
+    terminateAgent(agentId: string, opts?: {
+        reason: string;
+    }): Promise<void>;
+    reportOutcome(agentId: string, report: AgentOutcomeReport): Promise<void>;
+    runSurvivalCycle(): Promise<SurvivalReport[]>;
+    inspect(): Promise<OrganismInspectState>;
+    getGenealogy(): Promise<AgentGenealogy[]>;
+    formatGenealogy(): Promise<string>;
+    /**
+     * Phase 2 — create a specialized descendant from an existing agent.
+     */
+    reproduceAgent(parentAgentId: string, request: ReproduceRequest): Promise<RuntimeAgentRecord>;
+    /**
+     * Phase 3 — apply a constrained, auditable mutation.
+     */
+    mutateAgent(agentId: string, input: {
+        reason: string;
+        mutation: AgentMutation;
+    }): Promise<RuntimeAgentRecord>;
+    /**
+     * Phase 3 — evaluate a competing population and promote the winner's strategy id.
+     */
+    evaluateGeneration(input: {
+        population: string[];
+        populationId?: string;
+        promoteToLosers?: boolean;
+    }): Promise<GenerationEvaluationResult>;
+    getEvolutionaryHistory(limit?: number): import('../types/organism.types').EvolutionaryHistoryEntry[];
+    /** Phase 4 — forecast expected utility / opportunity cost for a resource request. */
+    forecastUtility(input: {
+        agentId: string;
+        requested: ResourceRequest;
+        expectedValue: number;
+        confidence: number;
+        urgency?: number;
+    }): Promise<UtilityForecast>;
+    /** Phase 4 — place a resource bid into the internal market. */
+    placeBid(input: {
+        agentId: string;
+        reason: string;
+        requested: ResourceRequest;
+        expectedValue: number;
+        confidence: number;
+        urgency?: number;
+        bidPrice?: number;
+        ttlMs?: number;
+    }): ResourceBid;
+    listOpenBids(): ResourceBid[];
+    /** Phase 4 — clear open bids against the organism pool. */
+    clearMarket(): Promise<MarketClearingResult>;
+    /** Phase 4 — peer resource negotiation between two agents. */
+    negotiate(offer: NegotiationOffer): Promise<NegotiationResult>;
+    /**
+     * Phase 4 — negotiate-aware resource request (forecast first, then allocate).
+     */
+    requestResourcesForAgent(agentId: string, input: {
+        reason: string;
+        requested: ResourceRequest;
+        expectedValue?: number;
+        confidence?: number;
+        urgency?: number;
+        useMarket?: boolean;
+    }): Promise<{
+        approved: boolean;
+        reason: string;
+        wallet?: import('../types/organism.types').AgentResourceWallet;
+        forecast?: UtilityForecast;
+    }>;
+    getMarketHistory(limit?: number): MarketClearingResult[];
+    getGraph(): Promise<OrganismGraph>;
+    createAgentContext(agentId: string): OrganismAgentContext;
+    /** Grant/deny a pending human approval key (for tests / HITL bridge). */
+    setApproval(action: string, reason: string, approved: boolean): void;
+    simulate(options: SimulateOptions): Promise<OrganismInspectState>;
+    getAgentRuntime(): AgentRuntime;
+    getRecord(): OrganismRecord;
+    listAgents(): Promise<RuntimeAgentRecord[]>;
+    listEvents(limit?: number): Promise<import('../events/organism-events').OrganismEvent[]>;
+    private syncGetAgent;
+    private liveAgents;
+    private delegateInternal;
+    private startCycles;
+    private stopCycles;
+    private persist;
+}
+export type SurvivalReport = import('../lifecycle/survival-engine').SurvivalVerdict;
+export declare function createOrganism(options: CreateOrganismOptions): Promise<OrganismRuntime>;
+export {};
+//# sourceMappingURL=organism-runtime.d.ts.map

package/dist/core/organism-runtime.d.ts.map

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