@acontext/acontext 0.1.11 → 0.1.13

package/README.md

@@ -10,4 +10,4 @@ npm install @acontext/acontext
 
 # 🔍 Document
 
-To understand more about this SDK, please view [our docs](https://docs.acontext.io/) and [api references](https://docs.acontext.io/api-reference/introduction)
+To understand more about this SDK, please view [our docs](https://docs.acontext.app/) and [api references](https://docs.acontext.app/api-reference/introduction)

package/dist/agent/sandbox.js

@@ -117,7 +117,8 @@ class BashTool extends base_1.AbstractBaseTool {
     }
     async execute(ctx, llmArguments) {
         const command = llmArguments.command;
-        const timeout = llmArguments.timeout ?? this._timeout;
+        const timeoutSec = llmArguments.timeout ?? this._timeout;
+        const timeout = timeoutSec != null ? timeoutSec * 1000 : undefined;
         if (!command) {
             throw new Error('command is required');
         }
@@ -177,6 +178,7 @@ class TextEditorTool extends base_1.AbstractBaseTool {
     async execute(ctx, llmArguments) {
         const command = llmArguments.command;
         const path = llmArguments.path;
+        const timeoutMs = this._timeout != null ? this._timeout * 1000 : undefined;
         if (!command) {
             throw new Error('command is required');
         }
@@ -185,7 +187,7 @@ class TextEditorTool extends base_1.AbstractBaseTool {
         }
         if (command === 'view') {
             const viewRange = llmArguments.view_range;
-            const result = await (0, text_editor_1.viewFile)(ctx, path, viewRange, this._timeout);
+            const result = await (0, text_editor_1.viewFile)(ctx, path, viewRange, timeoutMs);
             return JSON.stringify(result);
         }
         else if (command === 'create') {
@@ -193,7 +195,7 @@ class TextEditorTool extends base_1.AbstractBaseTool {
             if (fileText === null || fileText === undefined) {
                 throw new Error('file_text is required for create command');
             }
-            const result = await (0, text_editor_1.createFile)(ctx, path, fileText, this._timeout);
+            const result = await (0, text_editor_1.createFile)(ctx, path, fileText, timeoutMs);
             return JSON.stringify(result);
         }
         else if (command === 'str_replace') {
@@ -205,7 +207,7 @@ class TextEditorTool extends base_1.AbstractBaseTool {
             if (newStr === null || newStr === undefined) {
                 throw new Error('new_str is required for str_replace command');
             }
-            const result = await (0, text_editor_1.strReplace)(ctx, path, oldStr, newStr, this._timeout);
+            const result = await (0, text_editor_1.strReplace)(ctx, path, oldStr, newStr, timeoutMs);
             return JSON.stringify(result);
         }
         else {

package/dist/errors.d.ts

@@ -30,3 +30,9 @@ export declare class APIError extends AcontextError {
 export declare class TransportError extends AcontextError {
     constructor(message: string);
 }
+/**
+ * Raised when a polling operation exceeds the configured timeout.
+ */
+export declare class TimeoutError extends AcontextError {
+    constructor(message?: string);
+}

package/dist/errors.js

@@ -3,7 +3,7 @@
  * Custom exceptions raised by the acontext TypeScript client.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransportError = exports.APIError = exports.AcontextError = void 0;
+exports.TimeoutError = exports.TransportError = exports.APIError = exports.AcontextError = void 0;
 /**
  * Base exception for all errors raised by `acontext`.
  */
@@ -43,3 +43,14 @@ class TransportError extends AcontextError {
     }
 }
 exports.TransportError = TransportError;
+/**
+ * Raised when a polling operation exceeds the configured timeout.
+ */
+class TimeoutError extends AcontextError {
+    constructor(message = 'operation timed out') {
+        super(message);
+        this.name = 'TimeoutError';
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+exports.TimeoutError = TimeoutError;

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { AcontextClient } from './client';
 export type { AcontextClientOptions } from './client';
 export { FileUpload } from './uploads';
 export { MessagePart, AcontextMessage, buildAcontextMessage } from './messages';
-export { APIError, TransportError, AcontextError } from './errors';
+export { APIError, TransportError, AcontextError, TimeoutError } from './errors';
 export * from './types';
 export * from './resources';
 export * from './agent';

package/dist/index.js

@@ -17,7 +17,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AcontextError = exports.TransportError = exports.APIError = exports.buildAcontextMessage = exports.AcontextMessage = exports.MessagePart = exports.FileUpload = exports.AcontextClient = void 0;
+exports.TimeoutError = exports.AcontextError = exports.TransportError = exports.APIError = exports.buildAcontextMessage = exports.AcontextMessage = exports.MessagePart = exports.FileUpload = exports.AcontextClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "AcontextClient", { enumerable: true, get: function () { return client_1.AcontextClient; } });
 var uploads_1 = require("./uploads");
@@ -30,6 +30,7 @@ var errors_1 = require("./errors");
 Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return errors_1.APIError; } });
 Object.defineProperty(exports, "TransportError", { enumerable: true, get: function () { return errors_1.TransportError; } });
 Object.defineProperty(exports, "AcontextError", { enumerable: true, get: function () { return errors_1.AcontextError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
 __exportStar(require("./types"), exports);
 __exportStar(require("./resources"), exports);
 __exportStar(require("./agent"), exports);

package/dist/resources/learning-spaces.d.ts

@@ -44,6 +44,22 @@ export declare class LearningSpacesAPI {
         spaceId: string;
         sessionId: string;
     }): Promise<LearningSpaceSession>;
+    /**
+     * Get a single learning session record by session ID.
+     */
+    getSession(options: {
+        spaceId: string;
+        sessionId: string;
+    }): Promise<LearningSpaceSession>;
+    /**
+     * Poll until a learning session reaches a terminal status.
+     */
+    waitForLearning(options: {
+        spaceId: string;
+        sessionId: string;
+        timeout?: number;
+        pollInterval?: number;
+    }): Promise<LearningSpaceSession>;
     /**
      * List all learning session records for a space.
      */

package/dist/resources/learning-spaces.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LearningSpacesAPI = void 0;
+const errors_1 = require("../errors");
 const utils_1 = require("../utils");
 const types_1 = require("../types");
 class LearningSpacesAPI {
@@ -74,6 +75,36 @@ class LearningSpacesAPI {
         const data = await this.requester.request('POST', `/learning_spaces/${options.spaceId}/learn`, { jsonData: { session_id: options.sessionId } });
         return types_1.LearningSpaceSessionSchema.parse(data);
     }
+    /**
+     * Get a single learning session record by session ID.
+     */
+    async getSession(options) {
+        const data = await this.requester.request('GET', `/learning_spaces/${options.spaceId}/sessions/${options.sessionId}`);
+        return types_1.LearningSpaceSessionSchema.parse(data);
+    }
+    /**
+     * Poll until a learning session reaches a terminal status.
+     */
+    async waitForLearning(options) {
+        const timeout = options.timeout ?? 120;
+        const pollInterval = options.pollInterval ?? 1;
+        const terminal = new Set(['completed', 'failed']);
+        const deadline = Date.now() + timeout * 1000;
+        while (true) {
+            const session = await this.getSession({
+                spaceId: options.spaceId,
+                sessionId: options.sessionId,
+            });
+            if (terminal.has(session.status)) {
+                return session;
+            }
+            if (Date.now() >= deadline) {
+                throw new errors_1.TimeoutError(`learning session ${options.sessionId} did not complete within ${timeout}s ` +
+                    `(last status: ${session.status})`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollInterval * 1000));
+        }
+    }
     /**
      * List all learning session records for a space.
      */

package/package.json

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