@vfarcic/dot-ai 0.89.0 → 0.91.0

package/dist/tools/remediate.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Remediate Tool - AI-powered Kubernetes issue analysis and remediation
+ */
+import { z } from 'zod';
+export declare const REMEDIATE_TOOL_NAME = "remediate";
+export declare const REMEDIATE_TOOL_DESCRIPTION = "AI-powered Kubernetes issue analysis that provides root cause identification and actionable remediation steps. Unlike basic kubectl commands, this tool performs multi-step investigation, correlates cluster data, and generates intelligent solutions. Use when users want to understand WHY something is broken, not just see raw status. Ideal for: troubleshooting failures, diagnosing performance issues, analyzing pod problems, investigating networking/storage issues, or any \"what's wrong\" questions.";
+export declare const SAFE_OPERATIONS: readonly ["get", "describe", "logs", "events", "top", "explain"];
+export type SafeOperation = typeof SAFE_OPERATIONS[number];
+export declare const REMEDIATE_TOOL_INPUT_SCHEMA: {
+    issue: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodObject<{
+        event: z.ZodOptional<z.ZodAny>;
+        logs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        metrics: z.ZodOptional<z.ZodAny>;
+        podSpec: z.ZodOptional<z.ZodAny>;
+        relatedEvents: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        logs?: string[] | undefined;
+        event?: any;
+        metrics?: any;
+        podSpec?: any;
+        relatedEvents?: any[] | undefined;
+    }, {
+        logs?: string[] | undefined;
+        event?: any;
+        metrics?: any;
+        podSpec?: any;
+        relatedEvents?: any[] | undefined;
+    }>>;
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["manual", "automatic"]>>>;
+    confidenceThreshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxRiskLevel: z.ZodDefault<z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>>;
+    executeChoice: z.ZodOptional<z.ZodNumber>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    executedCommands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export interface RemediateInput {
+    issue?: string;
+    context?: {
+        event?: any;
+        logs?: string[];
+        metrics?: any;
+        podSpec?: any;
+        relatedEvents?: any[];
+    };
+    mode?: 'manual' | 'automatic';
+    confidenceThreshold?: number;
+    maxRiskLevel?: 'low' | 'medium' | 'high';
+    executeChoice?: number;
+    sessionId?: string;
+    executedCommands?: string[];
+}
+export interface DataRequest {
+    type: string;
+    resource: string;
+    namespace?: string;
+    args?: string[];
+    rationale: string;
+}
+export interface InvestigationIteration {
+    step: number;
+    aiAnalysis: string;
+    dataRequests: DataRequest[];
+    gatheredData: {
+        [key: string]: any;
+    };
+    complete: boolean;
+    timestamp: Date;
+}
+export interface RemediateSession {
+    sessionId: string;
+    issue: string;
+    initialContext: any;
+    mode: 'manual' | 'automatic';
+    iterations: InvestigationIteration[];
+    finalAnalysis?: RemediateOutput;
+    created: Date;
+    updated: Date;
+    status: 'investigating' | 'analysis_complete' | 'failed' | 'executed_successfully' | 'executed_with_errors' | 'cancelled';
+    executionResults?: ExecutionResult[];
+}
+export interface RemediationAction {
+    description: string;
+    command?: string;
+    risk: 'low' | 'medium' | 'high';
+    rationale: string;
+}
+export interface ExecutionResult {
+    action: string;
+    success: boolean;
+    output?: string;
+    error?: string;
+    timestamp: Date;
+}
+export interface ExecutionChoice {
+    id: number;
+    label: string;
+    description: string;
+    risk?: 'low' | 'medium' | 'high';
+}
+export interface RemediateOutput {
+    status: 'success' | 'failed' | 'awaiting_user_approval';
+    sessionId: string;
+    investigation: {
+        iterations: number;
+        dataGathered: string[];
+    };
+    analysis: {
+        rootCause: string;
+        confidence: number;
+        factors: string[];
+    };
+    remediation: {
+        summary: string;
+        actions: RemediationAction[];
+        risk: 'low' | 'medium' | 'high';
+    };
+    validationIntent?: string;
+    guidance?: string;
+    agentInstructions?: string;
+    nextAction?: string;
+    message?: string;
+    executionChoices?: ExecutionChoice[];
+    executed?: boolean;
+    results?: ExecutionResult[];
+    fallbackReason?: string;
+    mode?: 'manual' | 'automatic';
+}
+/**
+ * AI Response interface matching our prompt format
+ */
+interface AIInvestigationResponse {
+    analysis: string;
+    dataRequests: DataRequest[];
+    investigationComplete: boolean;
+    confidence: number;
+    reasoning: string;
+    needsMoreSpecificInfo?: boolean;
+}
+/**
+ * AI Final Analysis Response interface matching final analysis prompt format
+ */
+interface AIFinalAnalysisResponse {
+    issueStatus: 'active' | 'resolved' | 'non_existent';
+    rootCause: string;
+    confidence: number;
+    factors: string[];
+    remediation: {
+        summary: string;
+        actions: RemediationAction[];
+        risk: 'low' | 'medium' | 'high';
+    };
+    validationIntent?: string;
+}
+/**
+ * Parse AI final analysis response
+ */
+export declare function parseAIFinalAnalysis(aiResponse: string): AIFinalAnalysisResponse;
+/**
+ * Parse AI response for data requests and investigation status
+ */
+export declare function parseAIResponse(aiResponse: string): {
+    dataRequests: DataRequest[];
+    isComplete: boolean;
+    needsMoreSpecificInfo?: boolean;
+    parsedResponse?: AIInvestigationResponse;
+};
+/**
+ * Main tool handler for remediate tool
+ */
+export declare function handleRemediateTool(args: any): Promise<any>;
+export {};
+//# sourceMappingURL=remediate.d.ts.map

package/dist/tools/remediate.d.ts.map

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