@acontext/acontext 0.1.4 → 0.1.6

package/dist/client.d.ts

@@ -4,7 +4,6 @@
 import { DisksAPI } from './resources/disks';
 import { SandboxesAPI } from './resources/sandboxes';
 import { SessionsAPI } from './resources/sessions';
-import { ToolsAPI } from './resources/tools';
 import { SkillsAPI } from './resources/skills';
 import { UsersAPI } from './resources/users';
 import { RequesterProtocol } from './client-types';
@@ -22,7 +21,6 @@ export declare class AcontextClient implements RequesterProtocol {
     sessions: SessionsAPI;
     disks: DisksAPI;
     artifacts: DisksAPI['artifacts'];
-    tools: ToolsAPI;
     skills: SkillsAPI;
     users: UsersAPI;
     sandboxes: SandboxesAPI;

package/dist/client.js

@@ -41,7 +41,6 @@ const errors_1 = require("./errors");
 const disks_1 = require("./resources/disks");
 const sandboxes_1 = require("./resources/sandboxes");
 const sessions_1 = require("./resources/sessions");
-const tools_1 = require("./resources/tools");
 const skills_1 = require("./resources/skills");
 const users_1 = require("./resources/users");
 const constants_1 = require("./constants");
@@ -75,7 +74,6 @@ class AcontextClient {
         this.sessions = new sessions_1.SessionsAPI(this);
         this.disks = new disks_1.DisksAPI(this);
         this.artifacts = this.disks.artifacts;
-        this.tools = new tools_1.ToolsAPI(this);
         this.skills = new skills_1.SkillsAPI(this);
         this.users = new users_1.UsersAPI(this);
         this.sandboxes = new sandboxes_1.SandboxesAPI(this);

package/dist/resources/index.d.ts

@@ -3,7 +3,6 @@
  */
 export * from './sessions';
 export * from './disks';
-export * from './tools';
 export * from './skills';
 export * from './sandboxes';
 export * from './users';

package/dist/resources/index.js

@@ -19,7 +19,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./sessions"), exports);
 __exportStar(require("./disks"), exports);
-__exportStar(require("./tools"), exports);
 __exportStar(require("./skills"), exports);
 __exportStar(require("./sandboxes"), exports);
 __exportStar(require("./users"), exports);

package/dist/resources/sessions.d.ts

@@ -30,10 +30,22 @@ export declare class SessionsAPI {
         timeDesc?: boolean | null;
         filterByConfigs?: Record<string, unknown> | null;
     }): Promise<ListSessionsOutput>;
+    /**
+     * Create a new session.
+     *
+     * @param options - Options for creating a session.
+     * @param options.user - Optional user identifier string.
+     * @param options.disableTaskTracking - Whether to disable task tracking for this session.
+     * @param options.configs - Optional session configuration dictionary.
+     * @param options.useUuid - Optional UUID string to use as the session ID. If not provided, a UUID will be auto-generated.
+     *   If a session with this UUID already exists, a 409 Conflict error will be raised.
+     * @returns The created Session object.
+     */
     create(options?: {
         user?: string | null;
         disableTaskTracking?: boolean | null;
         configs?: Record<string, unknown>;
+        useUuid?: string | null;
     }): Promise<Session>;
     delete(sessionId: string): Promise<void>;
     updateConfigs(sessionId: string, options: {
@@ -56,8 +68,23 @@ export declare class SessionsAPI {
     getSessionSummary(sessionId: string, options?: {
         limit?: number | null;
     }): Promise<string>;
+    /**
+     * Store a message to a session.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param blob - The message blob in Acontext, OpenAI, Anthropic, or Gemini format.
+     * @param options - Options for storing the message.
+     * @param options.format - The format of the message blob ('acontext', 'openai', 'anthropic', or 'gemini').
+     * @param options.meta - Optional user-provided metadata for the message. This metadata is stored
+     *   separately from the message content and can be retrieved via getMessages().metas
+     *   or updated via patchMessageMeta(). Works with all formats.
+     * @param options.fileField - The field name for file upload. Only used when format is 'acontext'.
+     * @param options.file - Optional file upload. Only used when format is 'acontext'.
+     * @returns The created Message object. The msg.meta field contains only user-provided metadata.
+     */
     storeMessage(sessionId: string, blob: MessageBlob, options?: {
         format?: 'acontext' | 'openai' | 'anthropic' | 'gemini';
+        meta?: Record<string, unknown> | null;
         fileField?: string | null;
         file?: FileUpload | null;
     }): Promise<Message>;
@@ -114,4 +141,55 @@ export declare class SessionsAPI {
      *          pending counts and updated_at timestamp.
      */
     messagesObservingStatus(sessionId: string): Promise<MessageObservingStatus>;
+    /**
+     * Update message metadata using patch semantics.
+     *
+     * Only updates keys present in the meta object. Existing keys not in the request
+     * are preserved. To delete a key, pass null as its value.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param messageId - The UUID of the message.
+     * @param meta - Object of metadata keys to add, update, or delete. Pass null as a value to delete that key.
+     * @returns The complete user metadata after the patch operation.
+     *
+     * @example
+     * // Add/update keys
+     * const updated = await client.sessions.patchMessageMeta(
+     *   sessionId, messageId,
+     *   { status: 'processed', score: 0.95 }
+     * );
+     *
+     * @example
+     * // Delete a key
+     * const updated = await client.sessions.patchMessageMeta(
+     *   sessionId, messageId,
+     *   { old_key: null }  // Deletes "old_key"
+     * );
+     */
+    patchMessageMeta(sessionId: string, messageId: string, meta: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Update session configs using patch semantics.
+     *
+     * Only updates keys present in the configs object. Existing keys not in the request
+     * are preserved. To delete a key, pass null as its value.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param configs - Object of config keys to add, update, or delete. Pass null as a value to delete that key.
+     * @returns The complete configs after the patch operation.
+     *
+     * @example
+     * // Add/update keys
+     * const updated = await client.sessions.patchConfigs(
+     *   sessionId,
+     *   { agent: 'bot2', temperature: 0.8 }
+     * );
+     *
+     * @example
+     * // Delete a key
+     * const updated = await client.sessions.patchConfigs(
+     *   sessionId,
+     *   { old_key: null }  // Deletes "old_key"
+     * );
+     */
+    patchConfigs(sessionId: string, configs: Record<string, unknown>): Promise<Record<string, unknown>>;
 }

package/dist/resources/sessions.js

@@ -44,6 +44,17 @@ class SessionsAPI {
         });
         return types_1.ListSessionsOutputSchema.parse(data);
     }
+    /**
+     * Create a new session.
+     *
+     * @param options - Options for creating a session.
+     * @param options.user - Optional user identifier string.
+     * @param options.disableTaskTracking - Whether to disable task tracking for this session.
+     * @param options.configs - Optional session configuration dictionary.
+     * @param options.useUuid - Optional UUID string to use as the session ID. If not provided, a UUID will be auto-generated.
+     *   If a session with this UUID already exists, a 409 Conflict error will be raised.
+     * @returns The created Session object.
+     */
     async create(options) {
         const payload = {};
         if (options?.user !== undefined && options?.user !== null) {
@@ -55,6 +66,9 @@ class SessionsAPI {
         if (options?.configs !== undefined) {
             payload.configs = options.configs;
         }
+        if (options?.useUuid !== undefined && options?.useUuid !== null) {
+            payload.use_uuid = options.useUuid;
+        }
         const data = await this.requester.request('POST', '/session', {
             jsonData: Object.keys(payload).length > 0 ? payload : undefined,
         });
@@ -125,6 +139,20 @@ class SessionsAPI {
         }
         return parts.join('\n');
     }
+    /**
+     * Store a message to a session.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param blob - The message blob in Acontext, OpenAI, Anthropic, or Gemini format.
+     * @param options - Options for storing the message.
+     * @param options.format - The format of the message blob ('acontext', 'openai', 'anthropic', or 'gemini').
+     * @param options.meta - Optional user-provided metadata for the message. This metadata is stored
+     *   separately from the message content and can be retrieved via getMessages().metas
+     *   or updated via patchMessageMeta(). Works with all formats.
+     * @param options.fileField - The field name for file upload. Only used when format is 'acontext'.
+     * @param options.file - Optional file upload. Only used when format is 'acontext'.
+     * @returns The created Message object. The msg.meta field contains only user-provided metadata.
+     */
     async storeMessage(sessionId, blob, options) {
         const format = options?.format ?? 'openai';
         if (!['acontext', 'openai', 'anthropic', 'gemini'].includes(format)) {
@@ -136,6 +164,9 @@ class SessionsAPI {
         const payload = {
             format,
         };
+        if (options?.meta !== undefined && options?.meta !== null) {
+            payload.meta = options.meta;
+        }
         if (format === 'acontext') {
             if (blob instanceof messages_1.AcontextMessage) {
                 payload.blob = blob.toJSON();
@@ -242,5 +273,68 @@ class SessionsAPI {
         const data = await this.requester.request('GET', `/session/${sessionId}/observing_status`);
         return types_1.MessageObservingStatusSchema.parse(data);
     }
+    /**
+     * Update message metadata using patch semantics.
+     *
+     * Only updates keys present in the meta object. Existing keys not in the request
+     * are preserved. To delete a key, pass null as its value.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param messageId - The UUID of the message.
+     * @param meta - Object of metadata keys to add, update, or delete. Pass null as a value to delete that key.
+     * @returns The complete user metadata after the patch operation.
+     *
+     * @example
+     * // Add/update keys
+     * const updated = await client.sessions.patchMessageMeta(
+     *   sessionId, messageId,
+     *   { status: 'processed', score: 0.95 }
+     * );
+     *
+     * @example
+     * // Delete a key
+     * const updated = await client.sessions.patchMessageMeta(
+     *   sessionId, messageId,
+     *   { old_key: null }  // Deletes "old_key"
+     * );
+     */
+    async patchMessageMeta(sessionId, messageId, meta) {
+        const payload = { meta };
+        const data = await this.requester.request('PATCH', `/session/${sessionId}/messages/${messageId}/meta`, {
+            jsonData: payload,
+        });
+        return data.meta ?? {};
+    }
+    /**
+     * Update session configs using patch semantics.
+     *
+     * Only updates keys present in the configs object. Existing keys not in the request
+     * are preserved. To delete a key, pass null as its value.
+     *
+     * @param sessionId - The UUID of the session.
+     * @param configs - Object of config keys to add, update, or delete. Pass null as a value to delete that key.
+     * @returns The complete configs after the patch operation.
+     *
+     * @example
+     * // Add/update keys
+     * const updated = await client.sessions.patchConfigs(
+     *   sessionId,
+     *   { agent: 'bot2', temperature: 0.8 }
+     * );
+     *
+     * @example
+     * // Delete a key
+     * const updated = await client.sessions.patchConfigs(
+     *   sessionId,
+     *   { old_key: null }  // Deletes "old_key"
+     * );
+     */
+    async patchConfigs(sessionId, configs) {
+        const payload = { configs };
+        const data = await this.requester.request('PATCH', `/session/${sessionId}/configs`, {
+            jsonData: payload,
+        });
+        return data.configs ?? {};
+    }
 }
 exports.SessionsAPI = SessionsAPI;

package/dist/types/common.d.ts

@@ -7,3 +7,8 @@ export declare const FileContentSchema: z.ZodObject<{
     raw: z.ZodString;
 }, z.core.$strip>;
 export type FileContent = z.infer<typeof FileContentSchema>;
+export declare const FlagResponseSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    errmsg: z.ZodString;
+}, z.core.$strip>;
+export type FlagResponse = z.infer<typeof FlagResponseSchema>;

package/dist/types/common.js

@@ -3,9 +3,13 @@
  * Common type definitions shared across modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileContentSchema = void 0;
+exports.FlagResponseSchema = exports.FileContentSchema = void 0;
 const zod_1 = require("zod");
 exports.FileContentSchema = zod_1.z.object({
     type: zod_1.z.string(),
     raw: zod_1.z.string(),
 });
+exports.FlagResponseSchema = zod_1.z.object({
+    status: zod_1.z.number(),
+    errmsg: zod_1.z.string(),
+});

package/dist/types/index.d.ts

@@ -4,7 +4,6 @@
 export * from './common';
 export * from './session';
 export * from './disk';
-export * from './tool';
 export * from './skill';
 export * from './sandbox';
 export * from './user';

package/dist/types/index.js

@@ -20,7 +20,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common"), exports);
 __exportStar(require("./session"), exports);
 __exportStar(require("./disk"), exports);
-__exportStar(require("./tool"), exports);
 __exportStar(require("./skill"), exports);
 __exportStar(require("./sandbox"), exports);
 __exportStar(require("./user"), exports);

package/dist/types/session.d.ts

@@ -111,6 +111,7 @@ export type PublicURL = z.infer<typeof PublicURLSchema>;
 export declare const GetMessagesOutputSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodUnknown>;
     ids: z.ZodArray<z.ZodString>;
+    metas: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     has_more: z.ZodBoolean;
     this_time_tokens: z.ZodNumber;

package/dist/types/session.js

@@ -74,6 +74,8 @@ exports.PublicURLSchema = zod_1.z.object({
 exports.GetMessagesOutputSchema = zod_1.z.object({
     items: zod_1.z.array(zod_1.z.unknown()),
     ids: zod_1.z.array(zod_1.z.string()),
+    /** User-provided metadata for each message (same order as items/ids) */
+    metas: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).default([]),
     next_cursor: zod_1.z.string().nullable().optional(),
     has_more: zod_1.z.boolean(),
     /** Total token count of the returned messages */

package/package.json

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

package/dist/resources/tools.d.ts

@@ -1,13 +0,0 @@
-/**
- * Tool endpoints.
- */
-import { RequesterProtocol } from '../client-types';
-import { ToolRenameItem, ToolReferenceData, FlagResponse } from '../types/tool';
-export declare class ToolsAPI {
-    private requester;
-    constructor(requester: RequesterProtocol);
-    renameToolName(options: {
-        rename: ToolRenameItem[];
-    }): Promise<FlagResponse>;
-    getToolName(): Promise<ToolReferenceData[]>;
-}

package/dist/resources/tools.js

@@ -1,26 +0,0 @@
-"use strict";
-/**
- * Tool endpoints.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolsAPI = void 0;
-const tool_1 = require("../types/tool");
-class ToolsAPI {
-    constructor(requester) {
-        this.requester = requester;
-    }
-    async renameToolName(options) {
-        const payload = { rename: options.rename };
-        const data = await this.requester.request('PUT', '/tool/name', {
-            jsonData: payload,
-        });
-        return tool_1.FlagResponseSchema.parse(data);
-    }
-    async getToolName() {
-        const data = await this.requester.request('GET', '/tool/name');
-        return Array.isArray(data)
-            ? data.map((item) => tool_1.ToolReferenceDataSchema.parse(item))
-            : [];
-    }
-}
-exports.ToolsAPI = ToolsAPI;

package/dist/types/tool.d.ts

@@ -1,19 +0,0 @@
-/**
- * Type definitions for tool resources.
- */
-import { z } from 'zod';
-export declare const ToolRenameItemSchema: z.ZodObject<{
-    oldName: z.ZodString;
-    newName: z.ZodString;
-}, z.core.$strip>;
-export type ToolRenameItem = z.infer<typeof ToolRenameItemSchema>;
-export declare const ToolReferenceDataSchema: z.ZodObject<{
-    name: z.ZodString;
-    sop_count: z.ZodNumber;
-}, z.core.$strip>;
-export type ToolReferenceData = z.infer<typeof ToolReferenceDataSchema>;
-export declare const FlagResponseSchema: z.ZodObject<{
-    status: z.ZodNumber;
-    errmsg: z.ZodString;
-}, z.core.$strip>;
-export type FlagResponse = z.infer<typeof FlagResponseSchema>;

package/dist/types/tool.js

@@ -1,19 +0,0 @@
-"use strict";
-/**
- * Type definitions for tool resources.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlagResponseSchema = exports.ToolReferenceDataSchema = exports.ToolRenameItemSchema = void 0;
-const zod_1 = require("zod");
-exports.ToolRenameItemSchema = zod_1.z.object({
-    oldName: zod_1.z.string(),
-    newName: zod_1.z.string(),
-});
-exports.ToolReferenceDataSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    sop_count: zod_1.z.number(),
-});
-exports.FlagResponseSchema = zod_1.z.object({
-    status: zod_1.z.number(),
-    errmsg: zod_1.z.string(),
-});