@kernel.chat/kbot 2.8.0 → 2.9.1

package/dist/confidence.d.ts

@@ -0,0 +1,102 @@
+export interface ConfidenceScore {
+    /** 0-1: overall confidence in the action/response */
+    overall: number;
+    /** 0-1: how sure about factual accuracy */
+    factual: number;
+    /** 0-1: how sure the chosen approach is correct */
+    approach: number;
+    /** 0-1: how sure all aspects were covered */
+    completeness: number;
+    /** One-line explanation of the confidence level */
+    reasoning: string;
+}
+/**
+ * Estimate confidence for a task before execution.
+ *
+ * Considers task complexity, past success with similar tasks,
+ * provider capability, and available context.
+ */
+export declare function estimateConfidence(task: string, context: string): ConfidenceScore;
+/**
+ * Format a confidence score as a human-readable string.
+ */
+export declare function reportConfidence(score: ConfidenceScore): string;
+/**
+ * Record a calibration entry — predicted vs actual (from self-eval or user feedback).
+ * Called after a task completes to improve future predictions.
+ */
+export declare function recordCalibration(task: string, predicted: number, actual: number): void;
+export interface SkillEntry {
+    /** Domain or skill area, e.g. 'typescript', 'python', 'devops' */
+    domain: string;
+    /** 0-1 success rate from historical data */
+    successRate: number;
+    /** 0-1 average confidence when working in this domain */
+    avgConfidence: number;
+    /** Number of task attempts */
+    sampleSize: number;
+    /** ISO date of last attempt */
+    lastAttempt: string;
+}
+export interface SkillProfile {
+    /** Domains the agent excels at (successRate >= 0.7, sampleSize >= 3) */
+    strengths: SkillEntry[];
+    /** Domains the agent struggles with (successRate < 0.5, sampleSize >= 3) */
+    weaknesses: SkillEntry[];
+    /** Domains the agent hasn't tried enough to assess (<3 samples) */
+    unknown: string[];
+}
+/**
+ * Build a skill profile from stored skill data and calibration history.
+ */
+export declare function getSkillProfile(): SkillProfile;
+/**
+ * Assess whether the agent is suitable for a given task.
+ */
+export declare function assessSkillForTask(task: string): {
+    canDo: boolean;
+    confidence: number;
+    suggestion?: string;
+};
+/**
+ * Update the skill profile after completing a task.
+ *
+ * @param domain - The task domain (auto-detected or overridden)
+ * @param success - Whether the task completed successfully
+ * @param confidence - The confidence score used for this task
+ */
+export declare function updateSkillProfile(domain: string, success: boolean, confidence: number): void;
+export interface EffortEstimate {
+    /** Tool call count estimate: min, expected, max */
+    toolCalls: {
+        min: number;
+        expected: number;
+        max: number;
+    };
+    /** Estimated cost in USD: min, expected, max */
+    estimatedCostUsd: {
+        min: number;
+        expected: number;
+        max: number;
+    };
+    /** Complexity classification */
+    complexity: 'trivial' | 'simple' | 'moderate' | 'complex' | 'ambitious';
+    /** Human-readable breakdown of expected operations */
+    breakdown: string;
+}
+/**
+ * Estimate the effort required for a task — tool calls, cost, and complexity.
+ *
+ * @param task - The task description
+ * @param context - Optional context (repo state, file list, etc.)
+ */
+export declare function estimateEffort(task: string, context?: string): EffortEstimate;
+/**
+ * Record actual effort after a task completes, for future calibration.
+ */
+export declare function recordActualEffort(task: string, actualToolCalls: number, actualCostUsd: number): void;
+/**
+ * Register confidence engine tools with the K:BOT tool registry.
+ */
+export declare function registerConfidenceTools(): void;
+//# sourceMappingURL=confidence.d.ts.map

package/dist/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../src/confidence.ts"],"names":[],"mappings":"AAiDA,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAA;IACpB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAA;CAClB;AAsHD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAiFjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAa/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAkBvF;AAOD,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,SAAS,EAAE,UAAU,EAAE,CAAA;IACvB,4EAA4E;IAC5E,UAAU,EAAE,UAAU,EAAE,CAAA;IACxB,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAqBD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAoE9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAChD,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAqCA;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAqB7F;AAOD,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,gDAAgD;IAChD,gBAAgB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,gCAAgC;IAChC,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAA;IACvE,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;CAClB;AAyID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAkE7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAarG;AAOD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CA2H9C"}