attocode 0.2.3 → 0.2.5

package/dist/src/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoPxB;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAkCb,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/src/config/schema.js

@@ -0,0 +1,268 @@
+/**
+ * Zod schemas for user-facing configuration (config.json).
+ *
+ * Validates the serializable subset of config that users write in
+ * `~/.config/attocode/config.json` or `.attocode/config.json`.
+ */
+import { z } from 'zod';
+// =============================================================================
+// FEATURE SUB-SCHEMAS
+// =============================================================================
+/**
+ * Helper: a feature section that can be an object or `false` to disable.
+ */
+function featureSection(shape) {
+    return z.union([z.object(shape).strict(), z.literal(false)]);
+}
+const PlanningSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    autoplan: z.boolean().optional(),
+    complexityThreshold: z.number().int().positive().optional(),
+    maxDepth: z.number().int().positive().optional(),
+    allowReplan: z.boolean().optional(),
+})
+    .strict();
+const MemorySchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    types: z
+        .object({
+        episodic: z.boolean().optional(),
+        semantic: z.boolean().optional(),
+        working: z.boolean().optional(),
+    })
+        .optional(),
+    retrievalStrategy: z.enum(['recency', 'relevance', 'importance', 'hybrid']).optional(),
+    retrievalLimit: z.number().int().positive().optional(),
+    persistPath: z.string().optional(),
+    maxEpisodicEntries: z.number().int().positive().optional(),
+    maxSemanticEntries: z.number().int().positive().optional(),
+})
+    .strict();
+const SandboxSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    isolation: z.enum(['none', 'process', 'container']).optional(),
+    mode: z.enum(['auto', 'seatbelt', 'docker', 'basic', 'none']).optional(),
+    allowedCommands: z.array(z.string()).optional(),
+    blockedCommands: z.array(z.string()).optional(),
+    networkAllowed: z.boolean().optional(),
+    dockerImage: z.string().optional(),
+})
+    .strict();
+const PolicyEngineSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    legacyFallback: z.boolean().optional(),
+    defaultProfile: z.string().optional(),
+    defaultSwarmProfile: z.string().optional(),
+    profiles: z.record(z.string(), z.any()).optional(),
+})
+    .strict();
+const HumanInLoopSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    riskThreshold: z.enum(['low', 'moderate', 'high', 'critical']).optional(),
+    alwaysApprove: z.array(z.string()).optional(),
+    neverApprove: z.array(z.string()).optional(),
+    approvalTimeout: z.number().int().positive().optional(),
+    auditLog: z.boolean().optional(),
+})
+    .strict();
+const SubagentSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    defaultTimeout: z.number().int().positive().optional(),
+    defaultMaxIterations: z.number().int().positive().optional(),
+    inheritObservability: z.boolean().optional(),
+    wrapupWindowMs: z.number().int().nonnegative().optional(),
+    idleCheckIntervalMs: z.number().int().positive().optional(),
+})
+    .strict();
+const ObservabilitySchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    tracing: z
+        .object({
+        enabled: z.boolean().optional(),
+        serviceName: z.string().optional(),
+        exporter: z.enum(['console', 'otlp', 'custom']).optional(),
+    })
+        .optional(),
+    metrics: z
+        .object({
+        enabled: z.boolean().optional(),
+        collectTokens: z.boolean().optional(),
+        collectCosts: z.boolean().optional(),
+        collectLatencies: z.boolean().optional(),
+    })
+        .optional(),
+    logging: z
+        .object({
+        enabled: z.boolean().optional(),
+        level: z.enum(['debug', 'info', 'warn', 'error']).optional(),
+        structured: z.boolean().optional(),
+    })
+        .optional(),
+})
+    .strict();
+const CancellationSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    defaultTimeout: z.number().int().nonnegative().optional(),
+    gracePeriod: z.number().int().nonnegative().optional(),
+})
+    .strict();
+const ResourcesSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    maxMemoryMB: z.number().positive().optional(),
+    maxCpuTimeSec: z.number().positive().optional(),
+    maxConcurrentOps: z.number().int().positive().optional(),
+    warnThreshold: z.number().min(0).max(1).optional(),
+    criticalThreshold: z.number().min(0).max(1).optional(),
+})
+    .strict();
+const CompactionSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    tokenThreshold: z.number().int().positive().optional(),
+    preserveRecentCount: z.number().int().nonnegative().optional(),
+    preserveToolResults: z.boolean().optional(),
+    summaryMaxTokens: z.number().int().positive().optional(),
+    summaryModel: z.string().optional(),
+    mode: z.enum(['auto', 'approval', 'manual']).optional(),
+})
+    .strict();
+const ResilienceSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    maxEmptyRetries: z.number().int().nonnegative().optional(),
+    maxContinuations: z.number().int().nonnegative().optional(),
+    autoContinue: z.boolean().optional(),
+    minContentLength: z.number().int().nonnegative().optional(),
+    incompleteActionRecovery: z.boolean().optional(),
+    maxIncompleteActionRetries: z.number().int().nonnegative().optional(),
+    enforceRequestedArtifacts: z.boolean().optional(),
+    incompleteActionAutoLoop: z.boolean().optional(),
+    maxIncompleteAutoLoops: z.number().int().nonnegative().optional(),
+    autoLoopPromptStyle: z.enum(['strict', 'concise']).optional(),
+    taskLeaseStaleMs: z.number().int().positive().optional(),
+})
+    .strict();
+const HooksSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    builtIn: z
+        .object({
+        logging: z.boolean().optional(),
+        metrics: z.boolean().optional(),
+        timing: z.boolean().optional(),
+    })
+        .optional(),
+    shell: z
+        .object({
+        enabled: z.boolean().optional(),
+        defaultTimeoutMs: z.number().int().positive().optional(),
+        envAllowlist: z.array(z.string()).optional(),
+        commands: z.array(z.object({
+            id: z.string().optional(),
+            event: z.enum([
+                'run.before',
+                'run.after',
+                'iteration.before',
+                'iteration.after',
+                'completion.before',
+                'completion.after',
+                'recovery.before',
+                'recovery.after',
+                'agent.start',
+                'agent.end',
+                'llm.before',
+                'llm.after',
+                'tool.before',
+                'tool.after',
+                'error',
+            ]),
+            command: z.string(),
+            args: z.array(z.string()).optional(),
+            timeoutMs: z.number().int().positive().optional(),
+            priority: z.number().int().optional(),
+        }).strict()).optional(),
+    })
+        .optional(),
+})
+    .strict();
+// =============================================================================
+// PROVIDER RESILIENCE
+// =============================================================================
+const CircuitBreakerSchema = z.union([
+    z
+        .object({
+        failureThreshold: z.number().int().positive().optional(),
+        resetTimeout: z.number().int().positive().optional(),
+        halfOpenRequests: z.number().int().positive().optional(),
+        tripOnErrors: z
+            .array(z.enum(['RATE_LIMITED', 'SERVER_ERROR', 'NETWORK_ERROR', 'TIMEOUT', 'ALL']))
+            .optional(),
+    })
+        .strict(),
+    z.literal(false),
+]);
+const ProviderResilienceSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    circuitBreaker: CircuitBreakerSchema.optional(),
+    fallbackProviders: z.array(z.string()).optional(),
+    fallbackChain: z
+        .object({
+        cooldownMs: z.number().int().positive().optional(),
+        failureThreshold: z.number().int().positive().optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+// =============================================================================
+// TOP-LEVEL USER CONFIG SCHEMA
+// =============================================================================
+/**
+ * Zod schema for user-facing config.json files.
+ *
+ * Uses `.passthrough()` at the top level to avoid breaking users with custom fields.
+ * Feature sub-schemas use `.strict()` to catch typos in feature-specific keys.
+ */
+export const UserConfigSchema = z
+    .object({
+    // Core scalars
+    model: z.string().optional(),
+    maxIterations: z.number().int().positive().optional(),
+    timeout: z.number().int().positive().optional(),
+    maxTokens: z.number().int().positive().optional(),
+    temperature: z.number().min(0).max(2).optional(),
+    // Provider selection
+    providers: z
+        .object({
+        default: z.string().optional(),
+    })
+        .strict()
+        .optional(),
+    // Provider resilience
+    providerResilience: ProviderResilienceSchema.optional(),
+    // Feature sections (object | false)
+    planning: featureSection(PlanningSchema.shape).optional(),
+    memory: featureSection(MemorySchema.shape).optional(),
+    sandbox: featureSection(SandboxSchema.shape).optional(),
+    policyEngine: featureSection(PolicyEngineSchema.shape).optional(),
+    humanInLoop: featureSection(HumanInLoopSchema.shape).optional(),
+    subagent: featureSection(SubagentSchema.shape).optional(),
+    observability: featureSection(ObservabilitySchema.shape).optional(),
+    cancellation: featureSection(CancellationSchema.shape).optional(),
+    resources: featureSection(ResourcesSchema.shape).optional(),
+    compaction: featureSection(CompactionSchema.shape).optional(),
+    resilience: featureSection(ResilienceSchema.shape).optional(),
+    hooks: featureSection(HooksSchema.shape).optional(),
+})
+    .passthrough();
+//# sourceMappingURL=schema.js.map

package/dist/src/config/schema.js.map

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

package/dist/src/config.d.ts

@@ -1,11 +1,13 @@
 /**
  * User Configuration Loading
  *
- * Loads user config from ~/.config/attocode/config.json
+ * @deprecated Use `loadConfig()` from `./config/index.js` instead.
+ * This module is kept for backward compatibility and will be removed in a future release.
  */
 import type { ProviderResilienceConfig } from './types.js';
 /**
  * User configuration structure.
+ * @deprecated Use `ValidatedUserConfig` from `./config/index.js` instead.
  */
 export interface UserConfig {
     providers?: {
@@ -20,6 +22,7 @@ export interface UserConfig {
 /**
  * Load user config from ~/.config/attocode/config.json
  * Returns undefined if file doesn't exist or is invalid.
+ * @deprecated Use `loadConfig()` from `./config/index.js` instead.
  */
 export declare function loadUserConfig(): UserConfig | undefined;
 //# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,UAAU,GAAG,SAAS,CAWvD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CAC/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,UAAU,GAAG,SAAS,CAOvD"}

package/dist/src/config.js

@@ -1,25 +1,21 @@
 /**
  * User Configuration Loading
  *
- * Loads user config from ~/.config/attocode/config.json
+ * @deprecated Use `loadConfig()` from `./config/index.js` instead.
+ * This module is kept for backward compatibility and will be removed in a future release.
  */
-import { existsSync, readFileSync } from 'node:fs';
-import { getConfigPath } from './paths.js';
+import { loadConfig } from './config/index.js';
 /**
  * Load user config from ~/.config/attocode/config.json
  * Returns undefined if file doesn't exist or is invalid.
+ * @deprecated Use `loadConfig()` from `./config/index.js` instead.
  */
 export function loadUserConfig() {
-    try {
-        const configPath = getConfigPath();
-        if (!existsSync(configPath)) {
-            return undefined;
-        }
-        const content = readFileSync(configPath, 'utf-8');
-        return JSON.parse(content);
-    }
-    catch {
+    const { config, sources } = loadConfig({ skipProject: true });
+    const anyLoaded = sources.some((s) => s.loaded);
+    if (!anyLoaded) {
         return undefined;
     }
+    return config;
 }
 //# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAe3C;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgB/C;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAoB,CAAC;AAC9B,CAAC"}

package/dist/src/core/agent-state-machine.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Phase 2.2: Agent State Machine
+ *
+ * Formalizes the phase tracking that previously lived in economics.ts into a
+ * proper state machine with typed transitions, event emission, and per-phase
+ * metrics. Testable independently of the economics system.
+ *
+ * Phases:
+ * - exploring: Reading files, searching code, understanding the problem
+ * - planning: Creating or editing a plan
+ * - acting: Writing/editing files, running commands
+ * - verifying: Running tests, checking results
+ *
+ * Valid transitions:
+ *   exploring → planning | acting
+ *   planning  → acting | exploring
+ *   acting    → verifying | exploring
+ *   verifying → acting | exploring
+ */
+/** Agent execution phases */
+export type AgentPhase = 'exploring' | 'planning' | 'acting' | 'verifying';
+/** Per-phase metrics snapshot */
+export interface PhaseMetrics {
+    /** Phase name */
+    phase: AgentPhase;
+    /** Iterations spent in this phase */
+    iterations: number;
+    /** Timestamp when phase was entered */
+    enteredAt: number;
+    /** Duration in ms (0 if still in phase) */
+    duration: number;
+    /** Unique files read during this phase */
+    filesRead: number;
+    /** Unique files modified during this phase */
+    filesModified: number;
+    /** Tool calls made during this phase */
+    toolCalls: number;
+}
+/** Phase transition record */
+export interface PhaseTransition {
+    from: AgentPhase;
+    to: AgentPhase;
+    reason: string;
+    timestamp: number;
+    /** Metrics from the phase we're leaving */
+    fromMetrics: PhaseMetrics;
+}
+/** State machine events */
+export type StateMachineEvent = {
+    type: 'phase.changed';
+    transition: PhaseTransition;
+} | {
+    type: 'phase.metrics';
+    phase: AgentPhase;
+    metrics: PhaseMetrics;
+};
+export type StateMachineEventListener = (event: StateMachineEvent) => void;
+/** Current phase state (exposed for economics integration) */
+export interface PhaseSnapshot {
+    phase: AgentPhase;
+    iterationsInPhase: number;
+    uniqueFilesRead: Set<string>;
+    uniqueSearches: Set<string>;
+    filesModified: Set<string>;
+    testsRun: number;
+    shouldTransition: boolean;
+    recentNewFiles: number;
+    lastTestPassed: boolean | null;
+    consecutiveTestFailures: number;
+    inTestFixCycle: boolean;
+    consecutiveBashFailures: number;
+}
+export declare class AgentStateMachine {
+    private currentPhase;
+    private phaseEnteredAt;
+    private phaseIterations;
+    private phaseToolCalls;
+    private listeners;
+    private transitions;
+    private uniqueFilesRead;
+    private uniqueSearches;
+    private filesModified;
+    private testsRun;
+    private shouldTransition;
+    private recentNewFiles;
+    private lastTestPassed;
+    private consecutiveTestFailures;
+    private inTestFixCycle;
+    private consecutiveBashFailures;
+    private phaseHistory;
+    private explorationFileThreshold;
+    private explorationIterThreshold;
+    constructor(options?: {
+        initialPhase?: AgentPhase;
+        explorationFileThreshold?: number;
+        explorationIterThreshold?: number;
+    });
+    /** Get the current phase */
+    getPhase(): AgentPhase;
+    /** Get a snapshot of the current phase state (backward-compatible with economics) */
+    getPhaseSnapshot(): PhaseSnapshot;
+    /** Get metrics for the current phase */
+    getCurrentPhaseMetrics(): PhaseMetrics;
+    /** Get all phase transition history */
+    getTransitions(): readonly PhaseTransition[];
+    /** Get accumulated phase history */
+    getPhaseHistory(): readonly PhaseMetrics[];
+    /**
+     * Attempt a phase transition.
+     * Returns true if transition was valid and executed, false if rejected.
+     */
+    transition(to: AgentPhase, reason: string): boolean;
+    /**
+     * Record a tool call and update phase state.
+     * This is the primary input signal for the state machine.
+     */
+    recordToolCall(toolName: string, args: Record<string, unknown>, result?: unknown): void;
+    /** Subscribe to state machine events */
+    subscribe(listener: StateMachineEventListener): () => void;
+    /** Reset state machine to initial state */
+    reset(phase?: AgentPhase): void;
+    /** Check for exploration saturation (too many reads without action) */
+    private checkExplorationSaturation;
+    private emit;
+}
+export declare function createAgentStateMachine(options?: {
+    initialPhase?: AgentPhase;
+    explorationFileThreshold?: number;
+    explorationIterThreshold?: number;
+}): AgentStateMachine;
+//# sourceMappingURL=agent-state-machine.d.ts.map

package/dist/src/core/agent-state-machine.d.ts.map

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