@datalayer/agent-runtimes 1.3.84 → 1.3.86

package/lib/specs/appspecSchema.js

@@ -230,6 +230,82 @@ export const APPSPEC_SCHEMA = {
             title: 'AppCriterion',
             type: 'object',
         },
+        AppCustomComponent: {
+            additionalProperties: false,
+            description: "A component the developer writes (LOOP P-17), an A2UI component of this\napplication only: the catalog grows for it, it does not open.\n\nReviewed like any component of the catalog — its properties a JSON\nSchema, what it shows and sends bindings into the page's data — and drawn\nin a sandboxed frame of no origin, its module loaded from `source` and\nnothing else: what it is given is its properties and data, and what it\ngives back is what it sends.",
+            properties: {
+                name: {
+                    description: "Its name on a surface, as a catalog component's (`Gauge`); none of the catalog's own",
+                    pattern: '^[A-Z][A-Za-z0-9]{0,63}$',
+                    title: 'Name',
+                    type: 'string',
+                },
+                description: {
+                    description: 'What it is for, in a sentence: what the palette says',
+                    minLength: 1,
+                    title: 'Description',
+                    type: 'string',
+                },
+                props: {
+                    additionalProperties: true,
+                    description: 'Its properties, as the JSON Schema of an object: each typed `string`, `integer`, `number`, `boolean`, `array` or `object`, or an `enum` of words, with its `title`, `description` and `default`; `required` among them',
+                    title: 'Props',
+                    type: 'object',
+                },
+                shows: {
+                    description: "What it shows from the page's data: each a binding, given a path or a value in place",
+                    items: {
+                        type: 'string',
+                    },
+                    title: 'Shows',
+                    type: 'array',
+                },
+                sends: {
+                    description: 'What it sends back: each a binding it writes, then its `action` dispatched',
+                    items: {
+                        type: 'string',
+                    },
+                    title: 'Sends',
+                    type: 'array',
+                },
+                source: {
+                    description: "The address of its module, a built ES module whose default export draws it (`export default function (root, {props, send})`): over `https://`, or `http://localhost` while it is written. A module of the application's folder waits for its packaging (LOOP P-29)",
+                    title: 'Source',
+                    type: 'string',
+                },
+                integrity: {
+                    default: '',
+                    description: 'The module as it was reviewed: its Subresource Integrity hash (`sha384-…`); a module that differs is not drawn. Any module at the address when unsaid',
+                    title: 'Integrity',
+                    type: 'string',
+                },
+                height: {
+                    default: 240,
+                    description: 'Its height on the page, in pixels',
+                    maximum: 2000,
+                    minimum: 40,
+                    title: 'Height',
+                    type: 'integer',
+                },
+                example: {
+                    anyOf: [
+                        {
+                            additionalProperties: true,
+                            type: 'object',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'A configuration of it its schema accepts: what the palette previews',
+                    title: 'Example',
+                },
+            },
+            required: ['name', 'description', 'source'],
+            title: 'AppCustomComponent',
+            type: 'object',
+        },
         AppDecision: {
             additionalProperties: false,
             description: 'What a decision application decides.',
@@ -475,6 +551,14 @@ export const APPSPEC_SCHEMA = {
                     title: 'Components',
                     type: 'array',
                 },
+                custom_components: {
+                    description: "Components its developer wrote (LOOP P-17), of this application only: each named, its props a JSON Schema, its module's address; placed, shown and drawn as the catalog's own",
+                    items: {
+                        $ref: '#/$defs/AppCustomComponent',
+                    },
+                    title: 'Custom Components',
+                    type: 'array',
+                },
                 surface: {
                     anyOf: [
                         {
@@ -487,6 +571,18 @@ export const APPSPEC_SCHEMA = {
                     default: null,
                     description: 'The component tree, when there is one',
                 },
+                page: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/AppPage',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: "A widget's page written in its code (`@app.page`, LOOP P-05): its inputs as a form, its outputs as values; run again as an input changes, its outputs shown in place. None when unsaid",
+                },
                 assistant: {
                     anyOf: [
                         {
@@ -669,6 +765,89 @@ export const APPSPEC_SCHEMA = {
             title: 'AppOptionTranslation',
             type: 'object',
         },
+        AppPage: {
+            additionalProperties: false,
+            description: "A widget's page written in its code (LOOP P-05): `@app.page`.\n\nIts inputs are a form, drawn on the page; as one changes, the function\nof its code runs again on them and the page shows what it returned, in\nplace. Without its file nothing runs it, and validation says so.",
+            properties: {
+                function: {
+                    description: 'The function of its code that runs the page',
+                    pattern: '^[A-Za-z_][A-Za-z0-9_]*$',
+                    title: 'Function',
+                    type: 'string',
+                },
+                inputs: {
+                    additionalProperties: true,
+                    description: 'Its inputs: the JSON Schema of a form, an object of named fields, each with its `title` and its `default`; on the page at `/inputs/<name>`, checked by the runtime against the same schema',
+                    title: 'Inputs',
+                    type: 'object',
+                },
+                inputs_ui: {
+                    anyOf: [
+                        {
+                            additionalProperties: true,
+                            type: 'object',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'How its inputs are drawn, as `interface.settings_ui` draws the settings: a uiSchema by field name',
+                    title: 'Inputs Ui',
+                },
+                outputs: {
+                    description: 'What it shows for its inputs, in order, each at `/outputs/<name>`',
+                    items: {
+                        $ref: '#/$defs/AppPageOutput',
+                    },
+                    minItems: 1,
+                    title: 'Outputs',
+                    type: 'array',
+                },
+                live: {
+                    default: true,
+                    description: 'Whether it runs again as an input changes; `false`: when the person presses Run',
+                    title: 'Live',
+                    type: 'boolean',
+                },
+            },
+            required: ['function', 'inputs', 'outputs'],
+            title: 'AppPage',
+            type: 'object',
+        },
+        AppPageOutput: {
+            additionalProperties: false,
+            description: 'One thing a page shows for its inputs (LOOP P-05): a value, drawn with a component.',
+            properties: {
+                name: {
+                    description: 'Its name: what its code returns it under, and where the page shows it (`/outputs/<name>`)',
+                    pattern: '^[A-Za-z_][A-Za-z0-9_]*$',
+                    title: 'Name',
+                    type: 'string',
+                },
+                title: {
+                    default: '',
+                    description: 'What a person reads above it; none when unsaid',
+                    title: 'Title',
+                    type: 'string',
+                },
+                component: {
+                    default: 'Text',
+                    description: "What draws it: `Text` (words, unless said), `Image` (an address), `Table` (rows) or `Chart` (points), or a component of the application's own (`interface.custom_components`, LOOP P-17), its value what it shows first",
+                    title: 'Component',
+                    type: 'string',
+                },
+                props: {
+                    additionalProperties: true,
+                    description: "The component's other properties: a Table's `columns`, a Chart's `kind`, `x` and `y`",
+                    title: 'Props',
+                    type: 'object',
+                },
+            },
+            required: ['name'],
+            title: 'AppPageOutput',
+            type: 'object',
+        },
         AppPermissions: {
             additionalProperties: false,
             description: 'What the application may reach beside its connections. Nothing, unless said.',
@@ -1371,7 +1550,7 @@ export const APPSPEC_SCHEMA = {
         },
         HostBridge: {
             additionalProperties: false,
-            description: "What the host page and the application say to each other (LOOP D-10).\n\nThe values of the host it reads (`context`: `user`, `page`, or a name of\nthe host's own), through the tool `host_context`; the functions of the\nhost it may call, each through `host_<name>`. Every one of these tools is\ndecided by a rule that names it, as any tool is: one no rule names is\nleft to the person.",
+            description: "What the host page and the application say to each other (LOOP D-10).\n\nThe values of the host it reads (`context`: `user`, `page`, or a name of\nthe host's own), through the tool `host_context`; the functions of the\nhost it may call, each through `host_<name>`. Every one of these tools is\ndecided by a rule that names it, as any tool is: one no rule names is\nleft to the person.\n\nWho its user is (`user`, LOOP D-21): what the page says (`claimed`), or\nonly what the host's server signed (`signed`) — a short token, HS256\nwith the deployment's secret, naming `sub`, `name` and `exp` at most an\nhour away. An application that acts in each user's name, or shows data\nthat is theirs, says `signed`.",
             properties: {
                 context: {
                     description: "The host's values it reads: `user`, `page`, or names of the host's own",
@@ -1389,6 +1568,11 @@ export const APPSPEC_SCHEMA = {
                     title: 'Functions',
                     type: 'array',
                 },
+                user: {
+                    $ref: '#/$defs/HostUser',
+                    default: 'claimed',
+                    description: "Who its user is: `claimed`, what the page says; `signed`, only a token the host's server signed with the deployment's secret, the unsigned one refused",
+                },
             },
             title: 'HostBridge',
             type: 'object',
@@ -1418,6 +1602,12 @@ export const APPSPEC_SCHEMA = {
             title: 'HostFunction',
             type: 'object',
         },
+        HostUser: {
+            description: "What the host page's word on its visitor is worth (LOOP D-21).",
+            enum: ['claimed', 'signed'],
+            title: 'HostUser',
+            type: 'string',
+        },
         HostedDeployment: {
             additionalProperties: false,
             description: 'The application at an address of its own.',

package/lib/specs/index.d.ts

@@ -27,5 +27,6 @@ export * from './gates';
 export * from './tracks';
 export * from './ops';
 export * from './apps';
+export * from './scenes';
 export * from './actions';
 export * from './appspecSchema';

package/lib/specs/index.js

@@ -31,5 +31,6 @@ export * from './gates';
 export * from './tracks';
 export * from './ops';
 export * from './apps';
+export * from './scenes';
 export * from './actions';
 export * from './appspecSchema';

package/lib/specs/mcpServers.js

@@ -68,12 +68,18 @@ export const EARTHDATA_MCP_SERVER_0_0_1 = {
     emoji: '🌍',
     url: '',
     command: 'npx',
-    args: ['-y', 'earthdata-mcp-server'],
+    args: [
+        '-y',
+        'mcp-remote',
+        'https://mcp.datalayer.run/mcp?only=earthdata',
+        '--header',
+        'Authorization: Bearer ${DATALAYER_API_KEY}',
+    ],
     transport: 'stdio',
     enabled: true,
     isAvailable: false,
     tools: [],
-    requiredEnvVars: ['EARTHDATA_USERNAME:0.0.1', 'EARTHDATA_PASSWORD:0.0.1'],
+    requiredEnvVars: ['DATALAYER_API_KEY:0.0.1'],
 };
 export const EURUS_MCP_SERVER_0_0_1 = {
     id: 'eurus',

package/lib/specs/scenes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Scene Catalog.
+ *
+ * A team, staged: the setting, the script, the stage directions, the
+ * audience, the rehearsal and where it plays. The cast is resolved.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { SceneSpec } from '../types/scenes';
+export declare const CROP_MONITORING_SCENE_0_0_1: SceneSpec;
+export declare const DISASTER_ASSESSMENT_SCENE_0_0_1: SceneSpec;
+export declare const MONTH_END_CLOSE_SCENE_0_0_1: SceneSpec;
+export declare const SALES_AND_ACCOUNTING_SCENE_0_0_1: SceneSpec;
+export declare const SCENE_CATALOGUE: Record<string, SceneSpec>;
+/** A scene, by `id` or `id:version`, or undefined. */
+export declare function getSceneSpec(ref: string): SceneSpec | undefined;
+/** Every scene of the catalogue, in the catalogue's order, or those carrying a tag. */
+export declare function listSceneSpecs(tag?: string): SceneSpec[];
+/** Every scene that stages a team, by its id with or without a version. */
+export declare function scenesStaging(teamId: string): SceneSpec[];