@acontext/acontext 0.0.20 → 0.0.21

package/dist/resources/sessions.d.ts

@@ -36,6 +36,17 @@ export declare class SessionsAPI {
         cursor?: string | null;
         timeDesc?: boolean | null;
     }): Promise<GetTasksOutput>;
+    /**
+     * Get a summary of all tasks in a session as a formatted string.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param options - Options for retrieving the summary.
+     * @param options.limit - Maximum number of tasks to include in the summary.
+     * @returns A formatted string containing the session summary with all task information.
+     */
+    getSessionSummary(sessionId: string, options?: {
+        limit?: number | null;
+    }): Promise<string>;
     storeMessage(sessionId: string, blob: MessageBlob, options?: {
         format?: 'acontext' | 'openai' | 'anthropic' | 'gemini';
         fileField?: string | null;
@@ -54,6 +65,7 @@ export declare class SessionsAPI {
      * @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 } }]
+     *   - Middle out: [{ type: 'middle_out', params: { token_reduce_to: 5000 } }]
      *   - 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,

package/dist/resources/sessions.js

@@ -79,6 +79,47 @@ class SessionsAPI {
         });
         return types_1.GetTasksOutputSchema.parse(data);
     }
+    /**
+     * Get a summary of all tasks in a session as a formatted string.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param options - Options for retrieving the summary.
+     * @param options.limit - Maximum number of tasks to include in the summary.
+     * @returns A formatted string containing the session summary with all task information.
+     */
+    async getSessionSummary(sessionId, options) {
+        const tasksOutput = await this.getTasks(sessionId, {
+            limit: options?.limit,
+            timeDesc: false,
+        });
+        const tasks = tasksOutput.items;
+        if (tasks.length === 0) {
+            return '';
+        }
+        const parts = [];
+        for (const task of tasks) {
+            const taskLines = [
+                `<task id="${task.order}" description="${task.data.task_description}">`
+            ];
+            if (task.data.progresses && task.data.progresses.length > 0) {
+                taskLines.push('<progress>');
+                task.data.progresses.forEach((p, i) => {
+                    taskLines.push(`${i + 1}. ${p}`);
+                });
+                taskLines.push('</progress>');
+            }
+            if (task.data.user_preferences && task.data.user_preferences.length > 0) {
+                taskLines.push('<user_preference>');
+                task.data.user_preferences.forEach((pref, i) => {
+                    taskLines.push(`${i + 1}. ${pref}`);
+                });
+                taskLines.push('</user_preference>');
+            }
+            taskLines.push('</task>');
+            parts.push(taskLines.join('\n'));
+        }
+        return parts.join('\n');
+    }
     async storeMessage(sessionId, blob, options) {
         const format = options?.format ?? 'openai';
         if (!['acontext', 'openai', 'anthropic', 'gemini'].includes(format)) {
@@ -137,6 +178,7 @@ class SessionsAPI {
      * @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 } }]
+     *   - Middle out: [{ type: 'middle_out', params: { token_reduce_to: 5000 } }]
      *   - 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,

package/dist/resources/skills.d.ts

@@ -23,7 +23,7 @@ export declare class SkillsAPI {
      * @returns ListSkillsOutput containing skills with name and description for the current page,
      *          along with pagination information (next_cursor and has_more)
      */
-    list_catalog(options?: {
+    listCatalog(options?: {
         user?: string | null;
         limit?: number | null;
         cursor?: string | null;

package/dist/resources/skills.js

@@ -40,7 +40,7 @@ class SkillsAPI {
      * @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) {
+    async listCatalog(options) {
         // Use 100 as default for catalog listing (only name and description, lightweight)
         const effectiveLimit = options?.limit ?? 100;
         const params = (0, utils_1.buildParams)({

package/dist/types/session.d.ts

@@ -235,6 +235,25 @@ export declare const TokenLimitStrategySchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type TokenLimitStrategy = z.infer<typeof TokenLimitStrategySchema>;
+/**
+ * Parameters for the middle_out edit strategy.
+ */
+export declare const MiddleOutParamsSchema: z.ZodObject<{
+    token_reduce_to: z.ZodNumber;
+}, z.core.$strip>;
+export type MiddleOutParams = z.infer<typeof MiddleOutParamsSchema>;
+/**
+ * Edit strategy to reduce prompt size by removing middle messages.
+ *
+ * Example: { type: 'middle_out', params: { token_reduce_to: 5000 } }
+ */
+export declare const MiddleOutStrategySchema: z.ZodObject<{
+    type: z.ZodLiteral<"middle_out">;
+    params: z.ZodObject<{
+        token_reduce_to: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type MiddleOutStrategy = z.infer<typeof MiddleOutStrategySchema>;
 /**
  * Union schema for all edit strategies.
  * When adding new strategies, extend this union: z.union([RemoveToolResultStrategySchema, OtherStrategySchema, ...])
@@ -257,5 +276,10 @@ export declare const EditStrategySchema: z.ZodUnion<readonly [z.ZodObject<{
     params: z.ZodObject<{
         limit_tokens: z.ZodNumber;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"middle_out">;
+    params: z.ZodObject<{
+        token_reduce_to: 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.EditStrategySchema = exports.TokenLimitStrategySchema = exports.TokenLimitParamsSchema = exports.RemoveToolResultStrategySchema = exports.RemoveToolCallParamsStrategySchema = exports.RemoveToolCallParamsParamsSchema = exports.RemoveToolResultParamsSchema = exports.MessageObservingStatusSchema = exports.TokenCountsSchema = exports.LearningStatusSchema = 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.MessageObservingStatusSchema = exports.TokenCountsSchema = exports.LearningStatusSchema = exports.GetTasksOutputSchema = exports.GetMessagesOutputSchema = 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(),
@@ -190,6 +190,21 @@ exports.TokenLimitStrategySchema = zod_1.z.object({
     type: zod_1.z.literal('token_limit'),
     params: exports.TokenLimitParamsSchema,
 });
+/**
+ * Parameters for the middle_out edit strategy.
+ */
+exports.MiddleOutParamsSchema = zod_1.z.object({
+    token_reduce_to: zod_1.z.number(),
+});
+/**
+ * Edit strategy to reduce prompt size by removing middle messages.
+ *
+ * Example: { type: 'middle_out', params: { token_reduce_to: 5000 } }
+ */
+exports.MiddleOutStrategySchema = zod_1.z.object({
+    type: zod_1.z.literal('middle_out'),
+    params: exports.MiddleOutParamsSchema,
+});
 /**
  * Union schema for all edit strategies.
  * When adding new strategies, extend this union: z.union([RemoveToolResultStrategySchema, OtherStrategySchema, ...])
@@ -198,4 +213,5 @@ exports.EditStrategySchema = zod_1.z.union([
     exports.RemoveToolResultStrategySchema,
     exports.RemoveToolCallParamsStrategySchema,
     exports.TokenLimitStrategySchema,
+    exports.MiddleOutStrategySchema,
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acontext/acontext",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "description": "TypeScript SDK for the Acontext API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,6 +9,7 @@
     "dev": "tsc --watch",
     "test": "jest",
     "lint": "eslint src",
+    "e2e": "tsx examples/basic-usage.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -35,6 +36,7 @@
     "eslint": "^9.39.1",
     "jest": "^30.2.0",
     "ts-jest": "^29.4.5",
+    "tsx": "^4.19.0",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {