@acontext/acontext 0.0.18 → 0.0.20

package/dist/agent/disk.d.ts

@@ -107,6 +107,38 @@ export declare class DownloadFileTool extends AbstractBaseTool {
     readonly requiredArguments: string[];
     execute(ctx: DiskContext, llmArguments: Record<string, unknown>): Promise<string>;
 }
+export declare class GrepArtifactsTool extends AbstractBaseTool {
+    readonly name = "grep_artifacts";
+    readonly description = "Search for text patterns within file contents using regex. Only searches text-based files (code, markdown, json, csv, etc.). Use this to find specific code patterns, TODO comments, function definitions, or any text content.";
+    readonly arguments: {
+        query: {
+            type: string;
+            description: string;
+        };
+        limit: {
+            type: string;
+            description: string;
+        };
+    };
+    readonly requiredArguments: string[];
+    execute(ctx: DiskContext, llmArguments: Record<string, unknown>): Promise<string>;
+}
+export declare class GlobArtifactsTool extends AbstractBaseTool {
+    readonly name = "glob_artifacts";
+    readonly description = "Find files by path pattern using glob syntax. Use * for any characters, ? for single character, ** for recursive directories. Perfect for finding files by extension or location.";
+    readonly arguments: {
+        query: {
+            type: string;
+            description: string;
+        };
+        limit: {
+            type: string;
+            description: string;
+        };
+    };
+    readonly requiredArguments: string[];
+    execute(ctx: DiskContext, llmArguments: Record<string, unknown>): Promise<string>;
+}
 export declare class DiskToolPool extends BaseToolPool {
     formatContext(client: AcontextClient, diskId: string): DiskContext;
 }

package/dist/agent/disk.js

@@ -3,7 +3,7 @@
  * Disk tools for agent operations.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DISK_TOOLS = exports.DiskToolPool = exports.DownloadFileTool = exports.ListTool = exports.ReplaceStringTool = exports.ReadFileTool = exports.WriteFileTool = void 0;
+exports.DISK_TOOLS = exports.DiskToolPool = exports.GlobArtifactsTool = exports.GrepArtifactsTool = exports.DownloadFileTool = exports.ListTool = exports.ReplaceStringTool = exports.ReadFileTool = exports.WriteFileTool = void 0;
 const uploads_1 = require("../uploads");
 const base_1 = require("./base");
 function normalizePath(path) {
@@ -262,6 +262,76 @@ class DownloadFileTool extends base_1.AbstractBaseTool {
     }
 }
 exports.DownloadFileTool = DownloadFileTool;
+class GrepArtifactsTool extends base_1.AbstractBaseTool {
+    constructor() {
+        super(...arguments);
+        this.name = 'grep_artifacts';
+        this.description = 'Search for text patterns within file contents using regex. Only searches text-based files (code, markdown, json, csv, etc.). Use this to find specific code patterns, TODO comments, function definitions, or any text content.';
+        this.arguments = {
+            query: {
+                type: 'string',
+                description: "Regex pattern to search for (e.g., 'TODO.*', 'function.*calculate', 'import.*pandas')",
+            },
+            limit: {
+                type: 'integer',
+                description: 'Maximum number of results to return (default 100)',
+            },
+        };
+        this.requiredArguments = ['query'];
+    }
+    async execute(ctx, llmArguments) {
+        const query = llmArguments.query;
+        const limit = llmArguments.limit || 100;
+        if (!query) {
+            throw new Error('query is required');
+        }
+        const results = await ctx.client.disks.artifacts.grepArtifacts(ctx.diskId, {
+            query,
+            limit,
+        });
+        if (results.length === 0) {
+            return `No matches found for pattern '${query}'`;
+        }
+        const matches = results.map((artifact) => `${artifact.path}${artifact.filename}`);
+        return `Found ${matches.length} file(s) matching '${query}':\n` + matches.join('\n');
+    }
+}
+exports.GrepArtifactsTool = GrepArtifactsTool;
+class GlobArtifactsTool extends base_1.AbstractBaseTool {
+    constructor() {
+        super(...arguments);
+        this.name = 'glob_artifacts';
+        this.description = 'Find files by path pattern using glob syntax. Use * for any characters, ? for single character, ** for recursive directories. Perfect for finding files by extension or location.';
+        this.arguments = {
+            query: {
+                type: 'string',
+                description: "Glob pattern (e.g., '**/*.py' for all Python files, '*.txt' for text files in root, '/docs/**/*.md' for markdown in docs)",
+            },
+            limit: {
+                type: 'integer',
+                description: 'Maximum number of results to return (default 100)',
+            },
+        };
+        this.requiredArguments = ['query'];
+    }
+    async execute(ctx, llmArguments) {
+        const query = llmArguments.query;
+        const limit = llmArguments.limit || 100;
+        if (!query) {
+            throw new Error('query is required');
+        }
+        const results = await ctx.client.disks.artifacts.globArtifacts(ctx.diskId, {
+            query,
+            limit,
+        });
+        if (results.length === 0) {
+            return `No files found matching pattern '${query}'`;
+        }
+        const matches = results.map((artifact) => `${artifact.path}${artifact.filename}`);
+        return `Found ${matches.length} file(s) matching '${query}':\n` + matches.join('\n');
+    }
+}
+exports.GlobArtifactsTool = GlobArtifactsTool;
 class DiskToolPool extends base_1.BaseToolPool {
     formatContext(client, diskId) {
         return {
@@ -276,4 +346,6 @@ exports.DISK_TOOLS.addTool(new WriteFileTool());
 exports.DISK_TOOLS.addTool(new ReadFileTool());
 exports.DISK_TOOLS.addTool(new ReplaceStringTool());
 exports.DISK_TOOLS.addTool(new ListTool());
+exports.DISK_TOOLS.addTool(new GrepArtifactsTool());
+exports.DISK_TOOLS.addTool(new GlobArtifactsTool());
 exports.DISK_TOOLS.addTool(new DownloadFileTool());

package/dist/agent/skill.d.ts

@@ -2,15 +2,49 @@
  * Skill tools for agent operations.
  */
 import { AcontextClient } from '../client';
+import { Skill } from '../types';
 import { AbstractBaseTool, BaseContext, BaseToolPool } from './base';
+/**
+ * Context for skill tools with preloaded skill name mapping.
+ */
 export interface SkillContext extends BaseContext {
     client: AcontextClient;
+    skills: Map<string, Skill>;
+}
+/**
+ * Create a SkillContext by preloading skills from a list of skill IDs.
+ *
+ * @param client - The Acontext client instance.
+ * @param skillIds - List of skill UUIDs to preload.
+ * @returns SkillContext with preloaded skills mapped by name.
+ * @throws Error if duplicate skill names are found.
+ */
+export declare function createSkillContext(client: AcontextClient, skillIds: string[]): Promise<SkillContext>;
+/**
+ * Get a skill by name from the preloaded skills.
+ *
+ * @param ctx - The skill context.
+ * @param skillName - The name of the skill.
+ * @returns The Skill object.
+ * @throws Error if the skill is not found in the context.
+ */
+export declare function getSkillFromContext(ctx: SkillContext, skillName: string): Skill;
+/**
+ * Return list of available skill names in this context.
+ */
+export declare function listSkillNamesFromContext(ctx: SkillContext): string[];
+export declare class ListSkillsTool extends AbstractBaseTool {
+    readonly name = "list_skills";
+    readonly description = "List all available skills in the current context with their names and descriptions.";
+    readonly arguments: {};
+    readonly requiredArguments: string[];
+    execute(ctx: SkillContext, _llmArguments: Record<string, unknown>): Promise<string>;
 }
 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 description = "Get a skill by its name. Returns the skill information including the relative paths of the files and their mime type categories.";
     readonly arguments: {
-        name: {
+        skill_name: {
             type: string;
             description: string;
         };
@@ -20,7 +54,7 @@ export declare class GetSkillTool extends AbstractBaseTool {
 }
 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 description: string;
     readonly arguments: {
         skill_name: {
             type: string;
@@ -39,6 +73,13 @@ export declare class GetSkillFileTool extends AbstractBaseTool {
     execute(ctx: SkillContext, llmArguments: Record<string, unknown>): Promise<string>;
 }
 export declare class SkillToolPool extends BaseToolPool {
-    formatContext(client: AcontextClient): SkillContext;
+    /**
+     * Create a SkillContext by preloading skills from a list of skill IDs.
+     *
+     * @param client - The Acontext client instance.
+     * @param skillIds - List of skill UUIDs to preload.
+     * @returns Promise resolving to SkillContext with preloaded skills mapped by name.
+     */
+    formatContext(client: AcontextClient, skillIds: string[]): Promise<SkillContext>;
 }
 export declare const SKILL_TOOLS: SkillToolPool;

package/dist/agent/skill.js

@@ -3,27 +3,95 @@
  * Skill tools for agent operations.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKILL_TOOLS = exports.SkillToolPool = exports.GetSkillFileTool = exports.GetSkillTool = void 0;
+exports.SKILL_TOOLS = exports.SkillToolPool = exports.GetSkillFileTool = exports.GetSkillTool = exports.ListSkillsTool = void 0;
+exports.createSkillContext = createSkillContext;
+exports.getSkillFromContext = getSkillFromContext;
+exports.listSkillNamesFromContext = listSkillNamesFromContext;
 const base_1 = require("./base");
+/**
+ * Create a SkillContext by preloading skills from a list of skill IDs.
+ *
+ * @param client - The Acontext client instance.
+ * @param skillIds - List of skill UUIDs to preload.
+ * @returns SkillContext with preloaded skills mapped by name.
+ * @throws Error if duplicate skill names are found.
+ */
+async function createSkillContext(client, skillIds) {
+    const skills = new Map();
+    for (const skillId of skillIds) {
+        const skill = await client.skills.get(skillId);
+        if (skills.has(skill.name)) {
+            const existingSkill = skills.get(skill.name);
+            throw new Error(`Duplicate skill name '${skill.name}' found. ` +
+                `Existing ID: ${existingSkill.id}, New ID: ${skill.id}`);
+        }
+        skills.set(skill.name, skill);
+    }
+    return { client, skills };
+}
+/**
+ * Get a skill by name from the preloaded skills.
+ *
+ * @param ctx - The skill context.
+ * @param skillName - The name of the skill.
+ * @returns The Skill object.
+ * @throws Error if the skill is not found in the context.
+ */
+function getSkillFromContext(ctx, skillName) {
+    const skill = ctx.skills.get(skillName);
+    if (!skill) {
+        const available = ctx.skills.size > 0 ? Array.from(ctx.skills.keys()).join(', ') : '[none]';
+        throw new Error(`Skill '${skillName}' not found in context. Available skills: ${available}`);
+    }
+    return skill;
+}
+/**
+ * Return list of available skill names in this context.
+ */
+function listSkillNamesFromContext(ctx) {
+    return Array.from(ctx.skills.keys());
+}
+class ListSkillsTool extends base_1.AbstractBaseTool {
+    constructor() {
+        super(...arguments);
+        this.name = 'list_skills';
+        this.description = 'List all available skills in the current context with their names and descriptions.';
+        this.arguments = {};
+        this.requiredArguments = [];
+    }
+    async execute(ctx, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _llmArguments) {
+        if (ctx.skills.size === 0) {
+            return 'No skills available in the current context.';
+        }
+        const skillList = [];
+        for (const [skillName, skill] of ctx.skills.entries()) {
+            skillList.push(`- ${skillName}: ${skill.description}`);
+        }
+        return `Available skills (${ctx.skills.size}):\n${skillList.join('\n')}`;
+    }
+}
+exports.ListSkillsTool = ListSkillsTool;
 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.description = 'Get a skill by its name. Returns the skill information including the relative paths of the files and their mime type categories.';
         this.arguments = {
-            name: {
+            skill_name: {
                 type: 'string',
-                description: 'The name of the skill (unique within project).',
+                description: 'The name of the skill.',
             },
         };
-        this.requiredArguments = ['name'];
+        this.requiredArguments = ['skill_name'];
     }
     async execute(ctx, llmArguments) {
-        const name = llmArguments.name;
-        if (!name) {
-            throw new Error('name is required');
+        const skillName = llmArguments.skill_name;
+        if (!skillName) {
+            throw new Error('skill_name is required');
         }
-        const skill = await ctx.client.skills.getByName(name);
+        const skill = getSkillFromContext(ctx, skillName);
         const fileCount = skill.file_index.length;
         // Format all files with path and MIME type
         let fileList;
@@ -38,9 +106,7 @@ class GetSkillTool extends base_1.AbstractBaseTool {
         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}`);
+            `${fileList}`);
     }
 }
 exports.GetSkillTool = GetSkillTool;
@@ -48,7 +114,8 @@ 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.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')." +
+            'Tips: SKILL.md is the first file you should read to understand the full picture of this skill\'s content.';
         this.arguments = {
             skill_name: {
                 type: 'string',
@@ -69,14 +136,15 @@ class GetSkillFileTool extends base_1.AbstractBaseTool {
         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,
+        if (!filePath) {
+            throw new Error('file_path is required');
+        }
+        const skill = getSkillFromContext(ctx, skillName);
+        const result = await ctx.client.skills.getFile({
+            skillId: skill.id,
             filePath,
             expire: expire || null,
         });
@@ -100,13 +168,19 @@ class GetSkillFileTool extends base_1.AbstractBaseTool {
 }
 exports.GetSkillFileTool = GetSkillFileTool;
 class SkillToolPool extends base_1.BaseToolPool {
-    formatContext(client) {
-        return {
-            client,
-        };
+    /**
+     * Create a SkillContext by preloading skills from a list of skill IDs.
+     *
+     * @param client - The Acontext client instance.
+     * @param skillIds - List of skill UUIDs to preload.
+     * @returns Promise resolving to SkillContext with preloaded skills mapped by name.
+     */
+    async formatContext(client, skillIds) {
+        return createSkillContext(client, skillIds);
     }
 }
 exports.SkillToolPool = SkillToolPool;
 exports.SKILL_TOOLS = new SkillToolPool();
+exports.SKILL_TOOLS.addTool(new ListSkillsTool());
 exports.SKILL_TOOLS.addTool(new GetSkillTool());
 exports.SKILL_TOOLS.addTool(new GetSkillFileTool());

package/dist/resources/disks.d.ts

@@ -3,7 +3,7 @@
  */
 import { RequesterProtocol } from '../client-types';
 import { FileUpload } from '../uploads';
-import { Artifact, Disk, GetArtifactResp, ListArtifactsResp, ListDisksOutput, UpdateArtifactResp } from '../types';
+import { Artifact, Artifacts, Disk, GetArtifactResp, ListArtifactsResp, ListDisksOutput, UpdateArtifactResp } from '../types';
 export declare class DisksAPI {
     artifacts: DiskArtifactsAPI;
     private requester;
@@ -46,4 +46,12 @@ export declare class DiskArtifactsAPI {
     list(diskId: string, options?: {
         path?: string | null;
     }): Promise<ListArtifactsResp>;
+    grepArtifacts(diskId: string, options: {
+        query: string;
+        limit?: number;
+    }): Promise<Artifacts>;
+    globArtifacts(diskId: string, options: {
+        query: string;
+        limit?: number;
+    }): Promise<Artifacts>;
 }

package/dist/resources/disks.js

@@ -102,5 +102,25 @@ class DiskArtifactsAPI {
         });
         return types_1.ListArtifactsRespSchema.parse(data);
     }
+    async grepArtifacts(diskId, options) {
+        const params = (0, utils_1.buildParams)({
+            query: options.query,
+            limit: options.limit ?? 100,
+        });
+        const data = await this.requester.request('GET', `/disk/${diskId}/artifact/grep`, {
+            params,
+        });
+        return types_1.ArtifactsSchema.parse(data);
+    }
+    async globArtifacts(diskId, options) {
+        const params = (0, utils_1.buildParams)({
+            query: options.query,
+            limit: options.limit ?? 100,
+        });
+        const data = await this.requester.request('GET', `/disk/${diskId}/artifact/glob`, {
+            params,
+        });
+        return types_1.ArtifactsSchema.parse(data);
+    }
 }
 exports.DiskArtifactsAPI = DiskArtifactsAPI;

package/dist/resources/skills.d.ts

@@ -29,10 +29,28 @@ export declare class SkillsAPI {
         cursor?: string | null;
         timeDesc?: boolean | null;
     }): Promise<ListSkillsOutput>;
-    getByName(name: string): Promise<Skill>;
+    /**
+     * Get a skill by its ID.
+     *
+     * @param skillId - The UUID of the skill
+     * @returns Skill containing the full skill information including file_index
+     */
+    get(skillId: string): Promise<Skill>;
     delete(skillId: string): Promise<void>;
-    getFileByName(options: {
-        skillName: string;
+    /**
+     * Get a file from a skill by skill ID.
+     *
+     * The backend automatically returns content for parseable text files, or a presigned URL
+     * for non-parseable files (binary, images, etc.).
+     *
+     * @param options - File retrieval options
+     * @param options.skillId - The UUID of the skill
+     * @param options.filePath - Relative path to the file within the skill (e.g., 'scripts/extract_text.json')
+     * @param options.expire - URL expiration time in seconds (defaults to 900 / 15 minutes)
+     * @returns GetSkillFileResp containing the file path, MIME type, and either content or URL
+     */
+    getFile(options: {
+        skillId: string;
         filePath: string;
         expire?: number | null;
     }): Promise<GetSkillFileResp>;

package/dist/resources/skills.js

@@ -4,7 +4,6 @@
  */
 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");
@@ -42,12 +41,6 @@ class SkillsAPI {
      *          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)({
@@ -59,29 +52,36 @@ class SkillsAPI {
         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,
-        });
+        // Zod strips unknown keys, so ListSkillsOutputSchema extracts only name/description
+        return types_1.ListSkillsOutputSchema.parse(data);
     }
-    async getByName(name) {
-        const params = { name };
-        const data = await this.requester.request('GET', '/agent_skills/by_name', {
-            params,
-        });
+    /**
+     * Get a skill by its ID.
+     *
+     * @param skillId - The UUID of the skill
+     * @returns Skill containing the full skill information including file_index
+     */
+    async get(skillId) {
+        const data = await this.requester.request('GET', `/agent_skills/${skillId}`);
         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`;
+    /**
+     * Get a file from a skill by skill ID.
+     *
+     * The backend automatically returns content for parseable text files, or a presigned URL
+     * for non-parseable files (binary, images, etc.).
+     *
+     * @param options - File retrieval options
+     * @param options.skillId - The UUID of the skill
+     * @param options.filePath - Relative path to the file within the skill (e.g., 'scripts/extract_text.json')
+     * @param options.expire - URL expiration time in seconds (defaults to 900 / 15 minutes)
+     * @returns GetSkillFileResp containing the file path, MIME type, and either content or URL
+     */
+    async getFile(options) {
+        const endpoint = `/agent_skills/${options.skillId}/file`;
         const params = {
             file_path: options.filePath,
         };

package/dist/resources/users.d.ts

@@ -2,9 +2,31 @@
  * User management endpoints.
  */
 import { RequesterProtocol } from '../client-types';
+import { GetUserResourcesOutput, ListUsersOutput } from '../types';
 export declare class UsersAPI {
     private requester;
     constructor(requester: RequesterProtocol);
+    /**
+     * List all users in the project.
+     *
+     * @param options - Optional parameters for listing users
+     * @param options.limit - Maximum number of users to return. If not provided or 0, all users will be returned.
+     * @param options.cursor - Cursor for pagination
+     * @param options.timeDesc - Order by created_at descending if true, ascending if false
+     * @returns ListUsersOutput containing the list of users and pagination information
+     */
+    list(options?: {
+        limit?: number | null;
+        cursor?: string | null;
+        timeDesc?: boolean | null;
+    }): Promise<ListUsersOutput>;
+    /**
+     * Get resource counts for a user.
+     *
+     * @param identifier - The user identifier string
+     * @returns GetUserResourcesOutput containing counts for Spaces, Sessions, Disks, and Skills
+     */
+    getResources(identifier: string): Promise<GetUserResourcesOutput>;
     /**
      * Delete a user and cascade delete all associated resources (Space, Session, Disk, Skill).
      *

package/dist/resources/users.js

@@ -4,10 +4,42 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UsersAPI = void 0;
+const utils_1 = require("../utils");
+const types_1 = require("../types");
 class UsersAPI {
     constructor(requester) {
         this.requester = requester;
     }
+    /**
+     * List all users in the project.
+     *
+     * @param options - Optional parameters for listing users
+     * @param options.limit - Maximum number of users to return. If not provided or 0, all users will be returned.
+     * @param options.cursor - Cursor for pagination
+     * @param options.timeDesc - Order by created_at descending if true, ascending if false
+     * @returns ListUsersOutput containing the list of users and pagination information
+     */
+    async list(options) {
+        const params = (0, utils_1.buildParams)({
+            limit: options?.limit ?? null,
+            cursor: options?.cursor ?? null,
+            time_desc: options?.timeDesc ?? null,
+        });
+        const data = await this.requester.request('GET', '/user/ls', {
+            params: Object.keys(params).length > 0 ? params : undefined,
+        });
+        return types_1.ListUsersOutputSchema.parse(data);
+    }
+    /**
+     * Get resource counts for a user.
+     *
+     * @param identifier - The user identifier string
+     * @returns GetUserResourcesOutput containing counts for Spaces, Sessions, Disks, and Skills
+     */
+    async getResources(identifier) {
+        const data = await this.requester.request('GET', `/user/${encodeURIComponent(identifier)}/resources`);
+        return types_1.GetUserResourcesOutputSchema.parse(data);
+    }
     /**
      * Delete a user and cascade delete all associated resources (Space, Session, Disk, Skill).
      *

package/dist/types/disk.d.ts

@@ -31,6 +31,15 @@ export declare const ArtifactSchema: z.ZodObject<{
     updated_at: z.ZodString;
 }, z.core.$strip>;
 export type Artifact = z.infer<typeof ArtifactSchema>;
+export declare const ArtifactsSchema: z.ZodArray<z.ZodObject<{
+    disk_id: z.ZodString;
+    path: z.ZodString;
+    filename: z.ZodString;
+    meta: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>>;
+export type Artifacts = z.infer<typeof ArtifactsSchema>;
 export declare const GetArtifactRespSchema: z.ZodObject<{
     artifact: z.ZodObject<{
         disk_id: z.ZodString;

package/dist/types/disk.js

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

package/dist/types/index.d.ts

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

package/dist/types/index.js

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

package/dist/types/user.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Type definitions for user resources.
+ */
+import { z } from 'zod';
+export declare const UserSchema: z.ZodObject<{
+    id: z.ZodString;
+    project_id: z.ZodString;
+    identifier: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type User = z.infer<typeof UserSchema>;
+export declare const ListUsersOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        project_id: z.ZodString;
+        identifier: z.ZodString;
+        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 ListUsersOutput = z.infer<typeof ListUsersOutputSchema>;
+export declare const UserResourceCountsSchema: z.ZodObject<{
+    spaces_count: z.ZodNumber;
+    sessions_count: z.ZodNumber;
+    disks_count: z.ZodNumber;
+    skills_count: z.ZodNumber;
+}, z.core.$strip>;
+export type UserResourceCounts = z.infer<typeof UserResourceCountsSchema>;
+export declare const GetUserResourcesOutputSchema: z.ZodObject<{
+    counts: z.ZodObject<{
+        spaces_count: z.ZodNumber;
+        sessions_count: z.ZodNumber;
+        disks_count: z.ZodNumber;
+        skills_count: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type GetUserResourcesOutput = z.infer<typeof GetUserResourcesOutputSchema>;

package/dist/types/user.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Type definitions for user resources.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUserResourcesOutputSchema = exports.UserResourceCountsSchema = exports.ListUsersOutputSchema = exports.UserSchema = void 0;
+const zod_1 = require("zod");
+exports.UserSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    project_id: zod_1.z.string(),
+    identifier: zod_1.z.string(),
+    created_at: zod_1.z.string(),
+    updated_at: zod_1.z.string(),
+});
+exports.ListUsersOutputSchema = zod_1.z.object({
+    items: zod_1.z.array(exports.UserSchema),
+    next_cursor: zod_1.z.string().nullable().optional(),
+    has_more: zod_1.z.boolean(),
+});
+exports.UserResourceCountsSchema = zod_1.z.object({
+    spaces_count: zod_1.z.number(),
+    sessions_count: zod_1.z.number(),
+    disks_count: zod_1.z.number(),
+    skills_count: zod_1.z.number(),
+});
+exports.GetUserResourcesOutputSchema = zod_1.z.object({
+    counts: exports.UserResourceCountsSchema,
+});

package/package.json

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