@defai.digital/contracts 13.0.3

package/dist/iterate/v1/schema.d.ts

@@ -0,0 +1,693 @@
+/**
+ * Iterate Mode Contracts v1
+ *
+ * Zod schemas for iterate mode - autonomous execution with structured
+ * intent classification and safety controls.
+ *
+ * Invariants:
+ * - INV-ITR-001: Budget limits must be enforced (iterations, time, tokens)
+ * - INV-ITR-002: Safety guards must pause on dangerous patterns
+ * - INV-ITR-003: Intent classification drives action decisions
+ */
+import { z } from 'zod';
+/**
+ * Default budget values
+ */
+export declare const DEFAULT_MAX_ITERATIONS = 20;
+export declare const DEFAULT_MAX_TIME_MS = 300000;
+export declare const DEFAULT_MAX_CONSECUTIVE_ERRORS = 3;
+/**
+ * Intent classification from LLM response
+ * This determines whether to continue, pause, or stop iteration
+ */
+export declare const IterateIntentSchema: z.ZodEnum<["continue", "question", "blocked", "complete", "error"]>;
+export type IterateIntent = z.infer<typeof IterateIntentSchema>;
+/**
+ * Action to take based on intent and budget
+ */
+export declare const IterateActionTypeSchema: z.ZodEnum<["CONTINUE", "PAUSE", "STOP", "RETRY"]>;
+export type IterateActionType = z.infer<typeof IterateActionTypeSchema>;
+/**
+ * Full action with reason
+ */
+export declare const IterateActionSchema: z.ZodObject<{
+    type: z.ZodEnum<["CONTINUE", "PAUSE", "STOP", "RETRY"]>;
+    reason: z.ZodString;
+    requiresInput: z.ZodDefault<z.ZodBoolean>;
+    suggestedInput: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+    reason: string;
+    requiresInput: boolean;
+    suggestedInput?: string | undefined;
+}, {
+    type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+    reason: string;
+    requiresInput?: boolean | undefined;
+    suggestedInput?: string | undefined;
+}>;
+export type IterateAction = z.infer<typeof IterateActionSchema>;
+/**
+ * Budget constraints for iterate mode
+ */
+export declare const IterateBudgetSchema: z.ZodObject<{
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+    maxTimeMs: z.ZodDefault<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxIterations: number;
+    maxTimeMs: number;
+    maxTokens?: number | undefined;
+}, {
+    maxTokens?: number | undefined;
+    maxIterations?: number | undefined;
+    maxTimeMs?: number | undefined;
+}>;
+export type IterateBudget = z.infer<typeof IterateBudgetSchema>;
+/**
+ * Budget consumption tracking
+ */
+export declare const BudgetConsumedSchema: z.ZodObject<{
+    iterations: z.ZodNumber;
+    timeMs: z.ZodNumber;
+    tokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    iterations: number;
+    timeMs: number;
+    tokens?: number | undefined;
+}, {
+    iterations: number;
+    timeMs: number;
+    tokens?: number | undefined;
+}>;
+export type BudgetConsumed = z.infer<typeof BudgetConsumedSchema>;
+/**
+ * Budget status check result
+ */
+export declare const IterateBudgetStatusSchema: z.ZodObject<{
+    exceeded: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+    remaining: z.ZodObject<{
+        iterations: z.ZodNumber;
+        timeMs: z.ZodNumber;
+        tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        iterations: number;
+        timeMs: number;
+        tokens?: number | undefined;
+    }, {
+        iterations: number;
+        timeMs: number;
+        tokens?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    remaining: {
+        iterations: number;
+        timeMs: number;
+        tokens?: number | undefined;
+    };
+    exceeded: boolean;
+    reason?: string | undefined;
+}, {
+    remaining: {
+        iterations: number;
+        timeMs: number;
+        tokens?: number | undefined;
+    };
+    exceeded: boolean;
+    reason?: string | undefined;
+}>;
+export type IterateBudgetStatus = z.infer<typeof IterateBudgetStatusSchema>;
+/**
+ * Iterate mode state
+ */
+export declare const IterateStateSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    taskId: z.ZodOptional<z.ZodString>;
+    budget: z.ZodObject<{
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+        maxTimeMs: z.ZodDefault<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxIterations: number;
+        maxTimeMs: number;
+        maxTokens?: number | undefined;
+    }, {
+        maxTokens?: number | undefined;
+        maxIterations?: number | undefined;
+        maxTimeMs?: number | undefined;
+    }>;
+    consumed: z.ZodObject<{
+        iterations: z.ZodNumber;
+        timeMs: z.ZodNumber;
+        tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        iterations: number;
+        timeMs: number;
+        tokens?: number | undefined;
+    }, {
+        iterations: number;
+        timeMs: number;
+        tokens?: number | undefined;
+    }>;
+    iteration: z.ZodNumber;
+    startedAt: z.ZodString;
+    lastActivityAt: z.ZodString;
+    status: z.ZodEnum<["running", "paused", "completed", "failed", "budget_exceeded"]>;
+    lastIntent: z.ZodOptional<z.ZodEnum<["continue", "question", "blocked", "complete", "error"]>>;
+    lastAction: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["CONTINUE", "PAUSE", "STOP", "RETRY"]>;
+        reason: z.ZodString;
+        requiresInput: z.ZodDefault<z.ZodBoolean>;
+        suggestedInput: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        reason: string;
+        requiresInput: boolean;
+        suggestedInput?: string | undefined;
+    }, {
+        type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        reason: string;
+        requiresInput?: boolean | undefined;
+        suggestedInput?: string | undefined;
+    }>>;
+    consecutiveErrors: z.ZodDefault<z.ZodNumber>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        iteration: z.ZodNumber;
+        message: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        timestamp: string;
+        iteration: number;
+    }, {
+        message: string;
+        timestamp: string;
+        iteration: number;
+    }>, "many">>;
+    history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        iteration: z.ZodNumber;
+        intent: z.ZodEnum<["continue", "question", "blocked", "complete", "error"]>;
+        action: z.ZodEnum<["CONTINUE", "PAUSE", "STOP", "RETRY"]>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        iteration: number;
+        intent: "continue" | "blocked" | "error" | "question" | "complete";
+    }, {
+        timestamp: string;
+        action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        iteration: number;
+        intent: "continue" | "blocked" | "error" | "question" | "complete";
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "failed" | "running" | "paused" | "budget_exceeded";
+    sessionId: string;
+    startedAt: string;
+    budget: {
+        maxIterations: number;
+        maxTimeMs: number;
+        maxTokens?: number | undefined;
+    };
+    consumed: {
+        iterations: number;
+        timeMs: number;
+        tokens?: number | undefined;
+    };
+    iteration: number;
+    lastActivityAt: string;
+    consecutiveErrors: number;
+    taskId?: string | undefined;
+    errors?: {
+        message: string;
+        timestamp: string;
+        iteration: number;
+    }[] | undefined;
+    lastIntent?: "continue" | "blocked" | "error" | "question" | "complete" | undefined;
+    lastAction?: {
+        type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        reason: string;
+        requiresInput: boolean;
+        suggestedInput?: string | undefined;
+    } | undefined;
+    history?: {
+        timestamp: string;
+        action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        iteration: number;
+        intent: "continue" | "blocked" | "error" | "question" | "complete";
+    }[] | undefined;
+}, {
+    status: "completed" | "failed" | "running" | "paused" | "budget_exceeded";
+    sessionId: string;
+    startedAt: string;
+    budget: {
+        maxTokens?: number | undefined;
+        maxIterations?: number | undefined;
+        maxTimeMs?: number | undefined;
+    };
+    consumed: {
+        iterations: number;
+        timeMs: number;
+        tokens?: number | undefined;
+    };
+    iteration: number;
+    lastActivityAt: string;
+    taskId?: string | undefined;
+    errors?: {
+        message: string;
+        timestamp: string;
+        iteration: number;
+    }[] | undefined;
+    lastIntent?: "continue" | "blocked" | "error" | "question" | "complete" | undefined;
+    lastAction?: {
+        type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        reason: string;
+        requiresInput?: boolean | undefined;
+        suggestedInput?: string | undefined;
+    } | undefined;
+    consecutiveErrors?: number | undefined;
+    history?: {
+        timestamp: string;
+        action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        iteration: number;
+        intent: "continue" | "blocked" | "error" | "question" | "complete";
+    }[] | undefined;
+}>;
+export type IterateState = z.infer<typeof IterateStateSchema>;
+/**
+ * Safety guard configuration
+ */
+export declare const IterateSafetyConfigSchema: z.ZodObject<{
+    maxConsecutiveErrors: z.ZodDefault<z.ZodNumber>;
+    enableDangerousPatternDetection: z.ZodDefault<z.ZodBoolean>;
+    dangerousPatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    customDangerousPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    maxConsecutiveErrors: number;
+    enableDangerousPatternDetection: boolean;
+    dangerousPatterns: string[];
+    customDangerousPatterns?: string[] | undefined;
+}, {
+    maxConsecutiveErrors?: number | undefined;
+    enableDangerousPatternDetection?: boolean | undefined;
+    dangerousPatterns?: string[] | undefined;
+    customDangerousPatterns?: string[] | undefined;
+}>;
+export type IterateSafetyConfig = z.infer<typeof IterateSafetyConfigSchema>;
+/**
+ * Safety check result
+ */
+export declare const SafetyCheckResultSchema: z.ZodObject<{
+    safe: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+    matchedPattern: z.ZodOptional<z.ZodString>;
+    severity: z.ZodOptional<z.ZodEnum<["warning", "danger", "critical"]>>;
+}, "strip", z.ZodTypeAny, {
+    safe: boolean;
+    severity?: "critical" | "warning" | "danger" | undefined;
+    reason?: string | undefined;
+    matchedPattern?: string | undefined;
+}, {
+    safe: boolean;
+    severity?: "critical" | "warning" | "danger" | undefined;
+    reason?: string | undefined;
+    matchedPattern?: string | undefined;
+}>;
+export type SafetyCheckResult = z.infer<typeof SafetyCheckResultSchema>;
+/**
+ * Request to start iterate mode
+ */
+export declare const IterateStartRequestSchema: z.ZodObject<{
+    task: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    budget: z.ZodOptional<z.ZodObject<{
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+        maxTimeMs: z.ZodDefault<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxIterations: number;
+        maxTimeMs: number;
+        maxTokens?: number | undefined;
+    }, {
+        maxTokens?: number | undefined;
+        maxIterations?: number | undefined;
+        maxTimeMs?: number | undefined;
+    }>>;
+    safety: z.ZodOptional<z.ZodObject<{
+        maxConsecutiveErrors: z.ZodDefault<z.ZodNumber>;
+        enableDangerousPatternDetection: z.ZodDefault<z.ZodBoolean>;
+        dangerousPatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        customDangerousPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        maxConsecutiveErrors: number;
+        enableDangerousPatternDetection: boolean;
+        dangerousPatterns: string[];
+        customDangerousPatterns?: string[] | undefined;
+    }, {
+        maxConsecutiveErrors?: number | undefined;
+        enableDangerousPatternDetection?: boolean | undefined;
+        dangerousPatterns?: string[] | undefined;
+        customDangerousPatterns?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    task: string;
+    sessionId?: string | undefined;
+    budget?: {
+        maxIterations: number;
+        maxTimeMs: number;
+        maxTokens?: number | undefined;
+    } | undefined;
+    safety?: {
+        maxConsecutiveErrors: number;
+        enableDangerousPatternDetection: boolean;
+        dangerousPatterns: string[];
+        customDangerousPatterns?: string[] | undefined;
+    } | undefined;
+}, {
+    task: string;
+    sessionId?: string | undefined;
+    budget?: {
+        maxTokens?: number | undefined;
+        maxIterations?: number | undefined;
+        maxTimeMs?: number | undefined;
+    } | undefined;
+    safety?: {
+        maxConsecutiveErrors?: number | undefined;
+        enableDangerousPatternDetection?: boolean | undefined;
+        dangerousPatterns?: string[] | undefined;
+        customDangerousPatterns?: string[] | undefined;
+    } | undefined;
+}>;
+export type IterateStartRequest = z.infer<typeof IterateStartRequestSchema>;
+/**
+ * Response from handling an iteration
+ */
+export declare const IterateHandleResponseSchema: z.ZodObject<{
+    action: z.ZodObject<{
+        type: z.ZodEnum<["CONTINUE", "PAUSE", "STOP", "RETRY"]>;
+        reason: z.ZodString;
+        requiresInput: z.ZodDefault<z.ZodBoolean>;
+        suggestedInput: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        reason: string;
+        requiresInput: boolean;
+        suggestedInput?: string | undefined;
+    }, {
+        type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        reason: string;
+        requiresInput?: boolean | undefined;
+        suggestedInput?: string | undefined;
+    }>;
+    newState: z.ZodObject<{
+        sessionId: z.ZodString;
+        taskId: z.ZodOptional<z.ZodString>;
+        budget: z.ZodObject<{
+            maxIterations: z.ZodDefault<z.ZodNumber>;
+            maxTimeMs: z.ZodDefault<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxIterations: number;
+            maxTimeMs: number;
+            maxTokens?: number | undefined;
+        }, {
+            maxTokens?: number | undefined;
+            maxIterations?: number | undefined;
+            maxTimeMs?: number | undefined;
+        }>;
+        consumed: z.ZodObject<{
+            iterations: z.ZodNumber;
+            timeMs: z.ZodNumber;
+            tokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            iterations: number;
+            timeMs: number;
+            tokens?: number | undefined;
+        }, {
+            iterations: number;
+            timeMs: number;
+            tokens?: number | undefined;
+        }>;
+        iteration: z.ZodNumber;
+        startedAt: z.ZodString;
+        lastActivityAt: z.ZodString;
+        status: z.ZodEnum<["running", "paused", "completed", "failed", "budget_exceeded"]>;
+        lastIntent: z.ZodOptional<z.ZodEnum<["continue", "question", "blocked", "complete", "error"]>>;
+        lastAction: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["CONTINUE", "PAUSE", "STOP", "RETRY"]>;
+            reason: z.ZodString;
+            requiresInput: z.ZodDefault<z.ZodBoolean>;
+            suggestedInput: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            reason: string;
+            requiresInput: boolean;
+            suggestedInput?: string | undefined;
+        }, {
+            type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            reason: string;
+            requiresInput?: boolean | undefined;
+            suggestedInput?: string | undefined;
+        }>>;
+        consecutiveErrors: z.ZodDefault<z.ZodNumber>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            iteration: z.ZodNumber;
+            message: z.ZodString;
+            timestamp: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            timestamp: string;
+            iteration: number;
+        }, {
+            message: string;
+            timestamp: string;
+            iteration: number;
+        }>, "many">>;
+        history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            iteration: z.ZodNumber;
+            intent: z.ZodEnum<["continue", "question", "blocked", "complete", "error"]>;
+            action: z.ZodEnum<["CONTINUE", "PAUSE", "STOP", "RETRY"]>;
+            timestamp: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            timestamp: string;
+            action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            iteration: number;
+            intent: "continue" | "blocked" | "error" | "question" | "complete";
+        }, {
+            timestamp: string;
+            action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            iteration: number;
+            intent: "continue" | "blocked" | "error" | "question" | "complete";
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "failed" | "running" | "paused" | "budget_exceeded";
+        sessionId: string;
+        startedAt: string;
+        budget: {
+            maxIterations: number;
+            maxTimeMs: number;
+            maxTokens?: number | undefined;
+        };
+        consumed: {
+            iterations: number;
+            timeMs: number;
+            tokens?: number | undefined;
+        };
+        iteration: number;
+        lastActivityAt: string;
+        consecutiveErrors: number;
+        taskId?: string | undefined;
+        errors?: {
+            message: string;
+            timestamp: string;
+            iteration: number;
+        }[] | undefined;
+        lastIntent?: "continue" | "blocked" | "error" | "question" | "complete" | undefined;
+        lastAction?: {
+            type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            reason: string;
+            requiresInput: boolean;
+            suggestedInput?: string | undefined;
+        } | undefined;
+        history?: {
+            timestamp: string;
+            action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            iteration: number;
+            intent: "continue" | "blocked" | "error" | "question" | "complete";
+        }[] | undefined;
+    }, {
+        status: "completed" | "failed" | "running" | "paused" | "budget_exceeded";
+        sessionId: string;
+        startedAt: string;
+        budget: {
+            maxTokens?: number | undefined;
+            maxIterations?: number | undefined;
+            maxTimeMs?: number | undefined;
+        };
+        consumed: {
+            iterations: number;
+            timeMs: number;
+            tokens?: number | undefined;
+        };
+        iteration: number;
+        lastActivityAt: string;
+        taskId?: string | undefined;
+        errors?: {
+            message: string;
+            timestamp: string;
+            iteration: number;
+        }[] | undefined;
+        lastIntent?: "continue" | "blocked" | "error" | "question" | "complete" | undefined;
+        lastAction?: {
+            type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            reason: string;
+            requiresInput?: boolean | undefined;
+            suggestedInput?: string | undefined;
+        } | undefined;
+        consecutiveErrors?: number | undefined;
+        history?: {
+            timestamp: string;
+            action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            iteration: number;
+            intent: "continue" | "blocked" | "error" | "question" | "complete";
+        }[] | undefined;
+    }>;
+    content: z.ZodOptional<z.ZodString>;
+    autoResponse: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: {
+        type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        reason: string;
+        requiresInput: boolean;
+        suggestedInput?: string | undefined;
+    };
+    newState: {
+        status: "completed" | "failed" | "running" | "paused" | "budget_exceeded";
+        sessionId: string;
+        startedAt: string;
+        budget: {
+            maxIterations: number;
+            maxTimeMs: number;
+            maxTokens?: number | undefined;
+        };
+        consumed: {
+            iterations: number;
+            timeMs: number;
+            tokens?: number | undefined;
+        };
+        iteration: number;
+        lastActivityAt: string;
+        consecutiveErrors: number;
+        taskId?: string | undefined;
+        errors?: {
+            message: string;
+            timestamp: string;
+            iteration: number;
+        }[] | undefined;
+        lastIntent?: "continue" | "blocked" | "error" | "question" | "complete" | undefined;
+        lastAction?: {
+            type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            reason: string;
+            requiresInput: boolean;
+            suggestedInput?: string | undefined;
+        } | undefined;
+        history?: {
+            timestamp: string;
+            action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            iteration: number;
+            intent: "continue" | "blocked" | "error" | "question" | "complete";
+        }[] | undefined;
+    };
+    content?: string | undefined;
+    autoResponse?: string | undefined;
+}, {
+    action: {
+        type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+        reason: string;
+        requiresInput?: boolean | undefined;
+        suggestedInput?: string | undefined;
+    };
+    newState: {
+        status: "completed" | "failed" | "running" | "paused" | "budget_exceeded";
+        sessionId: string;
+        startedAt: string;
+        budget: {
+            maxTokens?: number | undefined;
+            maxIterations?: number | undefined;
+            maxTimeMs?: number | undefined;
+        };
+        consumed: {
+            iterations: number;
+            timeMs: number;
+            tokens?: number | undefined;
+        };
+        iteration: number;
+        lastActivityAt: string;
+        taskId?: string | undefined;
+        errors?: {
+            message: string;
+            timestamp: string;
+            iteration: number;
+        }[] | undefined;
+        lastIntent?: "continue" | "blocked" | "error" | "question" | "complete" | undefined;
+        lastAction?: {
+            type: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            reason: string;
+            requiresInput?: boolean | undefined;
+            suggestedInput?: string | undefined;
+        } | undefined;
+        consecutiveErrors?: number | undefined;
+        history?: {
+            timestamp: string;
+            action: "CONTINUE" | "PAUSE" | "STOP" | "RETRY";
+            iteration: number;
+            intent: "continue" | "blocked" | "error" | "question" | "complete";
+        }[] | undefined;
+    };
+    content?: string | undefined;
+    autoResponse?: string | undefined;
+}>;
+export type IterateHandleResponse = z.infer<typeof IterateHandleResponseSchema>;
+/**
+ * Iterate error codes
+ */
+export declare const IterateErrorCode: {
+    readonly ITERATE_BUDGET_EXCEEDED: "ITERATE_BUDGET_EXCEEDED";
+    readonly ITERATE_MAX_ERRORS: "ITERATE_MAX_ERRORS";
+    readonly ITERATE_DANGEROUS_PATTERN: "ITERATE_DANGEROUS_PATTERN";
+    readonly ITERATE_INVALID_STATE: "ITERATE_INVALID_STATE";
+    readonly ITERATE_PROVIDER_ERROR: "ITERATE_PROVIDER_ERROR";
+};
+export type IterateErrorCode = (typeof IterateErrorCode)[keyof typeof IterateErrorCode];
+/**
+ * Validates iterate intent
+ */
+export declare function validateIterateIntent(data: unknown): IterateIntent;
+/**
+ * Safely validates iterate intent
+ */
+export declare function safeValidateIterateIntent(data: unknown): {
+    success: true;
+    data: IterateIntent;
+} | {
+    success: false;
+    error: z.ZodError;
+};
+/**
+ * Validates iterate budget
+ */
+export declare function validateIterateBudget(data: unknown): IterateBudget;
+/**
+ * Validates iterate state
+ */
+export declare function validateIterateState(data: unknown): IterateState;
+/**
+ * Validates iterate start request
+ */
+export declare function validateIterateStartRequest(data: unknown): IterateStartRequest;
+/**
+ * Validates safety config
+ */
+export declare function validateIterateSafetyConfig(data: unknown): IterateSafetyConfig;
+//# sourceMappingURL=schema.d.ts.map

package/dist/iterate/v1/schema.d.ts.map

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