@datalayer/agent-runtimes 1.3.43 → 1.3.45

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

@@ -135,6 +135,10 @@ export interface RuntimeMemory {
     scope?: string | null;
     created_at?: string | null;
     updated_at?: string | null;
+    /** Who corrected it, when it was corrected in place (LOOP R-34). */
+    corrected_by?: string | null;
+    /** When it was corrected (ISO). */
+    corrected_at?: string | null;
     metadata?: Record<string, unknown>;
 }
 /**
@@ -191,6 +195,21 @@ export interface ForgetRuntimeMemoriesResponse {
  * person's own.
  */
 export declare const forgetRuntimeMemory: (token: string, memoryId: string, baseUrl?: string) => Promise<ForgetRuntimeMemoriesResponse>;
+/**
+ * What a correction answers: the memory as it is now kept.
+ */
+export interface CorrectRuntimeMemoryResponse {
+    success: boolean;
+    memory: RuntimeMemory;
+}
+/**
+ * Correct one of the caller's own persisted memories in place (LOOP R-34):
+ * its words become `text`, kept with who corrected it and when.
+ *
+ * Somebody else's is not found (404), whoever asks; empty words, more than
+ * the service keeps, or the words it already has are refused (422).
+ */
+export declare const correctRuntimeMemory: (token: string, memoryId: string, text: string, baseUrl?: string) => Promise<CorrectRuntimeMemoryResponse>;
 /**
  * Forget everything one agent — an application, by its key `app:<uid>` —
  * remembers of the caller, no more than `count`: the number the person was

package/lib/api/runtimes/runtimes.js

@@ -277,6 +277,28 @@ export const forgetRuntimeMemory = async (token, memoryId, baseUrl = DEFAULT_SER
         forgotten: Number(response?.forgotten ?? 0),
     };
 };
+/**
+ * Correct one of the caller's own persisted memories in place (LOOP R-34):
+ * its words become `text`, kept with who corrected it and when.
+ *
+ * Somebody else's is not found (404), whoever asks; empty words, more than
+ * the service keeps, or the words it already has are refused (422).
+ */
+export const correctRuntimeMemory = async (token, memoryId, text, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
+    validateToken(token);
+    validateRequiredString(memoryId, 'Memory id');
+    validateRequiredString(text, 'What it should remember');
+    const response = await requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.RUNTIMES}/memories/${encodeURIComponent(memoryId)}`,
+        method: 'PATCH',
+        body: { memory: text },
+        token,
+    });
+    return {
+        success: Boolean(response?.success),
+        memory: response?.memory,
+    };
+};
 /**
  * Forget everything one agent — an application, by its key `app:<uid>` —
  * remembers of the caller, no more than `count`: the number the person was

package/lib/client/AgentRuntimesClient.d.ts

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

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

@@ -96,6 +96,11 @@ export declare function RuntimesMixin<TBase extends Constructor>(Base: TBase): {
          * Forget one of the caller's own memories; answers how many were forgotten.
          */
         forgetRuntimeMemory(memoryId: string): Promise<number>;
+        /**
+         * Correct one of the caller's own memories in place (LOOP R-34): its
+         * words become `text`, kept with who corrected it and when.
+         */
+        correctRuntimeMemory(memoryId: string, text: string): Promise<RuntimeMemory>;
         /**
          * Forget everything an agent or application (`app:<uid>`) remembers of
          * the caller, no more than the `count` confirmed.

package/lib/client/mixins/RuntimesMixin.js

@@ -178,6 +178,16 @@ export function RuntimesMixin(Base) {
             const response = await runtimes.forgetRuntimeMemory(token, memoryId, runtimesUrl);
             return response.forgotten;
         }
+        /**
+         * Correct one of the caller's own memories in place (LOOP R-34): its
+         * words become `text`, kept with who corrected it and when.
+         */
+        async correctRuntimeMemory(memoryId, text) {
+            const token = this.getToken();
+            const runtimesUrl = this.getRuntimesUrl();
+            const response = await runtimes.correctRuntimeMemory(token, memoryId, text, runtimesUrl);
+            return response.memory;
+        }
         /**
          * Forget everything an agent or application (`app:<uid>`) remembers of
          * the caller, no more than the `count` confirmed.

package/lib/loop/apps/AppRenderer.d.ts

@@ -71,6 +71,12 @@ export type AppInstance = {
     deploymentUid?: string;
     /** The version that runs. */
     version?: number;
+    /**
+     * The organization it belongs to: its agent keeps to that organization's
+     * contexts, read by the runtime from IAM (LOOP U-31); unsaid for an
+     * application of nobody's organization.
+     */
+    organizationUid?: string;
 };
 export type AppRendererProps = Omit<LoopEmbedProps, 'agentId'> & {
     /** The application to render. */

package/lib/loop/apps/AppRenderer.js

@@ -212,6 +212,9 @@ export function appDatalayerCreatePayload(app, instance) {
                     app_uid: instance.appUid ?? '',
                     deployment_uid: instance.deploymentUid ?? '',
                     version: instance.version ?? 0,
+                    ...(instance.organizationUid
+                        ? { organization_uid: instance.organizationUid }
+                        : {}),
                 },
             }
             : {}),

package/lib/loop/apps/checks.d.ts

@@ -14,15 +14,23 @@ export interface AppCheck {
  * UI plugins, by the name a surface gives it.
  */
 export declare const componentNamed: (name: string) => ComponentSpec | undefined;
+/** How an organization's own context is named: never a catalogue id (agentspecs' `ORGANIZATION_FRAME_PREFIX`). */
+export declare const ORGANIZATION_FRAME_PREFIX = "org-";
+/** Whether a reference names an organization's own context rather than the catalogue's (LOOP U-32). */
+export declare const isOrganizationFrame: (ref: string) => boolean;
 /** The Guards the runtime executes (agent-runtimes `loop/apps/guards.py`). */
 export declare const EXECUTED_GUARDS: readonly string[];
 /**
  * Where an application is checked: the plugins its organization has turned
  * off (catalogue ids, `plugins_off` in IAM), none when it has decided nothing
- * or the checks run with no organization.
+ * or the checks run with no organization; and the ids of its organization's
+ * contexts (`frames` in IAM: its versions and its own, LOOP U-32), unsaid
+ * when no organization is known — a context of an organization's own is then
+ * refused.
  */
 export interface CheckContext {
     pluginsOff: readonly string[];
+    organizationFrames?: readonly string[];
 }
 /** The instant checks of an application as an editor holds it. */
 export declare function checkApp(app: AppSpec, read?: string[], context?: CheckContext): AppCheck;

package/lib/loop/apps/checks.js

@@ -134,8 +134,16 @@ function shapeProblems(app) {
     }
     return problems;
 }
-/** Every reference that does not resolve, in sentences. */
-function referenceProblems(app) {
+/** How an organization's own context is named: never a catalogue id (agentspecs' `ORGANIZATION_FRAME_PREFIX`). */
+export const ORGANIZATION_FRAME_PREFIX = 'org-';
+/** Whether a reference names an organization's own context rather than the catalogue's (LOOP U-32). */
+export const isOrganizationFrame = (ref) => idOf(ref).startsWith(ORGANIZATION_FRAME_PREFIX);
+/**
+ * Every reference that does not resolve, in sentences. A context of an
+ * organization's own resolves among `organizationFrames`, the contexts of the
+ * organization the application belongs to; with none known, it is refused.
+ */
+function referenceProblems(app, organizationFrames) {
     const problems = [];
     const missing = (what, ref) => problems.push(`There is no ${what} named “${ref}”.`);
     if (app.agent && !getAgentspecs(idOf(app.agent)) && !getCog(app.agent)) {
@@ -145,8 +153,16 @@ function referenceProblems(app) {
         missing('team', app.team);
     }
     for (const ref of app.context) {
-        if (!getFrame(idOf(ref)))
-            missing('Frame', ref);
+        if (!isOrganizationFrame(ref)) {
+            if (!getFrame(idOf(ref)))
+                missing('Frame', ref);
+        }
+        else if (organizationFrames === undefined) {
+            problems.push(`“${ref}” is a context of an organization’s own: it is checked with the organization the application belongs to, which was not said.`);
+        }
+        else if (!organizationFrames.includes(idOf(ref))) {
+            problems.push(`Its organization has no context named “${ref}”.`);
+        }
     }
     for (const connection of app.connections) {
         if (!own(MCP_SERVER_LIBRARY, idOf(connection.server))) {
@@ -340,7 +356,11 @@ function setupNotes(app) {
 const NO_ORGANIZATION = { pluginsOff: [] };
 /** The instant checks of an application as an editor holds it. */
 export function checkApp(app, read = [], context = NO_ORGANIZATION) {
-    const problems = [...read, ...shapeProblems(app), ...referenceProblems(app)];
+    const problems = [
+        ...read,
+        ...shapeProblems(app),
+        ...referenceProblems(app, context.organizationFrames),
+    ];
     // A block its page uses from a plugin its organization turned off is said
     // with the rest of what is not enabled today (C-12).
     const setup = [

package/lib/loop/index.d.ts

@@ -72,4 +72,4 @@ export { EMBED_ATTRIBUTES, EMBED_HOST_VARIABLES, EMBED_TAG, embedLookOf, embedSn
 export { SubagentActivityPlugin, SubagentPulse, SUBAGENT_ACTIVITY_PLUGIN_NAME, } from './plugins/subagent-activity';
 export { loopPlugins, type LoopPresetOptions } from './presets';
 export { DocumentExtension, NotebookExtension } from './extensions';
-export { BEHAVIOURS as APP_BEHAVIOUR_ORDER, DEFAULT_BEHAVIOURS as APP_DEFAULT_BEHAVIOURS, behaviourFor, classesOf, isReadOnly, toolBehaviours, toolEscalations, type BehaviourOptions, type ToolArguments, APP_SCHEMA, APPSPEC_KEY_ORDER, DEFAULT_LAYOUTS as APP_DEFAULT_LAYOUTS, dumpAppspec, emptyAppspec, parseAppspec, AppRenderer, checkApp, checkAppspec, type AppCheck, type CheckContext, defineAppPlugin, type AppRendererProps, type AppInstance, appLayoutOptions, readAppspecYaml, writeAppspecYaml, type ParsedAppspec, } from './apps';
+export { BEHAVIOURS as APP_BEHAVIOUR_ORDER, DEFAULT_BEHAVIOURS as APP_DEFAULT_BEHAVIOURS, behaviourFor, classesOf, isReadOnly, toolBehaviours, toolEscalations, type BehaviourOptions, type ToolArguments, APP_SCHEMA, APPSPEC_KEY_ORDER, DEFAULT_LAYOUTS as APP_DEFAULT_LAYOUTS, dumpAppspec, emptyAppspec, parseAppspec, AppRenderer, checkApp, checkAppspec, isOrganizationFrame, ORGANIZATION_FRAME_PREFIX, type AppCheck, type CheckContext, defineAppPlugin, type AppRendererProps, type AppInstance, appLayoutOptions, readAppspecYaml, writeAppspecYaml, type ParsedAppspec, } from './apps';

package/lib/loop/index.js

@@ -98,4 +98,4 @@ export { loopPlugins } from './presets';
 export { DocumentExtension, NotebookExtension } from './extensions';
 // Applications: what one does when its agent calls a tool — the rules a
 // person wrote, decided on what the tool does.
-export { BEHAVIOURS as APP_BEHAVIOUR_ORDER, DEFAULT_BEHAVIOURS as APP_DEFAULT_BEHAVIOURS, behaviourFor, classesOf, isReadOnly, toolBehaviours, toolEscalations, APP_SCHEMA, APPSPEC_KEY_ORDER, DEFAULT_LAYOUTS as APP_DEFAULT_LAYOUTS, dumpAppspec, emptyAppspec, parseAppspec, AppRenderer, checkApp, checkAppspec, defineAppPlugin, appLayoutOptions, readAppspecYaml, writeAppspecYaml, } from './apps';
+export { BEHAVIOURS as APP_BEHAVIOUR_ORDER, DEFAULT_BEHAVIOURS as APP_DEFAULT_BEHAVIOURS, behaviourFor, classesOf, isReadOnly, toolBehaviours, toolEscalations, APP_SCHEMA, APPSPEC_KEY_ORDER, DEFAULT_LAYOUTS as APP_DEFAULT_LAYOUTS, dumpAppspec, emptyAppspec, parseAppspec, AppRenderer, checkApp, checkAppspec, isOrganizationFrame, ORGANIZATION_FRAME_PREFIX, defineAppPlugin, appLayoutOptions, readAppspecYaml, writeAppspecYaml, } from './apps';

package/package.json

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