@acontext/acontext 0.0.21 → 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/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/package.json

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