@scenario-labs/sdk 3.2.0 → 3.3.1

package/src/resources/projects/memory.ts

@@ -0,0 +1,134 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Memory extends APIResource {
+  /**
+   * Get the caller's assistant memory scoped to this project (auto-learned). Returns
+   * 404 if empty.
+   */
+  retrieve(projectID: string, options?: RequestOptions): APIPromise<MemoryRetrieveResponse> {
+    return this._client.get(path`/projects/${projectID}/memory`, options);
+  }
+
+  /**
+   * Set the caller's assistant memory scoped to this project (markdown, max 30KB).
+   * Set content to null to clear.
+   */
+  update(
+    projectID: string,
+    body: MemoryUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<MemoryUpdateResponse> {
+    return this._client.put(path`/projects/${projectID}/memory`, { body, ...options });
+  }
+}
+
+export interface MemoryRetrieveResponse {
+  /**
+   * Public JSON shape returned by GET endpoints
+   */
+  memory: MemoryRetrieveResponse.Memory;
+}
+
+export namespace MemoryRetrieveResponse {
+  /**
+   * Public JSON shape returned by GET endpoints
+   */
+  export interface Memory {
+    /**
+     * The memory ID — deterministic from scope + parent IDs (example:
+     * "mem_team_team_abc")
+     */
+    id: string;
+
+    /**
+     * Markdown content of the memory
+     */
+    content: string;
+
+    /**
+     * ISO 8601 timestamp when the memory was first written
+     */
+    createdAt: string;
+
+    /**
+     * UTF-8 byte length of the content — used for quota enforcement
+     */
+    sizeBytes: number;
+
+    /**
+     * ISO 8601 timestamp when the memory was last updated
+     */
+    updatedAt: string;
+
+    /**
+     * The userId of the last writer — useful for audit/UI
+     */
+    updatedBy: string;
+  }
+}
+
+export interface MemoryUpdateResponse {
+  /**
+   * Public JSON shape returned by GET endpoints
+   */
+  memory?: MemoryUpdateResponse.Memory;
+}
+
+export namespace MemoryUpdateResponse {
+  /**
+   * Public JSON shape returned by GET endpoints
+   */
+  export interface Memory {
+    /**
+     * The memory ID — deterministic from scope + parent IDs (example:
+     * "mem_team_team_abc")
+     */
+    id: string;
+
+    /**
+     * Markdown content of the memory
+     */
+    content: string;
+
+    /**
+     * ISO 8601 timestamp when the memory was first written
+     */
+    createdAt: string;
+
+    /**
+     * UTF-8 byte length of the content — used for quota enforcement
+     */
+    sizeBytes: number;
+
+    /**
+     * ISO 8601 timestamp when the memory was last updated
+     */
+    updatedAt: string;
+
+    /**
+     * The userId of the last writer — useful for audit/UI
+     */
+    updatedBy: string;
+  }
+}
+
+export interface MemoryUpdateParams {
+  /**
+   * Markdown content of the memory. Set to null to clear. Max size depends on the
+   * scope (20-50 KB).
+   */
+  content?: string;
+}
+
+export declare namespace Memory {
+  export {
+    type MemoryRetrieveResponse as MemoryRetrieveResponse,
+    type MemoryUpdateResponse as MemoryUpdateResponse,
+    type MemoryUpdateParams as MemoryUpdateParams,
+  };
+}