@acontext/acontext 0.0.16 → 0.0.18

package/dist/agent/index.d.ts

@@ -3,3 +3,4 @@
  */
 export * from './base';
 export * from './disk';
+export * from './skill';

package/dist/agent/index.js

@@ -19,3 +19,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./base"), exports);
 __exportStar(require("./disk"), exports);
+__exportStar(require("./skill"), exports);

package/dist/agent/skill.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Skill tools for agent operations.
+ */
+import { AcontextClient } from '../client';
+import { AbstractBaseTool, BaseContext, BaseToolPool } from './base';
+export interface SkillContext extends BaseContext {
+    client: AcontextClient;
+}
+export declare class GetSkillTool extends AbstractBaseTool {
+    readonly name = "get_skill";
+    readonly description = "Get a skill by its name. Return the skill information including the relative paths of the files and their mime type categories";
+    readonly arguments: {
+        name: {
+            type: string;
+            description: string;
+        };
+    };
+    readonly requiredArguments: string[];
+    execute(ctx: SkillContext, llmArguments: Record<string, unknown>): Promise<string>;
+}
+export declare class GetSkillFileTool extends AbstractBaseTool {
+    readonly name = "get_skill_file";
+    readonly description = "Get a file from a skill by name. The file_path should be a relative path within the skill (e.g., 'scripts/extract_text.json'). ";
+    readonly arguments: {
+        skill_name: {
+            type: string;
+            description: string;
+        };
+        file_path: {
+            type: string;
+            description: string;
+        };
+        expire: {
+            type: string;
+            description: string;
+        };
+    };
+    readonly requiredArguments: string[];
+    execute(ctx: SkillContext, llmArguments: Record<string, unknown>): Promise<string>;
+}
+export declare class SkillToolPool extends BaseToolPool {
+    formatContext(client: AcontextClient): SkillContext;
+}
+export declare const SKILL_TOOLS: SkillToolPool;

package/dist/agent/skill.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Skill tools for agent operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_TOOLS = exports.SkillToolPool = exports.GetSkillFileTool = exports.GetSkillTool = void 0;
+const base_1 = require("./base");
+class GetSkillTool extends base_1.AbstractBaseTool {
+    constructor() {
+        super(...arguments);
+        this.name = 'get_skill';
+        this.description = 'Get a skill by its name. Return the skill information including the relative paths of the files and their mime type categories';
+        this.arguments = {
+            name: {
+                type: 'string',
+                description: 'The name of the skill (unique within project).',
+            },
+        };
+        this.requiredArguments = ['name'];
+    }
+    async execute(ctx, llmArguments) {
+        const name = llmArguments.name;
+        if (!name) {
+            throw new Error('name is required');
+        }
+        const skill = await ctx.client.skills.getByName(name);
+        const fileCount = skill.file_index.length;
+        // Format all files with path and MIME type
+        let fileList;
+        if (skill.file_index.length > 0) {
+            fileList = skill.file_index
+                .map((file) => `  - ${file.path} (${file.mime})`)
+                .join('\n');
+        }
+        else {
+            fileList = '  [NO FILES]';
+        }
+        return (`Skill: ${skill.name} (ID: ${skill.id})\n` +
+            `Description: ${skill.description}\n` +
+            `Files: ${fileCount} file(s)\n` +
+            `${fileList}\n` +
+            `Created: ${skill.created_at}\n` +
+            `Updated: ${skill.updated_at}`);
+    }
+}
+exports.GetSkillTool = GetSkillTool;
+class GetSkillFileTool extends base_1.AbstractBaseTool {
+    constructor() {
+        super(...arguments);
+        this.name = 'get_skill_file';
+        this.description = "Get a file from a skill by name. The file_path should be a relative path within the skill (e.g., 'scripts/extract_text.json'). ";
+        this.arguments = {
+            skill_name: {
+                type: 'string',
+                description: 'The name of the skill.',
+            },
+            file_path: {
+                type: 'string',
+                description: "Relative path to the file within the skill (e.g., 'scripts/extract_text.json').",
+            },
+            expire: {
+                type: 'number',
+                description: 'URL expiration time in seconds (only used for non-parseable files). Defaults to 900 (15 minutes).',
+            },
+        };
+        this.requiredArguments = ['skill_name', 'file_path'];
+    }
+    async execute(ctx, llmArguments) {
+        const skillName = llmArguments.skill_name;
+        const filePath = llmArguments.file_path;
+        const expire = llmArguments.expire;
+        if (!filePath) {
+            throw new Error('file_path is required');
+        }
+        if (!skillName) {
+            throw new Error('skill_name is required');
+        }
+        const result = await ctx.client.skills.getFileByName({
+            skillName,
+            filePath,
+            expire: expire || null,
+        });
+        const outputParts = [
+            `File '${result.path}' (MIME: ${result.mime}) from skill '${skillName}':`,
+        ];
+        if (result.content) {
+            outputParts.push(`\nContent (type: ${result.content.type}):`);
+            outputParts.push(result.content.raw);
+        }
+        if (result.url) {
+            const expireSeconds = expire || 900;
+            outputParts.push(`\nDownload URL (expires in ${expireSeconds} seconds):`);
+            outputParts.push(result.url);
+        }
+        if (!result.content && !result.url) {
+            return `File '${filePath}' retrieved but no content or URL returned.`;
+        }
+        return outputParts.join('\n');
+    }
+}
+exports.GetSkillFileTool = GetSkillFileTool;
+class SkillToolPool extends base_1.BaseToolPool {
+    formatContext(client) {
+        return {
+            client,
+        };
+    }
+}
+exports.SkillToolPool = SkillToolPool;
+exports.SKILL_TOOLS = new SkillToolPool();
+exports.SKILL_TOOLS.addTool(new GetSkillTool());
+exports.SKILL_TOOLS.addTool(new GetSkillFileTool());

package/dist/client.d.ts

@@ -6,6 +6,8 @@ import { DisksAPI } from './resources/disks';
 import { SessionsAPI } from './resources/sessions';
 import { SpacesAPI } from './resources/spaces';
 import { ToolsAPI } from './resources/tools';
+import { SkillsAPI } from './resources/skills';
+import { UsersAPI } from './resources/users';
 import { RequesterProtocol } from './client-types';
 export interface AcontextClientOptions {
     apiKey?: string | null;
@@ -24,6 +26,8 @@ export declare class AcontextClient implements RequesterProtocol {
     artifacts: DisksAPI['artifacts'];
     blocks: BlocksAPI;
     tools: ToolsAPI;
+    skills: SkillsAPI;
+    users: UsersAPI;
     constructor(options?: AcontextClientOptions);
     get baseUrl(): string;
     /**

package/dist/client.js

@@ -43,6 +43,8 @@ const disks_1 = require("./resources/disks");
 const sessions_1 = require("./resources/sessions");
 const spaces_1 = require("./resources/spaces");
 const tools_1 = require("./resources/tools");
+const skills_1 = require("./resources/skills");
+const users_1 = require("./resources/users");
 const constants_1 = require("./constants");
 class AcontextClient {
     constructor(options = {}) {
@@ -77,6 +79,8 @@ class AcontextClient {
         this.artifacts = this.disks.artifacts;
         this.blocks = new blocks_1.BlocksAPI(this);
         this.tools = new tools_1.ToolsAPI(this);
+        this.skills = new skills_1.SkillsAPI(this);
+        this.users = new users_1.UsersAPI(this);
     }
     get baseUrl() {
         return this._baseUrl;

package/dist/resources/disks.d.ts

@@ -9,11 +9,14 @@ export declare class DisksAPI {
     private requester;
     constructor(requester: RequesterProtocol);
     list(options?: {
+        user?: string | null;
         limit?: number | null;
         cursor?: string | null;
         timeDesc?: boolean | null;
     }): Promise<ListDisksOutput>;
-    create(): Promise<Disk>;
+    create(options?: {
+        user?: string | null;
+    }): Promise<Disk>;
     delete(diskId: string): Promise<void>;
 }
 export declare class DiskArtifactsAPI {

package/dist/resources/disks.js

@@ -14,6 +14,7 @@ class DisksAPI {
     }
     async list(options) {
         const params = (0, utils_1.buildParams)({
+            user: options?.user ?? null,
             limit: options?.limit ?? null,
             cursor: options?.cursor ?? null,
             time_desc: options?.timeDesc ?? null,
@@ -23,8 +24,14 @@ class DisksAPI {
         });
         return types_1.ListDisksOutputSchema.parse(data);
     }
-    async create() {
-        const data = await this.requester.request('POST', '/disk');
+    async create(options) {
+        const payload = {};
+        if (options?.user !== undefined && options?.user !== null) {
+            payload.user = options.user;
+        }
+        const data = await this.requester.request('POST', '/disk', {
+            jsonData: Object.keys(payload).length > 0 ? payload : undefined,
+        });
         return types_1.DiskSchema.parse(data);
     }
     async delete(diskId) {

package/dist/resources/index.d.ts

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

package/dist/resources/index.js

@@ -22,3 +22,5 @@ __exportStar(require("./sessions"), exports);
 __exportStar(require("./disks"), exports);
 __exportStar(require("./blocks"), exports);
 __exportStar(require("./tools"), exports);
+__exportStar(require("./skills"), exports);
+__exportStar(require("./users"), exports);

package/dist/resources/sessions.d.ts

@@ -10,6 +10,7 @@ export declare class SessionsAPI {
     private requester;
     constructor(requester: RequesterProtocol);
     list(options?: {
+        user?: string | null;
         spaceId?: string | null;
         notConnected?: boolean | null;
         limit?: number | null;
@@ -17,6 +18,7 @@ export declare class SessionsAPI {
         timeDesc?: boolean | null;
     }): Promise<ListSessionsOutput>;
     create(options?: {
+        user?: string | null;
         spaceId?: string | null;
         disableTaskTracking?: boolean | null;
         configs?: Record<string, unknown>;
@@ -53,6 +55,11 @@ export declare class SessionsAPI {
      *   Examples:
      *   - Remove tool results: [{ type: 'remove_tool_result', params: { keep_recent_n_tool_results: 3 } }]
      *   - 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,
+     *   keeping subsequent messages unchanged. This helps maintain prompt cache stability by
+     *   preserving a stable prefix. The response includes edit_at_message_id indicating where
+     *   strategies were applied. Pass this value in subsequent requests to maintain cache hits.
      * @returns GetMessagesOutput containing the list of messages and pagination information.
      */
     getMessages(sessionId: string, options?: {
@@ -62,6 +69,7 @@ export declare class SessionsAPI {
         format?: 'acontext' | 'openai' | 'anthropic' | 'gemini';
         timeDesc?: boolean | null;
         editStrategies?: Array<EditStrategy> | null;
+        pinEditingStrategiesAtMessage?: string | null;
     }): Promise<GetMessagesOutput>;
     flush(sessionId: string): Promise<{
         status: number;

package/dist/resources/sessions.js

@@ -13,6 +13,9 @@ class SessionsAPI {
     }
     async list(options) {
         const params = {};
+        if (options?.user) {
+            params.user = options.user;
+        }
         if (options?.spaceId) {
             params.space_id = options.spaceId;
         }
@@ -29,6 +32,9 @@ class SessionsAPI {
     }
     async create(options) {
         const payload = {};
+        if (options?.user !== undefined && options?.user !== null) {
+            payload.user = options.user;
+        }
         if (options?.spaceId) {
             payload.space_id = options.spaceId;
         }
@@ -132,6 +138,11 @@ class SessionsAPI {
      *   Examples:
      *   - Remove tool results: [{ type: 'remove_tool_result', params: { keep_recent_n_tool_results: 3 } }]
      *   - 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,
+     *   keeping subsequent messages unchanged. This helps maintain prompt cache stability by
+     *   preserving a stable prefix. The response includes edit_at_message_id indicating where
+     *   strategies were applied. Pass this value in subsequent requests to maintain cache hits.
      * @returns GetMessagesOutput containing the list of messages and pagination information.
      */
     async getMessages(sessionId, options) {
@@ -148,6 +159,9 @@ class SessionsAPI {
         if (options?.editStrategies !== undefined && options?.editStrategies !== null) {
             params.edit_strategies = JSON.stringify(options.editStrategies);
         }
+        if (options?.pinEditingStrategiesAtMessage !== undefined && options?.pinEditingStrategiesAtMessage !== null) {
+            params.pin_editing_strategies_at_message = options.pinEditingStrategiesAtMessage;
+        }
         const data = await this.requester.request('GET', `/session/${sessionId}/messages`, {
             params: Object.keys(params).length > 0 ? params : undefined,
         });

package/dist/resources/skills.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Skills endpoints.
+ */
+import { RequesterProtocol } from '../client-types';
+import { FileUpload } from '../uploads';
+import { GetSkillFileResp, ListSkillsOutput, Skill } from '../types';
+export declare class SkillsAPI {
+    private requester;
+    constructor(requester: RequesterProtocol);
+    create(options: {
+        file: FileUpload | [string, Buffer | NodeJS.ReadableStream] | [string, Buffer | NodeJS.ReadableStream, string | null];
+        user?: string | null;
+        meta?: Record<string, unknown> | null;
+    }): Promise<Skill>;
+    /**
+     * Get a catalog of skills (names and descriptions only) with pagination.
+     *
+     * @param options - Pagination options
+     * @param options.user - Filter by user identifier (optional)
+     * @param options.limit - Maximum number of skills per page (defaults to 100, max 200)
+     * @param options.cursor - Cursor for pagination to fetch the next page (optional)
+     * @param options.timeDesc - Order by created_at descending if true, ascending if false (defaults to false)
+     * @returns ListSkillsOutput containing skills with name and description for the current page,
+     *          along with pagination information (next_cursor and has_more)
+     */
+    list_catalog(options?: {
+        user?: string | null;
+        limit?: number | null;
+        cursor?: string | null;
+        timeDesc?: boolean | null;
+    }): Promise<ListSkillsOutput>;
+    getByName(name: string): Promise<Skill>;
+    delete(skillId: string): Promise<void>;
+    getFileByName(options: {
+        skillName: string;
+        filePath: string;
+        expire?: number | null;
+    }): Promise<GetSkillFileResp>;
+}

package/dist/resources/skills.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Skills endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillsAPI = void 0;
+const zod_1 = require("zod");
+const uploads_1 = require("../uploads");
+const utils_1 = require("../utils");
+const types_1 = require("../types");
+class SkillsAPI {
+    constructor(requester) {
+        this.requester = requester;
+    }
+    async create(options) {
+        const upload = (0, uploads_1.normalizeFileUpload)(options.file);
+        const files = {
+            file: upload.asFormData(),
+        };
+        const form = {};
+        if (options.user !== undefined && options.user !== null) {
+            form.user = options.user;
+        }
+        if (options.meta !== undefined && options.meta !== null) {
+            form.meta = JSON.stringify(options.meta);
+        }
+        const data = await this.requester.request('POST', '/agent_skills', {
+            data: Object.keys(form).length > 0 ? form : undefined,
+            files,
+        });
+        return types_1.SkillSchema.parse(data);
+    }
+    /**
+     * Get a catalog of skills (names and descriptions only) with pagination.
+     *
+     * @param options - Pagination options
+     * @param options.user - Filter by user identifier (optional)
+     * @param options.limit - Maximum number of skills per page (defaults to 100, max 200)
+     * @param options.cursor - Cursor for pagination to fetch the next page (optional)
+     * @param options.timeDesc - Order by created_at descending if true, ascending if false (defaults to false)
+     * @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) {
+        // Parse API response (contains full Skill objects)
+        const apiResponseSchema = zod_1.z.object({
+            items: zod_1.z.array(types_1.SkillSchema),
+            next_cursor: zod_1.z.string().nullable().optional(),
+            has_more: zod_1.z.boolean(),
+        });
+        // Use 100 as default for catalog listing (only name and description, lightweight)
+        const effectiveLimit = options?.limit ?? 100;
+        const params = (0, utils_1.buildParams)({
+            user: options?.user ?? null,
+            limit: effectiveLimit,
+            cursor: options?.cursor ?? null,
+            time_desc: options?.timeDesc ?? null,
+        });
+        const data = await this.requester.request('GET', '/agent_skills', {
+            params: Object.keys(params).length > 0 ? params : undefined,
+        });
+        const apiResponse = apiResponseSchema.parse(data);
+        // Convert to catalog format (name and description only)
+        return types_1.ListSkillsOutputSchema.parse({
+            items: apiResponse.items.map((skill) => ({
+                name: skill.name,
+                description: skill.description,
+            })),
+            next_cursor: apiResponse.next_cursor ?? null,
+            has_more: apiResponse.has_more,
+        });
+    }
+    async getByName(name) {
+        const params = { name };
+        const data = await this.requester.request('GET', '/agent_skills/by_name', {
+            params,
+        });
+        return types_1.SkillSchema.parse(data);
+    }
+    async delete(skillId) {
+        await this.requester.request('DELETE', `/agent_skills/${skillId}`);
+    }
+    async getFileByName(options) {
+        const endpoint = `/agent_skills/by_name/${options.skillName}/file`;
+        const params = {
+            file_path: options.filePath,
+        };
+        if (options.expire !== undefined && options.expire !== null) {
+            params.expire = options.expire;
+        }
+        const data = await this.requester.request('GET', endpoint, {
+            params,
+        });
+        return types_1.GetSkillFileRespSchema.parse(data);
+    }
+}
+exports.SkillsAPI = SkillsAPI;

package/dist/resources/spaces.d.ts

@@ -7,11 +7,13 @@ export declare class SpacesAPI {
     private requester;
     constructor(requester: RequesterProtocol);
     list(options?: {
+        user?: string | null;
         limit?: number | null;
         cursor?: string | null;
         timeDesc?: boolean | null;
     }): Promise<ListSpacesOutput>;
     create(options?: {
+        user?: string | null;
         configs?: Record<string, unknown>;
     }): Promise<Space>;
     delete(spaceId: string): Promise<void>;

package/dist/resources/spaces.js

@@ -12,6 +12,7 @@ class SpacesAPI {
     }
     async list(options) {
         const params = (0, utils_1.buildParams)({
+            user: options?.user ?? null,
             limit: options?.limit ?? null,
             cursor: options?.cursor ?? null,
             time_desc: options?.timeDesc ?? null,
@@ -23,6 +24,9 @@ class SpacesAPI {
     }
     async create(options) {
         const payload = {};
+        if (options?.user !== undefined && options?.user !== null) {
+            payload.user = options.user;
+        }
         if (options?.configs !== undefined) {
             payload.configs = options.configs;
         }

package/dist/resources/users.d.ts

@@ -0,0 +1,14 @@
+/**
+ * User management endpoints.
+ */
+import { RequesterProtocol } from '../client-types';
+export declare class UsersAPI {
+    private requester;
+    constructor(requester: RequesterProtocol);
+    /**
+     * Delete a user and cascade delete all associated resources (Space, Session, Disk, Skill).
+     *
+     * @param identifier - The user identifier string
+     */
+    delete(identifier: string): Promise<void>;
+}

package/dist/resources/users.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * User management endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsersAPI = void 0;
+class UsersAPI {
+    constructor(requester) {
+        this.requester = requester;
+    }
+    /**
+     * Delete a user and cascade delete all associated resources (Space, Session, Disk, Skill).
+     *
+     * @param identifier - The user identifier string
+     */
+    async delete(identifier) {
+        await this.requester.request('DELETE', `/user/${encodeURIComponent(identifier)}`);
+    }
+}
+exports.UsersAPI = UsersAPI;

package/dist/types/common.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Common type definitions shared across modules.
+ */
+import { z } from 'zod';
+export declare const FileContentSchema: z.ZodObject<{
+    type: z.ZodString;
+    raw: z.ZodString;
+}, z.core.$strip>;
+export type FileContent = z.infer<typeof FileContentSchema>;

package/dist/types/common.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Common type definitions shared across modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+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(),
+});

package/dist/types/disk.d.ts

@@ -5,6 +5,7 @@ import { z } from 'zod';
 export declare const DiskSchema: z.ZodObject<{
     id: z.ZodString;
     project_id: z.ZodString;
+    user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_at: z.ZodString;
     updated_at: z.ZodString;
 }, z.core.$strip>;
@@ -13,6 +14,7 @@ export declare const ListDisksOutputSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         project_id: z.ZodString;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         created_at: z.ZodString;
         updated_at: z.ZodString;
     }, z.core.$strip>>;
@@ -29,11 +31,6 @@ export declare const ArtifactSchema: z.ZodObject<{
     updated_at: z.ZodString;
 }, z.core.$strip>;
 export type Artifact = z.infer<typeof ArtifactSchema>;
-export declare const FileContentSchema: z.ZodObject<{
-    type: z.ZodString;
-    raw: z.ZodString;
-}, z.core.$strip>;
-export type FileContent = z.infer<typeof FileContentSchema>;
 export declare const GetArtifactRespSchema: z.ZodObject<{
     artifact: z.ZodObject<{
         disk_id: z.ZodString;

package/dist/types/disk.js

@@ -3,11 +3,13 @@
  * Type definitions for disk and artifact resources.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UpdateArtifactRespSchema = exports.ListArtifactsRespSchema = exports.GetArtifactRespSchema = exports.FileContentSchema = exports.ArtifactSchema = exports.ListDisksOutputSchema = exports.DiskSchema = void 0;
+exports.UpdateArtifactRespSchema = exports.ListArtifactsRespSchema = exports.GetArtifactRespSchema = exports.ArtifactSchema = exports.ListDisksOutputSchema = exports.DiskSchema = void 0;
 const zod_1 = require("zod");
+const common_1 = require("./common");
 exports.DiskSchema = zod_1.z.object({
     id: zod_1.z.string(),
     project_id: zod_1.z.string(),
+    user_id: zod_1.z.string().nullable().optional(),
     created_at: zod_1.z.string(),
     updated_at: zod_1.z.string(),
 });
@@ -24,14 +26,10 @@ exports.ArtifactSchema = zod_1.z.object({
     created_at: zod_1.z.string(),
     updated_at: zod_1.z.string(),
 });
-exports.FileContentSchema = zod_1.z.object({
-    type: zod_1.z.string(),
-    raw: zod_1.z.string(),
-});
 exports.GetArtifactRespSchema = zod_1.z.object({
     artifact: exports.ArtifactSchema,
     public_url: zod_1.z.string().nullable().optional(),
-    content: exports.FileContentSchema.nullable().optional(),
+    content: common_1.FileContentSchema.nullable().optional(),
 });
 exports.ListArtifactsRespSchema = zod_1.z.object({
     artifacts: zod_1.z.array(exports.ArtifactSchema),

package/dist/types/index.d.ts

@@ -1,8 +1,10 @@
 /**
  * Type exports
  */
+export * from './common';
 export * from './space';
 export * from './session';
 export * from './disk';
 export * from './block';
 export * from './tool';
+export * from './skill';

package/dist/types/index.js

@@ -17,8 +17,10 @@ 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 });
+__exportStar(require("./common"), exports);
 __exportStar(require("./space"), exports);
 __exportStar(require("./session"), exports);
 __exportStar(require("./disk"), exports);
 __exportStar(require("./block"), exports);
 __exportStar(require("./tool"), exports);
+__exportStar(require("./skill"), exports);

package/dist/types/session.d.ts

@@ -55,6 +55,7 @@ export type Message = z.infer<typeof MessageSchema>;
 export declare const SessionSchema: z.ZodObject<{
     id: z.ZodString;
     project_id: z.ZodString;
+    user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     disable_task_tracking: z.ZodBoolean;
     space_id: z.ZodNullable<z.ZodString>;
     configs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -96,6 +97,7 @@ export declare const ListSessionsOutputSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         project_id: z.ZodString;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         disable_task_tracking: z.ZodBoolean;
         space_id: z.ZodNullable<z.ZodString>;
         configs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -116,10 +118,12 @@ export declare const GetMessagesOutputSchema: z.ZodObject<{
     ids: z.ZodArray<z.ZodString>;
     next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     has_more: z.ZodBoolean;
+    this_time_tokens: z.ZodNumber;
     public_urls: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
         url: z.ZodString;
         expire_at: z.ZodString;
     }, z.core.$strip>>>>;
+    edit_at_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type GetMessagesOutput = z.infer<typeof GetMessagesOutputSchema>;
 export declare const GetTasksOutputSchema: z.ZodObject<{
@@ -166,6 +170,7 @@ export type MessageObservingStatus = z.infer<typeof MessageObservingStatusSchema
 export declare const RemoveToolResultParamsSchema: z.ZodObject<{
     keep_recent_n_tool_results: z.ZodOptional<z.ZodNumber>;
     tool_result_placeholder: z.ZodOptional<z.ZodString>;
+    keep_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type RemoveToolResultParams = z.infer<typeof RemoveToolResultParamsSchema>;
 /**
@@ -173,6 +178,7 @@ export type RemoveToolResultParams = z.infer<typeof RemoveToolResultParamsSchema
  */
 export declare const RemoveToolCallParamsParamsSchema: z.ZodObject<{
     keep_recent_n_tool_calls: z.ZodOptional<z.ZodNumber>;
+    keep_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type RemoveToolCallParamsParams = z.infer<typeof RemoveToolCallParamsParamsSchema>;
 /**
@@ -188,6 +194,7 @@ export declare const RemoveToolCallParamsStrategySchema: z.ZodObject<{
     type: z.ZodLiteral<"remove_tool_call_params">;
     params: z.ZodObject<{
         keep_recent_n_tool_calls: z.ZodOptional<z.ZodNumber>;
+        keep_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type RemoveToolCallParamsStrategy = z.infer<typeof RemoveToolCallParamsStrategySchema>;
@@ -201,6 +208,7 @@ export declare const RemoveToolResultStrategySchema: z.ZodObject<{
     params: z.ZodObject<{
         keep_recent_n_tool_results: z.ZodOptional<z.ZodNumber>;
         tool_result_placeholder: z.ZodOptional<z.ZodString>;
+        keep_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type RemoveToolResultStrategy = z.infer<typeof RemoveToolResultStrategySchema>;
@@ -236,11 +244,13 @@ export declare const EditStrategySchema: z.ZodUnion<readonly [z.ZodObject<{
     params: z.ZodObject<{
         keep_recent_n_tool_results: z.ZodOptional<z.ZodNumber>;
         tool_result_placeholder: z.ZodOptional<z.ZodString>;
+        keep_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"remove_tool_call_params">;
     params: z.ZodObject<{
         keep_recent_n_tool_calls: z.ZodOptional<z.ZodNumber>;
+        keep_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"token_limit">;

package/dist/types/session.js

@@ -35,6 +35,7 @@ exports.MessageSchema = zod_1.z.object({
 exports.SessionSchema = zod_1.z.object({
     id: zod_1.z.string(),
     project_id: zod_1.z.string(),
+    user_id: zod_1.z.string().nullable().optional(),
     disable_task_tracking: zod_1.z.boolean(),
     space_id: zod_1.z.string().nullable(),
     configs: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable(),
@@ -78,7 +79,17 @@ exports.GetMessagesOutputSchema = zod_1.z.object({
     ids: zod_1.z.array(zod_1.z.string()),
     next_cursor: zod_1.z.string().nullable().optional(),
     has_more: zod_1.z.boolean(),
+    /** Total token count of the returned messages */
+    this_time_tokens: zod_1.z.number(),
     public_urls: zod_1.z.record(zod_1.z.string(), exports.PublicURLSchema).nullable().optional(),
+    /**
+     * The message ID where edit strategies were applied up to.
+     * If pin_editing_strategies_at_message was provided, this equals that value.
+     * Otherwise, this is the ID of the last message in the response.
+     * Use this value to maintain prompt cache stability by passing it as
+     * pin_editing_strategies_at_message in subsequent requests.
+     */
+    edit_at_message_id: zod_1.z.string().nullable().optional(),
 });
 exports.GetTasksOutputSchema = zod_1.z.object({
     items: zod_1.z.array(exports.TaskSchema),
@@ -112,6 +123,11 @@ exports.RemoveToolResultParamsSchema = zod_1.z.object({
      * @default "Done"
      */
     tool_result_placeholder: zod_1.z.string().optional(),
+    /**
+     * List of tool names that should never have their results removed.
+     * Tool results from these tools are always kept regardless of keep_recent_n_tool_results.
+     */
+    keep_tools: zod_1.z.array(zod_1.z.string()).optional(),
 });
 /**
  * Parameters for the remove_tool_call_params edit strategy.
@@ -122,6 +138,11 @@ exports.RemoveToolCallParamsParamsSchema = zod_1.z.object({
      * @default 3
      */
     keep_recent_n_tool_calls: zod_1.z.number().optional(),
+    /**
+     * List of tool names that should never have their parameters removed.
+     * Tool calls for these tools always keep their full parameters regardless of keep_recent_n_tool_calls.
+     */
+    keep_tools: zod_1.z.array(zod_1.z.string()).optional(),
 });
 /**
  * Edit strategy to remove parameters from old tool-call parts.

package/dist/types/skill.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Type definitions for skill resources.
+ */
+import { z } from 'zod';
+export declare const FileInfoSchema: z.ZodObject<{
+    path: z.ZodString;
+    mime: z.ZodString;
+}, z.core.$strip>;
+export type FileInfo = z.infer<typeof FileInfoSchema>;
+export declare const SkillSchema: z.ZodObject<{
+    id: z.ZodString;
+    user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    file_index: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        mime: z.ZodString;
+    }, z.core.$strip>>;
+    meta: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type Skill = z.infer<typeof SkillSchema>;
+export declare const SkillCatalogItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+export type SkillCatalogItem = z.infer<typeof SkillCatalogItemSchema>;
+export declare const ListSkillsOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    has_more: z.ZodBoolean;
+}, z.core.$strip>;
+export type ListSkillsOutput = z.infer<typeof ListSkillsOutputSchema>;
+export declare const GetSkillFileRespSchema: z.ZodObject<{
+    path: z.ZodString;
+    mime: z.ZodString;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    content: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        type: z.ZodString;
+        raw: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type GetSkillFileResp = z.infer<typeof GetSkillFileRespSchema>;

package/dist/types/skill.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Type definitions for skill resources.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSkillFileRespSchema = exports.ListSkillsOutputSchema = exports.SkillCatalogItemSchema = exports.SkillSchema = exports.FileInfoSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+exports.FileInfoSchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    mime: zod_1.z.string(),
+});
+exports.SkillSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    user_id: zod_1.z.string().nullable().optional(),
+    name: zod_1.z.string(),
+    description: zod_1.z.string(),
+    file_index: zod_1.z.array(exports.FileInfoSchema),
+    meta: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable(),
+    created_at: zod_1.z.string(),
+    updated_at: zod_1.z.string(),
+});
+exports.SkillCatalogItemSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    description: zod_1.z.string(),
+});
+exports.ListSkillsOutputSchema = zod_1.z.object({
+    items: zod_1.z.array(exports.SkillCatalogItemSchema),
+    next_cursor: zod_1.z.string().nullable().optional(),
+    has_more: zod_1.z.boolean(),
+});
+exports.GetSkillFileRespSchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    mime: zod_1.z.string(),
+    url: zod_1.z.string().nullable().optional(),
+    content: common_1.FileContentSchema.nullable().optional(),
+});

package/dist/types/space.d.ts

@@ -5,6 +5,7 @@ import { z } from 'zod';
 export declare const SpaceSchema: z.ZodObject<{
     id: z.ZodString;
     project_id: z.ZodString;
+    user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     configs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     created_at: z.ZodString;
     updated_at: z.ZodString;
@@ -14,6 +15,7 @@ export declare const ListSpacesOutputSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         project_id: z.ZodString;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         configs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         created_at: z.ZodString;
         updated_at: z.ZodString;

package/dist/types/space.js

@@ -8,6 +8,7 @@ const zod_1 = require("zod");
 exports.SpaceSchema = zod_1.z.object({
     id: zod_1.z.string(),
     project_id: zod_1.z.string(),
+    user_id: zod_1.z.string().nullable().optional(),
     configs: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable(),
     created_at: zod_1.z.string(),
     updated_at: zod_1.z.string(),

package/package.json

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