@defai.digital/iterate-domain 13.0.3

package/dist/controller.js

@@ -0,0 +1,226 @@
+/**
+ * Iterate Controller
+ *
+ * State machine for iterate mode - handles intent classification
+ * and determines actions (CONTINUE, PAUSE, STOP, RETRY).
+ *
+ * Invariants:
+ * - INV-ITR-003: Intent classification drives action decisions
+ */
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_MAX_ITERATIONS, DEFAULT_MAX_TIME_MS, } from '@defai.digital/contracts';
+import { BudgetTracker } from './budget.js';
+import { SafetyGuard } from './safety.js';
+// ============================================================================
+// Auto-Response Templates
+// ============================================================================
+/**
+ * Auto-responses for CONTINUE action
+ */
+const AUTO_RESPONSES = {
+    continue: 'Continue.',
+    question: '', // Should not auto-respond
+    blocked: '', // Should not auto-respond
+    complete: '', // Should not auto-respond
+    error: '', // Should not auto-respond
+};
+// ============================================================================
+// Iterate Controller Implementation
+// ============================================================================
+/**
+ * Main controller for iterate mode
+ */
+export class IterateController {
+    budgetTracker;
+    safetyGuard;
+    constructor() {
+        this.budgetTracker = new BudgetTracker();
+        this.safetyGuard = new SafetyGuard();
+    }
+    /**
+     * Start a new iterate session
+     */
+    start(request) {
+        const sessionId = request.sessionId ?? randomUUID();
+        const now = new Date().toISOString();
+        // Initialize budget tracker
+        this.budgetTracker = new BudgetTracker(request.budget);
+        this.budgetTracker.start();
+        // Initialize safety guard
+        if (request.safety) {
+            this.safetyGuard = new SafetyGuard(request.safety);
+        }
+        return {
+            sessionId,
+            taskId: randomUUID(),
+            budget: {
+                maxIterations: request.budget?.maxIterations ?? DEFAULT_MAX_ITERATIONS,
+                maxTimeMs: request.budget?.maxTimeMs ?? DEFAULT_MAX_TIME_MS,
+                maxTokens: request.budget?.maxTokens,
+            },
+            consumed: {
+                iterations: 0,
+                timeMs: 0,
+                tokens: 0,
+            },
+            iteration: 0,
+            startedAt: now,
+            lastActivityAt: now,
+            status: 'running',
+            consecutiveErrors: 0,
+            history: [],
+        };
+    }
+    /**
+     * Handle a response from the LLM
+     */
+    handleResponse(state, intent, content) {
+        const now = new Date().toISOString();
+        // Record iteration in budget tracker
+        this.budgetTracker.recordIteration();
+        // Check budget first
+        const budgetStatus = this.budgetTracker.check();
+        if (budgetStatus.exceeded) {
+            return this.createResponse(state, intent, {
+                type: 'STOP',
+                reason: budgetStatus.reason ?? 'Budget exceeded',
+                requiresInput: false,
+            }, 'budget_exceeded', now, content);
+        }
+        // Check safety if content provided
+        if (content) {
+            const safetyResult = this.safetyGuard.checkContent(content);
+            if (!safetyResult.safe) {
+                return this.createResponse(state, intent, {
+                    type: 'PAUSE',
+                    reason: safetyResult.reason ?? 'Safety check failed',
+                    requiresInput: true,
+                    suggestedInput: 'Review the dangerous pattern and confirm to proceed.',
+                }, 'paused', now, content);
+            }
+        }
+        // Check consecutive errors
+        if (intent === 'error') {
+            const newErrorCount = state.consecutiveErrors + 1;
+            const errorResult = this.safetyGuard.checkErrors(newErrorCount);
+            if (!errorResult.safe) {
+                return this.createResponse(state, intent, {
+                    type: 'PAUSE',
+                    reason: errorResult.reason ?? 'Too many consecutive errors',
+                    requiresInput: true,
+                    suggestedInput: 'Review the errors and decide how to proceed.',
+                }, 'paused', now, content, newErrorCount);
+            }
+        }
+        // Map intent to action
+        const action = this.mapIntentToAction(intent);
+        // Determine new status
+        let newStatus = state.status;
+        if (action.type === 'STOP') {
+            newStatus = intent === 'complete' ? 'completed' : 'failed';
+        }
+        else if (action.type === 'PAUSE') {
+            newStatus = 'paused';
+        }
+        else {
+            newStatus = 'running';
+        }
+        // Reset error count on non-error intent
+        const consecutiveErrors = intent === 'error' ? state.consecutiveErrors + 1 : 0;
+        return this.createResponse(state, intent, action, newStatus, now, content, consecutiveErrors);
+    }
+    /**
+     * Get auto-response for CONTINUE action
+     */
+    getAutoResponse(intent) {
+        return AUTO_RESPONSES[intent] ?? 'Continue.';
+    }
+    /**
+     * Map intent to action
+     */
+    mapIntentToAction(intent) {
+        switch (intent) {
+            case 'continue':
+                return {
+                    type: 'CONTINUE',
+                    reason: 'Task in progress',
+                    requiresInput: false,
+                };
+            case 'question':
+                return {
+                    type: 'PAUSE',
+                    reason: 'User decision needed',
+                    requiresInput: true,
+                    suggestedInput: 'Please provide your decision.',
+                };
+            case 'blocked':
+                return {
+                    type: 'PAUSE',
+                    reason: 'External input needed',
+                    requiresInput: true,
+                    suggestedInput: 'Please provide the required input.',
+                };
+            case 'complete':
+                return {
+                    type: 'STOP',
+                    reason: 'Task completed successfully',
+                    requiresInput: false,
+                };
+            case 'error':
+                return {
+                    type: 'PAUSE',
+                    reason: 'Error occurred',
+                    requiresInput: true,
+                    suggestedInput: 'Please review the error and decide how to proceed.',
+                };
+            default:
+                // Unknown intent - pause for safety
+                return {
+                    type: 'PAUSE',
+                    reason: 'Unknown intent - pausing for safety',
+                    requiresInput: true,
+                };
+        }
+    }
+    /**
+     * Create response with updated state
+     */
+    createResponse(state, intent, action, newStatus, now, content, consecutiveErrors) {
+        const consumed = this.budgetTracker.getConsumed();
+        const newState = {
+            ...state,
+            iteration: state.iteration + 1,
+            consumed,
+            lastActivityAt: now,
+            status: newStatus,
+            lastIntent: intent,
+            lastAction: action,
+            consecutiveErrors: consecutiveErrors ?? (intent === 'error' ? state.consecutiveErrors + 1 : 0),
+            history: [
+                ...(state.history ?? []),
+                {
+                    iteration: state.iteration + 1,
+                    intent,
+                    action: action.type,
+                    timestamp: now,
+                },
+            ],
+        };
+        return {
+            action,
+            newState,
+            content,
+            autoResponse: action.type === 'CONTINUE' ? this.getAutoResponse(intent) : undefined,
+        };
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Creates an iterate controller
+ */
+export function createIterateController() {
+    return new IterateController();
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @defai.digital/iterate-domain
+ *
+ * Iterate mode for AutomatosX - autonomous execution with
+ * structured intent classification and safety controls.
+ *
+ * Key concepts:
+ * - Intent: What the LLM is communicating (continue, question, blocked, complete, error)
+ * - Action: What to do next (CONTINUE, PAUSE, STOP, RETRY)
+ * - Budget: Resource limits (iterations, time, tokens)
+ * - Safety: Pattern detection and error limits
+ */
+export type { IterateIntent, IterateAction, IterateBudget, BudgetConsumed, IterateBudgetStatus, IterateState, IterateSafetyConfig, SafetyCheckResult, IterateStartRequest, IterateHandleResponse, IBudgetTracker, ISafetyGuard, IIterateController, } from './types.js';
+export { BudgetTracker, createBudgetTracker } from './budget.js';
+export { SafetyGuard, createSafetyGuard, isContentSafe } from './safety.js';
+export { IterateController, createIterateController } from './controller.js';
+export { DEFAULT_MAX_ITERATIONS, DEFAULT_MAX_TIME_MS, DEFAULT_MAX_CONSECUTIVE_ERRORS, IterateIntentSchema, IterateActionTypeSchema, IterateBudgetSchema, IterateStateSchema, validateIterateIntent, safeValidateIterateIntent, validateIterateBudget, validateIterateState, IterateErrorCode, } from '@defai.digital/contracts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG7E,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * @defai.digital/iterate-domain
+ *
+ * Iterate mode for AutomatosX - autonomous execution with
+ * structured intent classification and safety controls.
+ *
+ * Key concepts:
+ * - Intent: What the LLM is communicating (continue, question, blocked, complete, error)
+ * - Action: What to do next (CONTINUE, PAUSE, STOP, RETRY)
+ * - Budget: Resource limits (iterations, time, tokens)
+ * - Safety: Pattern detection and error limits
+ */
+// Budget Tracker
+export { BudgetTracker, createBudgetTracker } from './budget.js';
+// Safety Guard
+export { SafetyGuard, createSafetyGuard, isContentSafe } from './safety.js';
+// Iterate Controller
+export { IterateController, createIterateController } from './controller.js';
+// Re-export contract constants
+export { DEFAULT_MAX_ITERATIONS, DEFAULT_MAX_TIME_MS, DEFAULT_MAX_CONSECUTIVE_ERRORS, IterateIntentSchema, IterateActionTypeSchema, IterateBudgetSchema, IterateStateSchema, validateIterateIntent, safeValidateIterateIntent, validateIterateBudget, validateIterateState, IterateErrorCode, } from '@defai.digital/contracts';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmBH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEjE,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5E,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,+BAA+B;AAC/B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/dist/safety.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Safety Guard
+ *
+ * Checks for dangerous patterns and enforces safety limits.
+ *
+ * Invariants:
+ * - INV-ITR-002: Safety guards must pause on dangerous patterns
+ */
+import { type IterateSafetyConfig, type SafetyCheckResult } from '@defai.digital/contracts';
+import type { ISafetyGuard } from './types.js';
+/**
+ * Checks content for dangerous patterns
+ */
+export declare class SafetyGuard implements ISafetyGuard {
+    private config;
+    private compiledPatterns;
+    constructor(config?: Partial<IterateSafetyConfig>);
+    /**
+     * Compile all patterns into RegExp objects
+     */
+    private compilePatterns;
+    /**
+     * Check content for dangerous patterns
+     */
+    checkContent(content: string): SafetyCheckResult;
+    /**
+     * Check if too many consecutive errors
+     */
+    checkErrors(consecutiveErrors: number): SafetyCheckResult;
+    /**
+     * Get safety configuration
+     */
+    getConfig(): IterateSafetyConfig;
+    /**
+     * Determine severity based on pattern
+     */
+    private getSeverity;
+}
+/**
+ * Creates a safety guard with optional configuration
+ */
+export declare function createSafetyGuard(config?: Partial<IterateSafetyConfig>): ISafetyGuard;
+/**
+ * Quick check if content is safe
+ */
+export declare function isContentSafe(content: string): boolean;
+//# sourceMappingURL=safety.d.ts.map

package/dist/safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../src/safety.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA2C/C;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,gBAAgB,CAAW;gBAEvB,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAYjD;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAsBhD;;OAEG;IACH,WAAW,CAAC,iBAAiB,EAAE,MAAM,GAAG,iBAAiB;IAYzD;;OAEG;IACH,SAAS,IAAI,mBAAmB;IAIhC;;OAEG;IACH,OAAO,CAAC,WAAW;CAgCpB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,YAAY,CAErF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGtD"}

package/dist/safety.js

@@ -0,0 +1,171 @@
+/**
+ * Safety Guard
+ *
+ * Checks for dangerous patterns and enforces safety limits.
+ *
+ * Invariants:
+ * - INV-ITR-002: Safety guards must pause on dangerous patterns
+ */
+import { DEFAULT_MAX_CONSECUTIVE_ERRORS, } from '@defai.digital/contracts';
+// ============================================================================
+// Default Dangerous Patterns
+// ============================================================================
+/**
+ * Default patterns that trigger safety pause
+ */
+const DEFAULT_DANGEROUS_PATTERNS = [
+    // File system destruction
+    'rm\\s+-rf\\s+[/~]',
+    'rm\\s+-rf\\s+\\*',
+    'rm\\s+-rf\\s+\\.',
+    'rmdir\\s+/\\s',
+    // Database destruction
+    'DROP\\s+TABLE',
+    'DROP\\s+DATABASE',
+    'TRUNCATE\\s+TABLE',
+    'DELETE\\s+FROM\\s+\\w+\\s*;',
+    // Disk format
+    'mkfs\\.',
+    'format\\s+[cC]:',
+    'dd\\s+if=',
+    // Fork bomb
+    ':\\(\\)\\{\\s*:|:&\\s*\\};:',
+    // Git force
+    'git\\s+push\\s+.*--force',
+    'git\\s+reset\\s+--hard\\s+origin',
+    // Shutdown/reboot
+    'shutdown',
+    'reboot',
+    'init\\s+0',
+    // Env/secrets exposure
+    'echo\\s+\\$[A-Z_]*KEY',
+    'echo\\s+\\$[A-Z_]*SECRET',
+    'echo\\s+\\$[A-Z_]*PASSWORD',
+];
+// ============================================================================
+// Safety Guard Implementation
+// ============================================================================
+/**
+ * Checks content for dangerous patterns
+ */
+export class SafetyGuard {
+    config;
+    compiledPatterns;
+    constructor(config) {
+        this.config = {
+            maxConsecutiveErrors: config?.maxConsecutiveErrors ?? DEFAULT_MAX_CONSECUTIVE_ERRORS,
+            enableDangerousPatternDetection: config?.enableDangerousPatternDetection ?? true,
+            dangerousPatterns: config?.dangerousPatterns ?? DEFAULT_DANGEROUS_PATTERNS,
+            customDangerousPatterns: config?.customDangerousPatterns,
+        };
+        // Compile patterns for performance
+        this.compiledPatterns = this.compilePatterns();
+    }
+    /**
+     * Compile all patterns into RegExp objects
+     */
+    compilePatterns() {
+        const patterns = [
+            ...this.config.dangerousPatterns,
+            ...(this.config.customDangerousPatterns ?? []),
+        ];
+        return patterns.map((pattern) => {
+            try {
+                return new RegExp(pattern, 'i');
+            }
+            catch {
+                // Invalid pattern - skip it
+                console.warn(`Invalid dangerous pattern: ${pattern}`);
+                return null;
+            }
+        }).filter((p) => p !== null);
+    }
+    /**
+     * Check content for dangerous patterns
+     */
+    checkContent(content) {
+        if (!this.config.enableDangerousPatternDetection) {
+            return { safe: true };
+        }
+        for (const pattern of this.compiledPatterns) {
+            if (pattern.test(content)) {
+                // Determine severity based on pattern
+                const severity = this.getSeverity(pattern.source);
+                return {
+                    safe: false,
+                    reason: `Dangerous pattern detected: ${pattern.source}`,
+                    matchedPattern: pattern.source,
+                    severity,
+                };
+            }
+        }
+        return { safe: true };
+    }
+    /**
+     * Check if too many consecutive errors
+     */
+    checkErrors(consecutiveErrors) {
+        if (consecutiveErrors >= this.config.maxConsecutiveErrors) {
+            return {
+                safe: false,
+                reason: `Too many consecutive errors (${consecutiveErrors}/${this.config.maxConsecutiveErrors})`,
+                severity: 'warning',
+            };
+        }
+        return { safe: true };
+    }
+    /**
+     * Get safety configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Determine severity based on pattern
+     */
+    getSeverity(pattern) {
+        // Critical patterns - immediate system damage
+        const criticalPatterns = [
+            'rm\\s+-rf\\s+[/~]',
+            'mkfs\\.',
+            'dd\\s+if=',
+            'DROP\\s+DATABASE',
+            ':\\(\\)\\{',
+        ];
+        for (const critical of criticalPatterns) {
+            if (pattern.includes(critical) || pattern === critical) {
+                return 'critical';
+            }
+        }
+        // Danger patterns - significant data loss
+        const dangerPatterns = [
+            'DROP\\s+TABLE',
+            'TRUNCATE',
+            'DELETE\\s+FROM',
+            'git\\s+push.*--force',
+        ];
+        for (const danger of dangerPatterns) {
+            if (pattern.includes(danger) || pattern === danger) {
+                return 'danger';
+            }
+        }
+        return 'warning';
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Creates a safety guard with optional configuration
+ */
+export function createSafetyGuard(config) {
+    return new SafetyGuard(config);
+}
+/**
+ * Quick check if content is safe
+ */
+export function isContentSafe(content) {
+    const guard = new SafetyGuard();
+    return guard.checkContent(content).safe;
+}
+//# sourceMappingURL=safety.js.map

package/dist/safety.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Iterate Domain Internal Types
+ *
+ * Internal types for the iterate mode implementation.
+ */
+import type { IterateIntent, IterateAction, IterateBudget, BudgetConsumed, IterateBudgetStatus, IterateState, IterateSafetyConfig, SafetyCheckResult, IterateStartRequest, IterateHandleResponse } from '@defai.digital/contracts';
+export type { IterateIntent, IterateAction, IterateBudget, BudgetConsumed, IterateBudgetStatus, IterateState, IterateSafetyConfig, SafetyCheckResult, IterateStartRequest, IterateHandleResponse, };
+/**
+ * Budget tracker interface
+ */
+export interface IBudgetTracker {
+    /**
+     * Start tracking budget
+     */
+    start(): void;
+    /**
+     * Record an iteration
+     */
+    recordIteration(tokens?: number): void;
+    /**
+     * Check budget status
+     */
+    check(): IterateBudgetStatus;
+    /**
+     * Check if budget is exceeded
+     */
+    isExceeded(): boolean;
+    /**
+     * Get current consumption
+     */
+    getConsumed(): BudgetConsumed;
+    /**
+     * Get budget limits
+     */
+    getBudget(): IterateBudget;
+}
+/**
+ * Safety guard interface
+ */
+export interface ISafetyGuard {
+    /**
+     * Check content for dangerous patterns
+     */
+    checkContent(content: string): SafetyCheckResult;
+    /**
+     * Check if too many consecutive errors
+     */
+    checkErrors(consecutiveErrors: number): SafetyCheckResult;
+    /**
+     * Get safety configuration
+     */
+    getConfig(): IterateSafetyConfig;
+}
+/**
+ * Iterate controller interface
+ */
+export interface IIterateController {
+    /**
+     * Start a new iterate session
+     */
+    start(request: IterateStartRequest): IterateState;
+    /**
+     * Handle a response from the LLM
+     */
+    handleResponse(state: IterateState, intent: IterateIntent, content?: string): IterateHandleResponse;
+    /**
+     * Get auto-response for CONTINUE action
+     */
+    getAutoResponse(intent: IterateIntent): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GACtB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,KAAK,IAAI,mBAAmB,CAAC;IAE7B;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC;IAEtB;;OAEG;IACH,WAAW,IAAI,cAAc,CAAC;IAE9B;;OAEG;IACH,SAAS,IAAI,aAAa,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAEjD;;OAEG;IACH,WAAW,CAAC,iBAAiB,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAE1D;;OAEG;IACH,SAAS,IAAI,mBAAmB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC;IAElD;;OAEG;IACH,cAAc,CACZ,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,qBAAqB,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC;CAChD"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Iterate Domain Internal Types
+ *
+ * Internal types for the iterate mode implementation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@defai.digital/iterate-domain",
+  "version": "13.0.3",
+  "type": "module",
+  "description": "Iterate mode for AutomatosX - autonomous execution with structured intent and safety controls",
+  "license": "Apache-2.0",
+  "author": "DEFAI Private Limited",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git",
+    "directory": "packages/core/iterate-domain"
+  },
+  "homepage": "https://github.com/defai-digital/automatosx#readme",
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@defai.digital/contracts": "13.0.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist"
+  }
+}