@papr/memory 1.0.0

package/src/resources/document.ts

@@ -0,0 +1,140 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Document extends APIResource {
+  /**
+   * Upload a document (PDF/HTML/TXT) to be processed and added to memory.
+   *
+   *     **Authentication Required**:
+   *     One of the following authentication methods must be used:
+   *     - Bearer token in `Authorization` header
+   *     - API Key in `X-API-Key` header
+   *     - Session token in `X-Session-Token` header
+   *
+   *     **Required Headers**:
+   *     - Content-Type: multipart/form-data
+   *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+   *
+   *     **Form Data**:
+   *     - file: The document file to upload (PDF/HTML/TXT)
+   *     - metadata: (optional) JSON string containing additional metadata
+   */
+  upload(
+    params: DocumentUploadParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DocumentUploadResponse> {
+    const { post_objectId, skip_background_processing } = params ?? {};
+    return this._client.post('/v1/document', {
+      query: { post_objectId, skip_background_processing },
+      ...options,
+    });
+  }
+}
+
+/**
+ * Response model for a single memory item in add_memory response
+ */
+export interface AddMemoryItem {
+  createdAt: string;
+
+  memoryId: string;
+
+  objectId: string;
+
+  memoryChunkIds?: Array<string>;
+}
+
+export interface DocumentUploadResponse {
+  /**
+   * Status and progress of the document upload
+   */
+  document_status: DocumentUploadResponse.DocumentStatus;
+
+  /**
+   * HTTP status code
+   */
+  code?: number;
+
+  /**
+   * Additional error details or context
+   */
+  details?: unknown;
+
+  /**
+   * Error message if failed
+   */
+  error?: string | null;
+
+  /**
+   * For backward compatibility
+   */
+  memories?: Array<AddMemoryItem> | null;
+
+  /**
+   * List of memory items created from the document
+   */
+  memory_items?: Array<AddMemoryItem>;
+
+  /**
+   * Human-readable status message
+   */
+  message?: string | null;
+
+  /**
+   * 'success', 'processing', 'error', etc.
+   */
+  status?: string;
+}
+
+export namespace DocumentUploadResponse {
+  /**
+   * Status and progress of the document upload
+   */
+  export interface DocumentStatus {
+    /**
+     * 0.0 to 1.0 for percentage
+     */
+    progress: number;
+
+    current_filename?: string | null;
+
+    current_page?: number | null;
+
+    /**
+     * Error message if failed
+     */
+    error?: string | null;
+
+    /**
+     * Processing status type
+     */
+    status_type?: 'processing' | 'completed' | 'failed' | 'not_found' | 'queued' | 'cancelled' | null;
+
+    total_pages?: number | null;
+
+    upload_id?: string | null;
+  }
+}
+
+export interface DocumentUploadParams {
+  /**
+   * Optional Post objectId for updating status
+   */
+  post_objectId?: string | null;
+
+  /**
+   * If True, skips adding background tasks for processing
+   */
+  skip_background_processing?: boolean;
+}
+
+export declare namespace Document {
+  export {
+    type AddMemoryItem as AddMemoryItem,
+    type DocumentUploadResponse as DocumentUploadResponse,
+    type DocumentUploadParams as DocumentUploadParams,
+  };
+}

package/src/resources/index.ts

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Document,
+  type AddMemoryItem,
+  type DocumentUploadResponse,
+  type DocumentUploadParams,
+} from './document';
+export {
+  Memory,
+  type AddMemory,
+  type AddMemoryResponse,
+  type ContextItem,
+  type MemoryMetadata,
+  type MemoryType,
+  type RelationshipItem,
+  type SearchResponse,
+  type MemoryUpdateResponse,
+  type MemoryDeleteResponse,
+  type MemoryAddBatchResponse,
+  type MemoryUpdateParams,
+  type MemoryDeleteParams,
+  type MemoryAddParams,
+  type MemoryAddBatchParams,
+  type MemorySearchParams,
+} from './memory';
+export {
+  User,
+  type UserResponse,
+  type UserType,
+  type UserListResponse,
+  type UserDeleteResponse,
+  type UserCreateParams,
+  type UserUpdateParams,
+  type UserListParams,
+} from './user';