@acontext/acontext 0.0.9 → 0.0.10

package/dist/messages.d.ts

@@ -27,7 +27,6 @@ export declare const AcontextMessageSchema: z.ZodObject<{
     role: z.ZodEnum<{
         user: "user";
         assistant: "assistant";
-        system: "system";
     }>;
     parts: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
@@ -39,14 +38,14 @@ export declare const AcontextMessageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AcontextMessageInput = z.infer<typeof AcontextMessageSchema>;
 export declare class AcontextMessage {
-    role: 'user' | 'assistant' | 'system';
+    role: 'user' | 'assistant';
     parts: MessagePart[];
     meta?: Record<string, unknown> | null;
     constructor(data: AcontextMessageInput);
     toJSON(): AcontextMessageInput;
 }
 export declare function buildAcontextMessage(options: {
-    role: 'user' | 'assistant' | 'system';
+    role: 'user' | 'assistant';
     parts: (MessagePart | string | MessagePartInput)[];
     meta?: Record<string, unknown> | null;
 }): AcontextMessage;

package/dist/messages.js

@@ -44,7 +44,7 @@ class MessagePart {
 }
 exports.MessagePart = MessagePart;
 exports.AcontextMessageSchema = zod_1.z.object({
-    role: zod_1.z.enum(['user', 'assistant', 'system']),
+    role: zod_1.z.enum(['user', 'assistant']),
     parts: zod_1.z.array(exports.MessagePartSchema),
     meta: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable().optional(),
 });
@@ -64,8 +64,8 @@ class AcontextMessage {
 }
 exports.AcontextMessage = AcontextMessage;
 function buildAcontextMessage(options) {
-    if (!['user', 'assistant', 'system'].includes(options.role)) {
-        throw new Error("role must be one of {'user', 'assistant', 'system'}");
+    if (!['user', 'assistant'].includes(options.role)) {
+        throw new Error("role must be one of {'user', 'assistant'}");
     }
     const normalizedParts = options.parts.map((part) => {
         if (part instanceof MessagePart) {

package/dist/resources/sessions.d.ts

@@ -4,7 +4,7 @@
 import { RequesterProtocol } from '../client-types';
 import { AcontextMessage } from '../messages';
 import { FileUpload } from '../uploads';
-import { GetMessagesOutput, GetTasksOutput, LearningStatus, ListSessionsOutput, Message, Session, TokenCounts } from '../types';
+import { EditStrategy, GetMessagesOutput, GetTasksOutput, LearningStatus, ListSessionsOutput, Message, Session, TokenCounts } from '../types';
 export type MessageBlob = AcontextMessage | Record<string, unknown>;
 export declare class SessionsAPI {
     private requester;
@@ -18,6 +18,7 @@ export declare class SessionsAPI {
     }): Promise<ListSessionsOutput>;
     create(options?: {
         spaceId?: string | null;
+        disableTaskTracking?: boolean | null;
         configs?: Record<string, unknown>;
     }): Promise<Session>;
     delete(sessionId: string): Promise<void>;
@@ -38,12 +39,29 @@ export declare class SessionsAPI {
         fileField?: string | null;
         file?: FileUpload | null;
     }): Promise<Message>;
+    /**
+     * Get messages for a session.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param options - Options for retrieving messages.
+     * @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.format - The format of the messages ('acontext', 'openai', or 'anthropic').
+     * @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.
+     *   Examples:
+     *   - Remove tool results: [{ type: 'remove_tool_result', params: { keep_recent_n_tool_results: 3 } }]
+     *   - Token limit: [{ type: 'token_limit', params: { limit_tokens: 20000 } }]
+     * @returns GetMessagesOutput containing the list of messages and pagination information.
+     */
     getMessages(sessionId: string, options?: {
         limit?: number | null;
         cursor?: string | null;
         withAssetPublicUrl?: boolean | null;
         format?: 'acontext' | 'openai' | 'anthropic';
         timeDesc?: boolean | null;
+        editStrategies?: Array<EditStrategy> | null;
     }): Promise<GetMessagesOutput>;
     flush(sessionId: string): Promise<{
         status: number;

package/dist/resources/sessions.js

@@ -32,6 +32,9 @@ class SessionsAPI {
         if (options?.spaceId) {
             payload.space_id = options.spaceId;
         }
+        if (options?.disableTaskTracking !== undefined && options?.disableTaskTracking !== null) {
+            payload.disable_task_tracking = options.disableTaskTracking;
+        }
         if (options?.configs !== undefined) {
             payload.configs = options.configs;
         }
@@ -115,6 +118,22 @@ class SessionsAPI {
             return types_1.MessageSchema.parse(data);
         }
     }
+    /**
+     * Get messages for a session.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param options - Options for retrieving messages.
+     * @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.format - The format of the messages ('acontext', 'openai', or 'anthropic').
+     * @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.
+     *   Examples:
+     *   - Remove tool results: [{ type: 'remove_tool_result', params: { keep_recent_n_tool_results: 3 } }]
+     *   - Token limit: [{ type: 'token_limit', params: { limit_tokens: 20000 } }]
+     * @returns GetMessagesOutput containing the list of messages and pagination information.
+     */
     async getMessages(sessionId, options) {
         const params = {};
         if (options?.format !== undefined) {
@@ -126,6 +145,9 @@ class SessionsAPI {
             with_asset_public_url: options?.withAssetPublicUrl ?? null,
             time_desc: options?.timeDesc ?? true, // Default to true
         }));
+        if (options?.editStrategies !== undefined && options?.editStrategies !== null) {
+            params.edit_strategies = JSON.stringify(options.editStrategies);
+        }
         const data = await this.requester.request('GET', `/session/${sessionId}/messages`, {
             params: Object.keys(params).length > 0 ? params : undefined,
         });

package/dist/resources/spaces.js

@@ -95,7 +95,7 @@ class SpacesAPI {
      */
     async confirmExperience(spaceId, experienceId, options) {
         const payload = { save: options.save };
-        const data = await this.requester.request('PATCH', `/space/${spaceId}/experience_confirmations/${experienceId}`, { jsonData: payload });
+        const data = await this.requester.request('PUT', `/space/${spaceId}/experience_confirmations/${experienceId}`, { jsonData: payload });
         if (data === null || data === undefined) {
             return null;
         }

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;
+    disable_task_tracking: z.ZodBoolean;
     space_id: z.ZodNullable<z.ZodString>;
     configs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     created_at: z.ZodString;
@@ -78,6 +79,7 @@ export declare const ListSessionsOutputSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         project_id: z.ZodString;
+        disable_task_tracking: z.ZodBoolean;
         space_id: z.ZodNullable<z.ZodString>;
         configs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         created_at: z.ZodString;
@@ -128,3 +130,64 @@ export declare const TokenCountsSchema: z.ZodObject<{
     total_tokens: z.ZodNumber;
 }, z.core.$strip>;
 export type TokenCounts = z.infer<typeof TokenCountsSchema>;
+/**
+ * Parameters for the remove_tool_result edit strategy.
+ */
+export declare const RemoveToolResultParamsSchema: z.ZodObject<{
+    keep_recent_n_tool_results: z.ZodOptional<z.ZodNumber>;
+    tool_result_placeholder: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RemoveToolResultParams = z.infer<typeof RemoveToolResultParamsSchema>;
+/**
+ * Edit strategy to replace old tool results with placeholder text.
+ *
+ * Example: { type: 'remove_tool_result', params: { keep_recent_n_tool_results: 5, tool_result_placeholder: 'Cleared' } }
+ */
+export declare const RemoveToolResultStrategySchema: z.ZodObject<{
+    type: z.ZodLiteral<"remove_tool_result">;
+    params: z.ZodObject<{
+        keep_recent_n_tool_results: z.ZodOptional<z.ZodNumber>;
+        tool_result_placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RemoveToolResultStrategy = z.infer<typeof RemoveToolResultStrategySchema>;
+/**
+ * Parameters for the token_limit edit strategy.
+ */
+export declare const TokenLimitParamsSchema: z.ZodObject<{
+    limit_tokens: z.ZodNumber;
+}, z.core.$strip>;
+export type TokenLimitParams = z.infer<typeof TokenLimitParamsSchema>;
+/**
+ * Edit strategy to truncate messages based on token count.
+ *
+ * Removes oldest messages until the total token count is within the specified limit.
+ * Maintains tool-call/tool-result pairing - when removing a message with tool-calls,
+ * the corresponding tool-result messages are also removed.
+ *
+ * Example: { type: 'token_limit', params: { limit_tokens: 20000 } }
+ */
+export declare const TokenLimitStrategySchema: z.ZodObject<{
+    type: z.ZodLiteral<"token_limit">;
+    params: z.ZodObject<{
+        limit_tokens: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type TokenLimitStrategy = z.infer<typeof TokenLimitStrategySchema>;
+/**
+ * Union schema for all edit strategies.
+ * When adding new strategies, extend this union: z.union([RemoveToolResultStrategySchema, OtherStrategySchema, ...])
+ */
+export declare const EditStrategySchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"remove_tool_result">;
+    params: z.ZodObject<{
+        keep_recent_n_tool_results: z.ZodOptional<z.ZodNumber>;
+        tool_result_placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"token_limit">;
+    params: z.ZodObject<{
+        limit_tokens: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>]>;
+export type EditStrategy = z.infer<typeof EditStrategySchema>;

package/dist/types/session.js

@@ -3,7 +3,7 @@
  * Type definitions for session, message, and task resources.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenCountsSchema = exports.LearningStatusSchema = exports.GetTasksOutputSchema = exports.GetMessagesOutputSchema = exports.PublicURLSchema = exports.ListSessionsOutputSchema = exports.TaskSchema = exports.SessionSchema = exports.MessageSchema = exports.PartSchema = exports.AssetSchema = void 0;
+exports.EditStrategySchema = exports.TokenLimitStrategySchema = exports.TokenLimitParamsSchema = exports.RemoveToolResultStrategySchema = exports.RemoveToolResultParamsSchema = exports.TokenCountsSchema = exports.LearningStatusSchema = exports.GetTasksOutputSchema = exports.GetMessagesOutputSchema = exports.PublicURLSchema = exports.ListSessionsOutputSchema = exports.TaskSchema = 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(),
@@ -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(),
+    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(),
     created_at: zod_1.z.string(),
@@ -79,3 +80,59 @@ exports.LearningStatusSchema = zod_1.z.object({
 exports.TokenCountsSchema = zod_1.z.object({
     total_tokens: zod_1.z.number(),
 });
+/**
+ * Parameters for the remove_tool_result edit strategy.
+ */
+exports.RemoveToolResultParamsSchema = zod_1.z.object({
+    /**
+     * Number of most recent tool results to keep with original content.
+     * @default 3
+     */
+    keep_recent_n_tool_results: zod_1.z.number().optional(),
+    /**
+     * Custom text to replace old tool results with.
+     * @default "Done"
+     */
+    tool_result_placeholder: zod_1.z.string().optional(),
+});
+/**
+ * Edit strategy to replace old tool results with placeholder text.
+ *
+ * Example: { type: 'remove_tool_result', params: { keep_recent_n_tool_results: 5, tool_result_placeholder: 'Cleared' } }
+ */
+exports.RemoveToolResultStrategySchema = zod_1.z.object({
+    type: zod_1.z.literal('remove_tool_result'),
+    params: exports.RemoveToolResultParamsSchema,
+});
+/**
+ * Parameters for the token_limit edit strategy.
+ */
+exports.TokenLimitParamsSchema = zod_1.z.object({
+    /**
+     * Maximum number of tokens to keep. Required parameter.
+     * Messages will be removed from oldest to newest until total tokens <= limit_tokens.
+     * Tool-call and tool-result pairs are always removed together.
+     */
+    limit_tokens: zod_1.z.number(),
+});
+/**
+ * Edit strategy to truncate messages based on token count.
+ *
+ * Removes oldest messages until the total token count is within the specified limit.
+ * Maintains tool-call/tool-result pairing - when removing a message with tool-calls,
+ * the corresponding tool-result messages are also removed.
+ *
+ * Example: { type: 'token_limit', params: { limit_tokens: 20000 } }
+ */
+exports.TokenLimitStrategySchema = zod_1.z.object({
+    type: zod_1.z.literal('token_limit'),
+    params: exports.TokenLimitParamsSchema,
+});
+/**
+ * Union schema for all edit strategies.
+ * When adding new strategies, extend this union: z.union([RemoveToolResultStrategySchema, OtherStrategySchema, ...])
+ */
+exports.EditStrategySchema = zod_1.z.union([
+    exports.RemoveToolResultStrategySchema,
+    exports.TokenLimitStrategySchema,
+]);

package/package.json

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