@modelrelay/sdk 4.0.0 → 5.3.0

package/dist/node.cjs

@@ -52,7 +52,7 @@ var import_child_process = require("child_process");
 // package.json
 var package_default = {
   name: "@modelrelay/sdk",
-  version: "4.0.0",
+  version: "5.3.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",
@@ -293,7 +293,8 @@ var ToolRegistry = class {
 var ToolNames = {
   FS_READ_FILE: "fs.read_file",
   FS_LIST_FILES: "fs.list_files",
-  FS_SEARCH: "fs.search"
+  FS_SEARCH: "fs.search",
+  FS_EDIT: "fs.edit"
 };
 var FSDefaults = {
   MAX_READ_BYTES: 64e3,
@@ -411,6 +412,36 @@ var LocalFSToolPack = class {
             required: ["query"]
           }
         }
+      },
+      {
+        type: "function",
+        function: {
+          name: ToolNames.FS_EDIT,
+          description: "Replace exact string matches in a file. Returns a confirmation with affected line numbers.",
+          parameters: {
+            type: "object",
+            properties: {
+              path: {
+                type: "string",
+                description: "Workspace-relative path to the file (e.g., 'src/index.ts')"
+              },
+              old_string: {
+                type: "string",
+                description: "Exact string to find and replace"
+              },
+              new_string: {
+                type: "string",
+                description: "Replacement string (may be empty)"
+              },
+              replace_all: {
+                type: "boolean",
+                default: false,
+                description: "Replace all occurrences (default: replace first only)"
+              }
+            },
+            required: ["path", "old_string", "new_string"]
+          }
+        }
       }
     ];
   }
@@ -423,6 +454,7 @@ var LocalFSToolPack = class {
     registry.register(ToolNames.FS_READ_FILE, this.readFile.bind(this));
     registry.register(ToolNames.FS_LIST_FILES, this.listFiles.bind(this));
     registry.register(ToolNames.FS_SEARCH, this.search.bind(this));
+    registry.register(ToolNames.FS_EDIT, this.editFile.bind(this));
     return registry;
   }
   /**
@@ -542,6 +574,41 @@ var LocalFSToolPack = class {
     }
     return this.searchWithJS(query, absPath, maxMatches, call);
   }
+  async editFile(_args, call) {
+    const args = this.parseArgs(call, [
+      "path",
+      "old_string"
+    ]);
+    const func = call.function;
+    const relPath = this.requireString(args, "path", call);
+    const oldString = this.requireString(args, "old_string", call);
+    const newString = this.requireStringAllowEmpty(args, "new_string", call);
+    const replaceAll = this.optionalBoolean(args, "replace_all", call) ?? false;
+    const absPath = await this.resolveAndValidatePath(relPath, call);
+    const stat = await import_fs.promises.stat(absPath);
+    if (stat.isDirectory()) {
+      throw new Error(`fs.edit: path is a directory: ${relPath}`);
+    }
+    const data = await import_fs.promises.readFile(absPath);
+    if (!this.isValidUtf8(data)) {
+      throw new Error(`fs.edit: file is not valid UTF-8: ${relPath}`);
+    }
+    const contents = data.toString("utf-8");
+    const matches = this.findOccurrences(contents, oldString);
+    if (matches.length === 0) {
+      throw new Error("fs.edit: old_string not found");
+    }
+    if (!replaceAll && matches.length > 1) {
+      throw new Error("fs.edit: old_string appears multiple times");
+    }
+    const appliedMatches = replaceAll ? matches : matches.slice(0, 1);
+    const updated = replaceAll ? contents.split(oldString).join(newString) : contents.replace(oldString, newString);
+    await import_fs.promises.writeFile(absPath, updated);
+    const lineSpec = this.formatLineRanges(
+      this.buildLineRanges(contents, appliedMatches, oldString.length)
+    );
+    return `Edited ${relPath} (replacements=${appliedMatches.length}, lines ${lineSpec})`;
+  }
   // ========================================================================
   // Path Safety
   // ========================================================================
@@ -821,6 +888,16 @@ var LocalFSToolPack = class {
     }
     return value;
   }
+  requireStringAllowEmpty(args, key, call) {
+    const value = args[key];
+    if (value === void 0 || value === null) {
+      this.toolArgumentError(call, `${key} is required`);
+    }
+    if (typeof value !== "string") {
+      this.toolArgumentError(call, `${key} must be a string`);
+    }
+    return value;
+  }
   optionalString(args, key, call) {
     const value = args[key];
     if (value === void 0 || value === null) {
@@ -848,6 +925,82 @@ var LocalFSToolPack = class {
     }
     return value;
   }
+  optionalBoolean(args, key, call) {
+    const value = args[key];
+    if (value === void 0 || value === null) {
+      return void 0;
+    }
+    if (typeof value !== "boolean") {
+      this.toolArgumentError(call, `${key} must be a boolean`);
+    }
+    return value;
+  }
+  findOccurrences(haystack, needle) {
+    if (needle.length === 0) {
+      return [];
+    }
+    const out = [];
+    let idx = 0;
+    for (; ; ) {
+      const found = haystack.indexOf(needle, idx);
+      if (found === -1) {
+        break;
+      }
+      out.push(found);
+      idx = found + needle.length;
+    }
+    return out;
+  }
+  buildLineRanges(source, offsets, needleLength) {
+    if (offsets.length === 0) {
+      return [];
+    }
+    const newlineOffsets = [];
+    for (let i = 0; i < source.length; i++) {
+      if (source.charCodeAt(i) === 10) {
+        newlineOffsets.push(i);
+      }
+    }
+    return offsets.map((startIdx) => {
+      const endIdx = startIdx + Math.max(needleLength, 1) - 1;
+      return {
+        start: this.lineNumberAt(newlineOffsets, startIdx),
+        end: this.lineNumberAt(newlineOffsets, endIdx)
+      };
+    });
+  }
+  lineNumberAt(newlineOffsets, index) {
+    let lo = 0;
+    let hi = newlineOffsets.length;
+    while (lo < hi) {
+      const mid = lo + hi >> 1;
+      if (newlineOffsets[mid] < index) {
+        lo = mid + 1;
+      } else {
+        hi = mid;
+      }
+    }
+    return lo + 1;
+  }
+  formatLineRanges(ranges) {
+    if (ranges.length === 0) {
+      return "";
+    }
+    const merged = [];
+    for (const range of ranges) {
+      const last = merged[merged.length - 1];
+      if (!last || range.start > last.end + 1) {
+        merged.push({ ...range });
+        continue;
+      }
+      if (range.end > last.end) {
+        last.end = range.end;
+      }
+    }
+    return merged.map(
+      (range) => range.start === range.end ? `${range.start}` : `${range.start}-${range.end}`
+    ).join(",");
+  }
   isValidUtf8(buffer) {
     try {
       const text = buffer.toString("utf-8");

package/dist/node.d.cts

@@ -7,6 +7,7 @@ import { e as Tool, k as ToolRegistry } from './tools-bCt1QwNk.cjs';
  * - fs.read_file - Read workspace-relative files
  * - fs.list_files - List files recursively
  * - fs.search - Regex search (ripgrep or JS fallback)
+ * - fs.edit - Replace exact string matches in a file
  *
  * Safety features:
  * - Root sandbox with symlink resolution
@@ -23,6 +24,7 @@ declare const ToolNames: {
     readonly FS_READ_FILE: "fs.read_file";
     readonly FS_LIST_FILES: "fs.list_files";
     readonly FS_SEARCH: "fs.search";
+    readonly FS_EDIT: "fs.edit";
 };
 /** Default size limits and caps from wire contract. */
 declare const FSDefaults: {
@@ -103,6 +105,7 @@ declare class LocalFSToolPack {
     private readFile;
     private listFiles;
     private search;
+    private editFile;
     /**
      * Resolves a workspace-relative path and validates it stays within the sandbox.
      * @throws {ToolArgumentError} if path is invalid
@@ -116,8 +119,14 @@ declare class LocalFSToolPack {
     private parseArgs;
     private toolArgumentError;
     private requireString;
+    private requireStringAllowEmpty;
     private optionalString;
     private optionalPositiveInt;
+    private optionalBoolean;
+    private findOccurrences;
+    private buildLineRanges;
+    private lineNumberAt;
+    private formatLineRanges;
     private isValidUtf8;
     /**
      * Recursively walks a directory, calling visitor for each entry.

package/dist/node.d.ts

@@ -7,6 +7,7 @@ import { e as Tool, k as ToolRegistry } from './tools-bCt1QwNk.js';
  * - fs.read_file - Read workspace-relative files
  * - fs.list_files - List files recursively
  * - fs.search - Regex search (ripgrep or JS fallback)
+ * - fs.edit - Replace exact string matches in a file
  *
  * Safety features:
  * - Root sandbox with symlink resolution
@@ -23,6 +24,7 @@ declare const ToolNames: {
     readonly FS_READ_FILE: "fs.read_file";
     readonly FS_LIST_FILES: "fs.list_files";
     readonly FS_SEARCH: "fs.search";
+    readonly FS_EDIT: "fs.edit";
 };
 /** Default size limits and caps from wire contract. */
 declare const FSDefaults: {
@@ -103,6 +105,7 @@ declare class LocalFSToolPack {
     private readFile;
     private listFiles;
     private search;
+    private editFile;
     /**
      * Resolves a workspace-relative path and validates it stays within the sandbox.
      * @throws {ToolArgumentError} if path is invalid
@@ -116,8 +119,14 @@ declare class LocalFSToolPack {
     private parseArgs;
     private toolArgumentError;
     private requireString;
+    private requireStringAllowEmpty;
     private optionalString;
     private optionalPositiveInt;
+    private optionalBoolean;
+    private findOccurrences;
+    private buildLineRanges;
+    private lineNumberAt;
+    private formatLineRanges;
     private isValidUtf8;
     /**
      * Recursively walks a directory, calling visitor for each entry.

package/dist/node.js

@@ -3,7 +3,7 @@ import {
   ToolArgumentError,
   ToolRegistry,
   ToolTypes
-} from "./chunk-5O4NJXLJ.js";
+} from "./chunk-LZDGY24E.js";
 import "./chunk-MLKGABMK.js";
 
 // src/tools_local_fs.ts
@@ -13,7 +13,8 @@ import { spawn } from "child_process";
 var ToolNames = {
   FS_READ_FILE: "fs.read_file",
   FS_LIST_FILES: "fs.list_files",
-  FS_SEARCH: "fs.search"
+  FS_SEARCH: "fs.search",
+  FS_EDIT: "fs.edit"
 };
 var FSDefaults = {
   MAX_READ_BYTES: 64e3,
@@ -131,6 +132,36 @@ var LocalFSToolPack = class {
             required: ["query"]
           }
         }
+      },
+      {
+        type: "function",
+        function: {
+          name: ToolNames.FS_EDIT,
+          description: "Replace exact string matches in a file. Returns a confirmation with affected line numbers.",
+          parameters: {
+            type: "object",
+            properties: {
+              path: {
+                type: "string",
+                description: "Workspace-relative path to the file (e.g., 'src/index.ts')"
+              },
+              old_string: {
+                type: "string",
+                description: "Exact string to find and replace"
+              },
+              new_string: {
+                type: "string",
+                description: "Replacement string (may be empty)"
+              },
+              replace_all: {
+                type: "boolean",
+                default: false,
+                description: "Replace all occurrences (default: replace first only)"
+              }
+            },
+            required: ["path", "old_string", "new_string"]
+          }
+        }
       }
     ];
   }
@@ -143,6 +174,7 @@ var LocalFSToolPack = class {
     registry.register(ToolNames.FS_READ_FILE, this.readFile.bind(this));
     registry.register(ToolNames.FS_LIST_FILES, this.listFiles.bind(this));
     registry.register(ToolNames.FS_SEARCH, this.search.bind(this));
+    registry.register(ToolNames.FS_EDIT, this.editFile.bind(this));
     return registry;
   }
   /**
@@ -262,6 +294,41 @@ var LocalFSToolPack = class {
     }
     return this.searchWithJS(query, absPath, maxMatches, call);
   }
+  async editFile(_args, call) {
+    const args = this.parseArgs(call, [
+      "path",
+      "old_string"
+    ]);
+    const func = call.function;
+    const relPath = this.requireString(args, "path", call);
+    const oldString = this.requireString(args, "old_string", call);
+    const newString = this.requireStringAllowEmpty(args, "new_string", call);
+    const replaceAll = this.optionalBoolean(args, "replace_all", call) ?? false;
+    const absPath = await this.resolveAndValidatePath(relPath, call);
+    const stat = await fs.stat(absPath);
+    if (stat.isDirectory()) {
+      throw new Error(`fs.edit: path is a directory: ${relPath}`);
+    }
+    const data = await fs.readFile(absPath);
+    if (!this.isValidUtf8(data)) {
+      throw new Error(`fs.edit: file is not valid UTF-8: ${relPath}`);
+    }
+    const contents = data.toString("utf-8");
+    const matches = this.findOccurrences(contents, oldString);
+    if (matches.length === 0) {
+      throw new Error("fs.edit: old_string not found");
+    }
+    if (!replaceAll && matches.length > 1) {
+      throw new Error("fs.edit: old_string appears multiple times");
+    }
+    const appliedMatches = replaceAll ? matches : matches.slice(0, 1);
+    const updated = replaceAll ? contents.split(oldString).join(newString) : contents.replace(oldString, newString);
+    await fs.writeFile(absPath, updated);
+    const lineSpec = this.formatLineRanges(
+      this.buildLineRanges(contents, appliedMatches, oldString.length)
+    );
+    return `Edited ${relPath} (replacements=${appliedMatches.length}, lines ${lineSpec})`;
+  }
   // ========================================================================
   // Path Safety
   // ========================================================================
@@ -541,6 +608,16 @@ var LocalFSToolPack = class {
     }
     return value;
   }
+  requireStringAllowEmpty(args, key, call) {
+    const value = args[key];
+    if (value === void 0 || value === null) {
+      this.toolArgumentError(call, `${key} is required`);
+    }
+    if (typeof value !== "string") {
+      this.toolArgumentError(call, `${key} must be a string`);
+    }
+    return value;
+  }
   optionalString(args, key, call) {
     const value = args[key];
     if (value === void 0 || value === null) {
@@ -568,6 +645,82 @@ var LocalFSToolPack = class {
     }
     return value;
   }
+  optionalBoolean(args, key, call) {
+    const value = args[key];
+    if (value === void 0 || value === null) {
+      return void 0;
+    }
+    if (typeof value !== "boolean") {
+      this.toolArgumentError(call, `${key} must be a boolean`);
+    }
+    return value;
+  }
+  findOccurrences(haystack, needle) {
+    if (needle.length === 0) {
+      return [];
+    }
+    const out = [];
+    let idx = 0;
+    for (; ; ) {
+      const found = haystack.indexOf(needle, idx);
+      if (found === -1) {
+        break;
+      }
+      out.push(found);
+      idx = found + needle.length;
+    }
+    return out;
+  }
+  buildLineRanges(source, offsets, needleLength) {
+    if (offsets.length === 0) {
+      return [];
+    }
+    const newlineOffsets = [];
+    for (let i = 0; i < source.length; i++) {
+      if (source.charCodeAt(i) === 10) {
+        newlineOffsets.push(i);
+      }
+    }
+    return offsets.map((startIdx) => {
+      const endIdx = startIdx + Math.max(needleLength, 1) - 1;
+      return {
+        start: this.lineNumberAt(newlineOffsets, startIdx),
+        end: this.lineNumberAt(newlineOffsets, endIdx)
+      };
+    });
+  }
+  lineNumberAt(newlineOffsets, index) {
+    let lo = 0;
+    let hi = newlineOffsets.length;
+    while (lo < hi) {
+      const mid = lo + hi >> 1;
+      if (newlineOffsets[mid] < index) {
+        lo = mid + 1;
+      } else {
+        hi = mid;
+      }
+    }
+    return lo + 1;
+  }
+  formatLineRanges(ranges) {
+    if (ranges.length === 0) {
+      return "";
+    }
+    const merged = [];
+    for (const range of ranges) {
+      const last = merged[merged.length - 1];
+      if (!last || range.start > last.end + 1) {
+        merged.push({ ...range });
+        continue;
+      }
+      if (range.end > last.end) {
+        last.end = range.end;
+      }
+    }
+    return merged.map(
+      (range) => range.start === range.end ? `${range.start}` : `${range.start}-${range.end}`
+    ).join(",");
+  }
   isValidUtf8(buffer) {
     try {
       const text = buffer.toString("utf-8");

package/dist/{tools-DAqAFZ8F.d.ts → tools-Db-F5rIL.d.cts}

@@ -272,10 +272,8 @@ interface FrontendToken {
     customerId: string;
     /** The external customer ID provided by the application. */
     customerExternalId: string;
-    /** The tier code for the customer (e.g., "free", "pro", "enterprise").
-     * Optional for BYOB (external billing) projects where customers may not have subscriptions.
-     */
-    tierCode?: string;
+    /** The tier code for the customer (e.g., "free", "pro", "enterprise"). */
+    tierCode: string;
     /**
      * Publishable key used for issuance. Added client-side for caching.
      */
@@ -306,8 +304,7 @@ interface CustomerToken {
     projectId: string;
     customerId: string;
     customerExternalId: string;
-    /** Optional for BYOB (external billing) projects */
-    tierCode?: string;
+    tierCode: string;
 }
 interface OIDCExchangeRequest {
     idToken: string;
@@ -359,8 +356,8 @@ interface DeviceTokenResponse {
     customerId: string;
     /** The external customer ID */
     customerExternalId: string;
-    /** The tier code for the customer (optional for BYOB projects) */
-    tierCode?: string;
+    /** The tier code for the customer */
+    tierCode: string;
 }
 /**
  * Pending response from polling device token endpoint.
@@ -706,7 +703,7 @@ interface APIFrontendToken {
     project_id: string;
     customer_id: string;
     customer_external_id: string;
-    tier_code?: string;
+    tier_code: string;
 }
 interface APICustomerRef {
     id: string;

package/dist/{tools-DAqAFZ8F.d.cts → tools-Db-F5rIL.d.ts}

@@ -272,10 +272,8 @@ interface FrontendToken {
     customerId: string;
     /** The external customer ID provided by the application. */
     customerExternalId: string;
-    /** The tier code for the customer (e.g., "free", "pro", "enterprise").
-     * Optional for BYOB (external billing) projects where customers may not have subscriptions.
-     */
-    tierCode?: string;
+    /** The tier code for the customer (e.g., "free", "pro", "enterprise"). */
+    tierCode: string;
     /**
      * Publishable key used for issuance. Added client-side for caching.
      */
@@ -306,8 +304,7 @@ interface CustomerToken {
     projectId: string;
     customerId: string;
     customerExternalId: string;
-    /** Optional for BYOB (external billing) projects */
-    tierCode?: string;
+    tierCode: string;
 }
 interface OIDCExchangeRequest {
     idToken: string;
@@ -359,8 +356,8 @@ interface DeviceTokenResponse {
     customerId: string;
     /** The external customer ID */
     customerExternalId: string;
-    /** The tier code for the customer (optional for BYOB projects) */
-    tierCode?: string;
+    /** The tier code for the customer */
+    tierCode: string;
 }
 /**
  * Pending response from polling device token endpoint.
@@ -706,7 +703,7 @@ interface APIFrontendToken {
     project_id: string;
     customer_id: string;
     customer_external_id: string;
-    tier_code?: string;
+    tier_code: string;
 }
 interface APICustomerRef {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@modelrelay/sdk",
-	"version": "4.0.0",
+	"version": "5.3.0",
 	"description": "TypeScript SDK for the ModelRelay API",
 	"type": "module",
 	"main": "dist/index.cjs",