@nexalab/agent-sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,1020 @@
+import { z } from "zod";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export declare const agentTaskStateSchema: z.ZodEnum<["IDLE", "RECEIVED", "UNDERSTANDING", "DEFINING_SUCCESS", "PLANNING", "VALIDATING_PLAN", "DISCOVERING_CAPABILITIES", "SELECTING_TOOL", "WAITING_FOR_APPROVAL", "WAITING_FOR_AUTH", "WAITING_FOR_EXTERNAL_JOB", "WAITING_FOR_RETRY", "PAUSED", "EXECUTING", "OBSERVING", "EVALUATING", "VALIDATING", "REPLANNING", "RECOVERING", "BLOCKED", "COMPLETED", "FAILED", "CANCELLED"]>;
+export type AgentTaskState = z.infer<typeof agentTaskStateSchema>;
+export declare const goalKindSchema: z.ZodEnum<["question", "simple_action", "compound_goal", "research", "creation", "repair", "external_operation", "continuous_task", "blocked_or_impossible"]>;
+export type GoalKind = z.infer<typeof goalKindSchema>;
+export declare const evidenceRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    summary: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: string;
+    summary: string;
+    uri?: string | undefined;
+}, {
+    id: string;
+    kind: string;
+    summary: string;
+    uri?: string | undefined;
+}>;
+export type EvidenceRef = z.infer<typeof evidenceRefSchema>;
+export declare const evidenceRequirementSchema: z.ZodObject<{
+    kind: z.ZodString;
+    description: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    description: string;
+    required: boolean;
+}, {
+    kind: string;
+    description: string;
+    required?: boolean | undefined;
+}>;
+export type EvidenceRequirement = z.infer<typeof evidenceRequirementSchema>;
+export declare const successCriterionSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    verificationMethod: z.ZodEnum<["tool_evidence", "test_result", "health_check", "user_confirmation", "source_citation", "artifact_exists", "manual_blocker"]>;
+    requiredEvidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        description: string;
+        required: boolean;
+    }, {
+        kind: string;
+        description: string;
+        required?: boolean | undefined;
+    }>, "many">>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    status: z.ZodDefault<z.ZodEnum<["SATISFIED", "UNSATISFIED", "UNKNOWN"]>>;
+    evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        summary: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }, {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "SATISFIED" | "UNSATISFIED" | "UNKNOWN";
+    id: string;
+    description: string;
+    required: boolean;
+    verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+    requiredEvidence: {
+        kind: string;
+        description: string;
+        required: boolean;
+    }[];
+    evidenceRefs: {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }[];
+}, {
+    id: string;
+    description: string;
+    verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+    status?: "SATISFIED" | "UNSATISFIED" | "UNKNOWN" | undefined;
+    required?: boolean | undefined;
+    requiredEvidence?: {
+        kind: string;
+        description: string;
+        required?: boolean | undefined;
+    }[] | undefined;
+    evidenceRefs?: {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }[] | undefined;
+}>;
+export type SuccessCriterion = z.infer<typeof successCriterionSchema>;
+export type SuccessCriterionStatus = SuccessCriterion["status"];
+export declare const capabilityRequirementSchema: z.ZodObject<{
+    capability: z.ZodString;
+    operation: z.ZodOptional<z.ZodString>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    constraints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    required: boolean;
+    capability: string;
+    constraints: Record<string, unknown>;
+    operation?: string | undefined;
+}, {
+    capability: string;
+    required?: boolean | undefined;
+    operation?: string | undefined;
+    constraints?: Record<string, unknown> | undefined;
+}>;
+export type CapabilityRequirement = z.infer<typeof capabilityRequirementSchema>;
+export declare const interpretedGoalSchema: z.ZodObject<{
+    objective: z.ZodString;
+    kind: z.ZodEnum<["question", "simple_action", "compound_goal", "research", "creation", "repair", "external_operation", "continuous_task", "blocked_or_impossible"]>;
+    constraints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    deliverables: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    assumptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    risks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    requiredCapabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        capability: z.ZodString;
+        operation: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        constraints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        required: boolean;
+        capability: string;
+        constraints: Record<string, unknown>;
+        operation?: string | undefined;
+    }, {
+        capability: string;
+        required?: boolean | undefined;
+        operation?: string | undefined;
+        constraints?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    successCriteria: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        verificationMethod: z.ZodEnum<["tool_evidence", "test_result", "health_check", "user_confirmation", "source_citation", "artifact_exists", "manual_blocker"]>;
+        requiredEvidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            kind: string;
+            description: string;
+            required: boolean;
+        }, {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }>, "many">>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        status: z.ZodDefault<z.ZodEnum<["SATISFIED", "UNSATISFIED", "UNKNOWN"]>>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            summary: z.ZodString;
+            uri: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }, {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        status: "SATISFIED" | "UNSATISFIED" | "UNKNOWN";
+        id: string;
+        description: string;
+        required: boolean;
+        verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+        requiredEvidence: {
+            kind: string;
+            description: string;
+            required: boolean;
+        }[];
+        evidenceRefs: {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }[];
+    }, {
+        id: string;
+        description: string;
+        verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+        status?: "SATISFIED" | "UNSATISFIED" | "UNKNOWN" | undefined;
+        required?: boolean | undefined;
+        requiredEvidence?: {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        evidenceRefs?: {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    userVisibleOutcome: z.ZodString;
+    needsClarification: z.ZodDefault<z.ZodBoolean>;
+    clarificationQuestions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    kind: "question" | "simple_action" | "compound_goal" | "research" | "creation" | "repair" | "external_operation" | "continuous_task" | "blocked_or_impossible";
+    constraints: string[];
+    objective: string;
+    deliverables: string[];
+    assumptions: string[];
+    risks: string[];
+    requiredCapabilities: {
+        required: boolean;
+        capability: string;
+        constraints: Record<string, unknown>;
+        operation?: string | undefined;
+    }[];
+    successCriteria: {
+        status: "SATISFIED" | "UNSATISFIED" | "UNKNOWN";
+        id: string;
+        description: string;
+        required: boolean;
+        verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+        requiredEvidence: {
+            kind: string;
+            description: string;
+            required: boolean;
+        }[];
+        evidenceRefs: {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }[];
+    }[];
+    userVisibleOutcome: string;
+    needsClarification: boolean;
+    clarificationQuestions: string[];
+}, {
+    kind: "question" | "simple_action" | "compound_goal" | "research" | "creation" | "repair" | "external_operation" | "continuous_task" | "blocked_or_impossible";
+    objective: string;
+    userVisibleOutcome: string;
+    constraints?: string[] | undefined;
+    deliverables?: string[] | undefined;
+    assumptions?: string[] | undefined;
+    risks?: string[] | undefined;
+    requiredCapabilities?: {
+        capability: string;
+        required?: boolean | undefined;
+        operation?: string | undefined;
+        constraints?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    successCriteria?: {
+        id: string;
+        description: string;
+        verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+        status?: "SATISFIED" | "UNSATISFIED" | "UNKNOWN" | undefined;
+        required?: boolean | undefined;
+        requiredEvidence?: {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        evidenceRefs?: {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    needsClarification?: boolean | undefined;
+    clarificationQuestions?: string[] | undefined;
+}>;
+export type InterpretedGoal = z.infer<typeof interpretedGoalSchema>;
+export declare const agentStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    objective: z.ZodString;
+    type: z.ZodEnum<["understand", "discover", "read", "write", "execute", "delegate", "research", "validate", "ask_user", "finalize"]>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    requiredCapabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        capability: z.ZodString;
+        operation: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        constraints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        required: boolean;
+        capability: string;
+        constraints: Record<string, unknown>;
+        operation?: string | undefined;
+    }, {
+        capability: string;
+        required?: boolean | undefined;
+        operation?: string | undefined;
+        constraints?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    candidateTools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    risk: z.ZodDefault<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+    approvalRisk: z.ZodDefault<z.ZodEnum<["SAFE_READ", "LOCAL_WRITE", "EXTERNAL_WRITE", "INSTALL_DEPENDENCY", "CREDENTIAL_ACCESS", "ACCOUNT_CONNECTION", "SENSITIVE_DATA", "DESTRUCTIVE", "FINANCIAL", "PRIVILEGED_EXECUTION"]>>;
+    expectedEvidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        description: string;
+        required: boolean;
+    }, {
+        kind: string;
+        description: string;
+        required?: boolean | undefined;
+    }>, "many">>;
+    successCriteria: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        verificationMethod: z.ZodEnum<["tool_evidence", "test_result", "health_check", "user_confirmation", "source_citation", "artifact_exists", "manual_blocker"]>;
+        requiredEvidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            kind: string;
+            description: string;
+            required: boolean;
+        }, {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }>, "many">>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        status: z.ZodDefault<z.ZodEnum<["SATISFIED", "UNSATISFIED", "UNKNOWN"]>>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            summary: z.ZodString;
+            uri: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }, {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        status: "SATISFIED" | "UNSATISFIED" | "UNKNOWN";
+        id: string;
+        description: string;
+        required: boolean;
+        verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+        requiredEvidence: {
+            kind: string;
+            description: string;
+            required: boolean;
+        }[];
+        evidenceRefs: {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }[];
+    }, {
+        id: string;
+        description: string;
+        verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+        status?: "SATISFIED" | "UNSATISFIED" | "UNKNOWN" | undefined;
+        required?: boolean | undefined;
+        requiredEvidence?: {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        evidenceRefs?: {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    retryPolicy: z.ZodDefault<z.ZodObject<{
+        maxAttempts: z.ZodDefault<z.ZodNumber>;
+        backoffMs: z.ZodDefault<z.ZodNumber>;
+        maxBackoffMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxAttempts: number;
+        backoffMs: number;
+        maxBackoffMs: number;
+    }, {
+        maxAttempts?: number | undefined;
+        backoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+    }>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    idempotencyKey: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<["pending", "ready", "waiting_approval", "waiting_auth", "waiting_external_job", "waiting_retry", "running", "observing", "evaluating", "completed", "failed", "blocked", "skipped", "cancelled"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "research" | "understand" | "discover" | "read" | "write" | "execute" | "delegate" | "validate" | "ask_user" | "finalize";
+    status: "pending" | "ready" | "waiting_approval" | "waiting_auth" | "waiting_external_job" | "waiting_retry" | "running" | "observing" | "evaluating" | "completed" | "failed" | "blocked" | "skipped" | "cancelled";
+    id: string;
+    objective: string;
+    requiredCapabilities: {
+        required: boolean;
+        capability: string;
+        constraints: Record<string, unknown>;
+        operation?: string | undefined;
+    }[];
+    successCriteria: {
+        status: "SATISFIED" | "UNSATISFIED" | "UNKNOWN";
+        id: string;
+        description: string;
+        required: boolean;
+        verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+        requiredEvidence: {
+            kind: string;
+            description: string;
+            required: boolean;
+        }[];
+        evidenceRefs: {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }[];
+    }[];
+    dependencies: string[];
+    candidateTools: string[];
+    risk: "low" | "medium" | "high" | "critical";
+    approvalRisk: "SAFE_READ" | "LOCAL_WRITE" | "EXTERNAL_WRITE" | "INSTALL_DEPENDENCY" | "CREDENTIAL_ACCESS" | "ACCOUNT_CONNECTION" | "SENSITIVE_DATA" | "DESTRUCTIVE" | "FINANCIAL" | "PRIVILEGED_EXECUTION";
+    expectedEvidence: {
+        kind: string;
+        description: string;
+        required: boolean;
+    }[];
+    retryPolicy: {
+        maxAttempts: number;
+        backoffMs: number;
+        maxBackoffMs: number;
+    };
+    timeoutMs: number;
+    idempotencyKey: string;
+}, {
+    type: "research" | "understand" | "discover" | "read" | "write" | "execute" | "delegate" | "validate" | "ask_user" | "finalize";
+    id: string;
+    objective: string;
+    idempotencyKey: string;
+    status?: "pending" | "ready" | "waiting_approval" | "waiting_auth" | "waiting_external_job" | "waiting_retry" | "running" | "observing" | "evaluating" | "completed" | "failed" | "blocked" | "skipped" | "cancelled" | undefined;
+    requiredCapabilities?: {
+        capability: string;
+        required?: boolean | undefined;
+        operation?: string | undefined;
+        constraints?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    successCriteria?: {
+        id: string;
+        description: string;
+        verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+        status?: "SATISFIED" | "UNSATISFIED" | "UNKNOWN" | undefined;
+        required?: boolean | undefined;
+        requiredEvidence?: {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        evidenceRefs?: {
+            id: string;
+            kind: string;
+            summary: string;
+            uri?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    dependencies?: string[] | undefined;
+    candidateTools?: string[] | undefined;
+    risk?: "low" | "medium" | "high" | "critical" | undefined;
+    approvalRisk?: "SAFE_READ" | "LOCAL_WRITE" | "EXTERNAL_WRITE" | "INSTALL_DEPENDENCY" | "CREDENTIAL_ACCESS" | "ACCOUNT_CONNECTION" | "SENSITIVE_DATA" | "DESTRUCTIVE" | "FINANCIAL" | "PRIVILEGED_EXECUTION" | undefined;
+    expectedEvidence?: {
+        kind: string;
+        description: string;
+        required?: boolean | undefined;
+    }[] | undefined;
+    retryPolicy?: {
+        maxAttempts?: number | undefined;
+        backoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+    } | undefined;
+    timeoutMs?: number | undefined;
+}>;
+export type AgentStep = z.infer<typeof agentStepSchema>;
+export declare const agentPlanSchema: z.ZodObject<{
+    id: z.ZodString;
+    taskId: z.ZodString;
+    runId: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    status: z.ZodDefault<z.ZodEnum<["draft", "active", "superseded", "completed", "blocked", "failed"]>>;
+    rationale: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        objective: z.ZodString;
+        type: z.ZodEnum<["understand", "discover", "read", "write", "execute", "delegate", "research", "validate", "ask_user", "finalize"]>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        requiredCapabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            capability: z.ZodString;
+            operation: z.ZodOptional<z.ZodString>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            constraints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            required: boolean;
+            capability: string;
+            constraints: Record<string, unknown>;
+            operation?: string | undefined;
+        }, {
+            capability: string;
+            required?: boolean | undefined;
+            operation?: string | undefined;
+            constraints?: Record<string, unknown> | undefined;
+        }>, "many">>;
+        candidateTools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        risk: z.ZodDefault<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+        approvalRisk: z.ZodDefault<z.ZodEnum<["SAFE_READ", "LOCAL_WRITE", "EXTERNAL_WRITE", "INSTALL_DEPENDENCY", "CREDENTIAL_ACCESS", "ACCOUNT_CONNECTION", "SENSITIVE_DATA", "DESTRUCTIVE", "FINANCIAL", "PRIVILEGED_EXECUTION"]>>;
+        expectedEvidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            kind: string;
+            description: string;
+            required: boolean;
+        }, {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }>, "many">>;
+        successCriteria: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodString;
+            verificationMethod: z.ZodEnum<["tool_evidence", "test_result", "health_check", "user_confirmation", "source_citation", "artifact_exists", "manual_blocker"]>;
+            requiredEvidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                kind: z.ZodString;
+                description: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                kind: string;
+                description: string;
+                required: boolean;
+            }, {
+                kind: string;
+                description: string;
+                required?: boolean | undefined;
+            }>, "many">>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            status: z.ZodDefault<z.ZodEnum<["SATISFIED", "UNSATISFIED", "UNKNOWN"]>>;
+            evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodString;
+                summary: z.ZodString;
+                uri: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                kind: string;
+                summary: string;
+                uri?: string | undefined;
+            }, {
+                id: string;
+                kind: string;
+                summary: string;
+                uri?: string | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            status: "SATISFIED" | "UNSATISFIED" | "UNKNOWN";
+            id: string;
+            description: string;
+            required: boolean;
+            verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+            requiredEvidence: {
+                kind: string;
+                description: string;
+                required: boolean;
+            }[];
+            evidenceRefs: {
+                id: string;
+                kind: string;
+                summary: string;
+                uri?: string | undefined;
+            }[];
+        }, {
+            id: string;
+            description: string;
+            verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+            status?: "SATISFIED" | "UNSATISFIED" | "UNKNOWN" | undefined;
+            required?: boolean | undefined;
+            requiredEvidence?: {
+                kind: string;
+                description: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+            evidenceRefs?: {
+                id: string;
+                kind: string;
+                summary: string;
+                uri?: string | undefined;
+            }[] | undefined;
+        }>, "many">>;
+        retryPolicy: z.ZodDefault<z.ZodObject<{
+            maxAttempts: z.ZodDefault<z.ZodNumber>;
+            backoffMs: z.ZodDefault<z.ZodNumber>;
+            maxBackoffMs: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxAttempts: number;
+            backoffMs: number;
+            maxBackoffMs: number;
+        }, {
+            maxAttempts?: number | undefined;
+            backoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+        }>>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        idempotencyKey: z.ZodString;
+        status: z.ZodDefault<z.ZodEnum<["pending", "ready", "waiting_approval", "waiting_auth", "waiting_external_job", "waiting_retry", "running", "observing", "evaluating", "completed", "failed", "blocked", "skipped", "cancelled"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "research" | "understand" | "discover" | "read" | "write" | "execute" | "delegate" | "validate" | "ask_user" | "finalize";
+        status: "pending" | "ready" | "waiting_approval" | "waiting_auth" | "waiting_external_job" | "waiting_retry" | "running" | "observing" | "evaluating" | "completed" | "failed" | "blocked" | "skipped" | "cancelled";
+        id: string;
+        objective: string;
+        requiredCapabilities: {
+            required: boolean;
+            capability: string;
+            constraints: Record<string, unknown>;
+            operation?: string | undefined;
+        }[];
+        successCriteria: {
+            status: "SATISFIED" | "UNSATISFIED" | "UNKNOWN";
+            id: string;
+            description: string;
+            required: boolean;
+            verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+            requiredEvidence: {
+                kind: string;
+                description: string;
+                required: boolean;
+            }[];
+            evidenceRefs: {
+                id: string;
+                kind: string;
+                summary: string;
+                uri?: string | undefined;
+            }[];
+        }[];
+        dependencies: string[];
+        candidateTools: string[];
+        risk: "low" | "medium" | "high" | "critical";
+        approvalRisk: "SAFE_READ" | "LOCAL_WRITE" | "EXTERNAL_WRITE" | "INSTALL_DEPENDENCY" | "CREDENTIAL_ACCESS" | "ACCOUNT_CONNECTION" | "SENSITIVE_DATA" | "DESTRUCTIVE" | "FINANCIAL" | "PRIVILEGED_EXECUTION";
+        expectedEvidence: {
+            kind: string;
+            description: string;
+            required: boolean;
+        }[];
+        retryPolicy: {
+            maxAttempts: number;
+            backoffMs: number;
+            maxBackoffMs: number;
+        };
+        timeoutMs: number;
+        idempotencyKey: string;
+    }, {
+        type: "research" | "understand" | "discover" | "read" | "write" | "execute" | "delegate" | "validate" | "ask_user" | "finalize";
+        id: string;
+        objective: string;
+        idempotencyKey: string;
+        status?: "pending" | "ready" | "waiting_approval" | "waiting_auth" | "waiting_external_job" | "waiting_retry" | "running" | "observing" | "evaluating" | "completed" | "failed" | "blocked" | "skipped" | "cancelled" | undefined;
+        requiredCapabilities?: {
+            capability: string;
+            required?: boolean | undefined;
+            operation?: string | undefined;
+            constraints?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        successCriteria?: {
+            id: string;
+            description: string;
+            verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+            status?: "SATISFIED" | "UNSATISFIED" | "UNKNOWN" | undefined;
+            required?: boolean | undefined;
+            requiredEvidence?: {
+                kind: string;
+                description: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+            evidenceRefs?: {
+                id: string;
+                kind: string;
+                summary: string;
+                uri?: string | undefined;
+            }[] | undefined;
+        }[] | undefined;
+        dependencies?: string[] | undefined;
+        candidateTools?: string[] | undefined;
+        risk?: "low" | "medium" | "high" | "critical" | undefined;
+        approvalRisk?: "SAFE_READ" | "LOCAL_WRITE" | "EXTERNAL_WRITE" | "INSTALL_DEPENDENCY" | "CREDENTIAL_ACCESS" | "ACCOUNT_CONNECTION" | "SENSITIVE_DATA" | "DESTRUCTIVE" | "FINANCIAL" | "PRIVILEGED_EXECUTION" | undefined;
+        expectedEvidence?: {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        retryPolicy?: {
+            maxAttempts?: number | undefined;
+            backoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+        } | undefined;
+        timeoutMs?: number | undefined;
+    }>, "many">;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "failed" | "blocked" | "draft" | "active" | "superseded";
+    id: string;
+    taskId: string;
+    runId: string;
+    version: number;
+    rationale: string;
+    steps: {
+        type: "research" | "understand" | "discover" | "read" | "write" | "execute" | "delegate" | "validate" | "ask_user" | "finalize";
+        status: "pending" | "ready" | "waiting_approval" | "waiting_auth" | "waiting_external_job" | "waiting_retry" | "running" | "observing" | "evaluating" | "completed" | "failed" | "blocked" | "skipped" | "cancelled";
+        id: string;
+        objective: string;
+        requiredCapabilities: {
+            required: boolean;
+            capability: string;
+            constraints: Record<string, unknown>;
+            operation?: string | undefined;
+        }[];
+        successCriteria: {
+            status: "SATISFIED" | "UNSATISFIED" | "UNKNOWN";
+            id: string;
+            description: string;
+            required: boolean;
+            verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+            requiredEvidence: {
+                kind: string;
+                description: string;
+                required: boolean;
+            }[];
+            evidenceRefs: {
+                id: string;
+                kind: string;
+                summary: string;
+                uri?: string | undefined;
+            }[];
+        }[];
+        dependencies: string[];
+        candidateTools: string[];
+        risk: "low" | "medium" | "high" | "critical";
+        approvalRisk: "SAFE_READ" | "LOCAL_WRITE" | "EXTERNAL_WRITE" | "INSTALL_DEPENDENCY" | "CREDENTIAL_ACCESS" | "ACCOUNT_CONNECTION" | "SENSITIVE_DATA" | "DESTRUCTIVE" | "FINANCIAL" | "PRIVILEGED_EXECUTION";
+        expectedEvidence: {
+            kind: string;
+            description: string;
+            required: boolean;
+        }[];
+        retryPolicy: {
+            maxAttempts: number;
+            backoffMs: number;
+            maxBackoffMs: number;
+        };
+        timeoutMs: number;
+        idempotencyKey: string;
+    }[];
+    createdAt: string;
+}, {
+    id: string;
+    taskId: string;
+    runId: string;
+    rationale: string;
+    steps: {
+        type: "research" | "understand" | "discover" | "read" | "write" | "execute" | "delegate" | "validate" | "ask_user" | "finalize";
+        id: string;
+        objective: string;
+        idempotencyKey: string;
+        status?: "pending" | "ready" | "waiting_approval" | "waiting_auth" | "waiting_external_job" | "waiting_retry" | "running" | "observing" | "evaluating" | "completed" | "failed" | "blocked" | "skipped" | "cancelled" | undefined;
+        requiredCapabilities?: {
+            capability: string;
+            required?: boolean | undefined;
+            operation?: string | undefined;
+            constraints?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        successCriteria?: {
+            id: string;
+            description: string;
+            verificationMethod: "tool_evidence" | "test_result" | "health_check" | "user_confirmation" | "source_citation" | "artifact_exists" | "manual_blocker";
+            status?: "SATISFIED" | "UNSATISFIED" | "UNKNOWN" | undefined;
+            required?: boolean | undefined;
+            requiredEvidence?: {
+                kind: string;
+                description: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+            evidenceRefs?: {
+                id: string;
+                kind: string;
+                summary: string;
+                uri?: string | undefined;
+            }[] | undefined;
+        }[] | undefined;
+        dependencies?: string[] | undefined;
+        candidateTools?: string[] | undefined;
+        risk?: "low" | "medium" | "high" | "critical" | undefined;
+        approvalRisk?: "SAFE_READ" | "LOCAL_WRITE" | "EXTERNAL_WRITE" | "INSTALL_DEPENDENCY" | "CREDENTIAL_ACCESS" | "ACCOUNT_CONNECTION" | "SENSITIVE_DATA" | "DESTRUCTIVE" | "FINANCIAL" | "PRIVILEGED_EXECUTION" | undefined;
+        expectedEvidence?: {
+            kind: string;
+            description: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        retryPolicy?: {
+            maxAttempts?: number | undefined;
+            backoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+        } | undefined;
+        timeoutMs?: number | undefined;
+    }[];
+    createdAt: string;
+    status?: "completed" | "failed" | "blocked" | "draft" | "active" | "superseded" | undefined;
+    version?: number | undefined;
+}>;
+export type AgentPlan = z.infer<typeof agentPlanSchema>;
+export declare const agentObservationSchema: z.ZodObject<{
+    status: z.ZodEnum<["success", "partial", "failed", "running", "cancelled"]>;
+    summary: z.ZodString;
+    data: z.ZodOptional<z.ZodUnknown>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        summary: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }, {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }>, "many">>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        summary: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }, {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }>, "many">>;
+    changedResources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        summary: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }, {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }>, "many">>;
+    metrics: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        retryable: boolean;
+    }, {
+        code: string;
+        message: string;
+        retryable?: boolean | undefined;
+    }>, "many">>;
+    nextHints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "running" | "failed" | "cancelled" | "success" | "partial";
+    summary: string;
+    evidence: {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }[];
+    artifacts: {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }[];
+    changedResources: {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }[];
+    metrics: Record<string, unknown>;
+    warnings: string[];
+    errors: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    }[];
+    nextHints: string[];
+    data?: unknown;
+}, {
+    status: "running" | "failed" | "cancelled" | "success" | "partial";
+    summary: string;
+    data?: unknown;
+    evidence?: {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }[] | undefined;
+    artifacts?: {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }[] | undefined;
+    changedResources?: {
+        id: string;
+        kind: string;
+        summary: string;
+        uri?: string | undefined;
+    }[] | undefined;
+    metrics?: Record<string, unknown> | undefined;
+    warnings?: string[] | undefined;
+    errors?: {
+        code: string;
+        message: string;
+        retryable?: boolean | undefined;
+    }[] | undefined;
+    nextHints?: string[] | undefined;
+}>;
+export type AgentObservation = z.infer<typeof agentObservationSchema>;
+export type EvaluationDecision = "SUCCESS" | "PARTIAL" | "RETRY" | "REPLAN" | "NEEDS_APPROVAL" | "NEEDS_AUTH" | "WAIT_EXTERNAL" | "BLOCKED" | "FAILED";
+export type AgentEvaluation = {
+    decision: EvaluationDecision;
+    confidence: number;
+    evidenceAccepted: EvidenceRef[];
+    evidenceRejected: EvidenceRef[];
+    unmetCriteria: string[];
+    reason: string;
+};
+export type CompletionDecision = {
+    type: "COMPLETE" | "INCOMPLETE" | "BLOCKED" | "FAILED";
+    criteria: Array<{
+        criterionId: string;
+        status: SuccessCriterionStatus;
+        evidenceRefs: string[];
+        reason: string;
+    }>;
+    reason: string;
+};
+export type AgentEvent = {
+    type: "task.created" | "goal.interpreted" | "plan.created" | "step.started" | "step.completed" | "step.failed" | "task.completed" | "task.blocked" | string;
+    taskId: string;
+    runId: string;
+    stepId?: string;
+    objective?: string;
+    goal?: InterpretedGoal;
+    plan?: AgentPlan;
+    observation?: AgentObservation;
+    decision?: CompletionDecision;
+    reason?: string;
+    at: string;
+};
+export type AgentRunSnapshot = {
+    taskId: string;
+    runId: string;
+    state: AgentTaskState;
+    objective: string;
+    goal?: InterpretedGoal;
+    plan?: AgentPlan;
+    observations: AgentObservation[];
+    events: AgentEvent[];
+    createdAt: string;
+    updatedAt: string;
+};
+//# sourceMappingURL=types.d.ts.map