@denpex/sdk 0.8.1 → 0.8.3

package/dist/client.d.ts

@@ -4,7 +4,7 @@ export interface DenpexClientOptions {
     baseUrl?: string;
     /** Override fetch (tests, custom agents). Defaults to globalThis.fetch. */
     fetchImpl?: typeof fetch;
-    /** Per-request timeout in ms (AbortController). Default 320s — server deep-path ceiling is 290s. */
+    /** Per-request timeout in ms (AbortController). Default 320s. The server deep-path ceiling is 290s. */
     timeoutMs?: number;
 }
 export interface DiagnoseOptions {
@@ -33,12 +33,12 @@ export interface DiagnoseMeta {
     confidence?: number;
     source?: string;
     tier?: number;
-    /** Engine build stamp — compare across surfaces to detect a stale deploy. */
+    /** Engine build stamp. Compare across surfaces to detect a stale deploy. */
     engineVersion?: string;
 }
 /**
  * The known response fields. The engine attaches additional sections as it
- * grows (forensics, advisories, execution plans) — they pass through untyped
+ * grows (forensics, advisories, execution plans). They pass through untyped
  * rather than being silently dropped, so SDK users always receive everything
  * the API returned.
  */
@@ -51,7 +51,7 @@ export interface DiagnoseMeta {
  * few lines, so treat the node as the stronger signal of the two.
  *
  * `analyzedLines` < `totalLines` means the paste exceeded the window the engine
- * reads — the verdict covers only what was analysed.
+ * reads. The verdict covers only what was analysed.
  */
 export interface DiagnoseInitiator {
     rank?: number | null;
@@ -86,6 +86,16 @@ export interface ClarifyingQuestion {
     command?: string;
 }
 export interface DiagnoseResponse {
+    /** Automated review signals, never independent proof of correctness. */
+    qualityReview?: {
+        schemaVersion: number;
+        status: 'needs_review' | 'no_flagged_issue';
+        family: string;
+        flags: string[];
+        verification: 'unverified';
+        engineVersion?: string;
+        note?: string;
+    };
     fix?: {
         summary?: string;
         action?: string;
@@ -139,11 +149,11 @@ export declare class DenpexClient {
     private readonly fetchImpl;
     private readonly timeoutMs;
     constructor(options: DenpexClientOptions);
-    /** Diagnose a training failure from raw logs (20 chars – 256 KB). */
+    /** Diagnose a training failure from raw logs. Oversized input is evidence-selected. */
     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. */
+    /** 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. */
     quota(): Promise<QuotaResponse>;

package/dist/client.js

@@ -1,5 +1,5 @@
 "use strict";
-// @denpex/sdk — TypeScript client for the Denpex public API.
+// @denpex/sdk: TypeScript client for the Denpex public API.
 //
 // Rewritten 2026-07-20: the previous file was a stub for /v1/{tenant}/incidents
 // routes that do not exist in the api-worker. This client targets the REAL
@@ -15,6 +15,7 @@
 // Zero dependencies. Requires global fetch (Node >= 18 or any browser/worker).
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = exports.DenpexClient = exports.DenpexError = void 0;
+const evidence_1 = require("./evidence");
 class DenpexError extends Error {
     constructor(message, status, 
     /** Machine-readable code when the API provides one (e.g. AUTH_REQUIRED, GPU_LIMIT_EXCEEDED). */
@@ -26,7 +27,7 @@ class DenpexError extends Error {
     }
 }
 exports.DenpexError = DenpexError;
-const MIN_LOG_CHARS = 20;
+const MIN_LOG_CHARS = 6;
 const MAX_LOG_CHARS = 256000;
 class DenpexClient {
     constructor(options) {
@@ -37,23 +38,21 @@ class DenpexClient {
         this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
         this.timeoutMs = options.timeoutMs ?? 320000;
         if (!this.fetchImpl)
-            throw new Error('DenpexClient: global fetch not found — Node >= 18 required, or pass fetchImpl');
+            throw new Error('DenpexClient: global fetch not found. Node >= 18 required, or pass fetchImpl');
     }
-    /** Diagnose a training failure from raw logs (20 chars – 256 KB). */
+    /** Diagnose a training failure from raw logs. Oversized input is evidence-selected. */
     async diagnose(logs, opts = {}) {
         if (typeof logs !== 'string' || logs.length < MIN_LOG_CHARS) {
             throw new DenpexError(`logs must be at least ${MIN_LOG_CHARS} characters`, 400);
         }
-        if (logs.length > MAX_LOG_CHARS) {
-            throw new DenpexError(`logs too large (max ${MAX_LOG_CHARS} chars) — send the failing excerpt`, 400);
-        }
-        return this.request('POST', '/api/diagnose', { logs, ...opts });
+        const selected = (0, evidence_1.selectEvidence)(logs, MAX_LOG_CHARS);
+        return this.request('POST', '/api/diagnose', { logs: selected.text, ...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. */
+    /** Report whether a diagnosis worked. This feedback directly improves future priors. */
     async feedback(diagnosisId, outcome, note) {
         if (!diagnosisId)
             throw new DenpexError('diagnosisId required', 400);
@@ -83,7 +82,11 @@ class DenpexClient {
             }
             catch { /* non-JSON error body */ }
             if (!res.ok) {
-                const message = typeof json.error === 'string' ? json.error : `Denpex API error (status ${res.status})`;
+                const message = typeof json.guidance === 'string'
+                    ? json.guidance
+                    : typeof json.error === 'string'
+                        ? json.error
+                        : `Denpex API error (status ${res.status})`;
                 throw new DenpexError(message, res.status, typeof json.code === 'string' ? json.code : undefined);
             }
             return json;

package/dist/evidence.d.ts

@@ -0,0 +1,4 @@
+export declare function selectEvidence(logs: string, max: number): {
+    text: string;
+    truncated: boolean;
+};

package/dist/evidence.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectEvidence = selectEvidence;
+const EVIDENCE_RE = /error|fail|fatal|traceback|exception|assert|panic|segfault|xid|nvrm|ecc|fallen off the bus|nccl|cuda|oom|out of memory|timeout|nan\b|\binf\b|node_fail|killed|terminated|version|driver|kernel|container|slurm|kubernetes|rank|node|host|gpu|pci|topology|nvlink|nvswitch|infiniband|rdma|roce/i;
+const CAUSAL_RE = /fatal|critical|traceback|exception|assert|panic|segfault|xid|uncorrectable|fallen off the bus|out of memory|watchdog timeout|crc mismatch|loss\s*=\s*(?:nan|inf)|insufficient|unhealthy|ibv_modify_qp|no space left|compil(?:e|ation) (?:error|failed)|no available memory|checksum mismatch|childfailederror|backendcompilerfailed|failedscheduling|input\/output error|nonfinite|divergence|first failure|initiator|caused by/i;
+const MAX_LINE_CHARS = 2000;
+function clipLine(line) {
+    if (line.length <= MAX_LINE_CHARS)
+        return line;
+    const marker = ' [line clipped by Denpex] ';
+    const side = Math.max(1, Math.floor((MAX_LINE_CHARS - marker.length) / 2));
+    return `${line.slice(0, side)}${marker}${line.slice(-side)}`.slice(0, MAX_LINE_CHARS);
+}
+function selectEvidence(logs, max) {
+    if (logs.length <= max)
+        return { text: logs, truncated: false };
+    const lines = logs.split(/\r?\n/);
+    const candidates = new Map();
+    const add = (index, radius, priority) => {
+        for (let i = Math.max(0, index - radius); i <= Math.min(lines.length - 1, index + radius); i++) {
+            candidates.set(i, Math.max(priority, candidates.get(i) ?? 0));
+        }
+    };
+    for (let i = 0; i < Math.min(48, lines.length); i++)
+        candidates.set(i, 300);
+    for (let i = Math.max(0, lines.length - 96); i < lines.length; i++)
+        candidates.set(i, 800);
+    let foundFirst = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        if (!EVIDENCE_RE.test(line))
+            continue;
+        const causal = CAUSAL_RE.test(line);
+        add(i, causal ? 3 : 1, causal ? 1000 : 700);
+        if (!foundFirst) {
+            add(i, 6, 1100);
+            foundFirst = true;
+        }
+    }
+    const warning = `[Denpex condensed input: input exceeded ${max.toLocaleString()} characters. Environment, causal, rank, topology, middle, and final-tail evidence were selected.]`;
+    let used = warning.length;
+    const selected = new Set();
+    for (const [index] of [...candidates].sort((a, b) => b[1] - a[1] || a[0] - b[0])) {
+        const line = clipLine(lines[index] ?? '');
+        if (used + line.length + 1 > max)
+            continue;
+        selected.add(index);
+        used += line.length + 1;
+    }
+    return {
+        text: [warning, ...[...selected].sort((a, b) => a - b).map((index) => clipLine(lines[index] ?? ''))].join('\n'),
+        truncated: true,
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@denpex/sdk",
-  "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.",
+  "version": "0.8.3",
+  "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",
     "gpu",