@acontext/acontext 0.1.3 → 0.1.5

package/dist/client.d.ts

@@ -4,7 +4,6 @@
 import { DisksAPI } from './resources/disks';
 import { SandboxesAPI } from './resources/sandboxes';
 import { SessionsAPI } from './resources/sessions';
-import { ToolsAPI } from './resources/tools';
 import { SkillsAPI } from './resources/skills';
 import { UsersAPI } from './resources/users';
 import { RequesterProtocol } from './client-types';
@@ -22,7 +21,6 @@ export declare class AcontextClient implements RequesterProtocol {
     sessions: SessionsAPI;
     disks: DisksAPI;
     artifacts: DisksAPI['artifacts'];
-    tools: ToolsAPI;
     skills: SkillsAPI;
     users: UsersAPI;
     sandboxes: SandboxesAPI;

package/dist/client.js

@@ -41,7 +41,6 @@ const errors_1 = require("./errors");
 const disks_1 = require("./resources/disks");
 const sandboxes_1 = require("./resources/sandboxes");
 const sessions_1 = require("./resources/sessions");
-const tools_1 = require("./resources/tools");
 const skills_1 = require("./resources/skills");
 const users_1 = require("./resources/users");
 const constants_1 = require("./constants");
@@ -75,7 +74,6 @@ class AcontextClient {
         this.sessions = new sessions_1.SessionsAPI(this);
         this.disks = new disks_1.DisksAPI(this);
         this.artifacts = this.disks.artifacts;
-        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);

package/dist/resources/index.d.ts

@@ -3,7 +3,6 @@
  */
 export * from './sessions';
 export * from './disks';
-export * from './tools';
 export * from './skills';
 export * from './sandboxes';
 export * from './users';

package/dist/resources/index.js

@@ -19,7 +19,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./sessions"), exports);
 __exportStar(require("./disks"), exports);
-__exportStar(require("./tools"), exports);
 __exportStar(require("./skills"), exports);
 __exportStar(require("./sandboxes"), exports);
 __exportStar(require("./users"), exports);

package/dist/resources/sessions.d.ts

@@ -9,16 +9,43 @@ 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 a new session.
+     *
+     * @param options - Options for creating a session.
+     * @param options.user - Optional user identifier string.
+     * @param options.disableTaskTracking - Whether to disable task tracking for this session.
+     * @param options.configs - Optional session configuration dictionary.
+     * @param options.useUuid - Optional UUID string to use as the session ID. If not provided, a UUID will be auto-generated.
+     *   If a session with this UUID already exists, a 409 Conflict error will be raised.
+     * @returns The created Session object.
+     */
     create(options?: {
         user?: string | null;
         disableTaskTracking?: boolean | null;
         configs?: Record<string, unknown>;
+        useUuid?: string | null;
     }): Promise<Session>;
     delete(sessionId: string): Promise<void>;
     updateConfigs(sessionId: string, options: {

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,
@@ -26,6 +44,17 @@ class SessionsAPI {
         });
         return types_1.ListSessionsOutputSchema.parse(data);
     }
+    /**
+     * Create a new session.
+     *
+     * @param options - Options for creating a session.
+     * @param options.user - Optional user identifier string.
+     * @param options.disableTaskTracking - Whether to disable task tracking for this session.
+     * @param options.configs - Optional session configuration dictionary.
+     * @param options.useUuid - Optional UUID string to use as the session ID. If not provided, a UUID will be auto-generated.
+     *   If a session with this UUID already exists, a 409 Conflict error will be raised.
+     * @returns The created Session object.
+     */
     async create(options) {
         const payload = {};
         if (options?.user !== undefined && options?.user !== null) {
@@ -37,6 +66,9 @@ class SessionsAPI {
         if (options?.configs !== undefined) {
             payload.configs = options.configs;
         }
+        if (options?.useUuid !== undefined && options?.useUuid !== null) {
+            payload.use_uuid = options.useUuid;
+        }
         const data = await this.requester.request('POST', '/session', {
             jsonData: Object.keys(payload).length > 0 ? payload : undefined,
         });

package/dist/types/common.d.ts

@@ -7,3 +7,8 @@ export declare const FileContentSchema: z.ZodObject<{
     raw: z.ZodString;
 }, z.core.$strip>;
 export type FileContent = z.infer<typeof FileContentSchema>;
+export declare const FlagResponseSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    errmsg: z.ZodString;
+}, z.core.$strip>;
+export type FlagResponse = z.infer<typeof FlagResponseSchema>;

package/dist/types/common.js

@@ -3,9 +3,13 @@
  * Common type definitions shared across modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileContentSchema = void 0;
+exports.FlagResponseSchema = exports.FileContentSchema = void 0;
 const zod_1 = require("zod");
 exports.FileContentSchema = zod_1.z.object({
     type: zod_1.z.string(),
     raw: zod_1.z.string(),
 });
+exports.FlagResponseSchema = zod_1.z.object({
+    status: zod_1.z.number(),
+    errmsg: zod_1.z.string(),
+});

package/dist/types/index.d.ts

@@ -4,7 +4,6 @@
 export * from './common';
 export * from './session';
 export * from './disk';
-export * from './tool';
 export * from './skill';
 export * from './sandbox';
 export * from './user';

package/dist/types/index.js

@@ -20,7 +20,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common"), exports);
 __exportStar(require("./session"), exports);
 __exportStar(require("./disk"), exports);
-__exportStar(require("./tool"), exports);
 __exportStar(require("./skill"), exports);
 __exportStar(require("./sandbox"), exports);
 __exportStar(require("./user"), exports);

package/package.json

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

package/dist/resources/tools.d.ts

@@ -1,13 +0,0 @@
-/**
- * Tool endpoints.
- */
-import { RequesterProtocol } from '../client-types';
-import { ToolRenameItem, ToolReferenceData, FlagResponse } from '../types/tool';
-export declare class ToolsAPI {
-    private requester;
-    constructor(requester: RequesterProtocol);
-    renameToolName(options: {
-        rename: ToolRenameItem[];
-    }): Promise<FlagResponse>;
-    getToolName(): Promise<ToolReferenceData[]>;
-}

package/dist/resources/tools.js

@@ -1,26 +0,0 @@
-"use strict";
-/**
- * Tool endpoints.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolsAPI = void 0;
-const tool_1 = require("../types/tool");
-class ToolsAPI {
-    constructor(requester) {
-        this.requester = requester;
-    }
-    async renameToolName(options) {
-        const payload = { rename: options.rename };
-        const data = await this.requester.request('PUT', '/tool/name', {
-            jsonData: payload,
-        });
-        return tool_1.FlagResponseSchema.parse(data);
-    }
-    async getToolName() {
-        const data = await this.requester.request('GET', '/tool/name');
-        return Array.isArray(data)
-            ? data.map((item) => tool_1.ToolReferenceDataSchema.parse(item))
-            : [];
-    }
-}
-exports.ToolsAPI = ToolsAPI;

package/dist/types/tool.d.ts

@@ -1,19 +0,0 @@
-/**
- * Type definitions for tool resources.
- */
-import { z } from 'zod';
-export declare const ToolRenameItemSchema: z.ZodObject<{
-    oldName: z.ZodString;
-    newName: z.ZodString;
-}, z.core.$strip>;
-export type ToolRenameItem = z.infer<typeof ToolRenameItemSchema>;
-export declare const ToolReferenceDataSchema: z.ZodObject<{
-    name: z.ZodString;
-    sop_count: z.ZodNumber;
-}, z.core.$strip>;
-export type ToolReferenceData = z.infer<typeof ToolReferenceDataSchema>;
-export declare const FlagResponseSchema: z.ZodObject<{
-    status: z.ZodNumber;
-    errmsg: z.ZodString;
-}, z.core.$strip>;
-export type FlagResponse = z.infer<typeof FlagResponseSchema>;

package/dist/types/tool.js

@@ -1,19 +0,0 @@
-"use strict";
-/**
- * Type definitions for tool resources.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlagResponseSchema = exports.ToolReferenceDataSchema = exports.ToolRenameItemSchema = void 0;
-const zod_1 = require("zod");
-exports.ToolRenameItemSchema = zod_1.z.object({
-    oldName: zod_1.z.string(),
-    newName: zod_1.z.string(),
-});
-exports.ToolReferenceDataSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    sop_count: zod_1.z.number(),
-});
-exports.FlagResponseSchema = zod_1.z.object({
-    status: zod_1.z.number(),
-    errmsg: zod_1.z.string(),
-});