@papr/memory 1.19.0 → 2.0.0

package/resources/messages/messages.js

@@ -0,0 +1,54 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const SessionsAPI = tslib_1.__importStar(require("./sessions.js"));
+const sessions_1 = require("./sessions.js");
+class Messages extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.sessions = new SessionsAPI.Sessions(this._client);
+    }
+    /**
+     * Store a chat message and queue it for AI analysis and memory creation.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     **Processing Control**:
+     *     - Set `process_messages: true` (default) to enable full AI analysis and memory creation
+     *     - Set `process_messages: false` to store messages only without processing into memories
+     *
+     *     **Processing Flow** (when process_messages=true):
+     *     1. Message is immediately stored in PostMessage class
+     *     2. Background processing analyzes the message for memory-worthiness
+     *     3. If worthy, creates a memory with appropriate role-based categorization
+     *     4. Links the message to the created memory
+     *
+     *     **Role-Based Categories**:
+     *     - **User messages**: preference, task, goal, facts, context
+     *     - **Assistant messages**: skills, learning
+     *
+     *     **Session Management**:
+     *     - `sessionId` is required to group related messages
+     *     - Use the same `sessionId` for an entire conversation
+     *     - **Optional `title`**: Set a human-readable title for the conversation (e.g., "Q4 Planning Session")
+     *     - Retrieve conversation history using GET /messages/sessions/{sessionId}
+     *
+     * @example
+     * ```ts
+     * const response = await client.messages.store({
+     *   content: 'string',
+     *   role: 'user',
+     *   sessionId: 'sessionId',
+     * });
+     * ```
+     */
+    store(body, options) {
+        return this._client.post('/v1/messages', { body, ...options });
+    }
+}
+exports.Messages = Messages;
+Messages.Sessions = sessions_1.Sessions;
+//# sourceMappingURL=messages.js.map

package/resources/messages/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/resources/messages/messages.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAGlD,mEAA0C;AAC1C,4CAOoB;AAIpB,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAuC1E,CAAC;IArCC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,IAAwB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AAxCD,4BAwCC;AA0HD,QAAQ,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}

package/resources/messages/messages.mjs

@@ -0,0 +1,49 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as SessionsAPI from "./sessions.mjs";
+import { Sessions, } from "./sessions.mjs";
+export class Messages extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.sessions = new SessionsAPI.Sessions(this._client);
+    }
+    /**
+     * Store a chat message and queue it for AI analysis and memory creation.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     **Processing Control**:
+     *     - Set `process_messages: true` (default) to enable full AI analysis and memory creation
+     *     - Set `process_messages: false` to store messages only without processing into memories
+     *
+     *     **Processing Flow** (when process_messages=true):
+     *     1. Message is immediately stored in PostMessage class
+     *     2. Background processing analyzes the message for memory-worthiness
+     *     3. If worthy, creates a memory with appropriate role-based categorization
+     *     4. Links the message to the created memory
+     *
+     *     **Role-Based Categories**:
+     *     - **User messages**: preference, task, goal, facts, context
+     *     - **Assistant messages**: skills, learning
+     *
+     *     **Session Management**:
+     *     - `sessionId` is required to group related messages
+     *     - Use the same `sessionId` for an entire conversation
+     *     - **Optional `title`**: Set a human-readable title for the conversation (e.g., "Q4 Planning Session")
+     *     - Retrieve conversation history using GET /messages/sessions/{sessionId}
+     *
+     * @example
+     * ```ts
+     * const response = await client.messages.store({
+     *   content: 'string',
+     *   role: 'user',
+     *   sessionId: 'sessionId',
+     * });
+     * ```
+     */
+    store(body, options) {
+        return this._client.post('/v1/messages', { body, ...options });
+    }
+}
+Messages.Sessions = Sessions;
+//# sourceMappingURL=messages.mjs.map

package/resources/messages/messages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../../src/resources/messages/messages.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,KAAK,WAAW;OAChB,EAML,QAAQ,GACT;AAID,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAuC1E,CAAC;IArCC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,IAAwB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AA0HD,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/resources/messages/sessions.d.mts

@@ -0,0 +1,262 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Sessions extends APIResource {
+    /**
+     * Get compressed conversation context for a session.
+     *
+     *     Compress your conversation into hierarchical summaries with rich metadata,
+     *     perfect for reducing token usage in LLM context windows.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     **What it returns**:
+     *     - **short_term**: Last 15 messages compressed
+     *     - **medium_term**: Last ~100 messages compressed
+     *     - **long_term**: Full session compressed
+     *     - **topics**: Key topics discussed
+     *     - **enhanced_fields**: Project context, tech stack, key decisions, next steps, files accessed
+     *
+     *     **Perfect for**:
+     *     - Reducing token usage in LLM prompts (96% savings)
+     *     - Providing conversation context without full history
+     *     - Quick conversation overview for AI agents
+     *     - Project documentation and status snapshots
+     *
+     *     **Input**: Just the session ID - all context is extracted automatically
+     *
+     * @example
+     * ```ts
+     * const response = await client.messages.sessions.compress(
+     *   'session_id',
+     * );
+     * ```
+     */
+    compress(sessionID: string, options?: RequestOptions): APIPromise<SessionCompressResponse>;
+    /**
+     * Process all stored messages in a session that were previously stored with
+     * process_messages=false.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     This endpoint allows you to retroactively process messages that were initially stored
+     *     without processing. Useful for:
+     *     - Processing messages after deciding you want them as memories
+     *     - Batch processing large conversation sessions
+     *     - Re-processing sessions with updated AI models
+     *
+     *     **Processing Behavior**:
+     *     - Only processes messages with status 'stored_only' or 'pending'
+     *     - Uses the same smart batch analysis (every 15 messages)
+     *     - Respects existing memory creation pipeline
+     *
+     * @example
+     * ```ts
+     * const response = await client.messages.sessions.process(
+     *   'session_id',
+     * );
+     * ```
+     */
+    process(sessionID: string, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Retrieve message history for a specific conversation session.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     **Pagination**:
+     *     - Use `limit` and `skip` parameters for pagination
+     *     - Messages are returned in chronological order (oldest first)
+     *     - `total_count` indicates total messages in the session
+     *
+     *     **Summaries** (if available):
+     *     - Returns hierarchical conversation summaries (short/medium/long-term)
+     *     - Includes `context_for_llm` field with pre-compressed context
+     *     - Summaries are automatically generated every 15 messages
+     *     - Use `/sessions/{session_id}/compress` endpoint to retrieve on-demand
+     *
+     *     **Access Control**:
+     *     - Only returns messages for the authenticated user
+     *     - Workspace scoping is applied if available
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.messages.sessions.retrieveHistory(
+     *     'session_id',
+     *   );
+     * ```
+     */
+    retrieveHistory(sessionID: string, query?: SessionRetrieveHistoryParams | null | undefined, options?: RequestOptions): APIPromise<SessionRetrieveHistoryResponse>;
+    /**
+     * Get processing status for messages in a session.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     **Status Information**:
+     *     - Total messages in session
+     *     - Processing status breakdown (queued, analyzing, completed, failed)
+     *     - Any messages with processing errors
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.messages.sessions.retrieveStatus(
+     *     'session_id',
+     *   );
+     * ```
+     */
+    retrieveStatus(sessionID: string, options?: RequestOptions): APIPromise<unknown>;
+}
+/**
+ * Response model for session summarization endpoint
+ */
+export interface SessionCompressResponse {
+    /**
+     * Instructions for AI agents on how to search for more details about this
+     * conversation
+     */
+    ai_agent_note: string;
+    /**
+     * Whether summaries were retrieved from cache (true) or just generated (false)
+     */
+    from_cache: boolean;
+    /**
+     * Session ID of the conversation
+     */
+    session_id: string;
+    /**
+     * Hierarchical conversation summaries
+     */
+    summaries: SessionCompressResponse.Summaries;
+    /**
+     * Number of messages summarized (only present if just generated)
+     */
+    message_count?: number | null;
+}
+export declare namespace SessionCompressResponse {
+    /**
+     * Hierarchical conversation summaries
+     */
+    interface Summaries {
+        /**
+         * When summaries were last updated
+         */
+        last_updated?: string | null;
+        /**
+         * Full session summary
+         */
+        long_term?: string | null;
+        /**
+         * Summary of last ~100 messages
+         */
+        medium_term?: string | null;
+        /**
+         * Summary of last 15 messages
+         */
+        short_term?: string | null;
+        /**
+         * Key topics discussed
+         */
+        topics?: Array<string>;
+    }
+}
+export type SessionProcessResponse = unknown;
+/**
+ * Response model for retrieving message history
+ */
+export interface SessionRetrieveHistoryResponse {
+    /**
+     * List of messages in chronological order
+     */
+    messages: Array<SessionRetrieveHistoryResponse.Message>;
+    /**
+     * Session ID of the conversation
+     */
+    sessionId: string;
+    /**
+     * Total number of messages in the session
+     */
+    total_count: number;
+    /**
+     * Pre-formatted compressed context ready for LLM consumption (summaries + recent
+     * messages)
+     */
+    context_for_llm?: string | null;
+    /**
+     * Hierarchical conversation summaries for context window compression
+     */
+    summaries?: SessionRetrieveHistoryResponse.Summaries | null;
+}
+export declare namespace SessionRetrieveHistoryResponse {
+    /**
+     * Response model for message storage
+     */
+    interface Message {
+        /**
+         * Content of the message - can be a simple string or structured content objects
+         */
+        content: string | Array<{
+            [key: string]: unknown;
+        }>;
+        /**
+         * When the message was created
+         */
+        createdAt: string;
+        /**
+         * Parse Server objectId of the stored message
+         */
+        objectId: string;
+        /**
+         * Role of the message sender
+         */
+        role: 'user' | 'assistant';
+        /**
+         * Session ID of the conversation
+         */
+        sessionId: string;
+        /**
+         * Status of background processing (queued, analyzing, completed, failed)
+         */
+        processing_status?: string;
+    }
+    /**
+     * Hierarchical conversation summaries for context window compression
+     */
+    interface Summaries {
+        /**
+         * When summaries were last updated
+         */
+        last_updated?: string | null;
+        /**
+         * Full session summary
+         */
+        long_term?: string | null;
+        /**
+         * Summary of last ~100 messages
+         */
+        medium_term?: string | null;
+        /**
+         * Summary of last 15 messages
+         */
+        short_term?: string | null;
+        /**
+         * Key topics discussed
+         */
+        topics?: Array<string>;
+    }
+}
+export type SessionRetrieveStatusResponse = unknown;
+export interface SessionRetrieveHistoryParams {
+    /**
+     * Maximum number of messages to return
+     */
+    limit?: number;
+    /**
+     * Number of messages to skip for pagination
+     */
+    skip?: number;
+}
+export declare namespace Sessions {
+    export { type SessionCompressResponse as SessionCompressResponse, type SessionProcessResponse as SessionProcessResponse, type SessionRetrieveHistoryResponse as SessionRetrieveHistoryResponse, type SessionRetrieveStatusResponse as SessionRetrieveStatusResponse, type SessionRetrieveHistoryParams as SessionRetrieveHistoryParams, };
+}
+//# sourceMappingURL=sessions.d.mts.map

package/resources/messages/sessions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.mts","sourceRoot":"","sources":["../../src/resources/messages/sessions.ts"],"names":[],"mappings":"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"}

package/resources/messages/sessions.d.ts

@@ -0,0 +1,262 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Sessions extends APIResource {
+    /**
+     * Get compressed conversation context for a session.
+     *
+     *     Compress your conversation into hierarchical summaries with rich metadata,
+     *     perfect for reducing token usage in LLM context windows.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     **What it returns**:
+     *     - **short_term**: Last 15 messages compressed
+     *     - **medium_term**: Last ~100 messages compressed
+     *     - **long_term**: Full session compressed
+     *     - **topics**: Key topics discussed
+     *     - **enhanced_fields**: Project context, tech stack, key decisions, next steps, files accessed
+     *
+     *     **Perfect for**:
+     *     - Reducing token usage in LLM prompts (96% savings)
+     *     - Providing conversation context without full history
+     *     - Quick conversation overview for AI agents
+     *     - Project documentation and status snapshots
+     *
+     *     **Input**: Just the session ID - all context is extracted automatically
+     *
+     * @example
+     * ```ts
+     * const response = await client.messages.sessions.compress(
+     *   'session_id',
+     * );
+     * ```
+     */
+    compress(sessionID: string, options?: RequestOptions): APIPromise<SessionCompressResponse>;
+    /**
+     * Process all stored messages in a session that were previously stored with
+     * process_messages=false.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     This endpoint allows you to retroactively process messages that were initially stored
+     *     without processing. Useful for:
+     *     - Processing messages after deciding you want them as memories
+     *     - Batch processing large conversation sessions
+     *     - Re-processing sessions with updated AI models
+     *
+     *     **Processing Behavior**:
+     *     - Only processes messages with status 'stored_only' or 'pending'
+     *     - Uses the same smart batch analysis (every 15 messages)
+     *     - Respects existing memory creation pipeline
+     *
+     * @example
+     * ```ts
+     * const response = await client.messages.sessions.process(
+     *   'session_id',
+     * );
+     * ```
+     */
+    process(sessionID: string, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Retrieve message history for a specific conversation session.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     **Pagination**:
+     *     - Use `limit` and `skip` parameters for pagination
+     *     - Messages are returned in chronological order (oldest first)
+     *     - `total_count` indicates total messages in the session
+     *
+     *     **Summaries** (if available):
+     *     - Returns hierarchical conversation summaries (short/medium/long-term)
+     *     - Includes `context_for_llm` field with pre-compressed context
+     *     - Summaries are automatically generated every 15 messages
+     *     - Use `/sessions/{session_id}/compress` endpoint to retrieve on-demand
+     *
+     *     **Access Control**:
+     *     - Only returns messages for the authenticated user
+     *     - Workspace scoping is applied if available
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.messages.sessions.retrieveHistory(
+     *     'session_id',
+     *   );
+     * ```
+     */
+    retrieveHistory(sessionID: string, query?: SessionRetrieveHistoryParams | null | undefined, options?: RequestOptions): APIPromise<SessionRetrieveHistoryResponse>;
+    /**
+     * Get processing status for messages in a session.
+     *
+     *     **Authentication Required**: Bearer token, API key, or session token
+     *
+     *     **Status Information**:
+     *     - Total messages in session
+     *     - Processing status breakdown (queued, analyzing, completed, failed)
+     *     - Any messages with processing errors
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.messages.sessions.retrieveStatus(
+     *     'session_id',
+     *   );
+     * ```
+     */
+    retrieveStatus(sessionID: string, options?: RequestOptions): APIPromise<unknown>;
+}
+/**
+ * Response model for session summarization endpoint
+ */
+export interface SessionCompressResponse {
+    /**
+     * Instructions for AI agents on how to search for more details about this
+     * conversation
+     */
+    ai_agent_note: string;
+    /**
+     * Whether summaries were retrieved from cache (true) or just generated (false)
+     */
+    from_cache: boolean;
+    /**
+     * Session ID of the conversation
+     */
+    session_id: string;
+    /**
+     * Hierarchical conversation summaries
+     */
+    summaries: SessionCompressResponse.Summaries;
+    /**
+     * Number of messages summarized (only present if just generated)
+     */
+    message_count?: number | null;
+}
+export declare namespace SessionCompressResponse {
+    /**
+     * Hierarchical conversation summaries
+     */
+    interface Summaries {
+        /**
+         * When summaries were last updated
+         */
+        last_updated?: string | null;
+        /**
+         * Full session summary
+         */
+        long_term?: string | null;
+        /**
+         * Summary of last ~100 messages
+         */
+        medium_term?: string | null;
+        /**
+         * Summary of last 15 messages
+         */
+        short_term?: string | null;
+        /**
+         * Key topics discussed
+         */
+        topics?: Array<string>;
+    }
+}
+export type SessionProcessResponse = unknown;
+/**
+ * Response model for retrieving message history
+ */
+export interface SessionRetrieveHistoryResponse {
+    /**
+     * List of messages in chronological order
+     */
+    messages: Array<SessionRetrieveHistoryResponse.Message>;
+    /**
+     * Session ID of the conversation
+     */
+    sessionId: string;
+    /**
+     * Total number of messages in the session
+     */
+    total_count: number;
+    /**
+     * Pre-formatted compressed context ready for LLM consumption (summaries + recent
+     * messages)
+     */
+    context_for_llm?: string | null;
+    /**
+     * Hierarchical conversation summaries for context window compression
+     */
+    summaries?: SessionRetrieveHistoryResponse.Summaries | null;
+}
+export declare namespace SessionRetrieveHistoryResponse {
+    /**
+     * Response model for message storage
+     */
+    interface Message {
+        /**
+         * Content of the message - can be a simple string or structured content objects
+         */
+        content: string | Array<{
+            [key: string]: unknown;
+        }>;
+        /**
+         * When the message was created
+         */
+        createdAt: string;
+        /**
+         * Parse Server objectId of the stored message
+         */
+        objectId: string;
+        /**
+         * Role of the message sender
+         */
+        role: 'user' | 'assistant';
+        /**
+         * Session ID of the conversation
+         */
+        sessionId: string;
+        /**
+         * Status of background processing (queued, analyzing, completed, failed)
+         */
+        processing_status?: string;
+    }
+    /**
+     * Hierarchical conversation summaries for context window compression
+     */
+    interface Summaries {
+        /**
+         * When summaries were last updated
+         */
+        last_updated?: string | null;
+        /**
+         * Full session summary
+         */
+        long_term?: string | null;
+        /**
+         * Summary of last ~100 messages
+         */
+        medium_term?: string | null;
+        /**
+         * Summary of last 15 messages
+         */
+        short_term?: string | null;
+        /**
+         * Key topics discussed
+         */
+        topics?: Array<string>;
+    }
+}
+export type SessionRetrieveStatusResponse = unknown;
+export interface SessionRetrieveHistoryParams {
+    /**
+     * Maximum number of messages to return
+     */
+    limit?: number;
+    /**
+     * Number of messages to skip for pagination
+     */
+    skip?: number;
+}
+export declare namespace Sessions {
+    export { type SessionCompressResponse as SessionCompressResponse, type SessionProcessResponse as SessionProcessResponse, type SessionRetrieveHistoryResponse as SessionRetrieveHistoryResponse, type SessionRetrieveStatusResponse as SessionRetrieveStatusResponse, type SessionRetrieveHistoryParams as SessionRetrieveHistoryParams, };
+}
+//# sourceMappingURL=sessions.d.ts.map

package/resources/messages/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/resources/messages/sessions.ts"],"names":[],"mappings":"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"}