@pellux/goodvibes-sdk 0.21.29 → 0.21.33

package/dist/_internal/platform/scheduler/scheduler.js

@@ -6,6 +6,8 @@ import { summarizeError } from '../utils/error-display.js';
 // ---------------------------------------------------------------------------
 /** Max run history records to keep per task. */
 const MAX_HISTORY_PER_TASK = 5;
+/** Debounce window for history persist calls (ms). Coalesces rapid consecutive runs. */
+const SAVE_DEBOUNCE_MS = 1_000;
 /** Maximum setTimeout delay — Node.js overflows at ~24.8 days; cap at 24 h. */
 const MAX_TIMEOUT_MS = 24 * 60 * 60 * 1000;
 // ---------------------------------------------------------------------------
@@ -195,8 +197,12 @@ function getCalendarParts(ts, timezone) {
             dow: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'].indexOf(parts['weekday'] ?? 'Sun'),
         };
     }
-    catch {
-        // Unknown timezone — fall back to local time
+    catch (err) {
+        // OBS-11: Unknown timezone — fall back to local time; log at debug so misconfigured schedules surface
+        logger.debug('[Scheduler] timezone decomposition failed, falling back to local time', {
+            error: String(err),
+        });
+        // fall back to local time
         const d = new Date(ts);
         return {
             minute: d.getMinutes(),
@@ -322,10 +328,16 @@ function countMissedRuns(expr, fromMs, toMs, timezone) {
 export class TaskScheduler {
     tasks = new Map();
     timers = new Map();
-    history = [];
+    /**
+     * Per-task run history indexed by taskId — O(1) push + trim per task run.
+     * The flat `history` array is derived from this on persist (PERF-03).
+     */
+    historyByTask = new Map();
     store;
     spawnTask;
     running = false;
+    /** Debounce handle for coalescing rapid successive save() calls (PERF-03). */
+    _saveDebounceTimer = null;
     constructor(config) {
         const resolvedConfig = typeof config === 'string'
             ? { storePath: config }
@@ -421,13 +433,13 @@ export class TaskScheduler {
     list() {
         return Array.from(this.tasks.values());
     }
-    /** Return the run history for a given task (up to MAX_HISTORY_PER_TASK). */
+    /** Return the run history for a given task (up to MAX_HISTORY_PER_TASK). O(1) via Map index. */
     getHistory(taskId) {
-        return this.history.filter((r) => r.taskId === taskId).slice(-MAX_HISTORY_PER_TASK);
+        return [...(this.historyByTask.get(taskId) ?? [])];
     }
     /** Return all run history records. */
     getAllHistory() {
-        return [...this.history];
+        return this.flatHistory();
     }
     /**
      * Compute the next run time for a cron expression, starting from `from`
@@ -531,7 +543,7 @@ export class TaskScheduler {
                 error: errorMsg,
             };
             this.pushHistory(runRecord);
-            void this.save().catch((e) => logger.warn('TaskScheduler: save failed', { error: summarizeError(e) }));
+            this.scheduleSave();
             throw err;
         }
         // Update task stats
@@ -544,35 +556,54 @@ export class TaskScheduler {
             status: 'running',
         };
         this.pushHistory(runRecord);
-        void this.save().catch((err) => logger.warn('TaskScheduler: save failed', { error: summarizeError(err) }));
+        this.scheduleSave();
         return agentId;
     }
+    /**
+     * O(1) per-task history push + trim (PERF-03).
+     * The Map index makes both the push and the cap check O(1) instead of O(n) global filter.
+     */
     pushHistory(record) {
-        this.history.push(record);
-        // Keep only MAX_HISTORY_PER_TASK per task
-        const perTask = this.history.filter((r) => r.taskId === record.taskId);
-        if (perTask.length > MAX_HISTORY_PER_TASK) {
-            // Remove the oldest entries for this task
-            const toRemove = perTask.length - MAX_HISTORY_PER_TASK;
-            let removed = 0;
-            this.history = this.history.filter((r) => {
-                if (r.taskId === record.taskId && removed < toRemove) {
-                    removed++;
-                    return false;
-                }
-                return true;
-            });
+        const bucket = this.historyByTask.get(record.taskId) ?? [];
+        bucket.push(record);
+        // Trim to MAX_HISTORY_PER_TASK in-place — oldest entries are at the front.
+        if (bucket.length > MAX_HISTORY_PER_TASK) {
+            bucket.splice(0, bucket.length - MAX_HISTORY_PER_TASK);
         }
+        this.historyByTask.set(record.taskId, bucket);
     }
     // -------------------------------------------------------------------------
     // Persistence
     // -------------------------------------------------------------------------
+    /** Flatten historyByTask Map into a single array for serialisation. */
+    flatHistory() {
+        const out = [];
+        for (const bucket of this.historyByTask.values()) {
+            for (const record of bucket) {
+                out.push(record);
+            }
+        }
+        return out;
+    }
     async save() {
         await this.store.persist({
             tasks: Array.from(this.tasks.values()),
-            history: this.history,
+            history: this.flatHistory(),
         });
     }
+    /**
+     * Debounced save: coalesces multiple rapid calls into a single disk write
+     * that fires SAVE_DEBOUNCE_MS after the last call (PERF-03).
+     */
+    scheduleSave() {
+        if (this._saveDebounceTimer !== null)
+            return;
+        this._saveDebounceTimer = setTimeout(() => {
+            this._saveDebounceTimer = null;
+            void this.save().catch((err) => logger.warn('TaskScheduler: save failed', { error: summarizeError(err) }));
+        }, SAVE_DEBOUNCE_MS);
+        this._saveDebounceTimer.unref?.();
+    }
     async load() {
         const data = await this.store.load();
         if (!data)
@@ -609,7 +640,7 @@ export class TaskScheduler {
                     const expectedNext = computeNextRun(t.cron, new Date(t.lastRun), t.timezone);
                     if (expectedNext.getTime() < now) {
                         logger.warn('[Scheduler] Missed run detected', { taskId: t.id, missedAt: expectedNext.toISOString() });
-                        this.history.push({
+                        this.pushHistory({
                             taskId: t.id,
                             startedAt: expectedNext.getTime(),
                             agentId: '',
@@ -621,8 +652,17 @@ export class TaskScheduler {
                 this.tasks.set(t.id, t);
             }
         }
+        // Restore history from disk into per-task Map buckets.
         if (Array.isArray(data.history)) {
-            this.history = data.history;
+            for (const record of data.history) {
+                const bucket = this.historyByTask.get(record.taskId) ?? [];
+                bucket.push(record);
+                // Maintain cap on restore (PERF-03).
+                if (bucket.length > MAX_HISTORY_PER_TASK) {
+                    bucket.splice(0, bucket.length - MAX_HISTORY_PER_TASK);
+                }
+                this.historyByTask.set(record.taskId, bucket);
+            }
         }
     }
 }

package/dist/_internal/platform/sessions/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/sessions/manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,aAAa,CAAC,EAAE,2BAA2B,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,aAAa,CAAC,EAAE,2BAA2B,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAMvG;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAapB;;;;OAIG;IACH,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,WAAW,EACjB,YAAY,CAAC,EAAE,WAAW,EAAE,GAC3B;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAuC9C;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,WAAW,EAAE,CAAA;KAAE;IAwD1F;;OAEG;IACH,IAAI,IAAI,WAAW,EAAE;IAoFrB;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IA4BzC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAoB5C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAY1B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAiD9F;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CASnC"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/sessions/manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,aAAa,CAAC,EAAE,2BAA2B,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,aAAa,CAAC,EAAE,2BAA2B,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAMvG;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAapB;;;;OAIG;IACH,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,WAAW,EACjB,YAAY,CAAC,EAAE,WAAW,EAAE,GAC3B;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAuC9C;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,WAAW,EAAE,CAAA;KAAE;IAwD1F;;OAEG;IACH,IAAI,IAAI,WAAW,EAAE;IAoFrB;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IA4BzC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAoB5C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAY1B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAiD9F;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CASnC"}

package/dist/_internal/platform/sessions/manager.js

@@ -39,8 +39,12 @@ export class SessionManager {
                 }
             }
         }
-        catch {
-            // Non-fatal: directory may not be readable yet
+        catch (err) {
+            // OBS-11: Non-fatal — dir not readable yet; log so ops can diagnose permission issues
+            logger.debug('[SessionManager] _cleanupOrphanTempFiles: directory read failed', {
+                dir: this.sessionsDir,
+                error: String(err),
+            });
         }
     }
     /**

package/dist/_internal/platform/state/memory-embedding-http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-embedding-http.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/state/memory-embedding-http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EAKxB,MAAM,wBAAwB,CAAC;AAEhC,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AA2BjD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAanG,wBAAgB,qCAAqC,CAAC,OAAO,GAAE,qBAA0B,GAAG,uBAAuB,EAAE,CAQpH"}
+{"version":3,"file":"memory-embedding-http.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/state/memory-embedding-http.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EAKxB,MAAM,wBAAwB,CAAC;AAEhC,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AA2BjD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAanG,wBAAgB,qCAAqC,CAAC,OAAO,GAAE,qBAA0B,GAAG,uBAAuB,EAAE,CAQpH"}

package/dist/_internal/platform/state/memory-embedding-http.js

@@ -1,10 +1,11 @@
 import { DEFAULT_MEMORY_EMBEDDING_DIMS } from './memory-embeddings.js';
+import { WELL_KNOWN_LOCAL_ENDPOINTS } from '../providers/well-known-endpoints.js';
 import { summarizeError } from '../utils/error-display.js';
 const DEFAULT_OPENAI_BASE_URL = 'https://api.openai.com/v1';
 const DEFAULT_OPENAI_MODEL = 'text-embedding-3-small';
-const DEFAULT_OPENAI_COMPATIBLE_BASE_URL = 'http://127.0.0.1:1234/v1';
+const DEFAULT_OPENAI_COMPATIBLE_BASE_URL = `${WELL_KNOWN_LOCAL_ENDPOINTS.lmStudio}/v1`;
 const DEFAULT_OPENAI_COMPATIBLE_MODEL = 'nomic-embed-text';
-const DEFAULT_OLLAMA_BASE_URL = 'http://127.0.0.1:11434';
+const DEFAULT_OLLAMA_BASE_URL = WELL_KNOWN_LOCAL_ENDPOINTS.ollama;
 const DEFAULT_OLLAMA_MODEL = 'embeddinggemma';
 const DEFAULT_GEMINI_BASE_URL = 'https://generativelanguage.googleapis.com/v1beta';
 const DEFAULT_GEMINI_MODEL = 'gemini-embedding-001';

package/dist/_internal/platform/state/project-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-index.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/state/project-index.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAyBD;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM;IAU3B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,QAAQ,IAAI,SAAS,EAAE;IAIvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAOvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAW7C,qEAAqE;IACrE,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUvC,cAAc,IAAI,MAAM;IAUxB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/C;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAc7B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW9B,OAAO,CAAC,aAAa;IAWf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;OAQG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/C,OAAO,CAAC,aAAa;YAUP,KAAK;CAiCpB"}
+{"version":3,"file":"project-index.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/state/project-index.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAyBD;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM;IAU3B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,QAAQ,IAAI,SAAS,EAAE;IAIvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAOvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAW7C,qEAAqE;IACrE,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUvC,cAAc,IAAI,MAAM;IAUxB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/C;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAe7B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW9B,OAAO,CAAC,aAAa;IAWf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;OAQG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/C,OAAO,CAAC,aAAa;YAUP,KAAK;CAiCpB"}

package/dist/_internal/platform/state/project-index.js

@@ -127,8 +127,9 @@ export class ProjectIndex {
             this.files.set(normalPath, tokens);
             this.scheduleFlush();
         }
-        catch {
-            // Non-fatal: leave existing value
+        catch (err) {
+            // OBS-11: Non-fatal — stat failed; leave existing token estimate
+            logger.debug('[ProjectIndex] statSync failed for file update', { path, error: String(err) });
         }
     }
     removeFile(path) {
@@ -175,8 +176,9 @@ export class ProjectIndex {
         try {
             await this.forceFlush();
         }
-        catch {
-            // Non-fatal — old location may be inaccessible after swap
+        catch (err) {
+            // OBS-11: Non-fatal — old location may be inaccessible after swap
+            logger.debug('[ProjectIndex] forceFlush failed during reroot (non-fatal)', { error: String(err) });
         }
         // Step 2: reset state and re-point to new directory
         this.projectRoot = newBaseDir;

package/dist/_internal/platform/tools/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAmB,YAAY,EAAE,MAAM,cAAc,CAAC;AAG7D,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAiB7D,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IACzD,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;CAC3C,GAAG,IAAI,CA+jBP"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAmB,YAAY,EAAE,MAAM,cAAc,CAAC;AAI7D,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAiB7D,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IACzD,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;CAC3C,GAAG,IAAI,CA+jBP"}

package/dist/_internal/platform/tools/agent/index.js

@@ -4,6 +4,7 @@ import { AgentMessageBus } from '../../agents/message-bus.js';
 import { AGENT_TEMPLATES, AgentManager } from './manager.js';
 import { evaluateOrchestrationSpawn } from '../../runtime/orchestration/spawn-policy.js';
 import { summarizeError } from '../../utils/error-display.js';
+import { toRecord } from '../../utils/record-coerce.js';
 export { AGENT_TEMPLATES, AgentManager } from './manager.js';
 // ---------------------------------------------------------------------------
 // Tool implementation
@@ -532,7 +533,7 @@ export function createAgentTool(config) {
                                 wrfcId: input.wrfcId,
                                 events: detail === 'full'
                                     ? events
-                                    : events.map((event) => summarizeWrfcEvent(event)),
+                                    : events.map((event) => summarizeWrfcEvent(toRecord(event))),
                                 count: events.length,
                             }),
                         };

package/dist/_internal/platform/tools/analyze/git-modes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-modes.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/analyze/git-modes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AAqGpE,wBAAsB,OAAO,CAC3B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8BlC;AA8CD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2DlC;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6ClC;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6ElC"}
+{"version":3,"file":"git-modes.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/analyze/git-modes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AAsGpE,wBAAsB,OAAO,CAC3B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8BlC;AA8CD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2DlC;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6ClC;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6ElC"}

package/dist/_internal/platform/tools/analyze/git-modes.js

@@ -3,6 +3,7 @@ import { join, relative } from 'node:path';
 import { GitService } from '../../git/service.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { isBreakingUpgrade, loadDependencyVersions, parseDiffStats, parseSemver, readJsonFile, truncateDiffAtBoundary, validateGitRefs, } from './shared.js';
+import { instrumentedFetch } from '../../utils/fetch-with-timeout.js';
 function parseSemanticDiffResponse(llmResponse, changedFiles) {
     let summary = 'LLM unavailable — diff available in raw_diff field.';
     let impact = changedFiles.map((f) => `Changed file: ${f}`);
@@ -283,7 +284,7 @@ export async function runUpgrade(input, projectRoot) {
     await Promise.all(batch.map(async (name) => {
         const current = currentVersions[name] ?? 'unknown';
         try {
-            const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(name)}/latest`, {
+            const res = await instrumentedFetch(`https://registry.npmjs.org/${encodeURIComponent(name)}/latest`, {
                 signal: AbortSignal.timeout(8000),
                 headers: { Accept: 'application/json' },
             });

package/dist/_internal/platform/tools/edit/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/edit/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAe,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAmiBxD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,qBAAqB,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;CAC5D;AAaD,wBAAgB,cAAc,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CA4CzF"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/edit/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAe,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAoiBxD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,qBAAqB,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;CAC5D;AAaD,wBAAgB,cAAc,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CA4CzF"}

package/dist/_internal/platform/tools/edit/core.js

@@ -10,6 +10,7 @@ import { ImportGraph } from '../../intelligence/index.js';
 import { buildFailedEditResult, classifyEditFailure, computeAstEdit, computeAstPatternEdit, computeSingleEdit, } from './match.js';
 import { executeNotebookEdit } from './notebook.js';
 import { summarizeError } from '../../utils/error-display.js';
+import { toRecord } from '../../utils/record-coerce.js';
 const DIFF_TRUNCATE_THRESHOLD = 5000;
 const DIFF_PREVIEW_LENGTH = 500;
 const VALIDATOR_COMMANDS = {
@@ -468,7 +469,7 @@ export function createEditTool(fileCache, options) {
             'Handles multiple edits in one call with atomic or partial transaction semantics. ' +
             'Detects OCC conflicts when files have been modified externally. ' +
             'Also supports Jupyter notebook (.ipynb) cell operations via notebook_operations field.',
-        parameters: editSchema,
+        parameters: toRecord(editSchema),
         sideEffects: ['write_fs'],
         concurrency: 'serial',
         supportsProgress: true,

package/dist/_internal/platform/tools/exec/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/exec/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAqB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAA+B,iBAAiB,EAAiB,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAwZ/E;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,GAC3D,OAAO,CA2CT;AA2ID,wBAAgB,cAAc,CAC5B,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE;IACP,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CACvC,GACL,IAAI,CAqEN"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/exec/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAqB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAA+B,iBAAiB,EAAiB,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAyZ/E;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,GAC3D,OAAO,CA2CT;AA2ID,wBAAgB,cAAc,CAC5B,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE;IACP,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CACvC,GACL,IAAI,CAqEN"}

package/dist/_internal/platform/tools/exec/runtime.js

@@ -156,8 +156,9 @@ async function runCommand(processManager, overflowHandler, featureFlags, cmdStr,
             await sleep(200);
             proc.kill('SIGKILL');
         }
-        catch {
-            // process already exited
+        catch (err) {
+            // OBS-11: Non-fatal — process may have already exited before kill
+            logger.debug('[ExecRuntime] kill on timeout failed (process may have exited)', { error: String(err) });
         }
         timeoutResolve();
     }, timeoutMs);

package/dist/_internal/platform/tools/fetch/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/fetch/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAsF,MAAM,aAAa,CAAC;AAClI,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAUxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG/E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;CACtE;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAC/D,OAAO,CAAC,eAAe,CAAK;IAE5B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAOtE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAiBxC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;CA8DpF;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAE5G;AA+UD,wBAAgB,eAAe,CAC7B,IAAI,GAAE,gBAAqB,EAC3B,OAAO,sBAA4B,GAClC,IAAI,CAiCN"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/fetch/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAsF,MAAM,aAAa,CAAC;AAClI,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAUxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAK/E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;CACtE;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAC/D,OAAO,CAAC,eAAe,CAAK;IAE5B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAOtE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAiBxC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;CA8DpF;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAE5G;AA+UD,wBAAgB,eAAe,CAC7B,IAAI,GAAE,gBAAqB,EAC3B,OAAO,sBAA4B,GAClC,IAAI,CAiCN"}

package/dist/_internal/platform/tools/fetch/runtime.js

@@ -4,6 +4,8 @@ import { applySanitizer, resolveSanitizeMode } from './sanitizer.js';
 import { classifyHostTrustTier, emitSsrfDeny, emitHostTrustTier, extractHostname, } from './trust-tiers.js';
 import { applyExtract, sniffContentType } from './extract.js';
 import { summarizeError } from '../../utils/error-display.js';
+import { instrumentedFetch } from '../../utils/fetch-with-timeout.js';
+import { toRecord } from '../../utils/record-coerce.js';
 const MAX_CACHE_SIZE = 500;
 const DEFAULT_TIMEOUT_MS = 30_000;
 export class FetchRuntimeService {
@@ -151,7 +153,7 @@ async function fetchOneRaw(urlInput, headers, method, body, effectiveUrl) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), urlInput.timeout_ms ?? DEFAULT_TIMEOUT_MS);
     try {
-        const response = await fetch(effectiveUrl, {
+        const response = await instrumentedFetch(effectiveUrl, {
             method,
             headers: Object.keys(headers).length > 0 ? headers : undefined,
             body,
@@ -370,7 +372,7 @@ export function createFetchTool(deps = {}, runtime = new FetchRuntimeService())
                 + ' readable, code_blocks, links, metadata, structured, tables, pdf, summary),'
                 + ' per-URL timeouts, caching, rate limiting, auth refresh, content-length limits,'
                 + ' redirect tracking, timing metrics, token estimation, and verbosity control.',
-            parameters: FETCH_TOOL_SCHEMA,
+            parameters: toRecord(FETCH_TOOL_SCHEMA),
             sideEffects: ['network'],
             concurrency: 'parallel',
             supportsProgress: true,

package/dist/_internal/platform/tools/read/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/read/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAUhE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpE,qBAAa,QAAS,YAAW,IAAI;IACnC,QAAQ,CAAC,UAAU,EAAE,cAAc,CASjC;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsD;gBAGrF,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,cAAc,EAC1B,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,YAAY,CAAC;IAOlE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAa9F,QAAQ;CAuHvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/read/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAIjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAUhE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpE,qBAAa,QAAS,YAAW,IAAI;IACnC,QAAQ,CAAC,UAAU,EAAE,cAAc,CASjC;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsD;gBAGrF,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,cAAc,EAC1B,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,YAAY,CAAC;IAOlE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAa9F,QAAQ;CAuHvB"}

package/dist/_internal/platform/tools/read/index.js

@@ -1,4 +1,5 @@
 import { READ_TOOL_SCHEMA } from './schema.js';
+import { toRecord } from '../../utils/record-coerce.js';
 import { FileStateCache } from '../../state/file-cache.js';
 import { ProjectIndex } from '../../state/project-index.js';
 import { CodeIntelligence } from '../../intelligence/facade.js';
@@ -10,7 +11,7 @@ export class ReadTool {
         name: 'read',
         description: 'Read one or more files from disk. Supports extract modes (content, outline, symbols, lines, ast)'
             + ' for token-efficient reading, per-file caching, pagination via token_budget, and batch processing.',
-        parameters: READ_TOOL_SCHEMA,
+        parameters: toRecord(READ_TOOL_SCHEMA),
         sideEffects: ['read_fs'],
         concurrency: 'parallel',
         supportsProgress: true,

package/dist/_internal/platform/tools/registry-tool/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/registry-tool/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAmCnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AA6HD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAwC7F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/registry-tool/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoCnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AA6HD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAwC7F"}

package/dist/_internal/platform/tools/registry-tool/index.js

@@ -4,6 +4,7 @@ import Fuse from 'fuse.js';
 import { logger } from '../../utils/logger.js';
 import { collectMarkdownReferences, extractMarkdownPreview, normalizeFrontmatterList, parseMarkdownFrontmatter, readMarkdownDisclosure, materializeMarkdownBody, } from '../../utils/markdown-disclosure.js';
 import { REGISTRY_TOOL_SCHEMA } from './schema.js';
+import { toRecord } from '../../utils/record-coerce.js';
 import { summarizeError } from '../../utils/error-display.js';
 // ---------------------------------------------------------------------------
 // Frontmatter parser
@@ -144,7 +145,7 @@ export function createRegistryTool(toolRegistry, roots) {
         description: 'Discover and inspect skills, agents, and tools.'
             + ' Modes: search finds items by keyword; recommend lists items sorted by relevance;'
             + ' dependencies reads a skill\'s dependency chain; content returns full markdown file.',
-        parameters: REGISTRY_TOOL_SCHEMA,
+        parameters: toRecord(REGISTRY_TOOL_SCHEMA),
         sideEffects: ['read_fs'],
         concurrency: 'parallel',
     };

package/dist/_internal/platform/tools/state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/state/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AAiCjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAClH;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAsFN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/state/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AAkCjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAClH;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAsFN"}

package/dist/_internal/platform/tools/state/index.js

@@ -7,6 +7,7 @@ import { HookDispatcher } from '../../hooks/dispatcher.js';
 import { TelemetryDB } from '../../state/telemetry.js';
 import { logger } from '../../utils/logger.js';
 import { STATE_TOOL_SCHEMA } from './schema.js';
+import { toRecord } from '../../utils/record-coerce.js';
 import { summarizeError } from '../../utils/error-display.js';
 // ---------------------------------------------------------------------------
 // Helpers
@@ -71,7 +72,7 @@ export function createStateTool(kvState, projectIndex, options) {
             + ' Discovery: use mode=list to see existing KV keys, mode=hooks hookAction=list to see registered hooks,'
             + ' mode=mode modeAction=get to see the current output mode.'
             + ' Also: mode=memory memoryAction=list to list persistent memory keys, mode=analytics analyticsAction=summary for session metrics.',
-        parameters: STATE_TOOL_SCHEMA,
+        parameters: toRecord(STATE_TOOL_SCHEMA),
         sideEffects: ['state'],
         concurrency: 'serial',
     };

package/dist/_internal/platform/tools/task/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAuB,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAkB3G,wBAAgB,cAAc,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAgJvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAuB,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAmB3G,wBAAgB,cAAc,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAgJvE"}

package/dist/_internal/platform/tools/task/index.js

@@ -1,4 +1,5 @@
 import { TASK_TOOL_SCHEMA } from './schema.js';
+import { toRecord } from '../../utils/record-coerce.js';
 const DEFAULT_SESSION_ID = 'local';
 function summarizeRef(ref) {
     if (!ref)
@@ -18,7 +19,7 @@ export function createTaskTool(registry) {
         definition: {
             name: 'task',
             description: 'Manage durable cross-session task refs, dependencies, cancellations, and handoffs.',
-            parameters: TASK_TOOL_SCHEMA,
+            parameters: toRecord(TASK_TOOL_SCHEMA),
             sideEffects: ['workflow', 'state'],
             concurrency: 'serial',
         },

package/dist/_internal/platform/tools/team/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/team/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA6DjD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA+HhF;AAED,eAAO,MAAM,QAAQ,MAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/team/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA8DjD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA+HhF;AAED,eAAO,MAAM,QAAQ,MAAmB,CAAC"}

package/dist/_internal/platform/tools/team/index.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node
 import { dirname } from 'node:path';
 import { resolveScopedDirectory } from '../../runtime/surface-root.js';
 import { TEAM_TOOL_SCHEMA } from './schema.js';
+import { toRecord } from '../../utils/record-coerce.js';
 function summarizeTeam(team) {
     return {
         id: team.id,
@@ -39,7 +40,7 @@ export function createTeamTool(options) {
         definition: {
             name: 'team',
             description: 'Manage durable team definitions, roles, and communication lanes.',
-            parameters: TEAM_TOOL_SCHEMA,
+            parameters: toRecord(TEAM_TOOL_SCHEMA),
             sideEffects: ['workflow', 'state'],
             concurrency: 'serial',
         },

package/dist/_internal/platform/tools/web-search/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/web-search/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAiCnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/web-search/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAiCnE"}

package/dist/_internal/platform/tools/web-search/index.js

@@ -1,11 +1,12 @@
 import { WEB_SEARCH_TOOL_SCHEMA } from './schema.js';
+import { toRecord } from '../../utils/record-coerce.js';
 export function createWebSearchTool(service) {
     return {
         definition: {
             name: 'web_search',
             description: 'Search the web through a provider-backed search layer.'
                 + ' Returns normalized ranked results, optional instant-answer data, and optional fetched evidence.',
-            parameters: WEB_SEARCH_TOOL_SCHEMA,
+            parameters: toRecord(WEB_SEARCH_TOOL_SCHEMA),
             sideEffects: ['network'],
             concurrency: 'parallel',
             supportsProgress: true,

package/dist/_internal/platform/tools/worklist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/worklist/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAgEjD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4GpF;AAED,eAAO,MAAM,YAAY,MAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/worklist/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAiEjD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4GpF;AAED,eAAO,MAAM,YAAY,MAAuB,CAAC"}

package/dist/_internal/platform/tools/worklist/index.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { resolveScopedDirectory } from '../../runtime/surface-root.js';
 import { WORKLIST_TOOL_SCHEMA } from './schema.js';
+import { toRecord } from '../../utils/record-coerce.js';
 function summarizeWorklist(record) {
     const openCount = record.items.filter((item) => item.status === 'open').length;
     const doneCount = record.items.filter((item) => item.status === 'done').length;
@@ -41,7 +42,7 @@ export function createWorklistTool(options) {
         definition: {
             name: 'worklist',
             description: 'Manage durable worklists and checklist items for execution planning and follow-up.',
-            parameters: WORKLIST_TOOL_SCHEMA,
+            parameters: toRecord(WORKLIST_TOOL_SCHEMA),
             sideEffects: ['workflow', 'state'],
             concurrency: 'serial',
         },

package/dist/_internal/platform/types/errors.d.ts

@@ -1,3 +1,4 @@
+import { GoodVibesSdkError } from '../../errors/index.js';
 /** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
 /** HTTP status codes that indicate transient failures eligible for retry. Single source of truth. */
 export declare const RETRYABLE_STATUS_CODES: readonly number[];
@@ -22,48 +23,49 @@ export interface ProviderErrorOptions extends AppErrorOptions {
     readonly statusCode?: number;
 }
 /** Base class for all application errors. Provides a machine-readable code and recoverability hint. */
-export declare class AppError extends Error {
+export declare class AppError extends GoodVibesSdkError {
     readonly code: string;
     readonly recoverable: boolean;
+    /** HTTP status code (backward-compat alias for `status`). */
     readonly statusCode?: number;
-    readonly category?: ErrorCategory;
+    /** Human-readable guidance (backward-compat alias for `hint`). */
     readonly guidance?: string;
+    /** Additional detail string not present on GoodVibesSdkError. */
     readonly detail?: string;
-    readonly source?: ErrorSource;
-    readonly provider?: string;
-    readonly operation?: string;
-    readonly phase?: string;
-    readonly requestId?: string;
-    readonly providerCode?: string;
-    readonly providerType?: string;
-    readonly retryAfterMs?: number;
+    /** Raw provider message before normalisation. */
     readonly rawMessage?: string;
     constructor(message: string, code: string, recoverable: boolean, options?: AppErrorOptions);
 }
 /** Thrown when configuration is invalid or cannot be loaded. Non-recoverable. */
 export declare class ConfigError extends AppError {
+    readonly code: 'CONFIG_ERROR';
     constructor(message: string);
 }
 /** Thrown when an LLM provider API call fails. Recoverable when statusCode is in RETRYABLE_STATUS_CODES. */
 export declare class ProviderError extends AppError {
+    readonly code: 'PROVIDER_ERROR';
     constructor(message: string, statusCode?: number);
     constructor(message: string, options?: ProviderErrorOptions);
 }
 /** Thrown when a tool execution fails. Recoverable by default. */
 export declare class ToolError extends AppError {
     readonly toolName: string;
+    readonly code: 'TOOL_ERROR';
     constructor(message: string, toolName: string);
 }
 /** Thrown for ACP (Agent Control Protocol) errors. Recoverable by default. */
 export declare class AcpError extends AppError {
+    readonly code: 'ACP_ERROR';
     constructor(message: string);
 }
 /** Thrown when an operation is denied due to insufficient permissions. Non-recoverable. */
 export declare class PermissionError extends AppError {
+    readonly code: 'PERMISSION_DENIED';
     constructor(message: string);
 }
 /** Thrown when the renderer encounters a failure. Recoverable by default. */
 export declare class RenderError extends AppError {
+    readonly code: 'RENDER_ERROR';
     constructor(message: string);
 }
 /**