@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/tools/write-file.js

@@ -0,0 +1,320 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable complexity, sonarjs/cognitive-complexity -- Phase 5: legacy core boundary retained while larger decomposition continues. */
+import fs from 'fs';
+import path from 'path';
+import * as Diff from 'diff';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from './tools.js';
+import { ToolErrorType } from '../types/tool-error.js';
+import { makeRelative, shortenPath } from '../utils/paths.js';
+import { getErrorMessage, isNodeError } from '../utils/errors.js';
+import { DEFAULT_CREATE_PATCH_OPTIONS, getDiffStat, } from '../utils/diffOptions.js';
+import { getSpecificMimeType } from '../utils/fileUtils.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { validatePathWithinWorkspace } from '../utils/pathValidation.js';
+/**
+ * Gets corrected file content — preserves trailing newline for existing files.
+ */
+async function getCorrectedFileContent(filePath, proposedContent, host) {
+    let originalContent = '';
+    let fileExists = false;
+    let correctedContent = proposedContent;
+    try {
+        originalContent = await fs.promises.readFile(filePath, 'utf-8');
+        fileExists = true;
+    }
+    catch (err) {
+        if (isNodeError(err) && err.code === 'ENOENT') {
+            fileExists = false;
+            originalContent = '';
+        }
+        else {
+            fileExists = true;
+            originalContent = '';
+            const error = {
+                message: getErrorMessage(err),
+                code: isNodeError(err) ? err.code : undefined,
+            };
+            return { originalContent, correctedContent, fileExists, error };
+        }
+    }
+    correctedContent = proposedContent;
+    const preserveTrailingNewline = fileExists && originalContent.endsWith('\n');
+    if (preserveTrailingNewline &&
+        correctedContent.length > 0 &&
+        !correctedContent.endsWith('\n')) {
+        correctedContent = `${correctedContent}\n`;
+    }
+    return { originalContent, correctedContent, fileExists };
+}
+class WriteFileToolInvocation extends BaseToolInvocation {
+    host;
+    constructor(host, params, messageBus, toolName, displayName) {
+        super(params, messageBus, toolName, displayName);
+        this.host = host;
+    }
+    getToolName() {
+        return WriteFileTool.Name;
+    }
+    getFilePath() {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string paths are invalid, fall back to file_path
+        return this.params.absolute_path || this.params.file_path || '';
+    }
+    toolLocations() {
+        return [{ path: this.getFilePath() }];
+    }
+    getDescription() {
+        const filePath = this.getFilePath();
+        if (!filePath || !this.params.content) {
+            return `Model did not provide valid parameters for write file tool`;
+        }
+        const relativePath = makeRelative(filePath, this.host.getTargetDir());
+        return `Writing to ${shortenPath(relativePath)}`;
+    }
+    async shouldConfirmExecute(abortSignal) {
+        if (this.messageBus) {
+            const decision = await this.getMessageBusDecision(abortSignal);
+            if (decision === 'ALLOW') {
+                return false;
+            }
+            if (decision === 'DENY') {
+                throw new Error('Tool execution denied by policy.');
+            }
+        }
+        if (this.host.getApprovalMode() === 'auto') {
+            return false;
+        }
+        const filePath = this.getFilePath();
+        const correctedContentResult = await getCorrectedFileContent(filePath, this.params.content, this.host);
+        const fileName = path.basename(filePath);
+        const originalContent = correctedContentResult.originalContent;
+        const newContent = correctedContentResult.correctedContent;
+        const fileDiff = Diff.createPatch(fileName, originalContent, newContent, 'Original', 'Written', DEFAULT_CREATE_PATCH_OPTIONS);
+        return {
+            type: 'edit',
+            title: 'Confirm Write File',
+            fileName,
+            filePath,
+            fileDiff,
+            originalContent,
+            newContent,
+            onConfirm: async (outcome) => {
+                if (outcome === ToolConfirmationOutcome.ProceedAlways) {
+                    this.host.setApprovalMode('auto');
+                }
+                else {
+                    await this.publishPolicyUpdate(outcome);
+                }
+            },
+        };
+    }
+    async execute(_abortSignal) {
+        const filePath = this.getFilePath();
+        const correctedContentResult = await getCorrectedFileContent(filePath, this.params.content, this.host);
+        if (correctedContentResult.error) {
+            const errDetails = correctedContentResult.error;
+            const errorMsg = errDetails.code
+                ? `Error checking existing file '${filePath}': ${errDetails.message} (${errDetails.code})`
+                : `Error checking existing file: ${errDetails.message}`;
+            return {
+                llmContent: errorMsg,
+                returnDisplay: errorMsg,
+                error: {
+                    message: errorMsg,
+                    type: ToolErrorType.FILE_WRITE_FAILURE,
+                },
+            };
+        }
+        const { originalContent, correctedContent: fileContent, fileExists, } = correctedContentResult;
+        const isNewFile = !fileExists;
+        try {
+            return await this.writeFile(filePath, fileContent, originalContent, isNewFile);
+        }
+        catch (error) {
+            return this.createWriteError(filePath, error);
+        }
+    }
+    async writeFile(filePath, fileContent, originalContent, isNewFile) {
+        const dirName = path.dirname(filePath);
+        if (!fs.existsSync(dirName)) {
+            fs.mkdirSync(dirName, { recursive: true });
+        }
+        fs.writeFileSync(filePath, fileContent, 'utf-8');
+        const fileName = path.basename(filePath);
+        const fileDiff = Diff.createPatch(fileName, originalContent, fileContent, 'Original', 'Written', DEFAULT_CREATE_PATCH_OPTIONS);
+        const originallyProposedContent = this.params.ai_proposed_content ?? this.params.content;
+        const diffStat = getDiffStat(fileName, originalContent, originallyProposedContent, this.params.content);
+        const llmSuccessMessageParts = this.buildSuccessMessageParts(isNewFile);
+        this.recordMetrics(filePath, fileContent, isNewFile, diffStat);
+        const displayResult = {
+            fileDiff,
+            fileName,
+            filePath,
+            originalContent,
+            newContent: fileContent,
+            diffStat,
+            isNewFile,
+        };
+        const result = {
+            llmContent: llmSuccessMessageParts.join('\n\n'),
+            returnDisplay: displayResult,
+        };
+        return result;
+    }
+    buildSuccessMessageParts(isNewFile) {
+        const displayPath = 
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string paths are invalid, fall back to file_path
+        this.params.absolute_path || this.params.file_path || '';
+        const parts = [
+            isNewFile
+                ? `Successfully created and wrote to new file: ${displayPath}.`
+                : `Successfully overwrote file: ${displayPath}.`,
+        ];
+        if (this.params.modified_by_user === true) {
+            parts.push(`User modified the \`content\` to be: ${this.params.content}`);
+        }
+        return parts;
+    }
+    recordMetrics(filePath, fileContent, isNewFile, diffStat) {
+        const lines = fileContent.split('\n').length;
+        const mimetype = getSpecificMimeType(filePath);
+        const extension = path.extname(filePath);
+        void lines;
+        void mimetype;
+        void extension;
+        void diffStat;
+        void isNewFile;
+        // Metrics recording deferred to core adapter layer
+    }
+    createWriteError(filePath, error) {
+        let errorMsg;
+        let errorType = ToolErrorType.FILE_WRITE_FAILURE;
+        if (isNodeError(error)) {
+            errorMsg = `Error writing to file '${filePath}': ${error.message} (${error.code})`;
+            if (error.code === 'EACCES') {
+                errorMsg = `Permission denied writing to file: ${filePath} (${error.code})`;
+                errorType = ToolErrorType.PERMISSION_DENIED;
+            }
+            else if (error.code === 'ENOSPC') {
+                errorMsg = `No space left on device: ${filePath} (${error.code})`;
+                errorType = ToolErrorType.NO_SPACE_LEFT;
+            }
+            else if (error.code === 'EISDIR') {
+                errorMsg = `Target is a directory, not a file: ${filePath} (${error.code})`;
+                errorType = ToolErrorType.TARGET_IS_DIRECTORY;
+            }
+            if (this.host.getDebugMode() && error.stack) {
+                debugLogger.error('Write file error stack:', error.stack);
+            }
+        }
+        else if (error instanceof Error) {
+            errorMsg = `Error writing to file: ${error.message}`;
+        }
+        else {
+            errorMsg = `Error writing to file: ${String(error)}`;
+        }
+        return {
+            llmContent: errorMsg,
+            returnDisplay: errorMsg,
+            error: {
+                message: errorMsg,
+                type: errorType,
+            },
+        };
+    }
+}
+/**
+ * Implementation of the WriteFile tool logic
+ */
+export class WriteFileTool extends BaseDeclarativeTool {
+    host;
+    static Name = 'write_file';
+    constructor(host, messageBus) {
+        super(WriteFileTool.Name, 'WriteFile', `Writes content to a specified file in the local filesystem.
+
+      The user has the ability to modify \`content\`. If modified, this will be stated in the response.`, Kind.Edit, {
+            properties: {
+                absolute_path: {
+                    description: "The absolute path to the file to write to (e.g., '/home/user/project/file.txt'). Relative paths are not supported.",
+                    type: 'string',
+                },
+                file_path: {
+                    description: 'Alternative parameter name for absolute_path (for compatibility). The absolute path to the file to write.',
+                    type: 'string',
+                },
+                content: {
+                    description: 'The content to write to the file.',
+                    type: 'string',
+                },
+            },
+            required: ['content'],
+            type: 'object',
+        }, true, false, messageBus);
+        this.host = host;
+    }
+    validateToolParamValues(params) {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string paths are invalid
+        const filePath = params.absolute_path || params.file_path || '';
+        if (filePath.trim() === '') {
+            return "Either 'absolute_path' or 'file_path' parameter must be provided and non-empty.";
+        }
+        if (!path.isAbsolute(filePath)) {
+            return `File path must be absolute: ${filePath}`;
+        }
+        const pathError = validatePathWithinWorkspace(this.host.getWorkspaceRoots(), filePath);
+        if (pathError) {
+            return pathError;
+        }
+        try {
+            if (fs.existsSync(filePath)) {
+                const stats = fs.lstatSync(filePath);
+                if (stats.isDirectory()) {
+                    return `Path is a directory, not a file: ${filePath}`;
+                }
+            }
+        }
+        catch (statError) {
+            return `Error accessing path properties for validation: ${filePath}. Reason: ${statError instanceof Error ? statError.message : String(statError)}`;
+        }
+        return null;
+    }
+    createInvocation(params, messageBus, toolName, displayName) {
+        const normalizedParams = { ...params };
+        if (!normalizedParams.absolute_path && normalizedParams.file_path) {
+            normalizedParams.absolute_path = normalizedParams.file_path;
+        }
+        return new WriteFileToolInvocation(this.host, normalizedParams, messageBus, toolName ?? this.name, displayName ?? this.displayName);
+    }
+    getModifyContext(_abortSignal) {
+        return {
+            getFilePath: (params) => 
+            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string paths are invalid, fall back to file_path
+            params.absolute_path || params.file_path || '',
+            getCurrentContent: async (params) => {
+                // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string paths are invalid, fall back to file_path
+                const filePath = params.absolute_path || params.file_path || '';
+                const correctedContentResult = await getCorrectedFileContent(filePath, params.content, this.host);
+                return correctedContentResult.originalContent;
+            },
+            getProposedContent: async (params) => {
+                // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string paths are invalid, fall back to file_path
+                const filePath = params.absolute_path || params.file_path || '';
+                const correctedContentResult = await getCorrectedFileContent(filePath, params.content, this.host);
+                return correctedContentResult.correctedContent;
+            },
+            createUpdatedParams: (_oldContent, modifiedProposedContent, originalParams) => {
+                const content = originalParams.content;
+                return {
+                    ...originalParams,
+                    ai_proposed_content: content,
+                    content: modifiedProposedContent,
+                    modified_by_user: true,
+                };
+            },
+        };
+    }
+}
+//# sourceMappingURL=write-file.js.map

package/dist/src/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../../src/tools/write-file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6IAA6I;AAE7I,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAGlB,IAAI,EAIJ,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,4BAA4B,EAC5B,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAwCzE;;GAEG;AACH,KAAK,UAAU,uBAAuB,CACpC,QAAgB,EAChB,eAAuB,EACvB,IAAe;IAEf,IAAI,eAAe,GAAG,EAAE,CAAC;IACzB,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,gBAAgB,GAAG,eAAe,CAAC;IAEvC,IAAI,CAAC;QACH,eAAe,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChE,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,UAAU,GAAG,KAAK,CAAC;YACnB,eAAe,GAAG,EAAE,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,IAAI,CAAC;YAClB,eAAe,GAAG,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG;gBACZ,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC;gBAC7B,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;aAC9C,CAAC;YACF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAED,gBAAgB,GAAG,eAAe,CAAC;IACnC,MAAM,uBAAuB,GAAG,UAAU,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7E,IACE,uBAAuB;QACvB,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAC3B,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAChC,CAAC;QACD,gBAAgB,GAAG,GAAG,gBAAgB,IAAI,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,uBAAwB,SAAQ,kBAGrC;IAEoB;IADnB,YACmB,IAAe,EAChC,MAA2B,EAC3B,UAA2B,EAC3B,QAAiB,EACjB,WAAoB;QAEpB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QANhC,SAAI,GAAJ,IAAI,CAAW;IAOlC,CAAC;IAEQ,WAAW;QAClB,OAAO,aAAa,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEO,WAAW;QACjB,gKAAgK;QAChK,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IAClE,CAAC;IAEQ,aAAa;QACpB,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAEQ,cAAc;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,OAAO,4DAA4D,CAAC;QACtE,CAAC;QACD,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACtE,OAAO,cAAc,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;IACnD,CAAC;IAEQ,KAAK,CAAC,oBAAoB,CACjC,WAAwB;QAExB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;YAC/D,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,sBAAsB,GAAG,MAAM,uBAAuB,CAC1D,QAAQ,EACR,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,IAAI,CAAC,IAAI,CACV,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,eAAe,GAAG,sBAAsB,CAAC,eAAe,CAAC;QAC/D,MAAM,UAAU,GAAG,sBAAsB,CAAC,gBAAgB,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAC/B,QAAQ,EACR,eAAe,EACf,UAAU,EACV,UAAU,EACV,SAAS,EACT,4BAA4B,CAC7B,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,oBAAoB;YAC3B,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,eAAe;YACf,UAAU;YACV,SAAS,EAAE,KAAK,EAAE,OAAgC,EAAE,EAAE;gBACpD,IAAI,OAAO,KAAK,uBAAuB,CAAC,aAAa,EAAE,CAAC;oBACtD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBACpC,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,YAAyB;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,sBAAsB,GAAG,MAAM,uBAAuB,CAC1D,QAAQ,EACR,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,IAAI,CAAC,IAAI,CACV,CAAC;QAEF,IAAI,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC;YAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI;gBAC9B,CAAC,CAAC,iCAAiC,QAAQ,MAAM,UAAU,CAAC,OAAO,KAAK,UAAU,CAAC,IAAI,GAAG;gBAC1F,CAAC,CAAC,iCAAiC,UAAU,CAAC,OAAO,EAAE,CAAC;YAC1D,OAAO;gBACL,UAAU,EAAE,QAAQ;gBACpB,aAAa,EAAE,QAAQ;gBACvB,KAAK,EAAE;oBACL,OAAO,EAAE,QAAQ;oBACjB,IAAI,EAAE,aAAa,CAAC,kBAAkB;iBACvC;aACF,CAAC;QACJ,CAAC;QAED,MAAM,EACJ,eAAe,EACf,gBAAgB,EAAE,WAAW,EAC7B,UAAU,GACX,GAAG,sBAAsB,CAAC;QAC3B,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC;QAE9B,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CACzB,QAAQ,EACR,WAAW,EACX,eAAe,EACf,SAAS,CACV,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,QAAgB,EAChB,WAAmB,EACnB,eAAuB,EACvB,SAAkB;QAElB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAC/B,QAAQ,EACR,eAAe,EACf,WAAW,EACX,UAAU,EACV,SAAS,EACT,4BAA4B,CAC7B,CAAC;QAEF,MAAM,yBAAyB,GAC7B,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACzD,MAAM,QAAQ,GAAG,WAAW,CAC1B,QAAQ,EACR,eAAe,EACf,yBAAyB,EACzB,IAAI,CAAC,MAAM,CAAC,OAAO,CACpB,CAAC;QAEF,MAAM,sBAAsB,GAAG,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAExE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE/D,MAAM,aAAa,GAAa;YAC9B,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,eAAe;YACf,UAAU,EAAE,WAAW;YACvB,QAAQ;YACR,SAAS;SACV,CAAC;QAEF,MAAM,MAAM,GAAe;YACzB,UAAU,EAAE,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC;YAC/C,aAAa,EAAE,aAAa;SAC7B,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,wBAAwB,CAAC,SAAkB;QACjD,MAAM,WAAW;QACf,gKAAgK;QAChK,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG;YACZ,SAAS;gBACP,CAAC,CAAC,+CAA+C,WAAW,GAAG;gBAC/D,CAAC,CAAC,gCAAgC,WAAW,GAAG;SACnD,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,wCAAwC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,aAAa,CACnB,QAAgB,EAChB,WAAmB,EACnB,SAAkB,EAClB,QAAwC;QAExC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC7C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,KAAK,KAAK,CAAC;QACX,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,mDAAmD;IACrD,CAAC;IAEO,gBAAgB,CAAC,QAAgB,EAAE,KAAc;QACvD,IAAI,QAAgB,CAAC;QACrB,IAAI,SAAS,GAAG,aAAa,CAAC,kBAAkB,CAAC;QAEjD,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,QAAQ,GAAG,0BAA0B,QAAQ,MAAM,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;YAEnF,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,QAAQ,GAAG,sCAAsC,QAAQ,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;gBAC5E,SAAS,GAAG,aAAa,CAAC,iBAAiB,CAAC;YAC9C,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnC,QAAQ,GAAG,4BAA4B,QAAQ,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;gBAClE,SAAS,GAAG,aAAa,CAAC,aAAa,CAAC;YAC1C,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnC,QAAQ,GAAG,sCAAsC,QAAQ,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;gBAC5E,SAAS,GAAG,aAAa,CAAC,mBAAmB,CAAC;YAChD,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC5C,WAAW,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAClC,QAAQ,GAAG,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,0BAA0B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,CAAC;QAED,OAAO;YACL,UAAU,EAAE,QAAQ;YACpB,aAAa,EAAE,QAAQ;YACvB,KAAK,EAAE;gBACL,OAAO,EAAE,QAAQ;gBACjB,IAAI,EAAE,SAAS;aAChB;SACF,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aACX,SAAQ,mBAAoD;IAMlD;IAHV,MAAM,CAAU,IAAI,GAAW,YAAY,CAAC;IAE5C,YACU,IAAe,EACvB,UAA4B;QAE5B,KAAK,CACH,aAAa,CAAC,IAAI,EAClB,WAAW,EACX;;wGAEkG,EAClG,IAAI,CAAC,IAAI,EACT;YACE,UAAU,EAAE;gBACV,aAAa,EAAE;oBACb,WAAW,EACT,oHAAoH;oBACtH,IAAI,EAAE,QAAQ;iBACf;gBACD,SAAS,EAAE;oBACT,WAAW,EACT,2GAA2G;oBAC7G,IAAI,EAAE,QAAQ;iBACf;gBACD,OAAO,EAAE;oBACP,WAAW,EAAE,mCAAmC;oBAChD,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,IAAI,EAAE,QAAQ;SACf,EACD,IAAI,EACJ,KAAK,EACL,UAAU,CACX,CAAC;QAjCM,SAAI,GAAJ,IAAI,CAAW;IAkCzB,CAAC;IAEkB,uBAAuB,CACxC,MAA2B;QAE3B,wIAAwI;QACxI,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QAEhE,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3B,OAAO,iFAAiF,CAAC;QAC3F,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,+BAA+B,QAAQ,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,SAAS,GAAG,2BAA2B,CAC3C,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAC7B,QAAQ,CACT,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,OAAO,oCAAoC,QAAQ,EAAE,CAAC;gBACxD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,SAAkB,EAAE,CAAC;YAC5B,OAAO,mDAAmD,QAAQ,aAAa,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACtJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAES,gBAAgB,CACxB,MAA2B,EAC3B,UAA4B,EAC5B,QAAiB,EACjB,WAAoB;QAEpB,MAAM,gBAAgB,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QACvC,IAAI,CAAC,gBAAgB,CAAC,aAAa,IAAI,gBAAgB,CAAC,SAAS,EAAE,CAAC;YAClE,gBAAgB,CAAC,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,uBAAuB,CAChC,IAAI,CAAC,IAAI,EACT,gBAAgB,EAChB,UAA6B,EAC7B,QAAQ,IAAI,IAAI,CAAC,IAAI,EACrB,WAAW,IAAI,IAAI,CAAC,WAAW,CAChC,CAAC;IACJ,CAAC;IAED,gBAAgB,CACd,YAAyB;QAEzB,OAAO;YACL,WAAW,EAAE,CAAC,MAA2B,EAAE,EAAE;YAC3C,gKAAgK;YAChK,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE;YAChD,iBAAiB,EAAE,KAAK,EAAE,MAA2B,EAAE,EAAE;gBACvD,gKAAgK;gBAChK,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;gBAChE,MAAM,sBAAsB,GAAG,MAAM,uBAAuB,CAC1D,QAAQ,EACR,MAAM,CAAC,OAAO,EACd,IAAI,CAAC,IAAI,CACV,CAAC;gBACF,OAAO,sBAAsB,CAAC,eAAe,CAAC;YAChD,CAAC;YACD,kBAAkB,EAAE,KAAK,EAAE,MAA2B,EAAE,EAAE;gBACxD,gKAAgK;gBAChK,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;gBAChE,MAAM,sBAAsB,GAAG,MAAM,uBAAuB,CAC1D,QAAQ,EACR,MAAM,CAAC,OAAO,EACd,IAAI,CAAC,IAAI,CACV,CAAC;gBACF,OAAO,sBAAsB,CAAC,gBAAgB,CAAC;YACjD,CAAC;YACD,mBAAmB,EAAE,CACnB,WAAmB,EACnB,uBAA+B,EAC/B,cAAmC,EACnC,EAAE;gBACF,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;gBACvC,OAAO;oBACL,GAAG,cAAc;oBACjB,mBAAmB,EAAE,OAAO;oBAC5B,OAAO,EAAE,uBAAuB;oBAChC,gBAAgB,EAAE,IAAI;iBACvB,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P05
+ * @requirement:REQ-API-001
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Barrel export for package-local types.
+ */
+export type { ToolContext, ContextAwareTool } from './tool-context.js';
+export { ToolConfirmationOutcome, type ToolConfirmationPayload, } from './tool-confirmation-types.js';
+export { ToolErrorType, isFatalToolError } from './tool-error.js';
+export { GOOGLE_WEB_SEARCH_TOOL, EXA_WEB_SEARCH_TOOL, EDIT_TOOL_NAME, GREP_TOOL_NAME, READ_MANY_FILES_TOOL_NAME, READ_FILE_TOOL_NAME, LS_TOOL_NAME, MEMORY_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, READ_FILE_TOOL, WRITE_FILE_TOOL, EDIT_TOOL, INSERT_AT_LINE_TOOL, DELETE_LINE_RANGE_TOOL, READ_LINE_RANGE_TOOL, READ_MANY_FILES_TOOL, GREP_TOOL, RIPGREP_TOOL, GLOB_TOOL, LS_TOOL, LIST_DIRECTORY_TOOL, CODE_SEARCH_TOOL, GOOGLE_WEB_FETCH_TOOL, DIRECT_WEB_FETCH_TOOL, TASK_TOOL, MEMORY_TOOL, TODO_READ_TOOL, TODO_WRITE_TOOL, TODO_PAUSE_TOOL, LIST_SUBAGENTS_TOOL, SHELL_TOOL, AST_GREP_TOOL, STRUCTURAL_ANALYSIS_TOOL, APPLY_PATCH_TOOL, EDIT_TOOL_NAMES, type ToolName, } from './tool-names.js';
+export { TodoStatus, TodoToolCallSchema, SubtaskSchema, TodoSchema, TodoArraySchema, type TodoToolCall, type Subtask, type Todo, } from './todo-schemas.js';

package/dist/src/types/index.js

@@ -0,0 +1,9 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P05
+ * @requirement:REQ-API-001
+ */
+export { ToolConfirmationOutcome, } from './tool-confirmation-types.js';
+export { ToolErrorType, isFatalToolError } from './tool-error.js';
+export { GOOGLE_WEB_SEARCH_TOOL, EXA_WEB_SEARCH_TOOL, EDIT_TOOL_NAME, GREP_TOOL_NAME, READ_MANY_FILES_TOOL_NAME, READ_FILE_TOOL_NAME, LS_TOOL_NAME, MEMORY_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, READ_FILE_TOOL, WRITE_FILE_TOOL, EDIT_TOOL, INSERT_AT_LINE_TOOL, DELETE_LINE_RANGE_TOOL, READ_LINE_RANGE_TOOL, READ_MANY_FILES_TOOL, GREP_TOOL, RIPGREP_TOOL, GLOB_TOOL, LS_TOOL, LIST_DIRECTORY_TOOL, CODE_SEARCH_TOOL, GOOGLE_WEB_FETCH_TOOL, DIRECT_WEB_FETCH_TOOL, TASK_TOOL, MEMORY_TOOL, TODO_READ_TOOL, TODO_WRITE_TOOL, TODO_PAUSE_TOOL, LIST_SUBAGENTS_TOOL, SHELL_TOOL, AST_GREP_TOOL, STRUCTURAL_ANALYSIS_TOOL, APPLY_PATCH_TOOL, EDIT_TOOL_NAMES, } from './tool-names.js';
+export { TodoStatus, TodoToolCallSchema, SubtaskSchema, TodoSchema, TodoArraySchema, } from './todo-schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EACL,uBAAuB,GAExB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,OAAO,EACP,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,SAAS,EACT,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,GAEhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,eAAe,GAIhB,MAAM,mBAAmB,CAAC"}

package/dist/src/types/provider-content-types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P11
+ * @requirement:REQ-PKG-BOUNDARY
+ */
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tools-owned structural replacement types for provider content shapes.
+ *
+ * These replace imports from packages/core/src/runtime/contracts and
+ * packages/core/src/services/history that would create forbidden
+ * dependencies. Moved tool files MUST import from this module instead.
+ */
+/**
+ * Tools-owned structural replacement for RuntimeProviderChat.
+ * Replaces import from packages/core/src/runtime/contracts/RuntimeProviderChat.
+ * Shape matches the provider content fields that ToolFormatter and tool registry consume.
+ */
+export interface ProviderChatContent {
+    role: string;
+    content?: string;
+    toolCalls?: ProviderToolCallBlock[];
+    toolResults?: ProviderToolResultBlock[];
+    [key: string]: unknown;
+}
+/**
+ * Tools-owned structural replacement for tool call blocks in history content.
+ * Replaces import from packages/core/src/services/history IContent shapes.
+ */
+export interface ProviderToolCallBlock {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * Tools-owned structural replacement for tool result blocks in history content.
+ */
+export interface ProviderToolResultBlock {
+    toolCallId: string;
+    output: string;
+}
+/**
+ * Tools-owned structural type for RuntimeProviderTool.
+ * Replaces import from packages/core/src/runtime/contracts.
+ */
+export interface ProviderToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}

package/dist/src/types/provider-content-types.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P11
+ * @requirement:REQ-PKG-BOUNDARY
+ */
+export {};
+//# sourceMappingURL=provider-content-types.js.map

package/dist/src/types/provider-content-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-content-types.js","sourceRoot":"","sources":["../../../src/types/provider-content-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}