@papr/memory 1.20.0 → 2.0.0

package/src/resources/sync.ts

@@ -0,0 +1,179 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as Shared from './shared';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Sync extends APIResource {
+  /**
+   * Return upserts/deletes since the provided cursor for a user/workspace. Cursor is
+   * an opaque watermark over updatedAt and objectId.
+   *
+   * @example
+   * ```ts
+   * const response = await client.sync.getDelta();
+   * ```
+   */
+  getDelta(
+    query: SyncGetDeltaParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SyncGetDeltaResponse> {
+    return this._client.get('/v1/sync/delta', { query, ...options });
+  }
+
+  /**
+   * Return initial Tier 0 (goals/OKRs/use-cases --> tier 0 memories) and Tier 1 (hot
+   * memories) for the requesting user/workspace.
+   *
+   * This is a minimal initial implementation to enable SDK integration. It uses
+   * simple heuristics and will be enhanced with analytics-driven selection.
+   *
+   * @example
+   * ```ts
+   * const response = await client.sync.getTiers();
+   * ```
+   */
+  getTiers(body: SyncGetTiersParams, options?: RequestOptions): APIPromise<SyncGetTiersResponse> {
+    return this._client.post('/v1/sync/tiers', { body, ...options });
+  }
+}
+
+export type SyncGetDeltaResponse = { [key: string]: unknown };
+
+/**
+ * Response model for sync tiers endpoint
+ */
+export interface SyncGetTiersResponse {
+  /**
+   * HTTP status code
+   */
+  code?: number;
+
+  /**
+   * Additional error details or context
+   */
+  details?: unknown;
+
+  /**
+   * Error message if failed
+   */
+  error?: string | null;
+
+  /**
+   * Whether there are more items available
+   */
+  has_more?: boolean;
+
+  /**
+   * Cursor for pagination
+   */
+  next_cursor?: string | null;
+
+  /**
+   * 'success' or 'error'
+   */
+  status?: string;
+
+  /**
+   * Tier 0 items (goals/OKRs/use-cases)
+   */
+  tier0?: Array<Shared.Memory>;
+
+  /**
+   * Tier 1 items (hot memories)
+   */
+  tier1?: Array<Shared.Memory>;
+
+  /**
+   * Transition items between tiers
+   */
+  transitions?: Array<{ [key: string]: unknown }>;
+}
+
+export interface SyncGetDeltaParams {
+  /**
+   * Opaque cursor from previous sync
+   */
+  cursor?: string | null;
+
+  include_embeddings?: boolean;
+
+  limit?: number;
+
+  workspace_id?: string | null;
+}
+
+export interface SyncGetTiersParams {
+  /**
+   * Max items to embed per tier to control latency
+   */
+  embed_limit?: number;
+
+  /**
+   * Embedding model hint: 'sbert' or 'bigbird' or 'Qwen4B'
+   */
+  embed_model?: string;
+
+  /**
+   * Embedding format: 'int8' (quantized, 4x smaller, default for efficiency),
+   * 'float32' (full precision, recommended for CoreML/ANE fp16 models). Only applies
+   * to Tier1; Tier0 always uses float32 when embeddings are included.
+   */
+  embedding_format?: 'int8' | 'float32';
+
+  /**
+   * Optional external user ID to filter tiers by a specific external user. If both
+   * user_id and external_user_id are provided, user_id takes precedence.
+   */
+  external_user_id?: string | null;
+
+  /**
+   * Include embeddings in the response. Format controlled by embedding_format
+   * parameter.
+   */
+  include_embeddings?: boolean;
+
+  /**
+   * Max Tier 0 items (goals/OKRs/use-cases)
+   */
+  max_tier0?: number;
+
+  /**
+   * Max Tier 1 items (hot memories)
+   */
+  max_tier1?: number;
+
+  /**
+   * Optional namespace ID for multi-tenant scoping. When provided, tiers are scoped
+   * to memories within this namespace.
+   */
+  namespace_id?: string | null;
+
+  /**
+   * Optional organization ID for multi-tenant scoping. When provided, tiers are
+   * scoped to memories within this organization.
+   */
+  organization_id?: string | null;
+
+  /**
+   * Optional internal user ID to filter tiers by a specific user. If not provided,
+   * results are not filtered by user. If both user_id and external_user_id are
+   * provided, user_id takes precedence.
+   */
+  user_id?: string | null;
+
+  /**
+   * Optional workspace id to scope tiers
+   */
+  workspace_id?: string | null;
+}
+
+export declare namespace Sync {
+  export {
+    type SyncGetDeltaResponse as SyncGetDeltaResponse,
+    type SyncGetTiersResponse as SyncGetTiersResponse,
+    type SyncGetDeltaParams as SyncGetDeltaParams,
+    type SyncGetTiersParams as SyncGetTiersParams,
+  };
+}

package/src/resources/user.ts

@@ -21,6 +21,18 @@ export class User extends APIResource {
     return this._client.post('/v1/user', { body, ...options });
   }
 
+  /**
+   * Update user details by user_id (\_User.objectId) and developer association
+   *
+   * @example
+   * ```ts
+   * const userResponse = await client.user.update('user_id');
+   * ```
+   */
+  update(userID: string, body: UserUpdateParams, options?: RequestOptions): APIPromise<UserResponse> {
+    return this._client.put(path`/v1/user/${userID}`, { body, ...options });
+  }
+
   /**
    * List users for a developer
    *
@@ -205,6 +217,16 @@ export interface UserCreateParams {
   type?: UserType;
 }
 
+export interface UserUpdateParams {
+  email?: string | null;
+
+  external_id?: string | null;
+
+  metadata?: { [key: string]: unknown } | null;
+
+  type?: UserType | null;
+}
+
 export interface UserListParams {
   email?: string | null;
 
@@ -249,6 +271,7 @@ export declare namespace User {
     type UserDeleteResponse as UserDeleteResponse,
     type UserCreateBatchResponse as UserCreateBatchResponse,
     type UserCreateParams as UserCreateParams,
+    type UserUpdateParams as UserUpdateParams,
     type UserListParams as UserListParams,
     type UserDeleteParams as UserDeleteParams,
     type UserCreateBatchParams as UserCreateBatchParams,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.20.0'; // x-release-please-version
+export const VERSION = '2.0.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.20.0";
+export declare const VERSION = "2.0.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.20.0";
+export declare const VERSION = "2.0.0";
 //# sourceMappingURL=version.d.ts.map

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.20.0'; // x-release-please-version
+exports.VERSION = '2.0.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.20.0'; // x-release-please-version
+export const VERSION = '2.0.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}