@acontext/acontext 0.1.5 → 0.1.6

package/dist/resources/sessions.d.ts

@@ -68,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>;
@@ -126,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

@@ -139,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)) {
@@ -150,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();
@@ -256,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/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.5",
+  "version": "0.1.6",
   "description": "TypeScript SDK for the Acontext API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",