@amodalai/runtime 0.3.47 → 0.3.49

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

@@ -0,0 +1,146 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * HTTP-backed file tools — same tool names and schemas as the local file-tools,
+ * but reads/writes go through a remote runtime's workspace API via HttpFsBackend.
+ *
+ * Used when the admin agent runs on a different machine than the main agent
+ * (Cloud mode). Set WORKSPACE_API_URL to activate.
+ */
+import { z } from 'zod';
+export function registerHttpFileTools(registry, opts) {
+    const { fs, logger } = opts;
+    registry.register('read_repo_file', {
+        description: 'Read a file from the agent repository.',
+        parameters: z.object({
+            path: z.string().describe('Relative path to the file within the repo'),
+            offset: z.number().optional().describe('Line offset to start reading from'),
+            limit: z.number().optional().describe('Max number of lines to return'),
+        }),
+        readOnly: true,
+        metadata: { category: 'system' },
+        async execute(params) {
+            try {
+                logger.debug('file_tool_call', { tool: 'read_repo_file', path: params.path });
+                let content = await fs.readRepoFile(params.path);
+                if (params.offset !== undefined || params.limit !== undefined) {
+                    const lines = content.split('\n');
+                    const start = params.offset ?? 0;
+                    const end = params.limit !== undefined ? start + params.limit : lines.length;
+                    content = lines.slice(start, end).join('\n');
+                }
+                return content;
+            }
+            catch (err) {
+                return { error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    });
+    registry.register('write_repo_file', {
+        description: 'Write content to a file in the agent repository. Creates parent directories as needed.',
+        parameters: z.object({
+            path: z.string().describe('Relative path to the file within the repo'),
+            content: z.string().describe('The content to write to the file'),
+        }),
+        readOnly: false,
+        metadata: { category: 'system' },
+        async execute(params) {
+            try {
+                logger.debug('file_tool_call', { tool: 'write_repo_file', path: params.path });
+                await fs.writeRepoFile(params.path, params.content);
+                return { ok: true, path: params.path };
+            }
+            catch (err) {
+                return { error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    });
+    registry.register('edit_repo_file', {
+        description: 'Edit a file by replacing a specific string. Use for targeted changes.',
+        parameters: z.object({
+            path: z.string().describe('Relative path to the file'),
+            old_string: z.string().describe('The exact text to find'),
+            new_string: z.string().describe('The replacement text'),
+        }),
+        readOnly: false,
+        metadata: { category: 'system' },
+        async execute(params) {
+            try {
+                logger.debug('file_tool_call', { tool: 'edit_repo_file', path: params.path });
+                const content = await fs.readRepoFile(params.path);
+                if (!content.includes(params.old_string)) {
+                    return { error: `String not found in ${params.path}` };
+                }
+                const updated = content.replace(params.old_string, params.new_string);
+                await fs.writeRepoFile(params.path, updated);
+                return { ok: true, path: params.path };
+            }
+            catch (err) {
+                return { error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    });
+    registry.register('delete_repo_file', {
+        description: 'Delete a file from the agent repository.',
+        parameters: z.object({
+            path: z.string().describe('Relative path to the file'),
+        }),
+        readOnly: false,
+        metadata: { category: 'system' },
+        async execute(params) {
+            try {
+                logger.debug('file_tool_call', { tool: 'delete_repo_file', path: params.path });
+                await fs.deleteRepoFile(params.path);
+                return { ok: true, path: params.path };
+            }
+            catch (err) {
+                return { error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    });
+    registry.register('list_repo_files', {
+        description: 'List files and directories at a path in the agent repository.',
+        parameters: z.object({
+            dir: z.string().optional().describe('Directory to list (default: repo root)'),
+        }),
+        readOnly: true,
+        metadata: { category: 'system' },
+        async execute(params) {
+            try {
+                logger.debug('file_tool_call', { tool: 'list_repo_files', dir: params.dir });
+                const listing = await fs.listRepoFiles(params.dir ?? '.');
+                const entries = [
+                    ...listing.directories.map((d) => `${d}/`),
+                    ...listing.files,
+                ];
+                return entries.join('\n') || '(empty directory)';
+            }
+            catch (err) {
+                return { error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    });
+    registry.register('read_many_repo_files', {
+        description: 'Read multiple files at once. Missing files are silently skipped.',
+        parameters: z.object({
+            paths: z.array(z.string()).describe('Array of relative file paths'),
+        }),
+        readOnly: true,
+        metadata: { category: 'system' },
+        async execute(params) {
+            try {
+                logger.debug('file_tool_call', { tool: 'read_many_repo_files', count: params.paths.length });
+                const files = await fs.readManyRepoFiles(params.paths);
+                return files.map((f) => `--- ${f.path} ---\n${f.content}`).join('\n\n');
+            }
+            catch (err) {
+                return { error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    });
+    logger.debug('http_file_tools_registered', { tools: 6 });
+}
+//# sourceMappingURL=http-file-tools.js.map

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

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