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

package/dist/index.d.ts

@@ -38,6 +38,7 @@ declare const agentConfigSchema: z.ZodObject<{
     name: z.ZodString;
     extends: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodEnum<{
         opus: "opus";
         sonnet: "sonnet";
@@ -62,7 +63,29 @@ declare const agentConfigSchema: z.ZodObject<{
         writable: "writable";
     }>>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
+    maxCost: z.ZodOptional<z.ZodNumber>;
     mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        prompt: z.ZodString;
+        tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            Read: "Read";
+            Write: "Write";
+            Edit: "Edit";
+            Bash: "Bash";
+            Glob: "Glob";
+            Grep: "Grep";
+            Agent: "Agent";
+            WebSearch: "WebSearch";
+            WebFetch: "WebFetch";
+            NotebookEdit: "NotebookEdit";
+        }>>>;
+        model: z.ZodOptional<z.ZodEnum<{
+            opus: "opus";
+            sonnet: "sonnet";
+            haiku: "haiku";
+        }>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type AgentConfig = z.infer<typeof agentConfigSchema>;
 type AgentModel = z.infer<typeof agentModelSchema>;
@@ -132,6 +155,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 +233,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>>;
@@ -360,18 +391,31 @@ declare function removeRepoFromGlobalConfig(pathOrName: string): Promise<boolean
  */
 declare function listReposFromGlobalConfig(): Promise<RepoConfig[]>;
 
+interface SubagentDefinition {
+    description: string;
+    prompt: string;
+    tools?: string[] | undefined;
+    model?: string | undefined;
+}
 interface AgentDefinition {
     description: string;
     prompt: string;
     tools: string[];
     model: string;
     mcpServers?: string[] | undefined;
+    agents?: Record<string, SubagentDefinition> | undefined;
 }
 interface ResolvedAgent {
     name: string;
     definition: AgentDefinition;
     sandbox: "writable" | "readonly";
     maxTurns?: number | undefined;
+    /**
+     * Maximum cost in USD for this agent session.
+     * Checked post-session; if session cost >= maxCost, budget_exceeded error is thrown.
+     */
+    maxCost?: number | undefined;
+    version?: string | undefined;
     source: "built-in" | "custom" | "extended";
 }
 interface PersistedRun {
@@ -451,6 +495,7 @@ interface ActiveSession {
 interface OrchestratorStatus {
     paused: boolean;
     activeSessions: ActiveSession[];
+    activeRunCount: number;
     queueDepth: number;
     costToday: number;
     budgetCapUsd: number;
@@ -699,8 +744,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 +778,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 +885,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 +976,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;
@@ -1042,7 +1094,9 @@ interface SessionOptions {
     env?: Record<string, string>;
     initTimeoutMs: number;
     maxDurationMs: number;
+    maxTurns?: number | undefined;
     resumeSessionId?: string | undefined;
+    agents?: Record<string, unknown> | undefined;
     onEvent?: ((event: SessionEvent) => void) | undefined;
 }
 interface SessionResult {
@@ -1178,12 +1232,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 +1245,32 @@ 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.
+ *
+ * Compaction Strategy:
+ * - Threshold-based compaction triggers on either:
+ *   1. Tombstone ratio exceeds 30% of total valid entries (tombstones / (valid decisions + tombstones), excluding malformed lines)
+ *   2. File size exceeds 10MB (prevents unbounded growth)
+ * - Compaction rebuilds the file, filtering out tombstoned entries and preserving active decisions
+ * - In-memory index maintains O(1) lookup without full file scans
+ * - Compaction runs synchronously within the write lock to maintain consistency
+ * - During compaction: all write operations are blocked until compaction completes, preventing race conditions
+ * - Concurrent reads during compaction may return stale data from before compaction started
  */
 declare class DecisionStore {
     private readonly filePath;
     private readonly dir;
     private readonly dirCache;
+    /** Promise-based mutex to serialize write operations */
+    private writeLock;
+    /** Maximum file size in bytes before validation fails (default: 10MB) */
+    private readonly maxFileSizeBytes;
     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 +1279,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 +1298,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[]>;
@@ -1288,9 +1364,9 @@ declare const activityEntrySchema: z.ZodObject<{
         message: "message";
         decision: "decision";
         tool_use: "tool_use";
+        action: "action";
         event: "event";
         heartbeat: "heartbeat";
-        action: "action";
         warning: "warning";
         thinking: "thinking";
         plan: "plan";
@@ -1353,8 +1429,8 @@ declare const activityQueryOptionsSchema: z.ZodObject<{
         error: "error";
         message: "message";
         decision: "decision";
-        event: "event";
         action: "action";
+        event: "event";
         plan: "plan";
         dispatch: "dispatch";
     }>>;
@@ -1639,6 +1715,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 +1941,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 {
@@ -1927,4 +2038,4 @@ declare function testWebhooks(): Promise<WebhookTestResult[]>;
 
 declare const VERSION = "0.1.0";
 
-export { type ActiveSession, type ActivityEntry, ActivityLog, type ActivityQueryOptions, type AgentConfig, type AgentDefinition, type AgentMessageEvent, type AgentModel, AgentRegistry, type AgentTool, type AgentToolEntry, type AgentToolUseEvent, type AuditLogMiddleware, type BudgetAlertEvent, ConfigStore, type CostEntry, CostJournal, type CostUpdateEvent, type Decision, type DecisionInput, type DecisionOption, DecisionStore, type DispatchInput, type Embedder, EventJournal, EventQueue, type GateWaitingEvent, type GitStrategy, type GlobalConfig, HeartbeatLoop, type HeartbeatLoopOptions, type HookEvent, type InboxMessage, LocalEmbedder, type LoopDetectionMiddleware, type McpServerConfig, type MemoryEntry, type MemoryQuery, type MemoryStats, MemoryStore, type MemoryType, type MemoryWriteInput, type Middleware, type MiddlewareChain, type MiddlewareContext, type MiddlewareContextMap, type MiddlewareEvent, type MiddlewareHandler, type MiddlewareResult, type NeoConfig, type NeoEvent, NeoEventEmitter, Orchestrator, type OrchestratorOptions, type OrchestratorShutdownEvent, type OrchestratorStatus, type ParsedOutput, type PersistedRun, type Priority, type QueueDequeueEvent, type QueueEnqueueEvent, type QueuedEvent, type RecoveryOptions, type RepoConfig, type RepoConfigInput, type ResolvedAgent, type RunContext, type SDKHooks, type SandboxConfig, Semaphore, type SemaphoreCallbacks, type SemaphoreConfig, type SessionCloneInfo, type SessionCompleteEvent, SessionError, type SessionEvent, type SessionExecutionConfig, type SessionExecutionDeps, type SessionExecutionInput, type SessionExecutionResult, SessionExecutor, type SessionFailEvent, type SessionOptions, type SessionResult, type SessionStartEvent, StatusReader, type StepCompleteEvent, type StepResult, type StepStartEvent, SupervisorDaemon, type SupervisorDaemonOptions, type SupervisorDaemonState, type SupervisorDaemonState as SupervisorState, type SupervisorStatus, type TaskResult, VERSION, WebhookDispatcher, type WebhookEntry, type WebhookEntryInput, type WebhookIncomingEvent, WebhookServer, type WebhookTestPayload, type WebhookTestResult, activityEntrySchema, addRepoToGlobalConfig, addWebhook, agentConfigSchema, agentModelSchema, agentSandboxSchema, agentToolEntrySchema, agentToolSchema, appendLogBuffer, auditLog, budgetGuard, buildFullPrompt, buildGitStrategyInstructions, buildMiddlewareChain, buildReportingInstructions, buildSDKHooks, buildSandboxConfig, createBranch, createSessionClone, decisionOptionSchema, decisionSchema, deleteBranch, fetchRemote, getBranchName, getCurrentBranch, getDataDir, getJournalsDir, getRepoRunsDir, getRunDispatchPath, getRunLogPath, getRunsDir, getSupervisorActivityPath, getSupervisorDecisionsPath, getSupervisorDir, getSupervisorEventsPath, getSupervisorInboxPath, getSupervisorLockPath, getSupervisorStatePath, getSupervisorsDir, globalConfigSchema, inboxMessageSchema, isProcessAlive, listReposFromGlobalConfig, listSessionClones, listWebhooks, loadAgentFile, loadConfig, loadGlobalConfig, loadRepoInstructions, loopDetection, matchesFilter, mcpServerConfigSchema, neoConfigSchema, parseOutput, pushBranch, pushSessionBranch, removeRepoFromGlobalConfig, removeSessionClone, removeWebhook, repoConfigSchema, repoOverrideConfigSchema, resolveAgent, runSession, runWithRecovery, supervisorDaemonStateSchema, supervisorDaemonStateSchema as supervisorStateSchema, supervisorStatusSchema, testWebhooks, toRepoSlug, webhookEntrySchema, webhookIncomingEventSchema };
+export { type ActiveSession, type ActivityEntry, ActivityLog, type ActivityQueryOptions, type AgentConfig, type AgentDefinition, type AgentMessageEvent, type AgentModel, AgentRegistry, type AgentTool, type AgentToolEntry, type AgentToolUseEvent, type AuditLogMiddleware, type BudgetAlertEvent, ConfigStore, type CostEntry, CostJournal, type CostUpdateEvent, type Decision, type DecisionInput, type DecisionOption, DecisionStore, type DispatchInput, type Embedder, EventJournal, EventQueue, type GateWaitingEvent, type GitStrategy, type GlobalConfig, HeartbeatLoop, type HeartbeatLoopOptions, type HookEvent, type InboxMessage, LocalEmbedder, type LoopDetectionMiddleware, type McpServerConfig, type MemoryEntry, type MemoryQuery, type MemoryStats, MemoryStore, type MemoryType, type MemoryWriteInput, type Middleware, type MiddlewareChain, type MiddlewareContext, type MiddlewareContextMap, type MiddlewareEvent, type MiddlewareHandler, type MiddlewareResult, type NeoConfig, type NeoEvent, NeoEventEmitter, Orchestrator, type OrchestratorOptions, type OrchestratorShutdownEvent, type OrchestratorStatus, type ParsedOutput, type PersistedRun, type Priority, type QueueDequeueEvent, type QueueEnqueueEvent, type QueuedEvent, type RecoveryOptions, type RepoConfig, type RepoConfigInput, type ResolvedAgent, type RunContext, type SDKHooks, type SandboxConfig, Semaphore, type SemaphoreCallbacks, type SemaphoreConfig, type SessionCloneInfo, type SessionCompleteEvent, SessionError, type SessionEvent, type SessionExecutionConfig, type SessionExecutionDeps, type SessionExecutionInput, type SessionExecutionResult, SessionExecutor, type SessionFailEvent, type SessionOptions, type SessionResult, type SessionStartEvent, StatusReader, type StepCompleteEvent, type StepResult, type StepStartEvent, type SubagentDefinition, SupervisorDaemon, type SupervisorDaemonOptions, type SupervisorDaemonState, type SupervisorDaemonState as SupervisorState, type SupervisorStatus, type TaskResult, VERSION, WebhookDispatcher, type WebhookEntry, type WebhookEntryInput, type WebhookIncomingEvent, WebhookServer, type WebhookTestPayload, type WebhookTestResult, activityEntrySchema, addRepoToGlobalConfig, addWebhook, agentConfigSchema, agentModelSchema, agentSandboxSchema, agentToolEntrySchema, agentToolSchema, appendLogBuffer, auditLog, budgetGuard, buildFullPrompt, buildGitStrategyInstructions, buildMiddlewareChain, buildReportingInstructions, buildSDKHooks, buildSandboxConfig, createBranch, createSessionClone, decisionOptionSchema, decisionSchema, deleteBranch, fetchRemote, getBranchName, getCurrentBranch, getDataDir, getJournalsDir, getRepoRunsDir, getRunDispatchPath, getRunLogPath, getRunsDir, getSupervisorActivityPath, getSupervisorDecisionsPath, getSupervisorDir, getSupervisorEventsPath, getSupervisorInboxPath, getSupervisorLockPath, getSupervisorStatePath, getSupervisorsDir, globalConfigSchema, inboxMessageSchema, isProcessAlive, listReposFromGlobalConfig, listSessionClones, listWebhooks, loadAgentFile, loadConfig, loadGlobalConfig, loadRepoInstructions, loopDetection, matchesFilter, mcpServerConfigSchema, neoConfigSchema, parseOutput, pushBranch, pushSessionBranch, removeRepoFromGlobalConfig, removeSessionClone, removeWebhook, repoConfigSchema, repoOverrideConfigSchema, resolveAgent, runSession, runWithRecovery, supervisorDaemonStateSchema, supervisorDaemonStateSchema as supervisorStateSchema, supervisorStatusSchema, testWebhooks, toRepoSlug, webhookEntrySchema, webhookIncomingEventSchema };