@acontext/acontext 0.0.18 → 0.0.19

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/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/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.19",
   "description": "TypeScript SDK for the Acontext API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",