@papr/memory 1.8.3 → 1.10.0

package/internal/utils/path.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"path.mjs","sourceRoot":"","sources":["../../src/internal/utils/path.ts"],"names":[],"mappings":"OAAO,EAAE,SAAS,EAAE;AAEpB;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,GAAG,CAAC,OAAO,CAAC,kCAAkC,EAAE,kBAAkB,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,WAAW,GAAG,aAAa,EAAE,EAAE,CACnE,SAAS,IAAI,CAAC,OAA0B,EAAE,GAAG,MAA0B;IACrE,mDAAmD;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;IAE7C,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE;QACjE,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,OAAO,CACL,aAAa;YACb,YAAY;YACZ,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACtG,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAC3C,MAAM,eAAe,GAAG,EAAE,CAAC;IAC3B,MAAM,qBAAqB,GAAG,oCAAoC,CAAC;IACnE,IAAI,KAAK,CAAC;IAEV,4BAA4B;IAC5B,OAAO,CAAC,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/D,eAAe,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;YACzC,OAAO,GAAG,GAAG,MAAM,GAAG,MAAM,CAAC;QAC/B,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,IAAI,SAAS,CAAC,0DAA0D,IAAI,KAAK,SAAS,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEJ;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"path.mjs","sourceRoot":"","sources":["../../src/internal/utils/path.ts"],"names":[],"mappings":"OAAO,EAAE,SAAS,EAAE;AAEpB;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,GAAG,CAAC,OAAO,CAAC,kCAAkC,EAAE,kBAAkB,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAEjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,WAAW,GAAG,aAAa,EAAE,EAAE,CACnE,SAAS,IAAI,CAAC,OAA0B,EAAE,GAAG,MAA0B;IACrE,mDAAmD;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;IAE7C,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,eAAe,GAAG,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE;QACjE,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;QACxE,IACE,KAAK,KAAK,MAAM,CAAC,MAAM;YACvB,CAAC,KAAK,IAAI,IAAI;gBACZ,CAAC,OAAO,KAAK,KAAK,QAAQ;oBACxB,kCAAkC;oBAClC,KAAK,CAAC,QAAQ;wBACZ,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAE,KAAa,CAAC,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;4BAC3F,EAAE,QAAQ,CAAC,CAAC,EACpB,CAAC;YACD,OAAO,GAAG,KAAK,GAAG,EAAE,CAAC;YACrB,eAAe,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM;gBACjD,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,iBAAiB,MAAM,CAAC,SAAS,CAAC,QAAQ;qBAC9C,IAAI,CAAC,KAAK,CAAC;qBACX,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gCAAgC;aAChD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,aAAa,GAAG,YAAY,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAC3C,MAAM,qBAAqB,GAAG,oCAAoC,CAAC;IACnE,IAAI,KAAK,CAAC;IAEV,4BAA4B;IAC5B,OAAO,CAAC,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/D,eAAe,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;YACvB,KAAK,EAAE,UAAU,KAAK,CAAC,CAAC,CAAC,+CAA+C;SACzE,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAElD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;YACzC,OAAO,GAAG,GAAG,MAAM,GAAG,MAAM,CAAC;QAC/B,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,IAAI,SAAS,CACjB,0DAA0D,eAAe;aACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;aACnB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,SAAS,EAAE,CACvC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEJ;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papr/memory",
-  "version": "1.8.3",
+  "version": "1.10.0",
   "description": "The official TypeScript library for the Papr API",
   "author": "Papr <support@papr.ai>",
   "types": "./index.d.ts",

package/resources/feedback.d.mts

@@ -0,0 +1,333 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Feedback extends APIResource {
+    /**
+     * Retrieve feedback by ID.
+     *
+     *     This endpoint allows developers to fetch feedback details by feedback ID.
+     *     Only the user who created the feedback or users with appropriate permissions can access it.
+     *
+     *     **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**:
+     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+     *
+     * @example
+     * ```ts
+     * const feedbackResponse = await client.feedback.getByID(
+     *   'feedback_id',
+     * );
+     * ```
+     */
+    getByID(feedbackID: string, options?: RequestOptions): APIPromise<FeedbackResponse>;
+    /**
+     * Submit feedback on search results to help improve model performance.
+     *
+     *     This endpoint allows developers to provide feedback on:
+     *     - Overall answer quality (thumbs up/down, ratings)
+     *     - Specific memory relevance and accuracy
+     *     - User engagement signals (copy, save, create document actions)
+     *     - Corrections and improvements
+     *
+     *     The feedback is used to train and improve:
+     *     - Router model tier predictions
+     *     - Memory retrieval ranking
+     *     - Answer generation quality
+     *     - Agentic graph search performance
+     *
+     *     **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: application/json
+     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+     *
+     * @example
+     * ```ts
+     * const feedbackResponse = await client.feedback.submit({
+     *   feedbackData: {
+     *     feedbackSource: 'inline',
+     *     feedbackType: 'thumbs_up',
+     *   },
+     *   search_id: 'abc123def456',
+     * });
+     * ```
+     */
+    submit(body: FeedbackSubmitParams, options?: RequestOptions): APIPromise<FeedbackResponse>;
+    /**
+     * Submit multiple feedback items in a single request.
+     *
+     *     Useful for submitting session-end feedback or bulk feedback collection.
+     *     Each feedback item is processed independently, so partial success is possible.
+     *
+     *     **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: application/json
+     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+     *
+     * @example
+     * ```ts
+     * const batchResponse = await client.feedback.submitBatch({
+     *   feedback_items: [
+     *     {
+     *       feedbackData: {
+     *         feedbackSource: 'inline',
+     *         feedbackType: 'thumbs_up',
+     *       },
+     *       search_id: 'abc123def456',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    submitBatch(body: FeedbackSubmitBatchParams, options?: RequestOptions): APIPromise<BatchResponse>;
+}
+/**
+ * Request model for submitting multiple feedback items
+ */
+export interface BatchRequest {
+    /**
+     * List of feedback items to submit
+     */
+    feedback_items: Array<FeedbackRequest>;
+    /**
+     * Session-level context for batch feedback
+     */
+    session_context?: {
+        [key: string]: unknown;
+    } | null;
+}
+/**
+ * Response model for batch feedback submission
+ */
+export interface BatchResponse {
+    /**
+     * HTTP status code
+     */
+    code: number;
+    /**
+     * Human-readable message
+     */
+    message: string;
+    /**
+     * 'success' or 'error'
+     */
+    status: string;
+    /**
+     * Error message if status is 'error'
+     */
+    error?: string | null;
+    /**
+     * List of error details
+     */
+    errors?: Array<{
+        [key: string]: unknown;
+    }>;
+    /**
+     * Number of failed feedback items
+     */
+    failed_count?: number;
+    /**
+     * List of feedback IDs
+     */
+    feedback_ids?: Array<string>;
+    /**
+     * Number of successfully processed feedback items
+     */
+    successful_count?: number;
+}
+/**
+ * Request model for submitting feedback on search results
+ */
+export interface FeedbackRequest {
+    /**
+     * The feedback data containing all feedback information
+     */
+    feedbackData: FeedbackRequest.FeedbackData;
+    /**
+     * The search_id from SearchResponse that this feedback relates to
+     */
+    search_id: string;
+    /**
+     * External user ID for developer API keys acting on behalf of end users
+     */
+    external_user_id?: string | null;
+    /**
+     * Internal user ID (if not provided, will be resolved from authentication)
+     */
+    user_id?: string | null;
+}
+export declare namespace FeedbackRequest {
+    /**
+     * The feedback data containing all feedback information
+     */
+    interface FeedbackData {
+        /**
+         * Where the feedback was provided from
+         */
+        feedbackSource: 'inline' | 'post_query' | 'session_end' | 'memory_citation' | 'answer_panel';
+        /**
+         * Types of feedback that can be provided
+         */
+        feedbackType: 'thumbs_up' | 'thumbs_down' | 'rating' | 'correction' | 'report' | 'copy_action' | 'save_action' | 'create_document' | 'memory_relevance' | 'answer_quality';
+        /**
+         * A pointer to a Parse object
+         */
+        assistantMessage?: FeedbackData.AssistantMessage | null;
+        citedMemoryIds?: Array<string> | null;
+        citedNodeIds?: Array<string> | null;
+        feedbackImpact?: string | null;
+        feedbackProcessed?: boolean | null;
+        feedbackScore?: number | null;
+        feedbackText?: string | null;
+        feedbackValue?: string | null;
+        /**
+         * A pointer to a Parse object
+         */
+        userMessage?: FeedbackData.UserMessage | null;
+    }
+    namespace FeedbackData {
+        /**
+         * A pointer to a Parse object
+         */
+        interface AssistantMessage {
+            className: string;
+            objectId: string;
+            __type?: string;
+        }
+        /**
+         * A pointer to a Parse object
+         */
+        interface UserMessage {
+            className: string;
+            objectId: string;
+            __type?: string;
+        }
+    }
+}
+/**
+ * Response model for feedback submission
+ */
+export interface FeedbackResponse {
+    /**
+     * HTTP status code
+     */
+    code: number;
+    /**
+     * Human-readable message
+     */
+    message: string;
+    /**
+     * 'success' or 'error'
+     */
+    status: string;
+    /**
+     * Additional error details
+     */
+    details?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Error message if status is 'error'
+     */
+    error?: string | null;
+    /**
+     * Unique feedback ID
+     */
+    feedback_id?: string | null;
+}
+export interface FeedbackSubmitParams {
+    /**
+     * The feedback data containing all feedback information
+     */
+    feedbackData: FeedbackSubmitParams.FeedbackData;
+    /**
+     * The search_id from SearchResponse that this feedback relates to
+     */
+    search_id: string;
+    /**
+     * External user ID for developer API keys acting on behalf of end users
+     */
+    external_user_id?: string | null;
+    /**
+     * Internal user ID (if not provided, will be resolved from authentication)
+     */
+    user_id?: string | null;
+}
+export declare namespace FeedbackSubmitParams {
+    /**
+     * The feedback data containing all feedback information
+     */
+    interface FeedbackData {
+        /**
+         * Where the feedback was provided from
+         */
+        feedbackSource: 'inline' | 'post_query' | 'session_end' | 'memory_citation' | 'answer_panel';
+        /**
+         * Types of feedback that can be provided
+         */
+        feedbackType: 'thumbs_up' | 'thumbs_down' | 'rating' | 'correction' | 'report' | 'copy_action' | 'save_action' | 'create_document' | 'memory_relevance' | 'answer_quality';
+        /**
+         * A pointer to a Parse object
+         */
+        assistantMessage?: FeedbackData.AssistantMessage | null;
+        citedMemoryIds?: Array<string> | null;
+        citedNodeIds?: Array<string> | null;
+        feedbackImpact?: string | null;
+        feedbackProcessed?: boolean | null;
+        feedbackScore?: number | null;
+        feedbackText?: string | null;
+        feedbackValue?: string | null;
+        /**
+         * A pointer to a Parse object
+         */
+        userMessage?: FeedbackData.UserMessage | null;
+    }
+    namespace FeedbackData {
+        /**
+         * A pointer to a Parse object
+         */
+        interface AssistantMessage {
+            className: string;
+            objectId: string;
+            __type?: string;
+        }
+        /**
+         * A pointer to a Parse object
+         */
+        interface UserMessage {
+            className: string;
+            objectId: string;
+            __type?: string;
+        }
+    }
+}
+export interface FeedbackSubmitBatchParams {
+    /**
+     * List of feedback items to submit
+     */
+    feedback_items: Array<FeedbackRequest>;
+    /**
+     * Session-level context for batch feedback
+     */
+    session_context?: {
+        [key: string]: unknown;
+    } | null;
+}
+export declare namespace Feedback {
+    export { type BatchRequest as BatchRequest, type BatchResponse as BatchResponse, type FeedbackRequest as FeedbackRequest, type FeedbackResponse as FeedbackResponse, type FeedbackSubmitParams as FeedbackSubmitParams, type FeedbackSubmitBatchParams as FeedbackSubmitBatchParams, };
+}
+//# sourceMappingURL=feedback.d.mts.map

package/resources/feedback.d.mts.map

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

package/resources/feedback.d.ts

@@ -0,0 +1,333 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Feedback extends APIResource {
+    /**
+     * Retrieve feedback by ID.
+     *
+     *     This endpoint allows developers to fetch feedback details by feedback ID.
+     *     Only the user who created the feedback or users with appropriate permissions can access it.
+     *
+     *     **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**:
+     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+     *
+     * @example
+     * ```ts
+     * const feedbackResponse = await client.feedback.getByID(
+     *   'feedback_id',
+     * );
+     * ```
+     */
+    getByID(feedbackID: string, options?: RequestOptions): APIPromise<FeedbackResponse>;
+    /**
+     * Submit feedback on search results to help improve model performance.
+     *
+     *     This endpoint allows developers to provide feedback on:
+     *     - Overall answer quality (thumbs up/down, ratings)
+     *     - Specific memory relevance and accuracy
+     *     - User engagement signals (copy, save, create document actions)
+     *     - Corrections and improvements
+     *
+     *     The feedback is used to train and improve:
+     *     - Router model tier predictions
+     *     - Memory retrieval ranking
+     *     - Answer generation quality
+     *     - Agentic graph search performance
+     *
+     *     **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: application/json
+     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+     *
+     * @example
+     * ```ts
+     * const feedbackResponse = await client.feedback.submit({
+     *   feedbackData: {
+     *     feedbackSource: 'inline',
+     *     feedbackType: 'thumbs_up',
+     *   },
+     *   search_id: 'abc123def456',
+     * });
+     * ```
+     */
+    submit(body: FeedbackSubmitParams, options?: RequestOptions): APIPromise<FeedbackResponse>;
+    /**
+     * Submit multiple feedback items in a single request.
+     *
+     *     Useful for submitting session-end feedback or bulk feedback collection.
+     *     Each feedback item is processed independently, so partial success is possible.
+     *
+     *     **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: application/json
+     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+     *
+     * @example
+     * ```ts
+     * const batchResponse = await client.feedback.submitBatch({
+     *   feedback_items: [
+     *     {
+     *       feedbackData: {
+     *         feedbackSource: 'inline',
+     *         feedbackType: 'thumbs_up',
+     *       },
+     *       search_id: 'abc123def456',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    submitBatch(body: FeedbackSubmitBatchParams, options?: RequestOptions): APIPromise<BatchResponse>;
+}
+/**
+ * Request model for submitting multiple feedback items
+ */
+export interface BatchRequest {
+    /**
+     * List of feedback items to submit
+     */
+    feedback_items: Array<FeedbackRequest>;
+    /**
+     * Session-level context for batch feedback
+     */
+    session_context?: {
+        [key: string]: unknown;
+    } | null;
+}
+/**
+ * Response model for batch feedback submission
+ */
+export interface BatchResponse {
+    /**
+     * HTTP status code
+     */
+    code: number;
+    /**
+     * Human-readable message
+     */
+    message: string;
+    /**
+     * 'success' or 'error'
+     */
+    status: string;
+    /**
+     * Error message if status is 'error'
+     */
+    error?: string | null;
+    /**
+     * List of error details
+     */
+    errors?: Array<{
+        [key: string]: unknown;
+    }>;
+    /**
+     * Number of failed feedback items
+     */
+    failed_count?: number;
+    /**
+     * List of feedback IDs
+     */
+    feedback_ids?: Array<string>;
+    /**
+     * Number of successfully processed feedback items
+     */
+    successful_count?: number;
+}
+/**
+ * Request model for submitting feedback on search results
+ */
+export interface FeedbackRequest {
+    /**
+     * The feedback data containing all feedback information
+     */
+    feedbackData: FeedbackRequest.FeedbackData;
+    /**
+     * The search_id from SearchResponse that this feedback relates to
+     */
+    search_id: string;
+    /**
+     * External user ID for developer API keys acting on behalf of end users
+     */
+    external_user_id?: string | null;
+    /**
+     * Internal user ID (if not provided, will be resolved from authentication)
+     */
+    user_id?: string | null;
+}
+export declare namespace FeedbackRequest {
+    /**
+     * The feedback data containing all feedback information
+     */
+    interface FeedbackData {
+        /**
+         * Where the feedback was provided from
+         */
+        feedbackSource: 'inline' | 'post_query' | 'session_end' | 'memory_citation' | 'answer_panel';
+        /**
+         * Types of feedback that can be provided
+         */
+        feedbackType: 'thumbs_up' | 'thumbs_down' | 'rating' | 'correction' | 'report' | 'copy_action' | 'save_action' | 'create_document' | 'memory_relevance' | 'answer_quality';
+        /**
+         * A pointer to a Parse object
+         */
+        assistantMessage?: FeedbackData.AssistantMessage | null;
+        citedMemoryIds?: Array<string> | null;
+        citedNodeIds?: Array<string> | null;
+        feedbackImpact?: string | null;
+        feedbackProcessed?: boolean | null;
+        feedbackScore?: number | null;
+        feedbackText?: string | null;
+        feedbackValue?: string | null;
+        /**
+         * A pointer to a Parse object
+         */
+        userMessage?: FeedbackData.UserMessage | null;
+    }
+    namespace FeedbackData {
+        /**
+         * A pointer to a Parse object
+         */
+        interface AssistantMessage {
+            className: string;
+            objectId: string;
+            __type?: string;
+        }
+        /**
+         * A pointer to a Parse object
+         */
+        interface UserMessage {
+            className: string;
+            objectId: string;
+            __type?: string;
+        }
+    }
+}
+/**
+ * Response model for feedback submission
+ */
+export interface FeedbackResponse {
+    /**
+     * HTTP status code
+     */
+    code: number;
+    /**
+     * Human-readable message
+     */
+    message: string;
+    /**
+     * 'success' or 'error'
+     */
+    status: string;
+    /**
+     * Additional error details
+     */
+    details?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Error message if status is 'error'
+     */
+    error?: string | null;
+    /**
+     * Unique feedback ID
+     */
+    feedback_id?: string | null;
+}
+export interface FeedbackSubmitParams {
+    /**
+     * The feedback data containing all feedback information
+     */
+    feedbackData: FeedbackSubmitParams.FeedbackData;
+    /**
+     * The search_id from SearchResponse that this feedback relates to
+     */
+    search_id: string;
+    /**
+     * External user ID for developer API keys acting on behalf of end users
+     */
+    external_user_id?: string | null;
+    /**
+     * Internal user ID (if not provided, will be resolved from authentication)
+     */
+    user_id?: string | null;
+}
+export declare namespace FeedbackSubmitParams {
+    /**
+     * The feedback data containing all feedback information
+     */
+    interface FeedbackData {
+        /**
+         * Where the feedback was provided from
+         */
+        feedbackSource: 'inline' | 'post_query' | 'session_end' | 'memory_citation' | 'answer_panel';
+        /**
+         * Types of feedback that can be provided
+         */
+        feedbackType: 'thumbs_up' | 'thumbs_down' | 'rating' | 'correction' | 'report' | 'copy_action' | 'save_action' | 'create_document' | 'memory_relevance' | 'answer_quality';
+        /**
+         * A pointer to a Parse object
+         */
+        assistantMessage?: FeedbackData.AssistantMessage | null;
+        citedMemoryIds?: Array<string> | null;
+        citedNodeIds?: Array<string> | null;
+        feedbackImpact?: string | null;
+        feedbackProcessed?: boolean | null;
+        feedbackScore?: number | null;
+        feedbackText?: string | null;
+        feedbackValue?: string | null;
+        /**
+         * A pointer to a Parse object
+         */
+        userMessage?: FeedbackData.UserMessage | null;
+    }
+    namespace FeedbackData {
+        /**
+         * A pointer to a Parse object
+         */
+        interface AssistantMessage {
+            className: string;
+            objectId: string;
+            __type?: string;
+        }
+        /**
+         * A pointer to a Parse object
+         */
+        interface UserMessage {
+            className: string;
+            objectId: string;
+            __type?: string;
+        }
+    }
+}
+export interface FeedbackSubmitBatchParams {
+    /**
+     * List of feedback items to submit
+     */
+    feedback_items: Array<FeedbackRequest>;
+    /**
+     * Session-level context for batch feedback
+     */
+    session_context?: {
+        [key: string]: unknown;
+    } | null;
+}
+export declare namespace Feedback {
+    export { type BatchRequest as BatchRequest, type BatchResponse as BatchResponse, type FeedbackRequest as FeedbackRequest, type FeedbackResponse as FeedbackResponse, type FeedbackSubmitParams as FeedbackSubmitParams, type FeedbackSubmitBatchParams as FeedbackSubmitBatchParams, };
+}
+//# sourceMappingURL=feedback.d.ts.map