@acontext/acontext 0.1.15 → 0.1.18

package/dist/client.d.ts

@@ -3,6 +3,7 @@
  */
 import { DisksAPI } from './resources/disks';
 import { LearningSpacesAPI } from './resources/learning-spaces';
+import { ProjectAPI } from './resources/project';
 import { SandboxesAPI } from './resources/sandboxes';
 import { SessionsAPI } from './resources/sessions';
 import { SkillsAPI } from './resources/skills';
@@ -26,6 +27,7 @@ export declare class AcontextClient implements RequesterProtocol {
     users: UsersAPI;
     sandboxes: SandboxesAPI;
     learningSpaces: LearningSpacesAPI;
+    project: ProjectAPI;
     constructor(options?: AcontextClientOptions);
     get baseUrl(): string;
     /**

package/dist/client.js

@@ -40,6 +40,7 @@ exports.AcontextClient = void 0;
 const errors_1 = require("./errors");
 const disks_1 = require("./resources/disks");
 const learning_spaces_1 = require("./resources/learning-spaces");
+const project_1 = require("./resources/project");
 const sandboxes_1 = require("./resources/sandboxes");
 const sessions_1 = require("./resources/sessions");
 const skills_1 = require("./resources/skills");
@@ -79,6 +80,7 @@ class AcontextClient {
         this.users = new users_1.UsersAPI(this);
         this.sandboxes = new sandboxes_1.SandboxesAPI(this);
         this.learningSpaces = new learning_spaces_1.LearningSpacesAPI(this);
+        this.project = new project_1.ProjectAPI(this);
     }
     get baseUrl() {
         return this._baseUrl;

package/dist/events.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Session event types for the Acontext SDK.
+ */
+export interface EventPayload {
+    type: string;
+    data: Record<string, unknown>;
+}
+/**
+ * A disk-related event.
+ */
+export declare class DiskEvent {
+    readonly diskId: string;
+    readonly path: string;
+    readonly note?: string;
+    constructor(options: {
+        diskId: string;
+        path: string;
+        note?: string;
+    });
+    toPayload(): EventPayload;
+}
+/**
+ * A free-text event.
+ */
+export declare class TextEvent {
+    readonly text: string;
+    constructor(options: {
+        text: string;
+    });
+    toPayload(): EventPayload;
+}

package/dist/events.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Session event types for the Acontext SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextEvent = exports.DiskEvent = void 0;
+/**
+ * A disk-related event.
+ */
+class DiskEvent {
+    constructor(options) {
+        this.diskId = options.diskId;
+        this.path = options.path;
+        this.note = options.note;
+    }
+    toPayload() {
+        const data = {
+            disk_id: this.diskId,
+            path: this.path,
+        };
+        if (this.note !== undefined) {
+            data.note = this.note;
+        }
+        return { type: 'disk_event', data };
+    }
+}
+exports.DiskEvent = DiskEvent;
+/**
+ * A free-text event.
+ */
+class TextEvent {
+    constructor(options) {
+        this.text = options.text;
+    }
+    toPayload() {
+        return { type: 'text_event', data: { text: this.text } };
+    }
+}
+exports.TextEvent = TextEvent;

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export type { AcontextClientOptions } from './client';
 export { FileUpload } from './uploads';
 export { MessagePart, AcontextMessage, buildAcontextMessage } from './messages';
 export { APIError, TransportError, AcontextError, TimeoutError } from './errors';
+export { DiskEvent, TextEvent } from './events';
+export type { EventPayload } from './events';
 export * from './types';
 export * from './resources';
 export * from './agent';

package/dist/index.js

@@ -17,7 +17,7 @@ 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 });
-exports.TimeoutError = exports.AcontextError = exports.TransportError = exports.APIError = exports.buildAcontextMessage = exports.AcontextMessage = exports.MessagePart = exports.FileUpload = exports.AcontextClient = void 0;
+exports.TextEvent = exports.DiskEvent = exports.TimeoutError = exports.AcontextError = exports.TransportError = exports.APIError = exports.buildAcontextMessage = exports.AcontextMessage = exports.MessagePart = exports.FileUpload = exports.AcontextClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "AcontextClient", { enumerable: true, get: function () { return client_1.AcontextClient; } });
 var uploads_1 = require("./uploads");
@@ -31,6 +31,9 @@ Object.defineProperty(exports, "APIError", { enumerable: true, get: function ()
 Object.defineProperty(exports, "TransportError", { enumerable: true, get: function () { return errors_1.TransportError; } });
 Object.defineProperty(exports, "AcontextError", { enumerable: true, get: function () { return errors_1.AcontextError; } });
 Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+var events_1 = require("./events");
+Object.defineProperty(exports, "DiskEvent", { enumerable: true, get: function () { return events_1.DiskEvent; } });
+Object.defineProperty(exports, "TextEvent", { enumerable: true, get: function () { return events_1.TextEvent; } });
 __exportStar(require("./types"), exports);
 __exportStar(require("./resources"), exports);
 __exportStar(require("./agent"), exports);

package/dist/resources/index.d.ts

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

package/dist/resources/index.js

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

package/dist/resources/project.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Project configuration endpoints.
+ */
+import { RequesterProtocol } from '../client-types';
+import { ProjectConfig, ProjectConfigUpdate } from '../types/project';
+export declare class ProjectAPI {
+    private requester;
+    constructor(requester: RequesterProtocol);
+    /**
+     * Get the project-level configuration.
+     *
+     * @returns ProjectConfig containing the current project configuration
+     */
+    getConfigs(): Promise<ProjectConfig>;
+    /**
+     * Update the project-level configuration by merging keys.
+     * Keys with null values are deleted (reset to default).
+     *
+     * @param configs - Configuration keys to merge
+     * @returns ProjectConfig containing the updated project configuration
+     */
+    updateConfigs(configs: ProjectConfigUpdate): Promise<ProjectConfig>;
+}

package/dist/resources/project.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Project configuration endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectAPI = void 0;
+class ProjectAPI {
+    constructor(requester) {
+        this.requester = requester;
+    }
+    /**
+     * Get the project-level configuration.
+     *
+     * @returns ProjectConfig containing the current project configuration
+     */
+    async getConfigs() {
+        const data = await this.requester.request('GET', '/project/configs');
+        return data;
+    }
+    /**
+     * Update the project-level configuration by merging keys.
+     * Keys with null values are deleted (reset to default).
+     *
+     * @param configs - Configuration keys to merge
+     * @returns ProjectConfig containing the updated project configuration
+     */
+    async updateConfigs(configs) {
+        const data = await this.requester.request('PATCH', '/project/configs', {
+            jsonData: configs,
+        });
+        return data;
+    }
+}
+exports.ProjectAPI = ProjectAPI;

package/dist/resources/sessions.d.ts

@@ -4,7 +4,8 @@
 import { RequesterProtocol } from '../client-types';
 import { AcontextMessage } from '../messages';
 import { FileUpload } from '../uploads';
-import { EditStrategy, CopySessionResult, GetMessagesOutput, GetTasksOutput, ListSessionsOutput, Message, MessageObservingStatus, Session, TokenCounts } from '../types';
+import { EditStrategy, CopySessionResult, GetMessagesOutput, GetTasksOutput, ListEventsOutput, ListSessionsOutput, Message, MessageObservingStatus, Session, SessionEvent, TokenCounts } from '../types';
+import type { EventPayload } from '../events';
 export type MessageBlob = AcontextMessage | Record<string, unknown>;
 export declare class SessionsAPI {
     private requester;
@@ -88,6 +89,28 @@ export declare class SessionsAPI {
         fileField?: string | null;
         file?: FileUpload | null;
     }): Promise<Message>;
+    /**
+     * Add a structured event to a session.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param event - An event object with a toPayload() method (e.g., DiskEvent, TextEvent).
+     * @returns The created SessionEvent object.
+     */
+    addEvent(sessionId: string, event: {
+        toPayload(): EventPayload;
+    }): Promise<SessionEvent>;
+    /**
+     * Get events for a session.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param options - Options for retrieving events.
+     * @returns ListEventsOutput containing the list of events and pagination information.
+     */
+    getEvents(sessionId: string, options?: {
+        limit?: number | null;
+        cursor?: string | null;
+        timeDesc?: boolean | null;
+    }): Promise<ListEventsOutput>;
     /**
      * Get messages for a session.
      *
@@ -96,6 +119,7 @@ export declare class SessionsAPI {
      * @param options.limit - Maximum number of messages to return.
      * @param options.cursor - Cursor for pagination.
      * @param options.withAssetPublicUrl - Whether to include presigned URLs for assets.
+     * @param options.withEvents - Whether to include session events in the response.
      * @param options.format - The format of the messages ('acontext', 'openai', 'anthropic', or 'gemini').
      * @param options.timeDesc - Order by created_at descending if true, ascending if false.
      * @param options.editStrategies - Optional list of edit strategies to apply before format conversion.
@@ -117,6 +141,7 @@ export declare class SessionsAPI {
         limit?: number | null;
         cursor?: string | null;
         withAssetPublicUrl?: boolean | null;
+        withEvents?: boolean | null;
         format?: 'acontext' | 'openai' | 'anthropic' | 'gemini';
         timeDesc?: boolean | null;
         editStrategies?: Array<EditStrategy> | null;

package/dist/resources/sessions.js

@@ -201,6 +201,38 @@ class SessionsAPI {
             return types_1.MessageSchema.parse(data);
         }
     }
+    /**
+     * Add a structured event to a session.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param event - An event object with a toPayload() method (e.g., DiskEvent, TextEvent).
+     * @returns The created SessionEvent object.
+     */
+    async addEvent(sessionId, event) {
+        const payload = event.toPayload();
+        const data = await this.requester.request('POST', `/session/${sessionId}/events`, {
+            jsonData: payload,
+        });
+        return types_1.SessionEventSchema.parse(data);
+    }
+    /**
+     * Get events for a session.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param options - Options for retrieving events.
+     * @returns ListEventsOutput containing the list of events and pagination information.
+     */
+    async getEvents(sessionId, 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', `/session/${sessionId}/events`, {
+            params: Object.keys(params).length > 0 ? params : undefined,
+        });
+        return types_1.ListEventsOutputSchema.parse(data);
+    }
     /**
      * Get messages for a session.
      *
@@ -209,6 +241,7 @@ class SessionsAPI {
      * @param options.limit - Maximum number of messages to return.
      * @param options.cursor - Cursor for pagination.
      * @param options.withAssetPublicUrl - Whether to include presigned URLs for assets.
+     * @param options.withEvents - Whether to include session events in the response.
      * @param options.format - The format of the messages ('acontext', 'openai', 'anthropic', or 'gemini').
      * @param options.timeDesc - Order by created_at descending if true, ascending if false.
      * @param options.editStrategies - Optional list of edit strategies to apply before format conversion.
@@ -237,6 +270,9 @@ class SessionsAPI {
             with_asset_public_url: options?.withAssetPublicUrl ?? null,
             time_desc: options?.timeDesc ?? true, // Default to true
         }));
+        if (options?.withEvents !== undefined && options?.withEvents !== null) {
+            params.with_events = options.withEvents ? 'true' : 'false';
+        }
         if (options?.editStrategies !== undefined && options?.editStrategies !== null) {
             types_1.EditStrategySchema.array().parse(options.editStrategies);
             params.edit_strategies = JSON.stringify(options.editStrategies);

package/dist/types/index.d.ts

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

package/dist/types/index.js

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

package/dist/types/project.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Project configuration types.
+ */
+export interface ProjectConfig {
+    task_success_criteria?: string | null;
+    task_failure_criteria?: string | null;
+    [key: string]: unknown;
+}
+export type ProjectConfigUpdate = Partial<ProjectConfig>;

package/dist/types/project.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Project configuration types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/session.d.ts

@@ -112,6 +112,30 @@ export declare const PublicURLSchema: z.ZodObject<{
     expire_at: z.ZodString;
 }, z.core.$strip>;
 export type PublicURL = z.infer<typeof PublicURLSchema>;
+export declare const SessionEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    session_id: z.ZodString;
+    project_id: z.ZodString;
+    type: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type SessionEvent = z.infer<typeof SessionEventSchema>;
+export declare const ListEventsOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        session_id: z.ZodString;
+        project_id: z.ZodString;
+        type: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    has_more: z.ZodBoolean;
+}, z.core.$strip>;
+export type ListEventsOutput = z.infer<typeof ListEventsOutputSchema>;
 export declare const GetMessagesOutputSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodUnknown>;
     ids: z.ZodArray<z.ZodString>;
@@ -124,6 +148,15 @@ export declare const GetMessagesOutputSchema: z.ZodObject<{
         expire_at: z.ZodString;
     }, z.core.$strip>>>>;
     edit_at_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    events: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        session_id: z.ZodString;
+        project_id: z.ZodString;
+        type: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;
 export type GetMessagesOutput = z.infer<typeof GetMessagesOutputSchema>;
 export declare const GetTasksOutputSchema: z.ZodObject<{

package/dist/types/session.js

@@ -3,7 +3,7 @@
  * Type definitions for session, message, and task resources.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EditStrategySchema = exports.MiddleOutStrategySchema = exports.MiddleOutParamsSchema = exports.TokenLimitStrategySchema = exports.TokenLimitParamsSchema = exports.RemoveToolResultStrategySchema = exports.RemoveToolCallParamsStrategySchema = exports.RemoveToolCallParamsParamsSchema = exports.RemoveToolResultParamsSchema = exports.CopySessionResultSchema = exports.MessageObservingStatusSchema = exports.TokenCountsSchema = exports.GetTasksOutputSchema = exports.GetMessagesOutputSchema = exports.PublicURLSchema = exports.ListSessionsOutputSchema = exports.TaskSchema = exports.TaskDataSchema = exports.SessionSchema = exports.MessageSchema = exports.PartSchema = exports.AssetSchema = void 0;
+exports.EditStrategySchema = exports.MiddleOutStrategySchema = exports.MiddleOutParamsSchema = exports.TokenLimitStrategySchema = exports.TokenLimitParamsSchema = exports.RemoveToolResultStrategySchema = exports.RemoveToolCallParamsStrategySchema = exports.RemoveToolCallParamsParamsSchema = exports.RemoveToolResultParamsSchema = exports.CopySessionResultSchema = exports.MessageObservingStatusSchema = exports.TokenCountsSchema = exports.GetTasksOutputSchema = exports.GetMessagesOutputSchema = exports.ListEventsOutputSchema = exports.SessionEventSchema = exports.PublicURLSchema = exports.ListSessionsOutputSchema = exports.TaskSchema = exports.TaskDataSchema = exports.SessionSchema = exports.MessageSchema = exports.PartSchema = exports.AssetSchema = void 0;
 const zod_1 = require("zod");
 exports.AssetSchema = zod_1.z.object({
     bucket: zod_1.z.string(),
@@ -32,6 +32,7 @@ exports.MessageSchema = zod_1.z.object({
     meta: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
     parts: zod_1.z.array(exports.PartSchema),
     task_id: zod_1.z.string().nullable(),
+    /** Task process status: 'success' | 'failed' | 'running' | 'pending' | 'disable_tracking' | 'limit_exceed' */
     session_task_process_status: zod_1.z.string(),
     created_at: zod_1.z.string(),
     updated_at: zod_1.z.string(),
@@ -75,6 +76,20 @@ exports.PublicURLSchema = zod_1.z.object({
     url: zod_1.z.string(),
     expire_at: zod_1.z.string(),
 });
+exports.SessionEventSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    session_id: zod_1.z.string(),
+    project_id: zod_1.z.string(),
+    type: zod_1.z.string(),
+    data: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    created_at: zod_1.z.string(),
+    updated_at: zod_1.z.string(),
+});
+exports.ListEventsOutputSchema = zod_1.z.object({
+    items: zod_1.z.array(exports.SessionEventSchema),
+    next_cursor: zod_1.z.string().nullable().optional(),
+    has_more: zod_1.z.boolean(),
+});
 exports.GetMessagesOutputSchema = zod_1.z.object({
     items: zod_1.z.array(zod_1.z.unknown()),
     ids: zod_1.z.array(zod_1.z.string()),
@@ -93,6 +108,8 @@ exports.GetMessagesOutputSchema = zod_1.z.object({
      * pin_editing_strategies_at_message in subsequent requests.
      */
     edit_at_message_id: zod_1.z.string().nullable().optional(),
+    /** Session events within the messages time window (only when withEvents is true) */
+    events: zod_1.z.array(exports.SessionEventSchema).nullable().optional(),
 });
 exports.GetTasksOutputSchema = zod_1.z.object({
     items: zod_1.z.array(exports.TaskSchema),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acontext/acontext",
-  "version": "0.1.15",
+  "version": "0.1.18",
   "description": "TypeScript SDK for the Acontext API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -54,5 +54,8 @@
   "files": [
     "dist",
     "README.md"
-  ]
+  ],
+  "overrides": {
+    "minimatch": ">=10.0.1"
+  }
 }