@acontext/acontext 0.0.20 → 0.1.0

package/dist/agent/skill.js

@@ -59,9 +59,7 @@ class ListSkillsTool extends base_1.AbstractBaseTool {
         this.arguments = {};
         this.requiredArguments = [];
     }
-    async execute(ctx, 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    _llmArguments) {
+    async execute(ctx, _llmArguments) {
         if (ctx.skills.size === 0) {
             return 'No skills available in the current context.';
         }

package/dist/client.d.ts

@@ -3,6 +3,7 @@
  */
 import { BlocksAPI } from './resources/blocks';
 import { DisksAPI } from './resources/disks';
+import { SandboxesAPI } from './resources/sandboxes';
 import { SessionsAPI } from './resources/sessions';
 import { SpacesAPI } from './resources/spaces';
 import { ToolsAPI } from './resources/tools';
@@ -28,6 +29,7 @@ export declare class AcontextClient implements RequesterProtocol {
     tools: ToolsAPI;
     skills: SkillsAPI;
     users: UsersAPI;
+    sandboxes: SandboxesAPI;
     constructor(options?: AcontextClientOptions);
     get baseUrl(): string;
     /**

package/dist/client.js

@@ -40,6 +40,7 @@ exports.AcontextClient = void 0;
 const errors_1 = require("./errors");
 const blocks_1 = require("./resources/blocks");
 const disks_1 = require("./resources/disks");
+const sandboxes_1 = require("./resources/sandboxes");
 const sessions_1 = require("./resources/sessions");
 const spaces_1 = require("./resources/spaces");
 const tools_1 = require("./resources/tools");
@@ -81,6 +82,7 @@ class AcontextClient {
         this.tools = new tools_1.ToolsAPI(this);
         this.skills = new skills_1.SkillsAPI(this);
         this.users = new users_1.UsersAPI(this);
+        this.sandboxes = new sandboxes_1.SandboxesAPI(this);
     }
     get baseUrl() {
         return this._baseUrl;

package/dist/resources/disks.d.ts

@@ -54,4 +54,16 @@ export declare class DiskArtifactsAPI {
         query: string;
         limit?: number;
     }): Promise<Artifacts>;
+    downloadToSandbox(diskId: string, options: {
+        filePath: string;
+        filename: string;
+        sandboxId: string;
+        sandboxPath: string;
+    }): Promise<boolean>;
+    uploadFromSandbox(diskId: string, options: {
+        sandboxId: string;
+        sandboxPath: string;
+        sandboxFilename: string;
+        filePath: string;
+    }): Promise<Artifact>;
 }

package/dist/resources/disks.js

@@ -122,5 +122,29 @@ class DiskArtifactsAPI {
         });
         return types_1.ArtifactsSchema.parse(data);
     }
+    async downloadToSandbox(diskId, options) {
+        const payload = {
+            file_path: options.filePath,
+            filename: options.filename,
+            sandbox_id: options.sandboxId,
+            sandbox_path: options.sandboxPath,
+        };
+        const data = await this.requester.request('POST', `/disk/${diskId}/artifact/download_to_sandbox`, {
+            jsonData: payload,
+        });
+        return Boolean(data?.success);
+    }
+    async uploadFromSandbox(diskId, options) {
+        const payload = {
+            sandbox_id: options.sandboxId,
+            sandbox_path: options.sandboxPath,
+            sandbox_filename: options.sandboxFilename,
+            file_path: options.filePath,
+        };
+        const data = await this.requester.request('POST', `/disk/${diskId}/artifact/upload_from_sandbox`, {
+            jsonData: payload,
+        });
+        return types_1.ArtifactSchema.parse(data);
+    }
 }
 exports.DiskArtifactsAPI = DiskArtifactsAPI;

package/dist/resources/index.d.ts

@@ -7,4 +7,5 @@ export * from './disks';
 export * from './blocks';
 export * from './tools';
 export * from './skills';
+export * from './sandboxes';
 export * from './users';

package/dist/resources/index.js

@@ -23,4 +23,5 @@ __exportStar(require("./disks"), exports);
 __exportStar(require("./blocks"), exports);
 __exportStar(require("./tools"), exports);
 __exportStar(require("./skills"), exports);
+__exportStar(require("./sandboxes"), exports);
 __exportStar(require("./users"), exports);

package/dist/resources/sandboxes.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Sandboxes endpoints.
+ */
+import { RequesterProtocol } from '../client-types';
+import { FlagResponse, SandboxCommandOutput, SandboxRuntimeInfo } from '../types';
+export declare class SandboxesAPI {
+    private requester;
+    constructor(requester: RequesterProtocol);
+    /**
+     * Create and start a new sandbox.
+     *
+     * @returns SandboxRuntimeInfo containing the sandbox ID, status, and timestamps
+     */
+    create(): Promise<SandboxRuntimeInfo>;
+    /**
+     * Execute a shell command in the sandbox.
+     *
+     * @param options - Command execution options
+     * @param options.sandboxId - The UUID of the sandbox
+     * @param options.command - The shell command to execute
+     * @returns SandboxCommandOutput containing stdout, stderr, and exit code
+     */
+    execCommand(options: {
+        sandboxId: string;
+        command: string;
+    }): Promise<SandboxCommandOutput>;
+    /**
+     * Kill a running sandbox.
+     *
+     * @param sandboxId - The UUID of the sandbox to kill
+     * @returns FlagResponse with status and error message
+     */
+    kill(sandboxId: string): Promise<FlagResponse>;
+}

package/dist/resources/sandboxes.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Sandboxes endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxesAPI = void 0;
+const types_1 = require("../types");
+class SandboxesAPI {
+    constructor(requester) {
+        this.requester = requester;
+    }
+    /**
+     * Create and start a new sandbox.
+     *
+     * @returns SandboxRuntimeInfo containing the sandbox ID, status, and timestamps
+     */
+    async create() {
+        const data = await this.requester.request('POST', '/sandbox');
+        return types_1.SandboxRuntimeInfoSchema.parse(data);
+    }
+    /**
+     * Execute a shell command in the sandbox.
+     *
+     * @param options - Command execution options
+     * @param options.sandboxId - The UUID of the sandbox
+     * @param options.command - The shell command to execute
+     * @returns SandboxCommandOutput containing stdout, stderr, and exit code
+     */
+    async execCommand(options) {
+        const data = await this.requester.request('POST', `/sandbox/${options.sandboxId}/exec`, {
+            jsonData: { command: options.command },
+        });
+        return types_1.SandboxCommandOutputSchema.parse(data);
+    }
+    /**
+     * Kill a running sandbox.
+     *
+     * @param sandboxId - The UUID of the sandbox to kill
+     * @returns FlagResponse with status and error message
+     */
+    async kill(sandboxId) {
+        const data = await this.requester.request('DELETE', `/sandbox/${sandboxId}`);
+        return types_1.FlagResponseSchema.parse(data);
+    }
+}
+exports.SandboxesAPI = SandboxesAPI;

package/dist/resources/sessions.d.ts

@@ -36,6 +36,17 @@ export declare class SessionsAPI {
         cursor?: string | null;
         timeDesc?: boolean | null;
     }): Promise<GetTasksOutput>;
+    /**
+     * Get a summary of all tasks in a session as a formatted string.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param options - Options for retrieving the summary.
+     * @param options.limit - Maximum number of tasks to include in the summary.
+     * @returns A formatted string containing the session summary with all task information.
+     */
+    getSessionSummary(sessionId: string, options?: {
+        limit?: number | null;
+    }): Promise<string>;
     storeMessage(sessionId: string, blob: MessageBlob, options?: {
         format?: 'acontext' | 'openai' | 'anthropic' | 'gemini';
         fileField?: string | null;
@@ -54,6 +65,7 @@ export declare class SessionsAPI {
      * @param options.editStrategies - Optional list of edit strategies to apply before format conversion.
      *   Examples:
      *   - Remove tool results: [{ type: 'remove_tool_result', params: { keep_recent_n_tool_results: 3 } }]
+     *   - Middle out: [{ type: 'middle_out', params: { token_reduce_to: 5000 } }]
      *   - Token limit: [{ type: 'token_limit', params: { limit_tokens: 20000 } }]
      * @param options.pinEditingStrategiesAtMessage - Message ID to pin editing strategies at.
      *   When provided, strategies are only applied to messages up to and including this message ID,

package/dist/resources/sessions.js

@@ -79,6 +79,47 @@ class SessionsAPI {
         });
         return types_1.GetTasksOutputSchema.parse(data);
     }
+    /**
+     * Get a summary of all tasks in a session as a formatted string.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param options - Options for retrieving the summary.
+     * @param options.limit - Maximum number of tasks to include in the summary.
+     * @returns A formatted string containing the session summary with all task information.
+     */
+    async getSessionSummary(sessionId, options) {
+        const tasksOutput = await this.getTasks(sessionId, {
+            limit: options?.limit,
+            timeDesc: false,
+        });
+        const tasks = tasksOutput.items;
+        if (tasks.length === 0) {
+            return '';
+        }
+        const parts = [];
+        for (const task of tasks) {
+            const taskLines = [
+                `<task id="${task.order}" description="${task.data.task_description}">`
+            ];
+            if (task.data.progresses && task.data.progresses.length > 0) {
+                taskLines.push('<progress>');
+                task.data.progresses.forEach((p, i) => {
+                    taskLines.push(`${i + 1}. ${p}`);
+                });
+                taskLines.push('</progress>');
+            }
+            if (task.data.user_preferences && task.data.user_preferences.length > 0) {
+                taskLines.push('<user_preference>');
+                task.data.user_preferences.forEach((pref, i) => {
+                    taskLines.push(`${i + 1}. ${pref}`);
+                });
+                taskLines.push('</user_preference>');
+            }
+            taskLines.push('</task>');
+            parts.push(taskLines.join('\n'));
+        }
+        return parts.join('\n');
+    }
     async storeMessage(sessionId, blob, options) {
         const format = options?.format ?? 'openai';
         if (!['acontext', 'openai', 'anthropic', 'gemini'].includes(format)) {
@@ -137,6 +178,7 @@ class SessionsAPI {
      * @param options.editStrategies - Optional list of edit strategies to apply before format conversion.
      *   Examples:
      *   - Remove tool results: [{ type: 'remove_tool_result', params: { keep_recent_n_tool_results: 3 } }]
+     *   - Middle out: [{ type: 'middle_out', params: { token_reduce_to: 5000 } }]
      *   - Token limit: [{ type: 'token_limit', params: { limit_tokens: 20000 } }]
      * @param options.pinEditingStrategiesAtMessage - Message ID to pin editing strategies at.
      *   When provided, strategies are only applied to messages up to and including this message ID,

package/dist/resources/skills.d.ts

@@ -23,7 +23,7 @@ export declare class SkillsAPI {
      * @returns ListSkillsOutput containing skills with name and description for the current page,
      *          along with pagination information (next_cursor and has_more)
      */
-    list_catalog(options?: {
+    listCatalog(options?: {
         user?: string | null;
         limit?: number | null;
         cursor?: string | null;

package/dist/resources/skills.js

@@ -40,7 +40,7 @@ class SkillsAPI {
      * @returns ListSkillsOutput containing skills with name and description for the current page,
      *          along with pagination information (next_cursor and has_more)
      */
-    async list_catalog(options) {
+    async listCatalog(options) {
         // Use 100 as default for catalog listing (only name and description, lightweight)
         const effectiveLimit = options?.limit ?? 100;
         const params = (0, utils_1.buildParams)({

package/dist/types/index.d.ts

@@ -8,4 +8,5 @@ export * from './disk';
 export * from './block';
 export * from './tool';
 export * from './skill';
+export * from './sandbox';
 export * from './user';

package/dist/types/index.js

@@ -24,4 +24,5 @@ __exportStar(require("./disk"), exports);
 __exportStar(require("./block"), exports);
 __exportStar(require("./tool"), exports);
 __exportStar(require("./skill"), exports);
+__exportStar(require("./sandbox"), exports);
 __exportStar(require("./user"), exports);

package/dist/types/sandbox.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Type definitions for sandbox resources.
+ */
+import { z } from 'zod';
+export declare const SandboxRuntimeInfoSchema: z.ZodObject<{
+    sandbox_id: z.ZodString;
+    sandbox_status: z.ZodString;
+    sandbox_created_at: z.ZodString;
+    sandbox_expires_at: z.ZodString;
+}, z.core.$strip>;
+export type SandboxRuntimeInfo = z.infer<typeof SandboxRuntimeInfoSchema>;
+export declare const SandboxCommandOutputSchema: z.ZodObject<{
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    exit_code: z.ZodNumber;
+}, z.core.$strip>;
+export type SandboxCommandOutput = z.infer<typeof SandboxCommandOutputSchema>;

package/dist/types/sandbox.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Type definitions for sandbox resources.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxCommandOutputSchema = exports.SandboxRuntimeInfoSchema = void 0;
+const zod_1 = require("zod");
+exports.SandboxRuntimeInfoSchema = zod_1.z.object({
+    sandbox_id: zod_1.z.string(),
+    sandbox_status: zod_1.z.string(),
+    sandbox_created_at: zod_1.z.string(),
+    sandbox_expires_at: zod_1.z.string(),
+});
+exports.SandboxCommandOutputSchema = zod_1.z.object({
+    stdout: zod_1.z.string(),
+    stderr: zod_1.z.string(),
+    exit_code: zod_1.z.number(),
+});

package/dist/types/session.d.ts

@@ -235,6 +235,25 @@ export declare const TokenLimitStrategySchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type TokenLimitStrategy = z.infer<typeof TokenLimitStrategySchema>;
+/**
+ * Parameters for the middle_out edit strategy.
+ */
+export declare const MiddleOutParamsSchema: z.ZodObject<{
+    token_reduce_to: z.ZodNumber;
+}, z.core.$strip>;
+export type MiddleOutParams = z.infer<typeof MiddleOutParamsSchema>;
+/**
+ * Edit strategy to reduce prompt size by removing middle messages.
+ *
+ * Example: { type: 'middle_out', params: { token_reduce_to: 5000 } }
+ */
+export declare const MiddleOutStrategySchema: z.ZodObject<{
+    type: z.ZodLiteral<"middle_out">;
+    params: z.ZodObject<{
+        token_reduce_to: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type MiddleOutStrategy = z.infer<typeof MiddleOutStrategySchema>;
 /**
  * Union schema for all edit strategies.
  * When adding new strategies, extend this union: z.union([RemoveToolResultStrategySchema, OtherStrategySchema, ...])
@@ -257,5 +276,10 @@ export declare const EditStrategySchema: z.ZodUnion<readonly [z.ZodObject<{
     params: z.ZodObject<{
         limit_tokens: z.ZodNumber;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"middle_out">;
+    params: z.ZodObject<{
+        token_reduce_to: z.ZodNumber;
+    }, z.core.$strip>;
 }, z.core.$strip>]>;
 export type EditStrategy = z.infer<typeof EditStrategySchema>;

package/dist/types/session.js

@@ -3,7 +3,7 @@
  * Type definitions for session, message, and task resources.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EditStrategySchema = exports.TokenLimitStrategySchema = exports.TokenLimitParamsSchema = exports.RemoveToolResultStrategySchema = exports.RemoveToolCallParamsStrategySchema = exports.RemoveToolCallParamsParamsSchema = exports.RemoveToolResultParamsSchema = exports.MessageObservingStatusSchema = exports.TokenCountsSchema = exports.LearningStatusSchema = exports.GetTasksOutputSchema = exports.GetMessagesOutputSchema = exports.PublicURLSchema = exports.ListSessionsOutputSchema = exports.TaskSchema = exports.TaskDataSchema = exports.SessionSchema = exports.MessageSchema = exports.PartSchema = exports.AssetSchema = void 0;
+exports.EditStrategySchema = exports.MiddleOutStrategySchema = exports.MiddleOutParamsSchema = exports.TokenLimitStrategySchema = exports.TokenLimitParamsSchema = exports.RemoveToolResultStrategySchema = exports.RemoveToolCallParamsStrategySchema = exports.RemoveToolCallParamsParamsSchema = exports.RemoveToolResultParamsSchema = exports.MessageObservingStatusSchema = exports.TokenCountsSchema = exports.LearningStatusSchema = exports.GetTasksOutputSchema = exports.GetMessagesOutputSchema = exports.PublicURLSchema = exports.ListSessionsOutputSchema = exports.TaskSchema = exports.TaskDataSchema = exports.SessionSchema = exports.MessageSchema = exports.PartSchema = exports.AssetSchema = void 0;
 const zod_1 = require("zod");
 exports.AssetSchema = zod_1.z.object({
     bucket: zod_1.z.string(),
@@ -190,6 +190,21 @@ exports.TokenLimitStrategySchema = zod_1.z.object({
     type: zod_1.z.literal('token_limit'),
     params: exports.TokenLimitParamsSchema,
 });
+/**
+ * Parameters for the middle_out edit strategy.
+ */
+exports.MiddleOutParamsSchema = zod_1.z.object({
+    token_reduce_to: zod_1.z.number(),
+});
+/**
+ * Edit strategy to reduce prompt size by removing middle messages.
+ *
+ * Example: { type: 'middle_out', params: { token_reduce_to: 5000 } }
+ */
+exports.MiddleOutStrategySchema = zod_1.z.object({
+    type: zod_1.z.literal('middle_out'),
+    params: exports.MiddleOutParamsSchema,
+});
 /**
  * Union schema for all edit strategies.
  * When adding new strategies, extend this union: z.union([RemoveToolResultStrategySchema, OtherStrategySchema, ...])
@@ -198,4 +213,5 @@ exports.EditStrategySchema = zod_1.z.union([
     exports.RemoveToolResultStrategySchema,
     exports.RemoveToolCallParamsStrategySchema,
     exports.TokenLimitStrategySchema,
+    exports.MiddleOutStrategySchema,
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acontext/acontext",
-  "version": "0.0.20",
+  "version": "0.1.0",
   "description": "TypeScript SDK for the Acontext API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,6 +9,7 @@
     "dev": "tsc --watch",
     "test": "jest",
     "lint": "eslint src",
+    "e2e": "tsx examples/basic-usage.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -35,6 +36,7 @@
     "eslint": "^9.39.1",
     "jest": "^30.2.0",
     "ts-jest": "^29.4.5",
+    "tsx": "^4.19.0",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {