@denpex/sdk 0.8.0 → 0.8.1

package/README.md

@@ -39,6 +39,7 @@ Create an API key at <https://denpex.com/dashboard>. It is sent as the `X-Denpex
 |---|---|
 | `new DenpexClient({ apiKey, baseUrl?, timeoutMs? })` | Construct a client. `baseUrl` defaults to `https://api.denpex.com`; the default 320-second timeout covers the server's 290-second deep path. |
 | `diagnose(logs, opts?)` | `POST /api/diagnose` — returns the diagnosis (failure type, confidence, root cause, fix, evidence). |
+| `refine(logs, operatorAnswers, opts?)` | Re-run the same canonical diagnosis with typed answers from `clarifyingChoices`. Send the full answer history; action selections become evidence requests, not evidence. |
 | `feedback(diagnosisId, outcome, note?)` | `POST /api/diagnose/feedback` — `outcome` is `"worked"` or `"did_not_work"`. |
 | `quota()` | `GET /api/diagnose/quota` — remaining diagnoses for the key's plan. |
 

package/dist/client.d.ts

@@ -18,6 +18,15 @@ export interface DiagnoseOptions {
     codeContext?: Record<string, unknown>;
     /** Client-side signature matches (e.g. from denpex_lite) so Tier 0 starts from evidence. */
     signatures?: unknown;
+    /** Prior clarification answers. Keep these typed and outside `logs`. */
+    operatorAnswers?: OperatorAnswerInput[];
+}
+export interface OperatorAnswerInput {
+    questionId?: string;
+    optionId?: string;
+    kind?: 'fact' | 'action';
+    question?: string;
+    answer: string;
 }
 export interface DiagnoseMeta {
     failureType?: string;
@@ -52,11 +61,53 @@ export interface DiagnoseInitiator {
     totalLines?: number | null;
     analyzedLines?: number | null;
 }
+export interface ClarifyingOption {
+    id?: string;
+    label?: string;
+    detail?: string;
+    /**
+     * Present only on an `action` question. The engine never recommends an answer to a
+     * question of fact: a recommendation there returns the answer that was hinted at
+     * rather than the one that happened, and the next verdict is built on an
+     * observation nobody made. Render this marker only when `kind === 'action'`.
+     */
+    recommended?: boolean;
+    /** Exact evidence command represented by this option on an action question. */
+    command?: string;
+}
+export interface ClarifyingQuestion {
+    id?: string;
+    /** `fact` = what the operator observed; `action` = what they could run next. */
+    kind?: 'fact' | 'action';
+    question?: string;
+    options?: ClarifyingOption[];
+    allowOther?: boolean;
+    /** The exact command behind the recommended option, on `action` questions. */
+    command?: string;
+}
 export interface DiagnoseResponse {
     fix?: {
         summary?: string;
         action?: string;
         evidence?: unknown[];
+        /**
+         * Set when the engine declined to name one cause and is asking for evidence
+         * instead. Answer with the option ids to get a sharper diagnosis. `inviteFollowup`
+         * is the flag that says this happened.
+         */
+        clarifyingChoices?: ClarifyingQuestion[];
+        /** Plain-text form of the same questions, for older callers. */
+        clarifyingQuestions?: string[];
+        inviteFollowup?: boolean;
+        evidenceRequests?: Array<{
+            questionId: string;
+            optionId: string;
+            label: string;
+            command: string;
+            why?: string;
+            pasteBack?: string;
+        }>;
+        awaitingEvidence?: boolean;
         [k: string]: unknown;
     };
     meta?: DiagnoseMeta;
@@ -90,6 +141,8 @@ export declare class DenpexClient {
     constructor(options: DenpexClientOptions);
     /** Diagnose a training failure from raw logs (20 chars – 256 KB). */
     diagnose(logs: string, opts?: DiagnoseOptions): Promise<DiagnoseResponse>;
+    /** Re-run the canonical diagnosis with observed facts or a selected evidence check. */
+    refine(logs: string, operatorAnswers: OperatorAnswerInput[], opts?: Omit<DiagnoseOptions, 'operatorAnswers'>): Promise<DiagnoseResponse>;
     /** Report whether a diagnosis worked — this feedback directly improves future priors. */
     feedback(diagnosisId: string, outcome: FeedbackOutcome, note?: string): Promise<Record<string, unknown>>;
     /** Remaining diagnosis headroom for this key's plan. */

package/dist/client.js

@@ -49,6 +49,10 @@ class DenpexClient {
         }
         return this.request('POST', '/api/diagnose', { logs, ...opts });
     }
+    /** Re-run the canonical diagnosis with observed facts or a selected evidence check. */
+    async refine(logs, operatorAnswers, opts = {}) {
+        return this.diagnose(logs, { ...opts, operatorAnswers });
+    }
     /** Report whether a diagnosis worked — this feedback directly improves future priors. */
     async feedback(diagnosisId, outcome, note) {
         if (!diagnosisId)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@denpex/sdk",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "TypeScript client for the Denpex API — diagnose GPU training failures from logs (POST /api/diagnose), report fix outcomes, check quota. Zero dependencies, Node >= 18.",
   "keywords": [
     "denpex",