@neotx/core 0.1.0-alpha.21 → 0.1.0-alpha.22

package/dist/index.d.ts

@@ -132,6 +132,10 @@ declare const globalConfigSchema: z.ZodObject<{
         maxDurationMs: z.ZodDefault<z.ZodNumber>;
         dir: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
+    journal: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+        maxCostJournalSizeBytes: z.ZodDefault<z.ZodNumber>;
+        maxEventJournalSizeBytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
     webhooks: z.ZodDefault<z.ZodArray<z.ZodObject<{
         url: z.ZodString;
         events: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -206,6 +210,10 @@ declare const neoConfigSchema: z.ZodObject<{
         maxDurationMs: z.ZodDefault<z.ZodNumber>;
         dir: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
+    journal: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+        maxCostJournalSizeBytes: z.ZodDefault<z.ZodNumber>;
+        maxEventJournalSizeBytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
     webhooks: z.ZodDefault<z.ZodArray<z.ZodObject<{
         url: z.ZodString;
         events: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -451,6 +459,7 @@ interface ActiveSession {
 interface OrchestratorStatus {
     paused: boolean;
     activeSessions: ActiveSession[];
+    activeRunCount: number;
     queueDepth: number;
     costToday: number;
     budgetCapUsd: number;
@@ -699,8 +708,10 @@ declare class CostJournal {
     private readonly dir;
     private readonly dirCache;
     private dayCache;
+    private readonly maxFileSizeBytes;
     constructor(options: {
         dir: string;
+        maxFileSizeBytes?: number;
     });
     append(entry: CostEntry): Promise<void>;
     getDayTotal(date?: Date): Promise<number>;
@@ -731,8 +742,10 @@ declare class NeoEventEmitter {
 declare class EventJournal {
     private readonly dir;
     private readonly dirCache;
+    private readonly maxFileSizeBytes;
     constructor(options: {
         dir: string;
+        maxFileSizeBytes?: number;
     });
     append(event: NeoEvent): Promise<void>;
 }
@@ -836,9 +849,11 @@ declare function buildSandboxConfig(agent: ResolvedAgent, sessionPath?: string):
  * File per session. Uses `{ decision: "async" }` so it never blocks the chain.
  *
  * Call `flush()` to force-write remaining entries (e.g. on shutdown).
+ * Call `cleanup()` to stop the internal timer (e.g. on shutdown or before GC).
  */
 interface AuditLogMiddleware extends Middleware {
     flush: () => Promise<void>;
+    cleanup: () => void;
 }
 declare function auditLog(options: {
     dir: string;
@@ -925,6 +940,7 @@ declare class Orchestrator extends NeoEventEmitter {
     drain(): Promise<void>;
     get status(): OrchestratorStatus;
     get activeSessions(): ActiveSession[];
+    get activeRunCount(): number;
     start(): Promise<void>;
     shutdown(): Promise<void>;
     emit(event: NeoEvent): void;
@@ -1178,12 +1194,12 @@ declare const decisionSchema: z.ZodObject<{
     type: z.ZodDefault<z.ZodString>;
     source: z.ZodString;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    createdAt: z.ZodString;
-    expiresAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodCoercedString<unknown>;
+    expiresAt: z.ZodOptional<z.ZodCoercedString<unknown>>;
     defaultAnswer: z.ZodOptional<z.ZodString>;
-    answeredAt: z.ZodOptional<z.ZodString>;
+    answeredAt: z.ZodOptional<z.ZodCoercedString<unknown>>;
     answer: z.ZodOptional<z.ZodString>;
-    expiredAt: z.ZodOptional<z.ZodString>;
+    expiredAt: z.ZodOptional<z.ZodCoercedString<unknown>>;
 }, z.core.$strip>;
 type DecisionOption = z.infer<typeof decisionOptionSchema>;
 type Decision = z.infer<typeof decisionSchema>;
@@ -1191,12 +1207,20 @@ type DecisionInput = Omit<Decision, "id" | "createdAt" | "answeredAt" | "answer"
 /**
  * JSONL-backed store for decisions.
  * Append-only with in-place updates for answers and expiration.
+ * Uses an in-memory mutex to serialize write operations.
  */
 declare class DecisionStore {
     private readonly filePath;
     private readonly dir;
     private readonly dirCache;
+    /** Promise-based mutex to serialize write operations */
+    private writeLock;
     constructor(filePath: string);
+    /**
+     * Acquire the write lock and execute a callback.
+     * Serializes all write operations to prevent race conditions.
+     */
+    private withWriteLock;
     /**
      * Create a new decision and persist it.
      * @returns The generated decision ID
@@ -1205,6 +1229,7 @@ declare class DecisionStore {
     /**
      * Answer a decision by ID.
      * Reads all entries, updates the matching one, and rewrites the file.
+     * Uses a mutex to serialize concurrent calls and prevent race conditions.
      */
     answer(id: string, answer: string): Promise<void>;
     /**
@@ -1223,6 +1248,7 @@ declare class DecisionStore {
     /**
      * Auto-answer expired decisions with their defaultAnswer.
      * Decisions without defaultAnswer are marked as expired (expiredAt).
+     * Uses a mutex to serialize concurrent calls and prevent race conditions.
      * @returns The decisions that were auto-answered or marked expired
      */
     expire(): Promise<Decision[]>;
@@ -1639,6 +1665,23 @@ declare class HeartbeatLoop {
      * Check if supervisor daily budget is exceeded.
      */
     private checkBudgetExceeded;
+    /**
+     * Process decision answers from inbox and expire old decisions.
+     * Returns pending, answered, and expiry status for prompt context.
+     */
+    private processDecisions;
+    /**
+     * Gather event context: drain queue, fetch active runs, memories, and recent actions.
+     */
+    private gatherEventContext;
+    /**
+     * Handle post-SDK processing: mark events as processed, consolidate log buffer.
+     */
+    private handlePostSdkProcessing;
+    /**
+     * Emit completion webhook events: heartbeat completed and run completed events.
+     */
+    private emitCompletionEvents;
     /**
      * Handle skip logic for idle and active-work scenarios.
      * Uses IdleDetector to make skip decisions based on context.
@@ -1848,6 +1891,24 @@ declare class StatusReader {
      * Returns empty array if the activity file doesn't exist or is empty.
      */
     queryActivity(options?: ActivityQueryOptions): ActivityEntry[];
+    /**
+     * Count runs with status "running" from .neo/runs/.
+     * Fails silently — returns 0 if the runs directory doesn't exist.
+     */
+    private countActiveRuns;
+    /**
+     * Collect all run JSON files from the runs directory tree.
+     * Searches both top-level and repo subdirectories.
+     */
+    private collectRunFiles;
+    /**
+     * Check if a filename is a run file (JSON but not dispatch).
+     */
+    private isRunFile;
+    /**
+     * Check if a run file represents an active (running) run.
+     */
+    private isRunning;
 }
 
 interface WebhookServerOptions {