@puku-ai/sdk 4.0.1 → 4.0.2

package/dist/vendor/resources/beta/memory-stores/memory-stores.d.ts

@@ -0,0 +1,230 @@
+import { APIResource } from '../../../core/resource';
+import * as BetaAPI from '../beta';
+import * as MemoriesAPI from './memories';
+import { BetaManagedAgentsConflictError, BetaManagedAgentsContentSha256Precondition, BetaManagedAgentsDeletedMemory, BetaManagedAgentsError, BetaManagedAgentsMemory, BetaManagedAgentsMemoryListItem, BetaManagedAgentsMemoryListItemsPageCursor, BetaManagedAgentsMemoryPathConflictError, BetaManagedAgentsMemoryPreconditionFailedError, BetaManagedAgentsMemoryPrefix, BetaManagedAgentsMemoryView, BetaManagedAgentsPrecondition, Memories, MemoryCreateParams, MemoryDeleteParams, MemoryListParams, MemoryRetrieveParams, MemoryUpdateParams } from './memories';
+import * as MemoryVersionsAPI from './memory-versions';
+import { BetaManagedAgentsAPIActor, BetaManagedAgentsActor, BetaManagedAgentsMemoryVersion, BetaManagedAgentsMemoryVersionOperation, BetaManagedAgentsMemoryVersionsPageCursor, BetaManagedAgentsServiceAccountActor, BetaManagedAgentsSessionActor, BetaManagedAgentsUserActor, MemoryVersionListParams, MemoryVersionRedactParams, MemoryVersionRetrieveParams, MemoryVersions } from './memory-versions';
+import { APIPromise } from '../../../core/api-promise';
+import { PageCursor, type PageCursorParams, PagePromise } from '../../../core/pagination';
+import { RequestOptions } from '../../../internal/request-options';
+export declare class MemoryStores extends APIResource {
+    memories: MemoriesAPI.Memories;
+    memoryVersions: MemoryVersionsAPI.MemoryVersions;
+    /**
+     * Create a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryStore =
+     *   await client.beta.memoryStores.create({ name: 'x' });
+     * ```
+     */
+    create(params: MemoryStoreCreateParams, options?: RequestOptions): APIPromise<BetaManagedAgentsMemoryStore>;
+    /**
+     * Retrieve a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryStore =
+     *   await client.beta.memoryStores.retrieve(
+     *     'memory_store_id',
+     *   );
+     * ```
+     */
+    retrieve(memoryStoreID: string, params?: MemoryStoreRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<BetaManagedAgentsMemoryStore>;
+    /**
+     * Update a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryStore =
+     *   await client.beta.memoryStores.update('memory_store_id');
+     * ```
+     */
+    update(memoryStoreID: string, params: MemoryStoreUpdateParams, options?: RequestOptions): APIPromise<BetaManagedAgentsMemoryStore>;
+    /**
+     * List memory stores
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsMemoryStore of client.beta.memoryStores.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params?: MemoryStoreListParams | null | undefined, options?: RequestOptions): PagePromise<BetaManagedAgentsMemoryStoresPageCursor, BetaManagedAgentsMemoryStore>;
+    /**
+     * Delete a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeletedMemoryStore =
+     *   await client.beta.memoryStores.delete('memory_store_id');
+     * ```
+     */
+    delete(memoryStoreID: string, params?: MemoryStoreDeleteParams | null | undefined, options?: RequestOptions): APIPromise<BetaManagedAgentsDeletedMemoryStore>;
+    /**
+     * Archive a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryStore =
+     *   await client.beta.memoryStores.archive('memory_store_id');
+     * ```
+     */
+    archive(memoryStoreID: string, params?: MemoryStoreArchiveParams | null | undefined, options?: RequestOptions): APIPromise<BetaManagedAgentsMemoryStore>;
+}
+export type BetaManagedAgentsMemoryStoresPageCursor = PageCursor<BetaManagedAgentsMemoryStore>;
+/**
+ * Confirmation that a `memory_store` was deleted.
+ */
+export interface BetaManagedAgentsDeletedMemoryStore {
+    /**
+     * ID of the deleted memory store (a `memstore_...` identifier). The store and all
+     * its memories and versions are no longer retrievable.
+     */
+    id: string;
+    type: 'memory_store_deleted';
+}
+/**
+ * A `memory_store`: a named container for agent memories, scoped to a workspace.
+ * Attach a store to a session via `resources[]` to mount it as a directory the
+ * agent can read and write.
+ */
+export interface BetaManagedAgentsMemoryStore {
+    /**
+     * Unique identifier for the memory store (a `memstore_...` tagged ID). Use this
+     * when attaching the store to a session, or in the `{memory_store_id}` path
+     * parameter of subsequent calls.
+     */
+    id: string;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    created_at: string;
+    /**
+     * Human-readable name for the store. 1–255 characters. The store's mount-path slug
+     * under `/mnt/memory/` is derived from this name.
+     */
+    name: string;
+    type: 'memory_store';
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    updated_at: string;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    archived_at?: string | null;
+    /**
+     * Free-text description of what the store contains, up to 1024 characters.
+     * Included in the agent's system prompt when the store is attached, so word it to
+     * be useful to the agent. Empty string when unset.
+     */
+    description?: string;
+    /**
+     * Arbitrary key-value tags for your own bookkeeping (such as the end user a store
+     * belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters.
+     * Returned on retrieve/list but not filterable.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export interface MemoryStoreCreateParams {
+    /**
+     * Body param: Human-readable name for the store. Required; 1–255 characters; no
+     * control characters. The mount-path slug under `/mnt/memory/` is derived from
+     * this name (lowercased, non-alphanumeric runs collapsed to a hyphen). Names need
+     * not be unique within a workspace.
+     */
+    name: string;
+    /**
+     * Body param: Free-text description of what the store contains, up to 1024
+     * characters. Included in the agent's system prompt when the store is attached, so
+     * word it to be useful to the agent.
+     */
+    description?: string;
+    /**
+     * Body param: Arbitrary key-value tags for your own bookkeeping (such as the end
+     * user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512
+     * characters. Not visible to the agent.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface MemoryStoreRetrieveParams {
+    /**
+     * Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface MemoryStoreUpdateParams {
+    /**
+     * Body param: New description for the store, up to 1024 characters. Pass an empty
+     * string to clear it.
+     */
+    description?: string | null;
+    /**
+     * Body param: Metadata patch. Set a key to a string to upsert it, or to null to
+     * delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up
+     * to 64 chars each) with values up to 512 chars.
+     */
+    metadata?: {
+        [key: string]: string | null;
+    } | null;
+    /**
+     * Body param: New human-readable name for the store. 1–255 characters; no control
+     * characters. Renaming changes the slug used for the store's `mount_path` in
+     * sessions created after the update.
+     */
+    name?: string | null;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface MemoryStoreListParams extends PageCursorParams {
+    /**
+     * Query param: Return only stores whose `created_at` is at or after this time
+     * (inclusive). Sent on the wire as `created_at[gte]`.
+     */
+    'created_at[gte]'?: string;
+    /**
+     * Query param: Return only stores whose `created_at` is at or before this time
+     * (inclusive). Sent on the wire as `created_at[lte]`.
+     */
+    'created_at[lte]'?: string;
+    /**
+     * Query param: When `true`, archived stores are included in the results. Defaults
+     * to `false` (archived stores are excluded).
+     */
+    include_archived?: boolean;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface MemoryStoreDeleteParams {
+    /**
+     * Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface MemoryStoreArchiveParams {
+    /**
+     * Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export declare namespace MemoryStores {
+    export { type BetaManagedAgentsDeletedMemoryStore as BetaManagedAgentsDeletedMemoryStore, type BetaManagedAgentsMemoryStore as BetaManagedAgentsMemoryStore, type BetaManagedAgentsMemoryStoresPageCursor as BetaManagedAgentsMemoryStoresPageCursor, type MemoryStoreCreateParams as MemoryStoreCreateParams, type MemoryStoreRetrieveParams as MemoryStoreRetrieveParams, type MemoryStoreUpdateParams as MemoryStoreUpdateParams, type MemoryStoreListParams as MemoryStoreListParams, type MemoryStoreDeleteParams as MemoryStoreDeleteParams, type MemoryStoreArchiveParams as MemoryStoreArchiveParams, };
+    export { Memories as Memories, type BetaManagedAgentsConflictError as BetaManagedAgentsConflictError, type BetaManagedAgentsContentSha256Precondition as BetaManagedAgentsContentSha256Precondition, type BetaManagedAgentsDeletedMemory as BetaManagedAgentsDeletedMemory, type BetaManagedAgentsError as BetaManagedAgentsError, type BetaManagedAgentsMemory as BetaManagedAgentsMemory, type BetaManagedAgentsMemoryListItem as BetaManagedAgentsMemoryListItem, type BetaManagedAgentsMemoryPathConflictError as BetaManagedAgentsMemoryPathConflictError, type BetaManagedAgentsMemoryPreconditionFailedError as BetaManagedAgentsMemoryPreconditionFailedError, type BetaManagedAgentsMemoryPrefix as BetaManagedAgentsMemoryPrefix, type BetaManagedAgentsMemoryView as BetaManagedAgentsMemoryView, type BetaManagedAgentsPrecondition as BetaManagedAgentsPrecondition, type BetaManagedAgentsMemoryListItemsPageCursor as BetaManagedAgentsMemoryListItemsPageCursor, type MemoryCreateParams as MemoryCreateParams, type MemoryRetrieveParams as MemoryRetrieveParams, type MemoryUpdateParams as MemoryUpdateParams, type MemoryListParams as MemoryListParams, type MemoryDeleteParams as MemoryDeleteParams, };
+    export { MemoryVersions as MemoryVersions, type BetaManagedAgentsActor as BetaManagedAgentsActor, type BetaManagedAgentsAPIActor as BetaManagedAgentsAPIActor, type BetaManagedAgentsMemoryVersion as BetaManagedAgentsMemoryVersion, type BetaManagedAgentsMemoryVersionOperation as BetaManagedAgentsMemoryVersionOperation, type BetaManagedAgentsServiceAccountActor as BetaManagedAgentsServiceAccountActor, type BetaManagedAgentsSessionActor as BetaManagedAgentsSessionActor, type BetaManagedAgentsUserActor as BetaManagedAgentsUserActor, type BetaManagedAgentsMemoryVersionsPageCursor as BetaManagedAgentsMemoryVersionsPageCursor, type MemoryVersionRetrieveParams as MemoryVersionRetrieveParams, type MemoryVersionListParams as MemoryVersionListParams, type MemoryVersionRedactParams as MemoryVersionRedactParams, };
+}

package/dist/vendor/resources/beta/memory-stores/memory-stores.js

@@ -0,0 +1,137 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../../core/resource.js';
+import * as MemoriesAPI from './memories.js';
+import { Memories, } from './memories.js';
+import * as MemoryVersionsAPI from './memory-versions.js';
+import { MemoryVersions, } from './memory-versions.js';
+import { PageCursor } from '../../../core/pagination.js';
+import { buildHeaders } from '../../../internal/headers.js';
+import { path } from '../../../internal/utils/path.js';
+export class MemoryStores extends APIResource {
+    memories = new MemoriesAPI.Memories(this._client);
+    memoryVersions = new MemoryVersionsAPI.MemoryVersions(this._client);
+    /**
+     * Create a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryStore =
+     *   await client.beta.memoryStores.create({ name: 'x' });
+     * ```
+     */
+    create(params, options) {
+        const { betas, ...body } = params;
+        return this._client.post('/v1/memory_stores?beta=true', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Retrieve a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryStore =
+     *   await client.beta.memoryStores.retrieve(
+     *     'memory_store_id',
+     *   );
+     * ```
+     */
+    retrieve(memoryStoreID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.get(path `/v1/memory_stores/${memoryStoreID}?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Update a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryStore =
+     *   await client.beta.memoryStores.update('memory_store_id');
+     * ```
+     */
+    update(memoryStoreID, params, options) {
+        const { betas, ...body } = params;
+        return this._client.post(path `/v1/memory_stores/${memoryStoreID}?beta=true`, {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List memory stores
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsMemoryStore of client.beta.memoryStores.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList('/v1/memory_stores?beta=true', (PageCursor), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Delete a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeletedMemoryStore =
+     *   await client.beta.memoryStores.delete('memory_store_id');
+     * ```
+     */
+    delete(memoryStoreID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.delete(path `/v1/memory_stores/${memoryStoreID}?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Archive a memory store
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryStore =
+     *   await client.beta.memoryStores.archive('memory_store_id');
+     * ```
+     */
+    archive(memoryStoreID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.post(path `/v1/memory_stores/${memoryStoreID}/archive?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'puku-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+MemoryStores.Memories = Memories;
+MemoryStores.MemoryVersions = MemoryVersions;
+//# sourceMappingURL=memory-stores.js.map

package/dist/vendor/resources/beta/memory-stores/memory-stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-stores.js","sourceRoot":"","sources":["../../../../../src/vendor/resources/beta/memory-stores/memory-stores.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,WAAW,MAAM,YAAY,CAAC;AAC1C,OAAO,EAaL,QAAQ,GAMT,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,iBAAiB,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAYL,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAsC,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEpD,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C,QAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxE,cAAc,GAAqC,IAAI,iBAAiB,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEtG;;;;;;;;OAQG;IACH,MAAM,CACJ,MAA+B,EAC/B,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACtD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CACN,aAAqB,EACrB,SAAuD,EAAE,EACzD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,qBAAqB,aAAa,YAAY,EAAE;YAC1E,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CACJ,aAAqB,EACrB,MAA+B,EAC/B,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,aAAa,YAAY,EAAE;YAC3E,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,SAAmD,EAAE,EACrD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAA,UAAwC,CAAA,EAAE;YACtG,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CACJ,aAAqB,EACrB,SAAqD,EAAE,EACvD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,qBAAqB,aAAa,YAAY,EAAE;YAC7E,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CACL,aAAqB,EACrB,SAAsD,EAAE,EACxD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,aAAa,oBAAoB,EAAE;YACnF,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AA0KD,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,YAAY,CAAC,cAAc,GAAG,cAAc,CAAC"}

package/dist/vendor/resources/beta/memory-stores/memory-versions.d.ts

@@ -0,0 +1,252 @@
+import { APIResource } from '../../../core/resource';
+import * as BetaAPI from '../beta';
+import * as MemoriesAPI from './memories';
+import { APIPromise } from '../../../core/api-promise';
+import { PageCursor, type PageCursorParams, PagePromise } from '../../../core/pagination';
+import { RequestOptions } from '../../../internal/request-options';
+export declare class MemoryVersions extends APIResource {
+    /**
+     * Retrieve a memory version
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryVersion =
+     *   await client.beta.memoryStores.memoryVersions.retrieve(
+     *     'memory_version_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    retrieve(memoryVersionID: string, params: MemoryVersionRetrieveParams, options?: RequestOptions): APIPromise<BetaManagedAgentsMemoryVersion>;
+    /**
+     * List memory versions
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsMemoryVersion of client.beta.memoryStores.memoryVersions.list(
+     *   'memory_store_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(memoryStoreID: string, params?: MemoryVersionListParams | null | undefined, options?: RequestOptions): PagePromise<BetaManagedAgentsMemoryVersionsPageCursor, BetaManagedAgentsMemoryVersion>;
+    /**
+     * Redact a memory version
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemoryVersion =
+     *   await client.beta.memoryStores.memoryVersions.redact(
+     *     'memory_version_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    redact(memoryVersionID: string, params: MemoryVersionRedactParams, options?: RequestOptions): APIPromise<BetaManagedAgentsMemoryVersion>;
+}
+export type BetaManagedAgentsMemoryVersionsPageCursor = PageCursor<BetaManagedAgentsMemoryVersion>;
+/**
+ * Identifies who performed a write or redact operation. Captured at write time on
+ * the `memory_version` row. The API key that created a session is not recorded on
+ * agent writes; attribution answers who made the write, not who is ultimately
+ * responsible. Look up session provenance separately via the
+ * [Sessions API](/en/api/sessions-retrieve).
+ */
+export type BetaManagedAgentsActor = BetaManagedAgentsSessionActor | BetaManagedAgentsAPIActor | BetaManagedAgentsUserActor | BetaManagedAgentsServiceAccountActor;
+/**
+ * Attribution for a write made directly via the public API (outside of any
+ * session).
+ */
+export interface BetaManagedAgentsAPIActor {
+    /**
+     * ID of the API key that performed the write. This identifies the key, not the
+     * secret.
+     */
+    api_key_id: string;
+    type: 'api_actor';
+}
+/**
+ * A `memory_version` object: one immutable, attributed row in a memory's
+ * append-only history. Every non-no-op mutation to a memory produces a new
+ * version. Versions belong to the store (not the individual memory) and are not
+ * deleted with the memory; each version is retained for at least the version
+ * retention period after it was written, unless the store itself is deleted.
+ * Retrieving a redacted version returns 200 with `content`, `path`,
+ * `content_size_bytes`, and `content_sha256` set to `null`; branch on
+ * `redacted_at`, not HTTP status.
+ */
+export interface BetaManagedAgentsMemoryVersion {
+    /**
+     * Unique identifier for this version (a `memver_...` value).
+     */
+    id: string;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    created_at: string;
+    /**
+     * ID of the memory this version snapshots (a `mem_...` value). Remains valid after
+     * the memory is deleted; pass it as `memory_id` to
+     * [List memory versions](/en/api/beta/memory_stores/memory_versions/list) to
+     * retrieve the memory's retained versions, including the `deleted` row while the
+     * lineage is retained.
+     */
+    memory_id: string;
+    /**
+     * ID of the memory store this version belongs to (a `memstore_...` value).
+     */
+    memory_store_id: string;
+    /**
+     * The kind of mutation a `memory_version` records. Every non-no-op mutation to a
+     * memory appends exactly one version row with one of these values.
+     */
+    operation: BetaManagedAgentsMemoryVersionOperation;
+    type: 'memory_version';
+    /**
+     * The memory's UTF-8 text content as of this version. `null` when `view=basic`,
+     * when `operation` is `deleted`, or when `redacted_at` is set.
+     */
+    content?: string | null;
+    /**
+     * Lowercase hex SHA-256 digest of `content` as of this version (64 characters).
+     * `null` when `redacted_at` is set or `operation` is `deleted`. Populated
+     * regardless of `view` otherwise.
+     */
+    content_sha256?: string | null;
+    /**
+     * Size of `content` in bytes as of this version. `null` when `redacted_at` is set
+     * or `operation` is `deleted`. Populated regardless of `view` otherwise.
+     */
+    content_size_bytes?: number | null;
+    /**
+     * Identifies who performed a write or redact operation. Captured at write time on
+     * the `memory_version` row. The API key that created a session is not recorded on
+     * agent writes; attribution answers who made the write, not who is ultimately
+     * responsible. Look up session provenance separately via the
+     * [Sessions API](/en/api/sessions-retrieve).
+     */
+    created_by?: BetaManagedAgentsActor;
+    /**
+     * The memory's path at the time of this write. `null` if and only if `redacted_at`
+     * is set.
+     */
+    path?: string | null;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    redacted_at?: string | null;
+    /**
+     * Identifies who performed a write or redact operation. Captured at write time on
+     * the `memory_version` row. The API key that created a session is not recorded on
+     * agent writes; attribution answers who made the write, not who is ultimately
+     * responsible. Look up session provenance separately via the
+     * [Sessions API](/en/api/sessions-retrieve).
+     */
+    redacted_by?: BetaManagedAgentsActor;
+}
+/**
+ * The kind of mutation a `memory_version` records. Every non-no-op mutation to a
+ * memory appends exactly one version row with one of these values.
+ */
+export type BetaManagedAgentsMemoryVersionOperation = 'created' | 'modified' | 'deleted';
+/**
+ * Attribution for a write made by a workload authenticated as a service account,
+ * for example via Workload Identity Federation.
+ */
+export interface BetaManagedAgentsServiceAccountActor {
+    /**
+     * ID of the service account that performed the write (a `svac_...` value).
+     */
+    service_account_id: string;
+    type: 'service_account_actor';
+}
+/**
+ * Attribution for a write made by an agent during a session, through the mounted
+ * filesystem at `/mnt/memory/`.
+ */
+export interface BetaManagedAgentsSessionActor {
+    /**
+     * ID of the session that performed the write (a `sesn_...` value). Look up the
+     * session via [Retrieve a session](/en/api/sessions-retrieve) for further
+     * provenance.
+     */
+    session_id: string;
+    type: 'session_actor';
+}
+/**
+ * Attribution for a write made by a human user through the PukuAI Console.
+ */
+export interface BetaManagedAgentsUserActor {
+    type: 'user_actor';
+    /**
+     * ID of the user who performed the write (a `user_...` value).
+     */
+    user_id: string;
+}
+export interface MemoryVersionRetrieveParams {
+    /**
+     * Path param: Path parameter memory_store_id
+     */
+    memory_store_id: string;
+    /**
+     * Query param: Query parameter for view
+     */
+    view?: MemoriesAPI.BetaManagedAgentsMemoryView;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface MemoryVersionListParams extends PageCursorParams {
+    /**
+     * Query param: Query parameter for api_key_id
+     */
+    api_key_id?: string;
+    /**
+     * Query param: Return versions created at or after this time (inclusive).
+     */
+    'created_at[gte]'?: string;
+    /**
+     * Query param: Return versions created at or before this time (inclusive).
+     */
+    'created_at[lte]'?: string;
+    /**
+     * Query param: Query parameter for memory_id
+     */
+    memory_id?: string;
+    /**
+     * Query param: Query parameter for operation
+     */
+    operation?: BetaManagedAgentsMemoryVersionOperation;
+    /**
+     * Query param: Query parameter for service_account_id
+     */
+    service_account_id?: string;
+    /**
+     * Query param: Query parameter for session_id
+     */
+    session_id?: string;
+    /**
+     * Query param: Query parameter for view
+     */
+    view?: MemoriesAPI.BetaManagedAgentsMemoryView;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface MemoryVersionRedactParams {
+    /**
+     * Path param: Path parameter memory_store_id
+     */
+    memory_store_id: string;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export declare namespace MemoryVersions {
+    export { type BetaManagedAgentsActor as BetaManagedAgentsActor, type BetaManagedAgentsAPIActor as BetaManagedAgentsAPIActor, type BetaManagedAgentsMemoryVersion as BetaManagedAgentsMemoryVersion, type BetaManagedAgentsMemoryVersionOperation as BetaManagedAgentsMemoryVersionOperation, type BetaManagedAgentsServiceAccountActor as BetaManagedAgentsServiceAccountActor, type BetaManagedAgentsSessionActor as BetaManagedAgentsSessionActor, type BetaManagedAgentsUserActor as BetaManagedAgentsUserActor, type BetaManagedAgentsMemoryVersionsPageCursor as BetaManagedAgentsMemoryVersionsPageCursor, type MemoryVersionRetrieveParams as MemoryVersionRetrieveParams, type MemoryVersionListParams as MemoryVersionListParams, type MemoryVersionRedactParams as MemoryVersionRedactParams, };
+}