@zavudev/sdk 0.57.0 → 0.58.1

package/src/resources/memory/collections/items.ts

@@ -0,0 +1,185 @@
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { Cursor, PagePromise } from '../../../core/pagination';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+import type * as T from '../../../types';
+
+export class Items extends APIResource {
+  /**
+   * List items
+   *
+   * Items in one scope of a collection, by key in lexicographic order. Narrow with
+   * `prefix` — key your documents so a prefix is meaningful (`order:2026-08:...`)
+   * and this becomes a range scan rather than a filter.
+   *
+   * `GET /v1/memory/collections/{collection}/items`
+   */
+  list(
+    collection: string,
+    query: ItemListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<MemoryItemsCursor, MemoryItem> {
+    return this._client.getAPIList(path`/v1/memory/collections/${collection}/items`, Cursor<MemoryItem>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Write items in bulk
+   *
+   * Up to 25 sets and deletes in one call, in one scope.
+   *
+   * **Not a transaction.** Each operation succeeds or fails on its own and is
+   * reported separately; the call returns `200` even when some failed. Check every
+   * entry's `ok` — treating a 200 as "all 25 landed" is the mistake this endpoint
+   * invites.
+   *
+   * `POST /v1/memory/collections/{collection}/items/batch`
+   */
+  batch(
+    collection: string,
+    params: ItemBatchParams,
+    options?: RequestOptions,
+  ): APIPromise<ItemBatchResponse> {
+    const { scope, ...body } = params;
+    return this._client.post(path`/v1/memory/collections/${collection}/items/batch`, {
+      query: { scope },
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Write an item
+   *
+   * Store a JSON document under a key. Creates the collection if it does not exist
+   * — with **no indexes**, which `query` then cannot use. Declare indexes with
+   * `POST /v1/memory/collections` first if you need them.
+   *
+   * This replaces the whole document; it does not merge. Pass `If-Match` with the
+   * revision from a previous read to make the write conditional.
+   *
+   * `PUT /v1/memory/collections/{collection}/items/{key}`
+   */
+  put(key: string, params: ItemPutParams, options?: RequestOptions): APIPromise<ItemPutResponse> {
+    const { collection, 'If-Match': ifMatch, scope, ...body } = params;
+    return this._client.put(path`/v1/memory/collections/${collection}/items/${key}`, {
+      query: { scope },
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(ifMatch != null ? { 'If-Match': ifMatch } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Get an item
+   *
+   * `GET /v1/memory/collections/{collection}/items/{key}`
+   */
+  retrieve(
+    key: string,
+    params: ItemRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<ItemRetrieveResponse> {
+    const { collection, ...query } = params;
+    return this._client.get(path`/v1/memory/collections/${collection}/items/${key}`, { query, ...options });
+  }
+
+  /**
+   * Delete an item
+   *
+   * Idempotent: deleting a key that is not there, or a key of a collection that does
+   * not exist, still answers `204`. Deletes are never refused for quota reasons.
+   *
+   * `DELETE /v1/memory/collections/{collection}/items/{key}`
+   */
+  delete(key: string, params: ItemDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { collection, 'If-Match': ifMatch, ...query } = params;
+    return this._client.delete(path`/v1/memory/collections/${collection}/items/${key}`, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*' },
+        { ...(ifMatch != null ? { 'If-Match': ifMatch } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Query items by field
+   *
+   * Find items by an indexed field instead of by key, within one scope.
+   *
+   * The field must have been declared in `indexes` when the collection was created.
+   * Querying any other field returns `400 field_not_indexed` — including every
+   * field of a collection that was auto-created by its first write, which has no
+   * indexes at all.
+   *
+   * `POST /v1/memory/collections/{collection}/query`
+   */
+  query(
+    collection: string,
+    params: ItemQueryParams,
+    options?: RequestOptions,
+  ): APIPromise<ItemQueryResponse> {
+    const { scope, ...body } = params;
+    return this._client.post(path`/v1/memory/collections/${collection}/query`, {
+      query: { scope },
+      body,
+      ...options,
+    });
+  }
+}
+
+export type ItemListParams = T.MemoryCollectionsItemsListParams;
+
+export type MemoryItem = T.MemoryItem;
+
+export type MemoryItemsCursor = Cursor<T.MemoryItem>;
+
+export type ItemBatchParams = T.MemoryCollectionsItemsBatchParams;
+
+export type ItemBatchResponse = T.MemoryItemBatchResponse;
+
+export type MemoryItemBatchResponse = T.MemoryItemBatchResponse;
+
+export type ItemPutParams = T.MemoryCollectionsItemsPutParams;
+
+export type ItemPutResponse = T.PutMemoryItemResponse;
+
+export type ItemRetrieveParams = T.MemoryCollectionsItemsRetrieveParams;
+
+export type ItemRetrieveResponse = T.GetMemoryItemResponse;
+
+export type ItemDeleteParams = T.MemoryCollectionsItemsDeleteParams;
+
+export type ItemQueryParams = T.MemoryCollectionsItemsQueryParams;
+
+export type ItemQueryResponse = T.QueryMemoryItemsResponse;
+
+export declare namespace Items {
+  export {
+    type ItemBatchParams as ItemBatchParams,
+    type ItemBatchResponse as ItemBatchResponse,
+    type ItemDeleteParams as ItemDeleteParams,
+    type ItemListParams as ItemListParams,
+    type ItemPutParams as ItemPutParams,
+    type ItemPutResponse as ItemPutResponse,
+    type ItemQueryParams as ItemQueryParams,
+    type ItemQueryResponse as ItemQueryResponse,
+    type ItemRetrieveParams as ItemRetrieveParams,
+    type ItemRetrieveResponse as ItemRetrieveResponse,
+    type MemoryItem as MemoryItem,
+    type MemoryItemBatchResponse as MemoryItemBatchResponse,
+    type MemoryItemsCursor as MemoryItemsCursor,
+  };
+}

package/src/resources/memory/collections.ts

@@ -0,0 +1,3 @@
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
+
+export * from './collections/index';

package/src/resources/memory/index.ts

@@ -0,0 +1,34 @@
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
+
+export {
+  MemoryResource,
+  type MemoryAddParams,
+  type MemoryAddResponse,
+  type MemoryRecord,
+  type MemoryScope,
+  type MemoryListParams,
+  type Memory,
+  type MemoriesCursor,
+  type MemoryScopeQuery,
+  type MemoryWipeParams,
+  type MemoryWipeResponse,
+  type MemorySearchParams,
+  type MemorySearchResponse,
+  type MemoryUsageResponse,
+  type MemoryUsage,
+  type MemoryRetrieveParams,
+  type MemoryRetrieveResponse,
+  type MemoryDeleteParams,
+} from './memory';
+export {
+  Collections,
+  type CollectionCreateParams,
+  type CollectionCreateResponse,
+  type MemoryCollection,
+  type CollectionListParams,
+  type MemoryCollectionsCursor,
+  type CollectionRetrieveResponse,
+  type CollectionUpdateParams,
+  type CollectionUpdateResponse,
+  type CollectionDeleteResponse,
+} from './collections/collections';

package/src/resources/memory/memory.ts

@@ -0,0 +1,211 @@
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { Cursor, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+import type * as T from '../../types';
+import * as CollectionsAPI from './collections/collections';
+import {
+  Collections,
+  type CollectionCreateParams,
+  type CollectionCreateResponse,
+  type MemoryCollection,
+  type CollectionListParams,
+  type MemoryCollectionsCursor,
+  type CollectionRetrieveResponse,
+  type CollectionUpdateParams,
+  type CollectionUpdateResponse,
+  type CollectionDeleteResponse,
+} from './collections/collections';
+
+export class MemoryResource extends APIResource {
+  collections: CollectionsAPI.Collections = new CollectionsAPI.Collections(this._client);
+
+  /**
+   * Remember a fact
+   *
+   * Store one fact so the agent can recall it later by meaning. The text is embedded
+   * on write; retrieval is semantic, not keyword.
+   *
+   * **Scope goes in the body here.** Pass `scope` plus the matching `contactId` /
+   * `conversationId`. Omit it for the project scope. Every read endpoint takes the
+   * scope as a `?scope=` query parameter instead — see the `scope` parameter on
+   * `GET /v1/memory`.
+   *
+   * **One fact per call.** A paragraph carrying five unrelated facts is embedded as
+   * an average of all five and retrieved well by none of them.
+   *
+   * `POST /v1/memory`
+   */
+  add(body: MemoryAddParams, options?: RequestOptions): APIPromise<MemoryAddResponse> {
+    return this._client.post('/v1/memory', { body, ...options });
+  }
+
+  /**
+   * List facts
+   *
+   * Every fact in a scope, newest first. This is the bookkeeping view — to
+   * actually recall something, use `POST /v1/memory/search`, which ranks by meaning.
+   *
+   * `GET /v1/memory`
+   */
+  list(
+    query: MemoryListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<MemoriesCursor, Memory> {
+    return this._client.getAPIList('/v1/memory', Cursor<Memory>, { query, ...options });
+  }
+
+  /**
+   * Forget an entire scope
+   *
+   * Delete every fact in one scope. Returns immediately; the purge runs in batches
+   * in the background, so a list right afterwards can still show rows.
+   *
+   * This does not touch collections — `DELETE /v1/memory/collections/{collection}`
+   * does that.
+   *
+   * `DELETE /v1/memory`
+   */
+  wipe(
+    query: MemoryWipeParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MemoryWipeResponse> {
+    return this._client.delete('/v1/memory', { query, ...options });
+  }
+
+  /**
+   * Recall facts by meaning
+   *
+   * Embed the query and return the closest facts in the scope, ranked by cosine
+   * similarity.
+   *
+   * **Scope goes in the body**, like `POST /v1/memory`: `scope` plus the matching
+   * id.
+   *
+   * Without `minScore`, a scope always answers with its `limit` closest facts
+   * however distant they are — a search that found nothing relevant is
+   * indistinguishable from one that found the right thing. Set `minScore` when your
+   * code branches on "did I know this?".
+   *
+   * `POST /v1/memory/search`
+   */
+  search(body: MemorySearchParams, options?: RequestOptions): APIPromise<MemorySearchResponse> {
+    return this._client.post('/v1/memory/search', { body, ...options });
+  }
+
+  /**
+   * Get Memory usage
+   *
+   * This month's Memory consumption for the project, with the plan quotas it is
+   * measured against. Read `capReached` to know whether writes are currently being
+   * refused.
+   *
+   * `GET /v1/memory/usage`
+   */
+  usage(options?: RequestOptions): APIPromise<MemoryUsageResponse> {
+    return this._client.get('/v1/memory/usage', options);
+  }
+
+  /**
+   * Get a fact
+   *
+   * `GET /v1/memory/{memoryId}`
+   */
+  retrieve(
+    memoryID: string,
+    query: MemoryRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MemoryRetrieveResponse> {
+    return this._client.get(path`/v1/memory/${memoryID}`, { query, ...options });
+  }
+
+  /**
+   * Forget a fact
+   *
+   * Delete one fact. Idempotent: deleting a fact that is not there, or no longer
+   * there, still answers `204`. Deletes are never refused for quota reasons.
+   *
+   * `DELETE /v1/memory/{memoryId}`
+   */
+  delete(
+    memoryID: string,
+    query: MemoryDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.delete(path`/v1/memory/${memoryID}`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type MemoryAddParams = T.MemoryAddParams;
+
+export type MemoryAddResponse = T.AddMemoryResponse;
+
+export type MemoryRecord = T.MemoryRecord;
+
+export type MemoryScope = T.MemoryScope;
+
+export type MemoryListParams = T.MemoryListParams;
+
+export type Memory = T.Memory;
+
+export type MemoriesCursor = Cursor<T.Memory>;
+
+export type MemoryScopeQuery = T.MemoryScopeQuery;
+
+export type MemoryWipeParams = T.MemoryWipeParams;
+
+export type MemoryWipeResponse = T.WipeMemoryScopeResponse;
+
+export type MemorySearchParams = T.MemorySearchParams;
+
+export type MemorySearchResponse = T.SearchMemoriesResponse;
+
+export type MemoryUsageResponse = T.GetMemoryUsageResponse;
+
+export type MemoryUsage = T.MemoryUsage;
+
+export type MemoryRetrieveParams = T.MemoryRetrieveParams;
+
+export type MemoryRetrieveResponse = T.GetMemoryResponse;
+
+export type MemoryDeleteParams = T.MemoryDeleteParams;
+
+export declare namespace MemoryResource {
+  export {
+    type MemoriesCursor as MemoriesCursor,
+    type Memory as Memory,
+    type MemoryAddParams as MemoryAddParams,
+    type MemoryAddResponse as MemoryAddResponse,
+    type MemoryDeleteParams as MemoryDeleteParams,
+    type MemoryListParams as MemoryListParams,
+    type MemoryRecord as MemoryRecord,
+    type MemoryRetrieveParams as MemoryRetrieveParams,
+    type MemoryRetrieveResponse as MemoryRetrieveResponse,
+    type MemoryScope as MemoryScope,
+    type MemoryScopeQuery as MemoryScopeQuery,
+    type MemorySearchParams as MemorySearchParams,
+    type MemorySearchResponse as MemorySearchResponse,
+    type MemoryUsage as MemoryUsage,
+    type MemoryUsageResponse as MemoryUsageResponse,
+    type MemoryWipeParams as MemoryWipeParams,
+    type MemoryWipeResponse as MemoryWipeResponse,
+    Collections as Collections,
+    type CollectionCreateParams as CollectionCreateParams,
+    type CollectionCreateResponse as CollectionCreateResponse,
+    type MemoryCollection as MemoryCollection,
+    type CollectionListParams as CollectionListParams,
+    type MemoryCollectionsCursor as MemoryCollectionsCursor,
+    type CollectionRetrieveResponse as CollectionRetrieveResponse,
+    type CollectionUpdateParams as CollectionUpdateParams,
+    type CollectionUpdateResponse as CollectionUpdateResponse,
+    type CollectionDeleteResponse as CollectionDeleteResponse,
+  };
+}

package/src/resources/memory.ts

@@ -0,0 +1,3 @@
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
+
+export * from './memory/index';