@papr/memory 1.9.0 → 1.13.0

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

package/resources/feedback.d.ts.map

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

package/resources/feedback.js

@@ -0,0 +1,108 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Feedback = void 0;
+const resource_1 = require("../core/resource.js");
+const path_1 = require("../internal/utils/path.js");
+class Feedback extends resource_1.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, options) {
+        return this._client.get((0, path_1.path) `/v1/feedback/${feedbackID}`, options);
+    }
+    /**
+     * 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, options) {
+        return this._client.post('/v1/feedback', { body, ...options });
+    }
+    /**
+     * 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, options) {
+        return this._client.post('/v1/feedback/batch', { body, ...options });
+    }
+}
+exports.Feedback = Feedback;
+//# sourceMappingURL=feedback.js.map

package/resources/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../src/resources/feedback.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAA8C;AAE9C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,UAAkB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,WAAW,CAAC,IAA+B,EAAE,OAAwB;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF;AArGD,4BAqGC"}

package/resources/feedback.mjs

@@ -0,0 +1,104 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { path } from "../internal/utils/path.mjs";
+export 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, options) {
+        return this._client.get(path `/v1/feedback/${feedbackID}`, options);
+    }
+    /**
+     * 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, options) {
+        return this._client.post('/v1/feedback', { body, ...options });
+    }
+    /**
+     * 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, options) {
+        return this._client.post('/v1/feedback/batch', { body, ...options });
+    }
+}
+//# sourceMappingURL=feedback.mjs.map

package/resources/feedback.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.mjs","sourceRoot":"","sources":["../src/resources/feedback.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,UAAkB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,WAAW,CAAC,IAA+B,EAAE,OAAwB;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF"}

package/resources/index.d.mts

@@ -1,3 +1,4 @@
+export { Feedback, type BatchRequest, type BatchResponse, type FeedbackRequest, type FeedbackResponse, type FeedbackSubmitParams, type FeedbackSubmitBatchParams, } from "./feedback.mjs";
 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.mjs";
-export { User, type UserResponse, type UserType, type UserListResponse, type UserDeleteResponse, type UserCreateBatchResponse, type UserCreateParams, type UserUpdateParams, type UserListParams, type UserDeleteParams, type UserCreateBatchParams, type UserGetParams, } from "./user.mjs";
+export { User, type UserResponse, type UserType, type UserListResponse, type UserDeleteResponse, type UserCreateBatchResponse, type UserCreateParams, type UserUpdateParams, type UserListParams, type UserDeleteParams, type UserCreateBatchParams, } from "./user.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,MAAM,EACN,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB;OACM,EACL,IAAI,EACJ,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B;OACM,EACL,MAAM,EACN,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB;OACM,EACL,IAAI,EACJ,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B"}

package/resources/index.d.ts

@@ -1,3 +1,4 @@
+export { Feedback, type BatchRequest, type BatchResponse, type FeedbackRequest, type FeedbackResponse, type FeedbackSubmitParams, type FeedbackSubmitBatchParams, } from "./feedback.js";
 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.js";
-export { User, type UserResponse, type UserType, type UserListResponse, type UserDeleteResponse, type UserCreateBatchResponse, type UserCreateParams, type UserUpdateParams, type UserListParams, type UserDeleteParams, type UserCreateBatchParams, type UserGetParams, } from "./user.js";
+export { User, type UserResponse, type UserType, type UserListResponse, type UserDeleteResponse, type UserCreateBatchResponse, type UserCreateParams, type UserUpdateParams, type UserListParams, type UserDeleteParams, type UserCreateBatchParams, } from "./user.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,MAAM,EACN,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB;OACM,EACL,IAAI,EACJ,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B;OACM,EACL,MAAM,EACN,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB;OACM,EACL,IAAI,EACJ,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B"}

package/resources/index.js

@@ -1,7 +1,9 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.User = exports.Memory = void 0;
+exports.User = exports.Memory = exports.Feedback = void 0;
+var feedback_1 = require("./feedback.js");
+Object.defineProperty(exports, "Feedback", { enumerable: true, get: function () { return feedback_1.Feedback; } });
 var memory_1 = require("./memory.js");
 Object.defineProperty(exports, "Memory", { enumerable: true, get: function () { return memory_1.Memory; } });
 var user_1 = require("./user.js");

package/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sCAiBkB;AAhBhB,gGAAA,MAAM,OAAA;AAiBR,kCAagB;AAZd,4FAAA,IAAI,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0CAQoB;AAPlB,oGAAA,QAAQ,OAAA;AAQV,sCAiBkB;AAhBhB,gGAAA,MAAM,OAAA;AAiBR,kCAYgB;AAXd,4FAAA,IAAI,OAAA"}

package/resources/index.mjs

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Feedback, } from "./feedback.mjs";
 export { Memory, } from "./memory.mjs";
 export { User, } from "./user.mjs";
 //# sourceMappingURL=index.mjs.map

package/resources/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,MAAM,GAgBP;OACM,EACL,IAAI,GAYL"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,QAAQ,GAOT;OACM,EACL,MAAM,GAgBP;OACM,EACL,IAAI,GAWL"}