@acontext/acontext 0.1.10 → 0.1.12

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/client.d.ts

@@ -2,6 +2,7 @@
  * High-level synchronous client for the Acontext API.
  */
 import { DisksAPI } from './resources/disks';
+import { LearningSpacesAPI } from './resources/learning-spaces';
 import { SandboxesAPI } from './resources/sandboxes';
 import { SessionsAPI } from './resources/sessions';
 import { SkillsAPI } from './resources/skills';
@@ -24,6 +25,7 @@ export declare class AcontextClient implements RequesterProtocol {
     skills: SkillsAPI;
     users: UsersAPI;
     sandboxes: SandboxesAPI;
+    learningSpaces: LearningSpacesAPI;
     constructor(options?: AcontextClientOptions);
     get baseUrl(): string;
     /**

package/dist/client.js

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AcontextClient = void 0;
 const errors_1 = require("./errors");
 const disks_1 = require("./resources/disks");
+const learning_spaces_1 = require("./resources/learning-spaces");
 const sandboxes_1 = require("./resources/sandboxes");
 const sessions_1 = require("./resources/sessions");
 const skills_1 = require("./resources/skills");
@@ -77,6 +78,7 @@ class AcontextClient {
         this.skills = new skills_1.SkillsAPI(this);
         this.users = new users_1.UsersAPI(this);
         this.sandboxes = new sandboxes_1.SandboxesAPI(this);
+        this.learningSpaces = new learning_spaces_1.LearningSpacesAPI(this);
     }
     get baseUrl() {
         return this._baseUrl;

package/dist/resources/index.d.ts

@@ -6,3 +6,4 @@ export * from './disks';
 export * from './skills';
 export * from './sandboxes';
 export * from './users';
+export * from './learning-spaces';

package/dist/resources/index.js

@@ -22,3 +22,4 @@ __exportStar(require("./disks"), exports);
 __exportStar(require("./skills"), exports);
 __exportStar(require("./sandboxes"), exports);
 __exportStar(require("./users"), exports);
+__exportStar(require("./learning-spaces"), exports);

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

@@ -0,0 +1,69 @@
+/**
+ * Learning Spaces endpoints.
+ */
+import { RequesterProtocol } from '../client-types';
+import { LearningSpace, LearningSpaceSession, LearningSpaceSkill, ListLearningSpacesOutput, Skill } from '../types';
+export declare class LearningSpacesAPI {
+    private requester;
+    constructor(requester: RequesterProtocol);
+    /**
+     * Create a new learning space.
+     */
+    create(options?: {
+        user?: string | null;
+        meta?: Record<string, unknown> | null;
+    }): Promise<LearningSpace>;
+    /**
+     * List learning spaces with optional filters and pagination.
+     */
+    list(options?: {
+        user?: string | null;
+        limit?: number | null;
+        cursor?: string | null;
+        timeDesc?: boolean | null;
+        filterByMeta?: Record<string, unknown> | null;
+    }): Promise<ListLearningSpacesOutput>;
+    /**
+     * Get a learning space by ID.
+     */
+    get(spaceId: string): Promise<LearningSpace>;
+    /**
+     * Update a learning space by merging meta into existing meta.
+     */
+    update(spaceId: string, options: {
+        meta: Record<string, unknown>;
+    }): Promise<LearningSpace>;
+    /**
+     * Delete a learning space by ID.
+     */
+    delete(spaceId: string): Promise<void>;
+    /**
+     * Create an async learning record from a session.
+     */
+    learn(options: {
+        spaceId: string;
+        sessionId: string;
+    }): Promise<LearningSpaceSession>;
+    /**
+     * List all learning session records for a space.
+     */
+    listSessions(spaceId: string): Promise<LearningSpaceSession[]>;
+    /**
+     * Include a skill in a learning space.
+     */
+    includeSkill(options: {
+        spaceId: string;
+        skillId: string;
+    }): Promise<LearningSpaceSkill>;
+    /**
+     * List all skills in a learning space. Returns full skill data.
+     */
+    listSkills(spaceId: string): Promise<Skill[]>;
+    /**
+     * Remove a skill from a learning space. Idempotent.
+     */
+    excludeSkill(options: {
+        spaceId: string;
+        skillId: string;
+    }): Promise<void>;
+}

package/dist/resources/learning-spaces.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Learning Spaces endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LearningSpacesAPI = void 0;
+const utils_1 = require("../utils");
+const types_1 = require("../types");
+class LearningSpacesAPI {
+    constructor(requester) {
+        this.requester = requester;
+    }
+    /**
+     * Create a new learning space.
+     */
+    async create(options) {
+        const payload = {};
+        if (options?.user !== undefined && options.user !== null) {
+            payload.user = options.user;
+        }
+        if (options?.meta !== undefined && options.meta !== null) {
+            payload.meta = options.meta;
+        }
+        const data = await this.requester.request('POST', '/learning_spaces', {
+            jsonData: payload,
+        });
+        return types_1.LearningSpaceSchema.parse(data);
+    }
+    /**
+     * List learning spaces with optional filters and pagination.
+     */
+    async list(options) {
+        const effectiveLimit = options?.limit ?? 20;
+        const params = (0, utils_1.buildParams)({
+            user: options?.user ?? null,
+            limit: effectiveLimit,
+            cursor: options?.cursor ?? null,
+            time_desc: options?.timeDesc ?? null,
+        });
+        if (options?.filterByMeta && Object.keys(options.filterByMeta).length > 0) {
+            params.filter_by_meta = JSON.stringify(options.filterByMeta);
+        }
+        const data = await this.requester.request('GET', '/learning_spaces', {
+            params: Object.keys(params).length > 0 ? params : undefined,
+        });
+        return types_1.ListLearningSpacesOutputSchema.parse(data);
+    }
+    /**
+     * Get a learning space by ID.
+     */
+    async get(spaceId) {
+        const data = await this.requester.request('GET', `/learning_spaces/${spaceId}`);
+        return types_1.LearningSpaceSchema.parse(data);
+    }
+    /**
+     * Update a learning space by merging meta into existing meta.
+     */
+    async update(spaceId, options) {
+        const data = await this.requester.request('PATCH', `/learning_spaces/${spaceId}`, {
+            jsonData: { meta: options.meta },
+        });
+        return types_1.LearningSpaceSchema.parse(data);
+    }
+    /**
+     * Delete a learning space by ID.
+     */
+    async delete(spaceId) {
+        await this.requester.request('DELETE', `/learning_spaces/${spaceId}`);
+    }
+    /**
+     * Create an async learning record from a session.
+     */
+    async learn(options) {
+        const data = await this.requester.request('POST', `/learning_spaces/${options.spaceId}/learn`, { jsonData: { session_id: options.sessionId } });
+        return types_1.LearningSpaceSessionSchema.parse(data);
+    }
+    /**
+     * List all learning session records for a space.
+     */
+    async listSessions(spaceId) {
+        const data = await this.requester.request('GET', `/learning_spaces/${spaceId}/sessions`);
+        return data.map((item) => types_1.LearningSpaceSessionSchema.parse(item));
+    }
+    /**
+     * Include a skill in a learning space.
+     */
+    async includeSkill(options) {
+        const data = await this.requester.request('POST', `/learning_spaces/${options.spaceId}/skills`, { jsonData: { skill_id: options.skillId } });
+        return types_1.LearningSpaceSkillSchema.parse(data);
+    }
+    /**
+     * List all skills in a learning space. Returns full skill data.
+     */
+    async listSkills(spaceId) {
+        const data = await this.requester.request('GET', `/learning_spaces/${spaceId}/skills`);
+        return data.map((item) => types_1.SkillSchema.parse(item));
+    }
+    /**
+     * Remove a skill from a learning space. Idempotent.
+     */
+    async excludeSkill(options) {
+        await this.requester.request('DELETE', `/learning_spaces/${options.spaceId}/skills/${options.skillId}`);
+    }
+}
+exports.LearningSpacesAPI = LearningSpacesAPI;

package/dist/resources/sessions.d.ts

@@ -4,7 +4,7 @@
 import { RequesterProtocol } from '../client-types';
 import { AcontextMessage } from '../messages';
 import { FileUpload } from '../uploads';
-import { EditStrategy, GetMessagesOutput, GetTasksOutput, ListSessionsOutput, Message, MessageObservingStatus, Session, TokenCounts } from '../types';
+import { EditStrategy, CopySessionResult, GetMessagesOutput, GetTasksOutput, ListSessionsOutput, Message, MessageObservingStatus, Session, TokenCounts } from '../types';
 export type MessageBlob = AcontextMessage | Record<string, unknown>;
 export declare class SessionsAPI {
     private requester;
@@ -195,4 +195,21 @@ export declare class SessionsAPI {
      * );
      */
     patchConfigs(sessionId: string, configs: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Copy (duplicate) a session with all its messages and tasks.
+     *
+     * Creates a complete copy of the session including all messages, tasks, and configurations.
+     * The copied session will be independent and modifications to it won't affect the original.
+     *
+     * @param sessionId - The UUID of the session to copy.
+     * @returns CopySessionResult containing the original and new session IDs.
+     * @throws {Error} If session_id is invalid or session doesn't exist.
+     * @throws {Error} If session exceeds maximum copyable size (5000 messages).
+     *
+     * @example
+     * const result = await client.sessions.copy(sessionId);
+     * console.log(`Copied session: ${result.newSessionId}`);
+     * console.log(`Original session: ${result.oldSessionId}`);
+     */
+    copy(sessionId: string): Promise<CopySessionResult>;
 }

package/dist/resources/sessions.js

@@ -340,5 +340,26 @@ class SessionsAPI {
         });
         return data.configs ?? {};
     }
+    /**
+     * Copy (duplicate) a session with all its messages and tasks.
+     *
+     * Creates a complete copy of the session including all messages, tasks, and configurations.
+     * The copied session will be independent and modifications to it won't affect the original.
+     *
+     * @param sessionId - The UUID of the session to copy.
+     * @returns CopySessionResult containing the original and new session IDs.
+     * @throws {Error} If session_id is invalid or session doesn't exist.
+     * @throws {Error} If session exceeds maximum copyable size (5000 messages).
+     *
+     * @example
+     * const result = await client.sessions.copy(sessionId);
+     * console.log(`Copied session: ${result.newSessionId}`);
+     * console.log(`Original session: ${result.oldSessionId}`);
+     */
+    async copy(sessionId) {
+        (0, utils_1.validateUUID)(sessionId, 'sessionId');
+        const data = await this.requester.request('POST', `/session/${sessionId}/copy`);
+        return types_1.CopySessionResultSchema.parse(data);
+    }
 }
 exports.SessionsAPI = SessionsAPI;

package/dist/types/index.d.ts

@@ -7,3 +7,4 @@ export * from './disk';
 export * from './skill';
 export * from './sandbox';
 export * from './user';
+export * from './learning-space';

package/dist/types/index.js

@@ -23,3 +23,4 @@ __exportStar(require("./disk"), exports);
 __exportStar(require("./skill"), exports);
 __exportStar(require("./sandbox"), exports);
 __exportStar(require("./user"), exports);
+__exportStar(require("./learning-space"), exports);

package/dist/types/learning-space.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Type definitions for learning space resources.
+ */
+import { z } from 'zod';
+export declare const LearningSpaceSchema: z.ZodObject<{
+    id: z.ZodString;
+    user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type LearningSpace = z.infer<typeof LearningSpaceSchema>;
+export declare const LearningSpaceSkillSchema: z.ZodObject<{
+    id: z.ZodString;
+    learning_space_id: z.ZodString;
+    skill_id: z.ZodString;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export type LearningSpaceSkill = z.infer<typeof LearningSpaceSkillSchema>;
+export declare const LearningSpaceSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    learning_space_id: z.ZodString;
+    session_id: z.ZodString;
+    status: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type LearningSpaceSession = z.infer<typeof LearningSpaceSessionSchema>;
+export declare const ListLearningSpacesOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    has_more: z.ZodBoolean;
+}, z.core.$strip>;
+export type ListLearningSpacesOutput = z.infer<typeof ListLearningSpacesOutputSchema>;

package/dist/types/learning-space.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Type definitions for learning space resources.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListLearningSpacesOutputSchema = exports.LearningSpaceSessionSchema = exports.LearningSpaceSkillSchema = exports.LearningSpaceSchema = void 0;
+const zod_1 = require("zod");
+exports.LearningSpaceSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    user_id: zod_1.z.string().nullable().optional(),
+    meta: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable().optional(),
+    created_at: zod_1.z.string(),
+    updated_at: zod_1.z.string(),
+});
+exports.LearningSpaceSkillSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    learning_space_id: zod_1.z.string(),
+    skill_id: zod_1.z.string(),
+    created_at: zod_1.z.string(),
+});
+exports.LearningSpaceSessionSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    learning_space_id: zod_1.z.string(),
+    session_id: zod_1.z.string(),
+    status: zod_1.z.string(),
+    created_at: zod_1.z.string(),
+    updated_at: zod_1.z.string(),
+});
+exports.ListLearningSpacesOutputSchema = zod_1.z.object({
+    items: zod_1.z.array(exports.LearningSpaceSchema),
+    next_cursor: zod_1.z.string().nullable().optional(),
+    has_more: zod_1.z.boolean(),
+});

package/dist/types/session.d.ts

@@ -157,6 +157,11 @@ export declare const MessageObservingStatusSchema: z.ZodObject<{
     updated_at: z.ZodString;
 }, z.core.$strip>;
 export type MessageObservingStatus = z.infer<typeof MessageObservingStatusSchema>;
+export declare const CopySessionResultSchema: z.ZodObject<{
+    old_session_id: z.ZodString;
+    new_session_id: z.ZodString;
+}, z.core.$strip>;
+export type CopySessionResult = z.infer<typeof CopySessionResultSchema>;
 /**
  * Parameters for the remove_tool_result edit strategy.
  */

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.MiddleOutStrategySchema = exports.MiddleOutParamsSchema = exports.TokenLimitStrategySchema = exports.TokenLimitParamsSchema = exports.RemoveToolResultStrategySchema = exports.RemoveToolCallParamsStrategySchema = exports.RemoveToolCallParamsParamsSchema = exports.RemoveToolResultParamsSchema = exports.MessageObservingStatusSchema = exports.TokenCountsSchema = 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.CopySessionResultSchema = exports.MessageObservingStatusSchema = exports.TokenCountsSchema = 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(),
@@ -108,6 +108,10 @@ exports.MessageObservingStatusSchema = zod_1.z.object({
     pending: zod_1.z.number(),
     updated_at: zod_1.z.string(),
 });
+exports.CopySessionResultSchema = zod_1.z.object({
+    old_session_id: zod_1.z.string(),
+    new_session_id: zod_1.z.string(),
+});
 /**
  * Parameters for the remove_tool_result edit strategy.
  */

package/dist/utils.d.ts

@@ -9,3 +9,16 @@ export declare function boolToStr(value: boolean): string;
  * Build query parameters dictionary, filtering None values and converting booleans.
  */
 export declare function buildParams(params: Record<string, unknown>): Record<string, string | number>;
+/**
+ * Validate that a string is a valid UUID (v1–v5) format.
+ * @param uuid - The string to validate.
+ * @returns True if valid UUID, false otherwise.
+ */
+export declare function isValidUUID(uuid: string): boolean;
+/**
+ * Validate UUID and throw error if invalid.
+ * @param uuid - The UUID to validate.
+ * @param paramName - The parameter name for error message.
+ * @throws {Error} If UUID is invalid.
+ */
+export declare function validateUUID(uuid: string, paramName?: string): void;

package/dist/utils.js

@@ -5,6 +5,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.boolToStr = boolToStr;
 exports.buildParams = buildParams;
+exports.isValidUUID = isValidUUID;
+exports.validateUUID = validateUUID;
 /**
  * Convert a boolean value to string representation used by the API.
  */
@@ -28,3 +30,23 @@ function buildParams(params) {
     }
     return result;
 }
+/**
+ * Validate that a string is a valid UUID (v1–v5) format.
+ * @param uuid - The string to validate.
+ * @returns True if valid UUID, false otherwise.
+ */
+function isValidUUID(uuid) {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(uuid);
+}
+/**
+ * Validate UUID and throw error if invalid.
+ * @param uuid - The UUID to validate.
+ * @param paramName - The parameter name for error message.
+ * @throws {Error} If UUID is invalid.
+ */
+function validateUUID(uuid, paramName = 'id') {
+    if (!isValidUUID(uuid)) {
+        throw new Error(`Invalid UUID format for ${paramName}: ${uuid}`);
+    }
+}

package/package.json

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