@pellux/goodvibes-sdk 0.30.3 → 0.33.0

package/dist/platform/tools/read/file-readers.js

@@ -123,7 +123,7 @@ async function readImageFile(target, context, imageMode, maxImageSize) {
     }
     const magicResult = validateMagicBytes(imgBuffer, extname(target.resolvedPath));
     if (!magicResult.valid) {
-        logger.debug('[read] image magic bytes mismatch', {
+        logger.warn('[read] image magic bytes mismatch', {
             path: target.resolvedPath,
             expected: extname(target.resolvedPath),
             detected: magicResult.detectedType ?? 'unknown',
@@ -242,7 +242,7 @@ async function readTextFile(target, context, fileInput) {
     }
     catch (err) {
         const message = summarizeError(err);
-        logger.debug('read tool: file read failed', { path: target.resolvedPath, error: message });
+        logger.warn('read tool: file read failed', { path: target.resolvedPath, error: message });
         return createReadErrorResult(target, `Cannot read file: ${message}`);
     }
     if (isBinaryByContent(fullBuf)) {
@@ -255,7 +255,7 @@ async function readTextFile(target, context, fileInput) {
     }
     catch (err) {
         const message = summarizeError(err);
-        logger.debug('read tool: utf-8 decode failed', { path: target.resolvedPath, error: message });
+        logger.warn('read tool: utf-8 decode failed', { path: target.resolvedPath, error: message });
         return createReadErrorResult(target, `Cannot decode file as UTF-8: ${message}`, fullBuf.length);
     }
     const cacheResult = fileInput.force ? { status: 'miss' } : context.fileCache.lookup(target.resolvedPath);
@@ -304,7 +304,7 @@ export async function readOneFile(fileInput, globalExtract, format, includeLineN
     }
     catch (err) {
         const message = summarizeError(err);
-        logger.debug('read tool: path validation failed', { path: fileInput.path, error: message });
+        logger.warn('read tool: path validation failed', { path: fileInput.path, error: message });
         return createReadErrorResult({ fileInput, resolvedPath: fileInput.path, extract }, message);
     }
     const target = { fileInput, resolvedPath, extract };
@@ -337,7 +337,7 @@ export function paginateFiles(files, tokenBudget, projectRoot) {
     for (let i = 0; i < files.length; i++) {
         let est = 0;
         try {
-            const resolved = resolveAndValidatePath(files[i].path, projectRoot);
+            const resolved = resolveAndValidatePath((files[i]?.path ?? ''), projectRoot);
             est = Math.ceil(statSync(resolved).size / 4);
         }
         catch {

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

@@ -61,7 +61,7 @@ export class ReadTool {
             const totalPages = Math.max(1, pages.length);
             const pageIdx = Math.min(page - 1, totalPages - 1);
             const pageIndices = pages[pageIdx] ?? [];
-            filesToProcess = pageIndices.map((i) => allFiles[i]);
+            filesToProcess = pageIndices.map((i) => allFiles[i]).filter((f) => f !== undefined);
             const deliveredSet = new Set(pages.slice(0, pageIdx + 1).flat());
             const pendingFiles = allFiles
                 .map((f, i) => ({ f, i }))

package/dist/platform/tools/read/media.d.ts

@@ -24,8 +24,8 @@ export declare function isArchiveFile(ext: string): boolean;
 /** Returns the MIME type for an image extension, or null if unknown. */
 export declare function getImageMediaType(ext: string): string | null;
 export interface ImageMetadata {
-    width?: number;
-    height?: number;
+    width?: number | undefined;
+    height?: number | undefined;
     format: string;
     fileSize: number;
 }
@@ -40,13 +40,13 @@ export declare function getImageMetadata(buffer: Buffer, ext: string): ImageMeta
  */
 interface SharpInstance {
     metadata(): Promise<{
-        width?: number;
-        height?: number;
+        width?: number | undefined;
+        height?: number | undefined;
         format?: string;
     }>;
     resize(options: {
-        width?: number;
-        height?: number;
+        width?: number | undefined;
+        height?: number | undefined;
     }): SharpInstance;
     png(): SharpInstance;
     jpeg(): SharpInstance;
@@ -70,8 +70,8 @@ export declare function tryLoadSharp(): Promise<SharpFactory | null>;
 export interface ResizeResult {
     buffer: Buffer;
     resized: boolean;
-    width?: number;
-    height?: number;
+    width?: number | undefined;
+    height?: number | undefined;
 }
 /**
  * Resize an image buffer so its longest edge is ≤ maxEdge.

package/dist/platform/tools/read/media.d.ts.map

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

package/dist/platform/tools/read/media.js

@@ -244,7 +244,7 @@ export function getImageMetadata(buffer, ext) {
         }
     }
     catch (err) {
-        logger.debug('[media] getImageMetadata failed', { error: summarizeError(err) });
+        logger.warn('[media] getImageMetadata failed', { error: summarizeError(err) });
     }
     return base;
 }
@@ -254,6 +254,9 @@ export function getImageMetadata(buffer, ext) {
  */
 export async function tryLoadSharp() {
     try {
+        // Preserve dynamic ESM import when TypeScript is emitted through CommonJS
+        // targets; `import('sharp')` would otherwise be lowered into `require`.
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
         const dynamicImport = new Function('specifier', 'return import(specifier)');
         const mod = await dynamicImport('sharp');
         if (typeof mod === 'function') {
@@ -311,7 +314,7 @@ export async function resizeImage(buffer, mediaType, maxEdge) {
         };
     }
     catch (err) {
-        logger.debug('[media] sharp resize failed', { error: summarizeError(err) });
+        logger.warn('[media] sharp resize failed', { error: summarizeError(err) });
         return { buffer, resized: false };
     }
 }
@@ -335,7 +338,7 @@ export async function convertToPortableFormat(buffer, ext) {
         return { buffer: pngBuffer, mediaType: 'image/png', converted: true, originalFormat };
     }
     catch (err) {
-        logger.debug('[media] format conversion failed', { error: summarizeError(err) });
+        logger.warn('[media] format conversion failed', { error: summarizeError(err) });
         return { buffer, mediaType: IMAGE_MEDIA_TYPES[ext.toLowerCase()] ?? 'application/octet-stream', converted: false, originalFormat };
     }
 }
@@ -441,7 +444,7 @@ export function listArchiveContents(resolvedPath, buffer, ext) {
         return `Archive (${entries.length} files):\n${lines.join('\n')}`;
     }
     catch (err) {
-        logger.debug('[media] listArchiveContents failed', { error: summarizeError(err) });
+        logger.warn('[media] listArchiveContents failed', { error: summarizeError(err) });
         return 'Archive (unable to list contents)';
     }
 }

package/dist/platform/tools/read/schema.d.ts

@@ -117,29 +117,29 @@ export type OutputFormat = 'count_only' | 'minimal' | 'standard' | 'verbose';
 /** Input shape for a single file entry in the read tool. */
 export interface ReadFileInput {
     path: string;
-    extract?: ExtractMode;
+    extract?: ExtractMode | undefined;
     range?: {
         start: number;
         end: number;
     };
-    force?: boolean;
+    force?: boolean | undefined;
     /** Page range for PDF files (e.g. '1-5', '3', '10-20'). Max 20 pages. */
-    pages?: string;
-    image_mode?: ImageMode;
+    pages?: string | undefined;
+    image_mode?: ImageMode | undefined;
 }
 /** Full input shape for the read tool. */
 export interface ReadInput {
     files: ReadFileInput[];
-    extract?: ExtractMode;
+    extract?: ExtractMode | undefined;
     output?: {
-        format?: OutputFormat;
-        include_line_numbers?: boolean;
-        max_per_item?: number;
-        max_tokens?: number;
+        format?: OutputFormat | undefined;
+        include_line_numbers?: boolean | undefined;
+        max_per_item?: number | undefined;
+        max_tokens?: number | undefined;
     };
-    token_budget?: number;
-    page?: number;
-    image_mode?: ImageMode;
-    max_image_size?: number;
+    token_budget?: number | undefined;
+    page?: number | undefined;
+    image_mode?: ImageMode | undefined;
+    max_image_size?: number | undefined;
 }
 //# sourceMappingURL=schema.d.ts.map

package/dist/platform/tools/read/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/read/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmHnB,CAAC;AAEX,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAE9E,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7E,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/read/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmHnB,CAAC;AAEX,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAE9E,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7E,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACpC;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;QAClC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC3C,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACjC,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC"}

package/dist/platform/tools/read/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/read/text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAsChE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAAE,OAAO,GAAG,MAAM,CAexF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAAE,OAAO,GAAG,MAAM,CAexF;AAuBD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,kBAAkB,EAAE,OAAO,EAC3B,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,YAAY,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,kBAAkB,EAAE,OAAO,EAC3B,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,YAAY,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,kBAAkB,EAAE,OAAO,EAC3B,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,YAAY,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,kBAAkB,EAAE,OAAO,EAC3B,KAAK,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAsBR"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/read/text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAsChE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAAE,OAAO,GAAG,MAAM,CAexF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAAE,OAAO,GAAG,MAAM,CAexF;AAuBD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,kBAAkB,EAAE,OAAO,EAC3B,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,YAAY,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,kBAAkB,EAAE,OAAO,EAC3B,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,YAAY,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,kBAAkB,EAAE,OAAO,EAC3B,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,YAAY,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,kBAAkB,EAAE,OAAO,EAC3B,KAAK,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAsBR"}

package/dist/platform/tools/read/text.js

@@ -87,7 +87,8 @@ export async function extractOutline(filePath, rawContent, lines, includeLineNum
     catch (err) {
         logger.debug('read tool: tree-sitter outline failed, using regex fallback', { filePath, error: summarizeError(err) });
     }
-    return extractOutlineRegex(lines, includeLineNumbers);
+    return ('# Note: tree-sitter outline unavailable for this file. Falling back to regex.\n'
+        + extractOutlineRegex(lines, includeLineNumbers));
 }
 export async function extractSymbols(filePath, rawContent, lines, includeLineNumbers, codeIntelligence) {
     try {
@@ -100,7 +101,8 @@ export async function extractSymbols(filePath, rawContent, lines, includeLineNum
     catch (err) {
         logger.debug('read tool: tree-sitter symbols failed, using regex fallback', { filePath, error: summarizeError(err) });
     }
-    return extractSymbolsRegex(lines, includeLineNumbers);
+    return ('# Note: tree-sitter symbols unavailable for this file. Falling back to regex.\n'
+        + extractSymbolsRegex(lines, includeLineNumbers));
 }
 export async function extractAst(filePath, rawContent, lines, includeLineNumbers, codeIntelligence) {
     try {

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

@@ -2,7 +2,7 @@ import type { Tool } from '../../types/tools.js';
 import type { ToolRegistry } from '../registry.js';
 export interface RegistryToolRoots {
     readonly workingDirectory: string;
-    readonly homeDirectory?: string;
+    readonly homeDirectory?: string | undefined;
 }
 /**
  * Create the `registry` tool bound to the given ToolRegistry.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/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,GAAG,SAAS,CAAC;CAC7C;AA6HD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAwC7F"}

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

@@ -14,7 +14,7 @@ function parseFrontmatter(content) {
     if (!match)
         return {};
     const result = {};
-    for (const line of match[1].split('\n')) {
+    for (const line of (match[1] ?? '').split('\n')) {
         const [key, ...rest] = line.split(':');
         if (key && rest.length)
             result[key.trim()] = rest.join(':').trim();
@@ -169,7 +169,7 @@ export function createRegistryTool(toolRegistry, roots) {
         }
         catch (err) {
             const message = summarizeError(err);
-            logger.debug('registry tool: unexpected error', { error: message });
+            logger.error('registry tool: unexpected error', { error: message });
             return { success: false, error: `Unexpected error: ${message}` };
         }
     }
@@ -279,12 +279,7 @@ function runRecommend(input, toolRegistry, roots) {
             task,
             scope,
             count: sorted.length,
-            results: sorted.map(({ score: _score, ...item }) => {
-                // strip internal score if present (from fallback path)
-                const { score: _s, ...rest } = { score: undefined, ...item };
-                void _s;
-                return rest;
-            }),
+            results: sorted.map(({ score: _score, ...item }) => item),
         }),
     });
 }

package/dist/platform/tools/registry-tool/schema.d.ts

@@ -44,11 +44,11 @@ export type RegistryMode = 'search' | 'recommend' | 'dependencies' | 'preview' |
 /** Full input shape for the registry tool. */
 export interface RegistryInput {
     mode: RegistryMode;
-    query?: string;
-    type?: 'skills' | 'agents' | 'tools' | 'all';
-    task?: string;
-    scope?: 'skills' | 'tools';
-    skillName?: string;
-    path?: string;
+    query?: string | undefined;
+    type?: 'skills' | 'agents' | 'tools' | 'all' | undefined;
+    task?: string | undefined;
+    scope?: 'skills' | 'tools' | undefined;
+    skillName?: string | undefined;
+    path?: string | undefined;
 }
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/registry-tool/schema.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CvB,CAAC;AAEX,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3F,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IAGnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IAG7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAG3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/registry-tool/schema.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CvB,CAAC;AAEX,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3F,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IAGnB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;IAGzD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAGvC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAG/B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B"}

package/dist/platform/tools/registry-tool/skill-loader.d.ts

@@ -1,6 +1,6 @@
 export interface SkillLoaderRoots {
     readonly workingDirectory: string;
-    readonly homeDirectory?: string;
+    readonly homeDirectory?: string | undefined;
 }
 /**
  * Find a skill whose triggers include the given input string.

package/dist/platform/tools/registry-tool/skill-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/registry-tool/skill-loader.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAcD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAuDxF"}
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/registry-tool/skill-loader.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAcD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAuDxF"}

package/dist/platform/tools/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/platform/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI1E,OAAO,KAAK,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAGjH;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA2B;IAExC,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAClB,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,uBAAuB,GAC7B,0BAA0B;IAiB7B;;;;;;OAMG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,uBAAuB,GAC7B,0BAA0B,GAAG,SAAS;IAOzC;;;;;OAKG;IACH,kBAAkB,CAChB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAK1C,2EAA2E;IAC3E,kBAAkB,IAAI,cAAc,EAAE;IAItC,iFAAiF;IAC3E,OAAO,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC;IAsCtB,gEAAgE;IAChE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,oCAAoC;IACpC,IAAI,IAAI,IAAI,EAAE;CAGf"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/platform/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI1E,OAAO,KAAK,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAGjH;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA2B;IAExC,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAClB,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,uBAAuB,GAC7B,0BAA0B;IAiB7B;;;;;;OAMG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,uBAAuB,GAC7B,0BAA0B,GAAG,SAAS;IAOzC;;;;;OAKG;IACH,kBAAkB,CAChB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAK1C,2EAA2E;IAC3E,kBAAkB,IAAI,cAAc,EAAE;IAItC,iFAAiF;IAC3E,OAAO,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC;IA0CtB,gEAAgE;IAChE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,oCAAoC;IACpC,IAAI,IAAI,IAAI,EAAE;CAGf"}

package/dist/platform/tools/registry.js

@@ -88,6 +88,9 @@ export class ToolRegistry {
             const result = await tool.execute(effectiveArgs);
             // Tool.execute returns ToolResult without callId — inject it here
             const toolResult = { ...result, callId };
+            if (repairResult.warnings && repairResult.warnings.length > 0) {
+                toolResult.warnings = [...(toolResult.warnings ?? []), ...repairResult.warnings];
+            }
             // Surface repairs to the LLM so it knows what was auto-fixed
             if (repairResult.repaired) {
                 const repairNote = `[Auto-repaired: ${repairResult.repairs.join(', ')}]`;

package/dist/platform/tools/remote-trigger/schema.d.ts

@@ -2,11 +2,11 @@ import type { ToolDefinition } from '../../types/tools.js';
 export declare const REMOTE_TRIGGER_TOOL_SCHEMA: ToolDefinition;
 export interface RemoteTriggerToolInput {
     readonly mode: 'create-pool' | 'pools' | 'assign' | 'unassign' | 'contracts' | 'artifacts' | 'review' | 'import-artifact';
-    readonly view?: 'summary' | 'full';
-    readonly poolId?: string;
-    readonly label?: string;
-    readonly runnerId?: string;
-    readonly artifactId?: string;
-    readonly path?: string;
+    readonly view?: 'summary' | 'full' | undefined;
+    readonly poolId?: string | undefined;
+    readonly label?: string | undefined;
+    readonly runnerId?: string | undefined;
+    readonly artifactId?: string | undefined;
+    readonly path?: string | undefined;
 }
 //# sourceMappingURL=schema.d.ts.map

package/dist/platform/tools/remote-trigger/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/remote-trigger/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,0BAA0B,EAAE,cAiBxC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IAC1H,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/remote-trigger/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,0BAA0B,EAAE,cAiBxC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IAC1H,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC"}

package/dist/platform/tools/repl/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/repl/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAmBjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAsMD,wBAAgB,cAAc,CAC5B,aAAa,EAAE,iBAAiB,EAChC,sBAAsB,EAAE,sBAAsB,EAC9C,OAAO,EAAE,eAAe,GACvB,IAAI,CA6EN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/repl/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAqBjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAuMD,wBAAgB,cAAc,CAC5B,aAAa,EAAE,iBAAiB,EAChC,sBAAsB,EAAE,sBAAsB,EAC9C,OAAO,EAAE,eAAe,GACvB,IAAI,CA6EN"}

package/dist/platform/tools/repl/index.js

@@ -1,4 +1,4 @@
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import ts from 'typescript';
 import { executeSandboxCommand } from '../../runtime/sandbox/backend.js';
@@ -7,29 +7,36 @@ import { SandboxSessionRegistry } from '../../runtime/sandbox/session-registry.j
 import { requireSurfaceRoot } from '../../runtime/surface-root.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { REPL_TOOL_SCHEMA } from './schema.js';
+const REPL_ENV_ALLOWLIST = ['PATH', 'HOME', 'TMPDIR', 'TEMP', 'TMP', 'LANG'];
 function resolveHistoryPath(workspaceRoot, surfaceRoot) {
     return join(workspaceRoot, '.goodvibes', surfaceRoot, 'repl-history.json');
 }
-function createLocalExecPlan(workspaceRoot) {
-    return {
-        backend: 'local',
-        command: process.env.SHELL || 'bash',
-        args: ['-lc', 'true'],
-        workspaceRoot,
-        summary: 'local process exec',
-    };
+function createReplEnv(extra = {}) {
+    const env = {};
+    for (const key of REPL_ENV_ALLOWLIST) {
+        const value = process.env[key];
+        if (value !== undefined)
+            env[key] = value;
+    }
+    return { ...env, ...extra };
 }
-function loadHistory(historyPath) {
+function requireReplSandbox(launchPlan) {
+    if (!launchPlan || launchPlan.backend !== 'qemu') {
+        throw new Error('REPL eval requires an explicit QEMU sandbox backend; configure sandbox.vmBackend, sandbox.qemuImagePath, and sandbox.qemuExecWrapper before evaluating code.');
+    }
+    return launchPlan;
+}
+async function loadHistory(historyPath) {
     try {
-        return JSON.parse(readFileSync(historyPath, 'utf-8'));
+        return JSON.parse(await readFile(historyPath, 'utf-8'));
     }
     catch {
         return [];
     }
 }
-function saveHistory(historyPath, entries) {
-    mkdirSync(dirname(historyPath), { recursive: true });
-    writeFileSync(historyPath, `${JSON.stringify(entries, null, 2)}\n`, 'utf-8');
+async function saveHistory(historyPath, entries) {
+    await mkdir(dirname(historyPath), { recursive: true });
+    await writeFile(historyPath, `${JSON.stringify(entries, null, 2)}\n`, 'utf-8');
 }
 function mapRuntimeToSandboxProfile(runtime) {
     switch (runtime) {
@@ -41,6 +48,9 @@ function mapRuntimeToSandboxProfile(runtime) {
     }
 }
 async function evalJavaScriptInSandbox(expression, bindings, launchPlan, configManager, sandboxSessionRegistry, sessionId) {
+    if (launchPlan.backend !== 'qemu') {
+        throw new Error('evalJavaScriptInSandbox: refusing to run outside QEMU sandbox');
+    }
     const payload = JSON.stringify({ expression, bindings });
     const runner = `
 const payload = JSON.parse(process.env.GV_REPL_PAYLOAD ?? '{}');
@@ -54,17 +64,13 @@ process.stdout.write(typeof value === 'string' ? value : JSON.stringify(value));
     const result = sessionId
         ? sandboxSessionRegistry.execute(sessionId, process.execPath, ['-e', runner], configManager, {
             timeoutMs: 1000,
-            env: {
-                ...process.env,
-                GV_REPL_PAYLOAD: payload,
-            },
+            inheritHostEnv: false,
+            env: createReplEnv({ GV_REPL_PAYLOAD: payload }),
         })
         : executeSandboxCommand(launchPlan, process.execPath, ['-e', runner], {
             timeoutMs: 1000,
-            env: {
-                ...process.env,
-                GV_REPL_PAYLOAD: payload,
-            },
+            inheritHostEnv: false,
+            env: createReplEnv({ GV_REPL_PAYLOAD: payload }),
         });
     if (result.status !== 0) {
         throw new Error((result.stderr || result.stdout || 'JavaScript eval failed.').trim());
@@ -85,10 +91,14 @@ function evalPython(expression, workspaceRoot, configManager, sandboxSessionRegi
         ? sandboxSessionRegistry.execute(sessionId, 'python3', ['-I', '-S', '-c', `import json\nresult = (${expression})\nprint(json.dumps(result))`], configManager, {
             cwd: workspaceRoot,
             timeoutMs: 5000,
+            inheritHostEnv: false,
+            env: createReplEnv(),
         })
         : executeSandboxCommand(launchPlan, 'python3', ['-I', '-S', '-c', `import json\nresult = (${expression})\nprint(json.dumps(result))`], {
             cwd: workspaceRoot,
             timeoutMs: 5000,
+            inheritHostEnv: false,
+            env: createReplEnv(),
         });
     if (run.status !== 0) {
         throw new Error((run.stderr || run.stdout || 'Python eval failed.').trim());
@@ -110,17 +120,13 @@ process.stdout.write(JSON.stringify(rows));
     const result = sessionId
         ? sandboxSessionRegistry.execute(sessionId, process.execPath, ['-e', script], configManager, {
             timeoutMs: 5000,
-            env: {
-                ...process.env,
-                GV_REPL_PAYLOAD: payload,
-            },
+            inheritHostEnv: false,
+            env: createReplEnv({ GV_REPL_PAYLOAD: payload }),
         })
         : executeSandboxCommand(launchPlan, process.execPath, ['-e', script], {
             timeoutMs: 5000,
-            env: {
-                ...process.env,
-                GV_REPL_PAYLOAD: payload,
-            },
+            inheritHostEnv: false,
+            env: createReplEnv({ GV_REPL_PAYLOAD: payload }),
         });
     if (result.status !== 0) {
         throw new Error((result.stderr || result.stdout || 'SQL eval failed.').trim());
@@ -144,17 +150,13 @@ process.stdout.write(JSON.stringify({
     const result = sessionId
         ? sandboxSessionRegistry.execute(sessionId, process.execPath, ['-e', script], configManager, {
             timeoutMs: 2000,
-            env: {
-                ...process.env,
-                GV_REPL_PAYLOAD: payload,
-            },
+            inheritHostEnv: false,
+            env: createReplEnv({ GV_REPL_PAYLOAD: payload }),
         })
         : executeSandboxCommand(launchPlan, process.execPath, ['-e', script], {
             timeoutMs: 2000,
-            env: {
-                ...process.env,
-                GV_REPL_PAYLOAD: payload,
-            },
+            inheritHostEnv: false,
+            env: createReplEnv({ GV_REPL_PAYLOAD: payload }),
         });
     if (result.status !== 0) {
         throw new Error((result.stderr || result.stdout || 'GraphQL eval failed.').trim());
@@ -180,8 +182,7 @@ export function createReplTool(configManager, sandboxSessionRegistry, options) {
                 return { success: false, error: 'repl requires workspaceRoot.' };
             }
             const historyPath = resolveHistoryPath(input.workspaceRoot, surfaceRoot);
-            const history = loadHistory(historyPath);
-            const localExecPlan = createLocalExecPlan(input.workspaceRoot);
+            const history = await loadHistory(historyPath);
             if (input.mode === 'history') {
                 return { success: true, output: JSON.stringify({ count: history.length, history }) };
             }
@@ -190,25 +191,26 @@ export function createReplTool(configManager, sandboxSessionRegistry, options) {
             const runtime = input.runtime ?? 'javascript';
             const sandboxSession = await sandboxSessionRegistry.start(mapRuntimeToSandboxProfile(runtime), `repl:${runtime}`, configManager);
             try {
+                const launchPlan = requireReplSandbox(sandboxSession.launchPlan);
                 let rendered = '';
                 switch (runtime) {
                     case 'javascript':
-                        rendered = await evalJavaScriptInSandbox(input.expression, input.bindings ?? {}, sandboxSession.launchPlan ?? localExecPlan, configManager, sandboxSessionRegistry, sandboxSession.id);
+                        rendered = await evalJavaScriptInSandbox(input.expression, input.bindings ?? {}, launchPlan, configManager, sandboxSessionRegistry, sandboxSession.id);
                         break;
                     case 'typescript':
-                        rendered = await evalTypeScript(input.expression, input.bindings ?? {}, configManager, sandboxSessionRegistry, sandboxSession.launchPlan ?? localExecPlan, sandboxSession.id);
+                        rendered = await evalTypeScript(input.expression, input.bindings ?? {}, configManager, sandboxSessionRegistry, launchPlan, sandboxSession.id);
                         break;
                     case 'python':
-                        rendered = evalPython(input.expression, input.workspaceRoot, configManager, sandboxSessionRegistry, sandboxSession.launchPlan ?? localExecPlan, sandboxSession.id);
+                        rendered = evalPython(input.expression, input.workspaceRoot, configManager, sandboxSessionRegistry, launchPlan, sandboxSession.id);
                         break;
                     case 'sql':
-                        rendered = await evalSql(input.expression, configManager, sandboxSessionRegistry, sandboxSession.launchPlan ?? localExecPlan, sandboxSession.id);
+                        rendered = await evalSql(input.expression, configManager, sandboxSessionRegistry, launchPlan, sandboxSession.id);
                         break;
                     case 'graphql':
-                        rendered = evalGraphql(input.expression, configManager, sandboxSessionRegistry, sandboxSession.launchPlan ?? localExecPlan, sandboxSession.id);
+                        rendered = evalGraphql(input.expression, configManager, sandboxSessionRegistry, launchPlan, sandboxSession.id);
                         break;
                 }
-                saveHistory(historyPath, [...history, {
+                await saveHistory(historyPath, [...history, {
                         ts: Date.now(),
                         runtime,
                         expression: input.expression,
@@ -220,7 +222,7 @@ export function createReplTool(configManager, sandboxSessionRegistry, options) {
                 return { success: true, output: rendered };
             }
             catch (error) {
-                saveHistory(historyPath, [...history, {
+                await saveHistory(historyPath, [...history, {
                         ts: Date.now(),
                         runtime,
                         expression: input.expression,

package/dist/platform/tools/repl/schema.d.ts

@@ -2,8 +2,8 @@ import type { ToolDefinition } from '../../types/tools.js';
 export declare const REPL_TOOL_SCHEMA: ToolDefinition;
 export interface ReplToolInput {
     readonly mode: 'eval' | 'history';
-    readonly runtime?: 'javascript' | 'typescript' | 'python' | 'sql' | 'graphql';
-    readonly expression?: string;
-    readonly bindings?: Record<string, unknown>;
+    readonly runtime?: 'javascript' | 'typescript' | 'python' | 'sql' | 'graphql' | undefined;
+    readonly expression?: string | undefined;
+    readonly bindings?: Record<string, unknown> | undefined;
 }
 //# sourceMappingURL=schema.d.ts.map

package/dist/platform/tools/repl/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/repl/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,gBAAgB,EAAE,cAc9B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/repl/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,gBAAgB,EAAE,cAc9B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACzD"}

package/dist/platform/tools/shared/auto-heal.d.ts

@@ -7,7 +7,8 @@
  *   3. ToolLLM: LLM-assisted fix with error context
  *
  * Design constraints:
- *   - Never throws — returns {healed: false, content: originalContent} on any failure
+ *   - Returns {healed: false, content: originalContent} with warnings whenever
+ *     repair cannot safely produce validated replacement content
  *   - Each stage checks if errors are resolved before proceeding to the next
  *   - Uses Bun.which() to detect available tools at runtime
  */
@@ -17,7 +18,8 @@ import type { ToolLLM } from '../../config/tool-llm.js';
 export interface HealResult {
     healed: boolean;
     content: string;
-    method?: 'formatter' | 'linter' | 'llm';
+    method?: 'formatter' | 'linter' | 'llm' | undefined;
+    warnings?: string[] | undefined;
 }
 /**
  * AutoHealer — attempts to fix content with validation errors via a staged pipeline.

package/dist/platform/tools/shared/auto-heal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-heal.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/shared/auto-heal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAIxD,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;IAGjD;;;;;;;OAOG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IA8CpF;;OAEG;YACW,aAAa;IAmD3B;;OAEG;YACW,UAAU;IAqCxB;;OAEG;YACW,OAAO;IAsDrB;;;;;OAKG;YACW,eAAe;CA0B9B"}
+{"version":3,"file":"auto-heal.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/shared/auto-heal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAIxD,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACjC;AAOD;;;;;;;GAOG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;IAGjD;;;;;;;OAOG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAkDpF;;OAEG;YACW,aAAa;IA0D3B;;OAEG;YACW,UAAU;IA2CxB;;OAEG;YACW,OAAO;IA8DrB;;;;;OAKG;YACW,eAAe;CA0B9B"}