@datalayer/agent-runtimes 1.3.45 → 1.3.46

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

@@ -217,6 +217,34 @@ export declare const correctRuntimeMemory: (token: string, memoryId: string, tex
  * the service refuses (409) in a sentence (LOOP R-18).
  */
 export declare const forgetRuntimeMemories: (token: string, agentId: string, count: number, baseUrl?: string) => Promise<ForgetRuntimeMemoriesResponse>;
+/**
+ * One allowance of a person (LOOP R-35): `reader` uses what `source`
+ * remembers of them, both applications by their key `app:<uid>`.
+ */
+export interface RuntimeMemoryShare {
+    source: string;
+    reader: string;
+    /** When it was allowed (ISO). */
+    allowed_at: string | null;
+}
+/**
+ * The caller's allowances: who reads what one application remembers of them
+ * (`source`), or what one application reads besides its own (`reader`).
+ */
+export declare const listRuntimeMemoryShares: (token: string, filter: {
+    source?: string;
+    reader?: string;
+}, baseUrl?: string) => Promise<RuntimeMemoryShare[]>;
+/**
+ * Allow `reader` to use what `source` remembers of the caller (LOOP R-35).
+ * Allowed again, it is kept as it was.
+ */
+export declare const allowRuntimeMemoryShare: (token: string, source: string, reader: string, baseUrl?: string) => Promise<RuntimeMemoryShare>;
+/**
+ * Stop sharing what `source` remembers of the caller with `reader`
+ * (LOOP R-35); the service refuses (404) what was never allowed.
+ */
+export declare const stopRuntimeMemoryShare: (token: string, source: string, reader: string, baseUrl?: string) => Promise<void>;
 /**
  * Resume a paused runtime by restoring from a checkpoint (async).
  *

package/lib/api/runtimes/runtimes.js

@@ -325,6 +325,60 @@ export const forgetRuntimeMemories = async (token, agentId, count, baseUrl = DEF
         forgotten: Number(response?.forgotten ?? 0),
     };
 };
+/**
+ * The caller's allowances: who reads what one application remembers of them
+ * (`source`), or what one application reads besides its own (`reader`).
+ */
+export const listRuntimeMemoryShares = async (token, filter, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
+    validateToken(token);
+    const query = new URLSearchParams();
+    if (filter.source) {
+        query.set('source', filter.source.trim());
+    }
+    if (filter.reader) {
+        query.set('reader', filter.reader.trim());
+    }
+    const response = await requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/memory-shares?${query.toString()}`,
+        method: 'GET',
+        token,
+    });
+    return Array.isArray(response?.shares) ? response.shares : [];
+};
+/**
+ * Allow `reader` to use what `source` remembers of the caller (LOOP R-35).
+ * Allowed again, it is kept as it was.
+ */
+export const allowRuntimeMemoryShare = async (token, source, reader, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
+    validateToken(token);
+    validateRequiredString(source, 'The application remembering');
+    validateRequiredString(reader, 'The application reading');
+    const response = await requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/memory-shares`,
+        method: 'PUT',
+        body: { source: source.trim(), reader: reader.trim() },
+        token,
+    });
+    return response?.share;
+};
+/**
+ * Stop sharing what `source` remembers of the caller with `reader`
+ * (LOOP R-35); the service refuses (404) what was never allowed.
+ */
+export const stopRuntimeMemoryShare = async (token, source, reader, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
+    validateToken(token);
+    validateRequiredString(source, 'The application remembering');
+    validateRequiredString(reader, 'The application reading');
+    const query = new URLSearchParams({
+        source: source.trim(),
+        reader: reader.trim(),
+    });
+    await requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/memory-shares?${query.toString()}`,
+        method: 'DELETE',
+        token,
+    });
+};
 /**
  * Resume a paused runtime by restoring from a checkpoint (async).
  *

package/lib/client/AgentRuntimesClient.d.ts

@@ -14,7 +14,7 @@ import type { SpaceDTO, UpdateSpaceRequest } from '../models/SpaceDTO';
 import type { NotebookDTO } from '../models/NotebookDTO';
 import type { LexicalDTO } from '../models/LexicalDTO';
 import type { ProjectDTO, ProjectDefaultItems } from '../models/ProjectDTO';
-import type { RuntimeMemory, ListRuntimeMemoriesOptions } from '../api/runtimes/runtimes';
+import type { RuntimeMemory, RuntimeMemoryShare, ListRuntimeMemoriesOptions } from '../api/runtimes/runtimes';
 declare const AgentRuntimesClientWithMixins: {
     new (...args: any[]): {
         getMySpaces(): Promise<SpaceDTO[]>;
@@ -61,6 +61,12 @@ declare const AgentRuntimesClientWithMixins: {
         forgetRuntimeMemory(memoryId: string): Promise<number>;
         correctRuntimeMemory(memoryId: string, text: string): Promise<RuntimeMemory>;
         forgetRuntimeMemories(agentId: string, count: number): Promise<number>;
+        listRuntimeMemoryShares(filter: {
+            source?: string;
+            reader?: string;
+        }): Promise<RuntimeMemoryShare[]>;
+        allowRuntimeMemoryShare(source: string, reader: string): Promise<RuntimeMemoryShare>;
+        stopRuntimeMemoryShare(source: string, reader: string): Promise<void>;
         terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;
         createSnapshot(runtimeName: string, name: string, description: string, stop?: boolean): Promise<CodeSandboxSnapshotDTO>;
         listSnapshots(): Promise<CodeSandboxSnapshotDTO[]>;
@@ -98,6 +104,12 @@ export interface AgentRuntimesClient extends DatalayerCoreClient {
     forgetRuntimeMemory(memoryId: string): Promise<number>;
     correctRuntimeMemory(memoryId: string, text: string): Promise<RuntimeMemory>;
     forgetRuntimeMemories(agentId: string, count: number): Promise<number>;
+    listRuntimeMemoryShares(filter: {
+        source?: string;
+        reader?: string;
+    }): Promise<RuntimeMemoryShare[]>;
+    allowRuntimeMemoryShare(source: string, reader: string): Promise<RuntimeMemoryShare>;
+    stopRuntimeMemoryShare(source: string, reader: string): Promise<void>;
     getRuntime(runtimeName: string): Promise<RuntimeDTO>;
     deleteRuntime(runtimeName: string): Promise<void>;
     terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>;

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

@@ -1,4 +1,4 @@
-import type { RuntimeMemory, ListRuntimeMemoriesOptions } from '../../api/runtimes/runtimes';
+import type { RuntimeMemory, RuntimeMemoryShare, ListRuntimeMemoriesOptions } from '../../api/runtimes/runtimes';
 import type { Constructor } from '@datalayer/core/lib/client/utils/mixins';
 import { EnvironmentDTO } from '../../models/EnvironmentDTO';
 import { RuntimeDTO } from '../../models/RuntimeDTO';
@@ -106,6 +106,18 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
          * the caller, no more than the `count` confirmed.
          */
         forgetRuntimeMemories(agentId: string, count: number): Promise<number>;
+        /**
+         * The caller's allowances to share what an application remembers of
+         * them with another (LOOP R-35), by `source` or by `reader`.
+         */
+        listRuntimeMemoryShares(filter: {
+            source?: string;
+            reader?: string;
+        }): Promise<RuntimeMemoryShare[]>;
+        /** Allow `reader` to use what `source` remembers of the caller. */
+        allowRuntimeMemoryShare(source: string, reader: string): Promise<RuntimeMemoryShare>;
+        /** Stop sharing what `source` remembers of the caller with `reader`. */
+        stopRuntimeMemoryShare(source: string, reader: string): Promise<void>;
         /**
          * Terminate all runtimes.
          * Lists all runtimes and deletes them in parallel.

package/lib/client/mixins/RuntimesMixin.js

@@ -198,6 +198,27 @@ export function RuntimesMixin(Base) {
             const response = await runtimes.forgetRuntimeMemories(token, agentId, count, runtimesUrl);
             return response.forgotten;
         }
+        /**
+         * The caller's allowances to share what an application remembers of
+         * them with another (LOOP R-35), by `source` or by `reader`.
+         */
+        async listRuntimeMemoryShares(filter) {
+            const token = this.getToken();
+            const runtimesUrl = this.getRuntimesUrl();
+            return runtimes.listRuntimeMemoryShares(token, filter, runtimesUrl);
+        }
+        /** Allow `reader` to use what `source` remembers of the caller. */
+        async allowRuntimeMemoryShare(source, reader) {
+            const token = this.getToken();
+            const runtimesUrl = this.getRuntimesUrl();
+            return runtimes.allowRuntimeMemoryShare(token, source, reader, runtimesUrl);
+        }
+        /** Stop sharing what `source` remembers of the caller with `reader`. */
+        async stopRuntimeMemoryShare(source, reader) {
+            const token = this.getToken();
+            const runtimesUrl = this.getRuntimesUrl();
+            await runtimes.stopRuntimeMemoryShare(token, source, reader, runtimesUrl);
+        }
         /**
          * 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.45",
+    "version": "1.3.46",
     "type": "module",
     "workspaces": [
         ".",