@agent-e/server 1.6.4 → 1.6.6

package/dist/cli.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.mts

@@ -0,0 +1,87 @@
+import * as _agent_e_core from '@agent-e/core';
+import { AgentEConfig, AgentE, EconomyState, EconomicEvent, Diagnosis, AgentEMode } from '@agent-e/core';
+
+interface ServerConfig {
+    port?: number;
+    host?: string;
+    agentE?: Partial<Omit<AgentEConfig, 'adapter'>>;
+    validateState?: boolean;
+    corsOrigin?: string;
+    serveDashboard?: boolean;
+}
+interface EnrichedAdjustment {
+    parameter: string;
+    value: number;
+    scope?: _agent_e_core.ParameterScope;
+    reasoning: string;
+}
+declare class AgentEServer {
+    private readonly agentE;
+    private readonly server;
+    private lastState;
+    private adjustmentQueue;
+    private alerts;
+    readonly port: number;
+    private readonly host;
+    private readonly thresholds;
+    private readonly startedAt;
+    private wsHandle;
+    readonly validateState: boolean;
+    readonly corsOrigin: string;
+    readonly serveDashboard: boolean;
+    constructor(config?: ServerConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getAgentE(): AgentE;
+    getAddress(): {
+        port: number;
+        host: string;
+    };
+    getUptime(): number;
+    /**
+     * Process a tick with the given state.
+     * 1. Clear adjustment queue
+     * 2. Set state
+     * 3. Ingest events
+     * 4. Run agentE.tick(state)
+     * 5. Drain adjustment queue, enrich with reasoning from decisions
+     * 6. Return response
+     */
+    processTick(state: EconomyState, events?: EconomicEvent[]): Promise<{
+        adjustments: EnrichedAdjustment[];
+        alerts: Diagnosis[];
+        health: number;
+        tick: number;
+        decisions: ReturnType<AgentE['getDecisions']>;
+    }>;
+    /**
+     * Run Observer + Diagnoser on the given state without side effects (no execution).
+     * Computes fresh metrics from the state rather than reading stored metrics.
+     */
+    diagnoseOnly(state: EconomyState): {
+        diagnoses: ReturnType<AgentE['diagnoseNow']>;
+        health: number;
+    };
+    setMode(mode: AgentEMode): void;
+    lock(param: string): void;
+    unlock(param: string): void;
+    constrain(param: string, bounds: {
+        min: number;
+        max: number;
+    }): void;
+    broadcast(data: Record<string, unknown>): void;
+}
+
+/**
+ * Quick-start helper — creates and starts an AgentE server.
+ *
+ * @example
+ * ```ts
+ * import { startServer } from '@agent-e/server';
+ * const server = await startServer({ port: 3100 });
+ * // POST /tick, GET /health, etc.
+ * ```
+ */
+declare function startServer(config?: ServerConfig): Promise<AgentEServer>;
+
+export { AgentEServer, type EnrichedAdjustment, type ServerConfig, startServer };

package/dist/index.d.ts

@@ -0,0 +1,87 @@
+import * as _agent_e_core from '@agent-e/core';
+import { AgentEConfig, AgentE, EconomyState, EconomicEvent, Diagnosis, AgentEMode } from '@agent-e/core';
+
+interface ServerConfig {
+    port?: number;
+    host?: string;
+    agentE?: Partial<Omit<AgentEConfig, 'adapter'>>;
+    validateState?: boolean;
+    corsOrigin?: string;
+    serveDashboard?: boolean;
+}
+interface EnrichedAdjustment {
+    parameter: string;
+    value: number;
+    scope?: _agent_e_core.ParameterScope;
+    reasoning: string;
+}
+declare class AgentEServer {
+    private readonly agentE;
+    private readonly server;
+    private lastState;
+    private adjustmentQueue;
+    private alerts;
+    readonly port: number;
+    private readonly host;
+    private readonly thresholds;
+    private readonly startedAt;
+    private wsHandle;
+    readonly validateState: boolean;
+    readonly corsOrigin: string;
+    readonly serveDashboard: boolean;
+    constructor(config?: ServerConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getAgentE(): AgentE;
+    getAddress(): {
+        port: number;
+        host: string;
+    };
+    getUptime(): number;
+    /**
+     * Process a tick with the given state.
+     * 1. Clear adjustment queue
+     * 2. Set state
+     * 3. Ingest events
+     * 4. Run agentE.tick(state)
+     * 5. Drain adjustment queue, enrich with reasoning from decisions
+     * 6. Return response
+     */
+    processTick(state: EconomyState, events?: EconomicEvent[]): Promise<{
+        adjustments: EnrichedAdjustment[];
+        alerts: Diagnosis[];
+        health: number;
+        tick: number;
+        decisions: ReturnType<AgentE['getDecisions']>;
+    }>;
+    /**
+     * Run Observer + Diagnoser on the given state without side effects (no execution).
+     * Computes fresh metrics from the state rather than reading stored metrics.
+     */
+    diagnoseOnly(state: EconomyState): {
+        diagnoses: ReturnType<AgentE['diagnoseNow']>;
+        health: number;
+    };
+    setMode(mode: AgentEMode): void;
+    lock(param: string): void;
+    unlock(param: string): void;
+    constrain(param: string, bounds: {
+        min: number;
+        max: number;
+    }): void;
+    broadcast(data: Record<string, unknown>): void;
+}
+
+/**
+ * Quick-start helper — creates and starts an AgentE server.
+ *
+ * @example
+ * ```ts
+ * import { startServer } from '@agent-e/server';
+ * const server = await startServer({ port: 3100 });
+ * // POST /tick, GET /health, etc.
+ * ```
+ */
+declare function startServer(config?: ServerConfig): Promise<AgentEServer>;
+
+export { AgentEServer, type EnrichedAdjustment, type ServerConfig, startServer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-e/server",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "description": "Ready-to-run HTTP + WebSocket server for AgentE",
   "license": "MIT",
   "repository": {