@acontext/acontext 0.1.2 → 0.1.4

package/dist/agent/sandbox.d.ts

@@ -64,6 +64,9 @@ export declare class TextEditorTool extends AbstractBaseTool {
         };
         view_range: {
             type: string[];
+            items: {
+                type: string;
+            };
             description: string;
         };
     };

package/dist/agent/sandbox.js

@@ -167,6 +167,7 @@ class TextEditorTool extends base_1.AbstractBaseTool {
             },
             view_range: {
                 type: ['array', 'null'],
+                items: { type: 'integer' },
                 description: "Optional for 'view' command. An array [start_line, end_line] to view specific lines. If not provided, shows the first 200 lines.",
             },
         };

package/dist/agent/text-editor.d.ts

@@ -22,23 +22,22 @@ export interface CreateFileResult {
     stderr?: string;
 }
 export interface StrReplaceResult {
-    oldStart?: number;
-    oldLines?: number;
-    newStart?: number;
-    newLines?: number;
-    lines?: string[];
+    msg?: string;
     error?: string;
     stderr?: string;
 }
 /**
  * View file content with line numbers.
  */
-export declare function viewFile(ctx: SandboxContext, path: string, viewRange: number[] | null, timeout?: number): Promise<ViewFileResult>;
+export declare function viewFile(ctx: SandboxContext, filePath: string, viewRange: number[] | null, timeout?: number): Promise<ViewFileResult>;
 /**
  * Create a new file with content.
  */
-export declare function createFile(ctx: SandboxContext, path: string, fileText: string, timeout?: number): Promise<CreateFileResult>;
+export declare function createFile(ctx: SandboxContext, filePath: string, fileText: string, timeout?: number): Promise<CreateFileResult>;
 /**
  * Replace a string in a file.
+ *
+ * Uses a Python script on the sandbox to avoid transferring the entire file.
+ * Only the base64-encoded oldStr and newStr are sent.
  */
-export declare function strReplace(ctx: SandboxContext, path: string, oldStr: string, newStr: string, timeout?: number): Promise<StrReplaceResult>;
+export declare function strReplace(ctx: SandboxContext, filePath: string, oldStr: string, newStr: string, timeout?: number): Promise<StrReplaceResult>;

package/dist/agent/text-editor.js

@@ -2,11 +2,15 @@
 /**
  * Text editor file operations for sandbox environments.
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.escapeForShell = escapeForShell;
 exports.viewFile = viewFile;
 exports.createFile = createFile;
 exports.strReplace = strReplace;
+const path_1 = __importDefault(require("path"));
 const MAX_CONTENT_CHARS = 20000;
 /**
  * Truncate text to maxChars, appending a truncation flag if needed.
@@ -27,56 +31,48 @@ function escapeForShell(s) {
 /**
  * View file content with line numbers.
  */
-async function viewFile(ctx, path, viewRange, timeout) {
-    // First check if file exists and get total lines
-    const checkCmd = `wc -l < ${escapeForShell(path)} 2>/dev/null || echo 'FILE_NOT_FOUND'`;
-    const checkResult = await ctx.client.sandboxes.execCommand({
-        sandboxId: ctx.sandboxId,
-        command: checkCmd,
-        timeout,
-    });
-    if (checkResult.stdout.includes('FILE_NOT_FOUND') || checkResult.exit_code !== 0) {
-        return {
-            error: `File not found: ${path}`,
-            stderr: checkResult.stderr,
-        };
-    }
-    const totalLines = /^\d+$/.test(checkResult.stdout.trim())
-        ? parseInt(checkResult.stdout.trim(), 10)
-        : 0;
-    // Build the view command with line numbers
-    let cmd;
+async function viewFile(ctx, filePath, viewRange, timeout) {
+    const escapedPath = escapeForShell(filePath);
+    // Build combined command: check existence, get total lines, and view content in one exec
+    let viewCmd;
     let startLine;
     if (viewRange && viewRange.length === 2) {
         const [rangeStart, rangeEnd] = viewRange;
-        cmd = `sed -n '${rangeStart},${rangeEnd}p' ${escapeForShell(path)} | nl -ba -v ${rangeStart}`;
+        viewCmd = `sed -n '${rangeStart},${rangeEnd}p' ${escapedPath} | nl -ba -v ${rangeStart}`;
         startLine = rangeStart;
     }
     else {
-        // Default to first 200 lines if no range specified
         const maxLines = 200;
-        cmd = `head -n ${maxLines} ${escapeForShell(path)} | nl -ba`;
+        viewCmd = `head -n ${maxLines} ${escapedPath} | nl -ba`;
         startLine = 1;
     }
+    // Single combined command: outputs "TOTAL:<n>" on first line, then file content
+    const cmd = `if [ ! -f ${escapedPath} ]; then echo 'FILE_NOT_FOUND'; exit 1; fi; echo "TOTAL:$(wc -l < ${escapedPath})"; ${viewCmd}`;
     const result = await ctx.client.sandboxes.execCommand({
         sandboxId: ctx.sandboxId,
         command: cmd,
         timeout,
     });
-    if (result.exit_code !== 0) {
+    if (result.exit_code !== 0 || result.stdout.includes('FILE_NOT_FOUND')) {
         return {
-            error: `Failed to view file: ${path}`,
+            error: `File not found: ${filePath}`,
             stderr: result.stderr,
         };
     }
-    // Count lines in output
-    const contentLines = result.stdout.trim()
-        ? result.stdout.trimEnd().split('\n')
-        : [];
+    // Parse output: first line is "TOTAL:<n>", rest is content
+    const lines = result.stdout.split('\n');
+    let totalLines = 0;
+    let content = '';
+    if (lines.length > 0 && lines[0].startsWith('TOTAL:')) {
+        const totalStr = lines[0].substring(6).trim();
+        totalLines = /^\d+$/.test(totalStr) ? parseInt(totalStr, 10) : 0;
+        content = lines.slice(1).join('\n');
+    }
+    const contentLines = content.trim() ? content.trimEnd().split('\n') : [];
     const numLines = contentLines.length;
     return {
         file_type: 'text',
-        content: truncateContent(result.stdout),
+        content: truncateContent(content),
         numLines,
         startLine: viewRange ? startLine : 1,
         totalLines: totalLines + 1, // wc -l doesn't count last line without newline
@@ -85,129 +81,83 @@ async function viewFile(ctx, path, viewRange, timeout) {
 /**
  * Create a new file with content.
  */
-async function createFile(ctx, path, fileText, timeout) {
-    // Check if file already exists
-    const checkCmd = `test -f ${escapeForShell(path)} && echo 'EXISTS' || echo 'NEW'`;
-    const checkResult = await ctx.client.sandboxes.execCommand({
-        sandboxId: ctx.sandboxId,
-        command: checkCmd,
-        timeout,
-    });
-    const isUpdate = checkResult.stdout.includes('EXISTS');
-    // Create directory if needed
-    const parts = path.split('/');
-    parts.pop();
-    const dirPath = parts.join('/');
-    if (dirPath) {
-        const mkdirCmd = `mkdir -p ${escapeForShell(dirPath)}`;
-        await ctx.client.sandboxes.execCommand({
-            sandboxId: ctx.sandboxId,
-            command: mkdirCmd,
-            timeout,
-        });
-    }
-    // Write file using base64 encoding to safely transfer content
+async function createFile(ctx, filePath, fileText, timeout) {
+    const escapedPath = escapeForShell(filePath);
     const encodedContent = Buffer.from(fileText, 'utf-8').toString('base64');
-    const writeCmd = `echo ${escapeForShell(encodedContent)} | base64 -d > ${escapeForShell(path)}`;
+    // Get directory path for mkdir
+    const dirPath = path_1.default.posix.dirname(filePath);
+    const mkdirPart = dirPath && dirPath !== '.' ? `mkdir -p ${escapeForShell(dirPath)} && ` : '';
+    // Single combined command: check existence, create dir, write file
+    const cmd = `is_update=$(test -f ${escapedPath} && echo 1 || echo 0); ${mkdirPart}echo ${escapeForShell(encodedContent)} | base64 -d > ${escapedPath} && echo "STATUS:$is_update"`;
     const result = await ctx.client.sandboxes.execCommand({
         sandboxId: ctx.sandboxId,
-        command: writeCmd,
+        command: cmd,
         timeout,
     });
-    if (result.exit_code !== 0) {
+    if (result.exit_code !== 0 || !result.stdout.includes('STATUS:')) {
         return {
-            error: `Failed to create file: ${path}`,
+            error: `Failed to create file: ${filePath}`,
             stderr: result.stderr,
         };
     }
+    const isUpdate = result.stdout.includes('STATUS:1');
     return {
         is_file_update: isUpdate,
-        message: `File ${isUpdate ? 'updated' : 'created'}: ${path}`,
+        message: `File ${isUpdate ? 'updated' : 'created'}: ${filePath}`,
     };
 }
 /**
  * Replace a string in a file.
+ *
+ * Uses a Python script on the sandbox to avoid transferring the entire file.
+ * Only the base64-encoded oldStr and newStr are sent.
  */
-async function strReplace(ctx, path, oldStr, newStr, timeout) {
-    // First read the file content
-    const readCmd = `cat ${escapeForShell(path)}`;
+async function strReplace(ctx, filePath, oldStr, newStr, timeout) {
+    const oldB64 = Buffer.from(oldStr, 'utf-8').toString('base64');
+    const newB64 = Buffer.from(newStr, 'utf-8').toString('base64');
+    // Write Python script and base64 encode it to avoid shell escaping issues
+    const pyScript = `import sys, base64, os
+old = base64.b64decode("${oldB64}").decode()
+new = base64.b64decode("${newB64}").decode()
+path = "${filePath}"
+if not os.path.exists(path):
+    print("FILE_NOT_FOUND")
+    sys.exit(1)
+with open(path, "r") as f:
+    content = f.read()
+count = content.count(old)
+if count == 0:
+    print("NOT_FOUND")
+    sys.exit(0)
+if count > 1:
+    print(f"MULTIPLE:{count}")
+    sys.exit(0)
+with open(path, "w") as f:
+    f.write(content.replace(old, new, 1))
+print("SUCCESS")
+`;
+    const scriptB64 = Buffer.from(pyScript, 'utf-8').toString('base64');
+    const cmd = `echo ${escapeForShell(scriptB64)} | base64 -d | python3`;
     const result = await ctx.client.sandboxes.execCommand({
         sandboxId: ctx.sandboxId,
-        command: readCmd,
+        command: cmd,
         timeout,
     });
-    if (result.exit_code !== 0) {
-        return {
-            error: `File not found: ${path}`,
-            stderr: result.stderr,
-        };
-    }
-    const originalContent = result.stdout;
-    // Check if oldStr exists in the file
-    if (!originalContent.includes(oldStr)) {
-        return {
-            error: `String not found in file: ${oldStr.substring(0, 50)}...`,
-        };
-    }
-    // Count occurrences
-    let occurrences = 0;
-    let searchIndex = 0;
-    while (searchIndex < originalContent.length) {
-        const foundIndex = originalContent.indexOf(oldStr, searchIndex);
-        if (foundIndex === -1)
-            break;
-        occurrences++;
-        searchIndex = foundIndex + oldStr.length;
-    }
-    if (occurrences > 1) {
-        return {
-            error: `Multiple occurrences (${occurrences}) of the string found. Please provide more context to make the match unique.`,
-        };
+    const output = result.stdout.trim();
+    if (result.exit_code !== 0 || output === 'FILE_NOT_FOUND') {
+        return { error: `File not found: ${filePath}`, stderr: result.stderr };
     }
-    // Perform the replacement
-    const newContent = originalContent.replace(oldStr, newStr);
-    // Find the line numbers affected
-    const oldLines = originalContent.split('\n');
-    const newLines = newContent.split('\n');
-    // Find where the change starts
-    let oldStart = 1;
-    const minLen = Math.min(oldLines.length, newLines.length);
-    for (let i = 0; i < minLen; i++) {
-        if (oldLines[i] !== newLines[i]) {
-            oldStart = i + 1;
-            break;
-        }
+    if (output === 'NOT_FOUND') {
+        return { error: `String not found in file: ${oldStr.substring(0, 50)}...` };
     }
-    // Write the new content
-    const encodedContent = Buffer.from(newContent, 'utf-8').toString('base64');
-    const writeCmd = `echo ${escapeForShell(encodedContent)} | base64 -d > ${escapeForShell(path)}`;
-    const writeResult = await ctx.client.sandboxes.execCommand({
-        sandboxId: ctx.sandboxId,
-        command: writeCmd,
-        timeout,
-    });
-    if (writeResult.exit_code !== 0) {
+    if (output.startsWith('MULTIPLE:')) {
+        const count = output.split(':')[1];
         return {
-            error: `Failed to write file: ${path}`,
-            stderr: writeResult.stderr,
+            error: `Multiple occurrences (${count}) of the string found. Please provide more context to make the match unique.`,
         };
     }
-    // Calculate diff info
-    const oldStrLines = oldStr.split('\n').length;
-    const newStrLines = newStr.split('\n').length;
-    // Build diff lines
-    const diffLines = [];
-    for (const line of oldStr.split('\n')) {
-        diffLines.push(`-${line}`);
+    if (output === 'SUCCESS') {
+        return { msg: 'Successfully replaced text at exactly one location.' };
     }
-    for (const line of newStr.split('\n')) {
-        diffLines.push(`+${line}`);
-    }
-    return {
-        oldStart,
-        oldLines: oldStrLines,
-        newStart: oldStart,
-        newLines: newStrLines,
-        lines: diffLines,
-    };
+    return { error: `Unexpected response: ${output}`, stderr: result.stderr };
 }

package/dist/resources/sessions.d.ts

@@ -9,11 +9,26 @@ export type MessageBlob = AcontextMessage | Record<string, unknown>;
 export declare class SessionsAPI {
     private requester;
     constructor(requester: RequesterProtocol);
+    /**
+     * List all sessions in the project.
+     *
+     * @param options - Options for listing sessions.
+     * @param options.user - Filter by user identifier.
+     * @param options.limit - Maximum number of sessions to return.
+     * @param options.cursor - Cursor for pagination.
+     * @param options.timeDesc - Order by created_at descending if true, ascending if false.
+     * @param options.filterByConfigs - Filter by session configs using JSONB containment.
+     *   Only sessions where configs contains all key-value pairs in this object will be returned.
+     *   Supports nested objects. Note: Matching is case-sensitive and type-sensitive.
+     *   Sessions with NULL configs are excluded from filtered results.
+     * @returns ListSessionsOutput containing the list of sessions and pagination information.
+     */
     list(options?: {
         user?: string | null;
         limit?: number | null;
         cursor?: string | null;
         timeDesc?: boolean | null;
+        filterByConfigs?: Record<string, unknown> | null;
     }): Promise<ListSessionsOutput>;
     create(options?: {
         user?: string | null;

package/dist/resources/sessions.js

@@ -11,11 +11,29 @@ class SessionsAPI {
     constructor(requester) {
         this.requester = requester;
     }
+    /**
+     * List all sessions in the project.
+     *
+     * @param options - Options for listing sessions.
+     * @param options.user - Filter by user identifier.
+     * @param options.limit - Maximum number of sessions to return.
+     * @param options.cursor - Cursor for pagination.
+     * @param options.timeDesc - Order by created_at descending if true, ascending if false.
+     * @param options.filterByConfigs - Filter by session configs using JSONB containment.
+     *   Only sessions where configs contains all key-value pairs in this object will be returned.
+     *   Supports nested objects. Note: Matching is case-sensitive and type-sensitive.
+     *   Sessions with NULL configs are excluded from filtered results.
+     * @returns ListSessionsOutput containing the list of sessions and pagination information.
+     */
     async list(options) {
         const params = {};
         if (options?.user) {
             params.user = options.user;
         }
+        // Handle filterByConfigs - JSON encode, skip empty object
+        if (options?.filterByConfigs && Object.keys(options.filterByConfigs).length > 0) {
+            params.filter_by_configs = JSON.stringify(options.filterByConfigs);
+        }
         Object.assign(params, (0, utils_1.buildParams)({
             limit: options?.limit ?? null,
             cursor: options?.cursor ?? null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acontext/acontext",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "TypeScript SDK for the Acontext API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",