@datalayer/agent-runtimes 1.3.42 → 1.3.43

package/lib/api/runtimes/runtimes.d.ts

@@ -177,6 +177,27 @@ export declare const listRuntimeMemories: (token: string, options?: ListRuntimeM
  * Fetch one persisted memory by id from the runtimes API.
  */
 export declare const getRuntimeMemory: (token: string, memoryId: string, baseUrl?: string) => Promise<GetRuntimeMemoryResponse>;
+/**
+ * What forgetting answers: how many memories were forgotten.
+ */
+export interface ForgetRuntimeMemoriesResponse {
+    success: boolean;
+    forgotten: number;
+}
+/**
+ * Forget one of the caller's own persisted memories (LOOP R-18).
+ *
+ * Somebody else's is not found (404), whoever asks: forgetting is the
+ * person's own.
+ */
+export declare const forgetRuntimeMemory: (token: string, memoryId: string, baseUrl?: string) => Promise<ForgetRuntimeMemoriesResponse>;
+/**
+ * Forget everything one agent — an application, by its key `app:<uid>` —
+ * remembers of the caller, no more than `count`: the number the person was
+ * shown and confirmed. When it remembers more now, nothing is forgotten and
+ * the service refuses (409) in a sentence (LOOP R-18).
+ */
+export declare const forgetRuntimeMemories: (token: string, agentId: string, count: number, baseUrl?: string) => Promise<ForgetRuntimeMemoriesResponse>;
 /**
  * Resume a paused runtime by restoring from a checkpoint (async).
  *

package/lib/api/runtimes/runtimes.js

@@ -258,6 +258,51 @@ export const getRuntimeMemory = async (token, memoryId, baseUrl = DEFAULT_SERVIC
         memory: response?.memory,
     };
 };
+/**
+ * Forget one of the caller's own persisted memories (LOOP R-18).
+ *
+ * Somebody else's is not found (404), whoever asks: forgetting is the
+ * person's own.
+ */
+export const forgetRuntimeMemory = async (token, memoryId, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
+    validateToken(token);
+    validateRequiredString(memoryId, 'Memory id');
+    const response = await requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/memories/${encodeURIComponent(memoryId)}`,
+        method: 'DELETE',
+        token,
+    });
+    return {
+        success: Boolean(response?.success),
+        forgotten: Number(response?.forgotten ?? 0),
+    };
+};
+/**
+ * Forget everything one agent — an application, by its key `app:<uid>` —
+ * remembers of the caller, no more than `count`: the number the person was
+ * shown and confirmed. When it remembers more now, nothing is forgotten and
+ * the service refuses (409) in a sentence (LOOP R-18).
+ */
+export const forgetRuntimeMemories = async (token, agentId, count, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
+    validateToken(token);
+    validateRequiredString(agentId, 'Agent id');
+    if (!Number.isInteger(count) || count < 0) {
+        throw new Error(`Forgetting needs the count confirmed, not ${count}.`);
+    }
+    const query = new URLSearchParams({
+        agent_id: agentId.trim(),
+        count: String(count),
+    });
+    const response = await requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/memories?${query.toString()}`,
+        method: 'DELETE',
+        token,
+    });
+    return {
+        success: Boolean(response?.success),
+        forgotten: Number(response?.forgotten ?? 0),
+    };
+};
 /**
  * Resume a paused runtime by restoring from a checkpoint (async).
  *

package/lib/client/AgentRuntimesClient.d.ts

@@ -58,6 +58,8 @@ declare const AgentRuntimesClientWithMixins: {
         deleteRuntime(runtimeName: string): Promise<void>;
         listRuntimeMemories(options?: ListRuntimeMemoriesOptions): Promise<RuntimeMemory[]>;
         getRuntimeMemory(memoryId: string): Promise<RuntimeMemory>;
+        forgetRuntimeMemory(memoryId: string): Promise<number>;
+        forgetRuntimeMemories(agentId: string, count: number): Promise<number>;
         terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;
         createSnapshot(runtimeName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
         listSnapshots(): Promise<CodeSandboxSnapshotDTO[]>;
@@ -92,6 +94,8 @@ export interface AgentRuntimesClient extends DatalayerCoreClient {
     listRuntimes(): Promise<RuntimeDTO[]>;
     listRuntimeMemories(options?: ListRuntimeMemoriesOptions): Promise<RuntimeMemory[]>;
     getRuntimeMemory(memoryId: string): Promise<RuntimeMemory>;
+    forgetRuntimeMemory(memoryId: string): Promise<number>;
+    forgetRuntimeMemories(agentId: string, count: number): Promise<number>;
     getRuntime(runtimeName: string): Promise<RuntimeDTO>;
     deleteRuntime(runtimeName: string): Promise<void>;
     terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;

package/lib/client/mixins/RuntimesMixin.d.ts

@@ -92,6 +92,15 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
          * Fetch one persisted memory by id.
          */
         getRuntimeMemory(memoryId: string): Promise<RuntimeMemory>;
+        /**
+         * Forget one of the caller's own memories; answers how many were forgotten.
+         */
+        forgetRuntimeMemory(memoryId: string): Promise<number>;
+        /**
+         * Forget everything an agent or application (`app:<uid>`) remembers of
+         * the caller, no more than the `count` confirmed.
+         */
+        forgetRuntimeMemories(agentId: string, count: number): Promise<number>;
         /**
          * Terminate all runtimes.
          * Lists all runtimes and deletes them in parallel.

package/lib/client/mixins/RuntimesMixin.js

@@ -169,6 +169,25 @@ export function RuntimesMixin(Base) {
             const response = await runtimes.getRuntimeMemory(token, memoryId, runtimesUrl);
             return response.memory;
         }
+        /**
+         * Forget one of the caller's own memories; answers how many were forgotten.
+         */
+        async forgetRuntimeMemory(memoryId) {
+            const token = this.getToken();
+            const runtimesUrl = this.getRuntimesUrl();
+            const response = await runtimes.forgetRuntimeMemory(token, memoryId, runtimesUrl);
+            return response.forgotten;
+        }
+        /**
+         * Forget everything an agent or application (`app:<uid>`) remembers of
+         * the caller, no more than the `count` confirmed.
+         */
+        async forgetRuntimeMemories(agentId, count) {
+            const token = this.getToken();
+            const runtimesUrl = this.getRuntimesUrl();
+            const response = await runtimes.forgetRuntimeMemories(token, agentId, count, runtimesUrl);
+            return response.forgotten;
+        }
         /**
          * Terminate all runtimes.
          * Lists all runtimes and deletes them in parallel.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.42",
+    "version": "1.3.43",
     "type": "module",
     "workspaces": [
         ".",