@datalayer/agent-runtimes 1.5.93 → 1.5.94
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist-embed/chunks/{code-block-IT6T5CEO-DqNGASTc.js → code-block-IT6T5CEO-BG9nTZfk.js} +16 -16
- package/dist-embed/datalayer-app-main.js +8 -8
- package/lib/specs/apps.js +67 -67
- package/lib/specs/appspecSchema.js +62 -62
- package/lib/specs/harnesses.js +2 -2
- package/lib/specs/sceneSchema.js +2 -2
- package/lib/specs/scenes.js +4 -4
- package/package.json +1 -1
|
@@ -30,7 +30,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
30
30
|
},
|
|
31
31
|
AppA2A: {
|
|
32
32
|
additionalProperties: false,
|
|
33
|
-
description: "A2A: what the application's Agent Card says beside its name and skill
|
|
33
|
+
description: "A2A: what the application's Agent Card says beside its name and skill.",
|
|
34
34
|
properties: {
|
|
35
35
|
extensions: {
|
|
36
36
|
description: "Extensions its card advertises, besides the runtime's own",
|
|
@@ -46,7 +46,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
46
46
|
},
|
|
47
47
|
AppA2AExtension: {
|
|
48
48
|
additionalProperties: false,
|
|
49
|
-
description: "An A2A extension the application's Agent Card advertises (A2A 1.0\n*Extensions
|
|
49
|
+
description: "An A2A extension the application's Agent Card advertises (A2A 1.0\n*Extensions*), beside the runtime's own.\n\nNamed by its URI, as `capabilities.extensions` writes it; its params are\npublished on the card as they are, so they never hold a credential.\nDatalayer's own extensions (orchestration, the face) are the runtime's,\nnever declared here.",
|
|
50
50
|
properties: {
|
|
51
51
|
uri: {
|
|
52
52
|
description: "The extension's URI: `https://example.com/ext/gift-wrap/v1`",
|
|
@@ -138,7 +138,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
138
138
|
type: 'string',
|
|
139
139
|
},
|
|
140
140
|
code: {
|
|
141
|
-
description: 'Checks written in its code (`@app.check`), each run at its stage
|
|
141
|
+
description: 'Checks written in its code (`@app.check`), each run at its stage',
|
|
142
142
|
items: {
|
|
143
143
|
$ref: '#/$defs/AppCodeCheck',
|
|
144
144
|
},
|
|
@@ -151,7 +151,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
151
151
|
},
|
|
152
152
|
AppCodeCheck: {
|
|
153
153
|
additionalProperties: false,
|
|
154
|
-
description: "A check written in the application's code
|
|
154
|
+
description: "A check written in the application's code: `@app.check`.\n\nRun at its stage beside the built-in checks and the catalogue's Guards;\nwhat it refuses is said in its own sentence. Without its file nothing\nruns it, and validation says so.",
|
|
155
155
|
properties: {
|
|
156
156
|
name: {
|
|
157
157
|
description: 'The function of its code that checks, by name',
|
|
@@ -176,7 +176,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
176
176
|
},
|
|
177
177
|
AppCommand: {
|
|
178
178
|
additionalProperties: false,
|
|
179
|
-
description: "A slash command the user picks in the composer
|
|
179
|
+
description: "A slash command the user picks in the composer.\n\nTyping `/` lists the application's commands; picking one sends its\n`prompt`, `{input}` replaced by the words typed after the command.",
|
|
180
180
|
properties: {
|
|
181
181
|
name: {
|
|
182
182
|
description: 'What follows the slash: lower-case letters, digits and hyphens, a letter first (`summarise`)',
|
|
@@ -203,7 +203,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
203
203
|
},
|
|
204
204
|
AppCommerce: {
|
|
205
205
|
additionalProperties: false,
|
|
206
|
-
description: 'Commerce: the merchants it shops at for each person
|
|
206
|
+
description: 'Commerce: the merchants it shops at for each person.',
|
|
207
207
|
properties: {
|
|
208
208
|
merchants: {
|
|
209
209
|
description: 'Merchants, over UCP or ACP: test merchants only for now',
|
|
@@ -219,7 +219,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
219
219
|
},
|
|
220
220
|
AppCommerceMerchant: {
|
|
221
221
|
additionalProperties: false,
|
|
222
|
-
description: "A merchant the application shops at for each person, over UCP or ACP
|
|
222
|
+
description: "A merchant the application shops at for each person, over UCP or ACP.\n\nDecided 2026-10-13: test merchants only, with no real payment — a\npurchase is always asked of the person first (*Ask me first*),\nas the exact checkout, and made at most once; Datalayer's gateway pays\nwith a test instrument and refuses any merchant it does not know as a\ntest one. Named by its domain (its profile at `/.well-known/ucp`, or\n`/.well-known/acp.json`), always in each person's own name. No\ncredential is ever part of a spec.",
|
|
223
223
|
properties: {
|
|
224
224
|
id: {
|
|
225
225
|
description: 'Stable within the application: `example-store`',
|
|
@@ -383,7 +383,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
383
383
|
},
|
|
384
384
|
AppCustomComponent: {
|
|
385
385
|
additionalProperties: false,
|
|
386
|
-
description: "A component the developer writes
|
|
386
|
+
description: "A component the developer writes, 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.",
|
|
387
387
|
properties: {
|
|
388
388
|
name: {
|
|
389
389
|
description: "Its name on a surface, as a catalog component's (`Gauge`); none of the catalog's own",
|
|
@@ -420,7 +420,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
420
420
|
type: 'array',
|
|
421
421
|
},
|
|
422
422
|
source: {
|
|
423
|
-
description: "Its module, a built ES module whose default export draws it (`export default function (root, {props, send})`): an address over `https://`, or `http://localhost` while it is written; or a file of the application's folder, by its path in it (`gauge.js`), packaged with the application and served by the server its package is installed beside
|
|
423
|
+
description: "Its module, a built ES module whose default export draws it (`export default function (root, {props, send})`): an address over `https://`, or `http://localhost` while it is written; or a file of the application's folder, by its path in it (`gauge.js`), packaged with the application and served by the server its package is installed beside",
|
|
424
424
|
title: 'Source',
|
|
425
425
|
type: 'string',
|
|
426
426
|
},
|
|
@@ -624,7 +624,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
624
624
|
type: 'array',
|
|
625
625
|
},
|
|
626
626
|
commands: {
|
|
627
|
-
description: 'Slash commands the user picks in the composer: typing `/` lists them
|
|
627
|
+
description: 'Slash commands the user picks in the composer: typing `/` lists them',
|
|
628
628
|
items: {
|
|
629
629
|
$ref: '#/$defs/AppCommand',
|
|
630
630
|
},
|
|
@@ -632,7 +632,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
632
632
|
type: 'array',
|
|
633
633
|
},
|
|
634
634
|
modes: {
|
|
635
|
-
description: 'Mode switches in the composer: the option picked goes with every run, its instructions told to the agent and its model run on
|
|
635
|
+
description: 'Mode switches in the composer: the option picked goes with every run, its instructions told to the agent and its model run on',
|
|
636
636
|
items: {
|
|
637
637
|
$ref: '#/$defs/AppMode',
|
|
638
638
|
},
|
|
@@ -648,7 +648,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
648
648
|
type: 'array',
|
|
649
649
|
},
|
|
650
650
|
profiles: {
|
|
651
|
-
description: 'Several assistants in one application, two at least: the person picks one before the conversation starts — the first unless they do — and keeps it to the end; its instructions, model and starters go with every run
|
|
651
|
+
description: 'Several assistants in one application, two at least: the person picks one before the conversation starts — the first unless they do — and keeps it to the end; its instructions, model and starters go with every run. None when unsaid',
|
|
652
652
|
items: {
|
|
653
653
|
$ref: '#/$defs/AppProfile',
|
|
654
654
|
},
|
|
@@ -666,7 +666,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
666
666
|
},
|
|
667
667
|
],
|
|
668
668
|
default: null,
|
|
669
|
-
description: "What the user may set: the JSON Schema of a form, an object of named fields, each with its `title` and its `default
|
|
669
|
+
description: "What the user may set: the JSON Schema of a form, an object of named fields, each with its `title` and its `default`. Drawn with `@datalayer/primer-rjsf` beside the conversation and on a deployment's Ship card, its values go with every run and are checked by the runtime against the same schema. None when unsaid",
|
|
670
670
|
title: 'Settings',
|
|
671
671
|
},
|
|
672
672
|
settings_ui: {
|
|
@@ -680,12 +680,12 @@ export const APPSPEC_SCHEMA = {
|
|
|
680
680
|
},
|
|
681
681
|
],
|
|
682
682
|
default: null,
|
|
683
|
-
description: "How the settings' fields are drawn, as `@datalayer/primer-rjsf` reads a uiSchema: by field name, its `ui:` options — `ui:widget` one of `select`, `radio`, `range`, `updown`, `switch`, `checkbox`, `text`, `textarea`, `date`, `checkboxes`, `tags` — and `ui:order
|
|
683
|
+
description: "How the settings' fields are drawn, as `@datalayer/primer-rjsf` reads a uiSchema: by field name, its `ui:` options — `ui:widget` one of `select`, `radio`, `range`, `updown`, `switch`, `checkbox`, `text`, `textarea`, `date`, `checkboxes`, `tags` — and `ui:order`. Each field's own widget when unsaid",
|
|
684
684
|
title: 'Settings Ui',
|
|
685
685
|
},
|
|
686
686
|
language: {
|
|
687
687
|
default: 'en',
|
|
688
|
-
description: 'The language its own words are in, as BCP 47 tags it (`en`, `fr`, `pt-BR`)
|
|
688
|
+
description: 'The language its own words are in, as BCP 47 tags it (`en`, `fr`, `pt-BR`)',
|
|
689
689
|
title: 'Language',
|
|
690
690
|
type: 'string',
|
|
691
691
|
},
|
|
@@ -693,7 +693,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
693
693
|
additionalProperties: {
|
|
694
694
|
$ref: '#/$defs/AppTranslation',
|
|
695
695
|
},
|
|
696
|
-
description: "What a person reads of it in other languages, by BCP 47 tag: its name, welcome, starters and their categories, settings, commands, modes and profiles. The page shows the person's language when it has it, else its own words
|
|
696
|
+
description: "What a person reads of it in other languages, by BCP 47 tag: its name, welcome, starters and their categories, settings, commands, modes and profiles. The page shows the person's language when it has it, else its own words",
|
|
697
697
|
title: 'Translations',
|
|
698
698
|
type: 'object',
|
|
699
699
|
},
|
|
@@ -707,7 +707,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
707
707
|
},
|
|
708
708
|
],
|
|
709
709
|
default: null,
|
|
710
|
-
description: 'What a person may send in the composer without being asked — images, files, audio — by kind, each with its largest size, and how many at once
|
|
710
|
+
description: 'What a person may send in the composer without being asked — images, files, audio — by kind, each with its largest size, and how many at once. None when unsaid: the composer offers no attachment, and a file sent with a message is refused',
|
|
711
711
|
},
|
|
712
712
|
components: {
|
|
713
713
|
description: "The components of the catalog the surface may use; the kind's own when empty",
|
|
@@ -718,7 +718,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
718
718
|
type: 'array',
|
|
719
719
|
},
|
|
720
720
|
custom_components: {
|
|
721
|
-
description: "Components its developer wrote
|
|
721
|
+
description: "Components its developer wrote, of this application only: each named, its props a JSON Schema, its module's address; placed, shown and drawn as the catalog's own",
|
|
722
722
|
items: {
|
|
723
723
|
$ref: '#/$defs/AppCustomComponent',
|
|
724
724
|
},
|
|
@@ -747,7 +747,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
747
747
|
},
|
|
748
748
|
],
|
|
749
749
|
default: null,
|
|
750
|
-
description: "A widget's page written in its code (`@app.page
|
|
750
|
+
description: "A widget's page written in its code (`@app.page`): its inputs as a form, its outputs as values; run again as an input changes, its outputs shown in place. None when unsaid",
|
|
751
751
|
},
|
|
752
752
|
avatar: {
|
|
753
753
|
anyOf: [
|
|
@@ -805,7 +805,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
805
805
|
},
|
|
806
806
|
AppMode: {
|
|
807
807
|
additionalProperties: false,
|
|
808
|
-
description: 'A mode switch in the composer
|
|
808
|
+
description: 'A mode switch in the composer: the person picks one of its options.',
|
|
809
809
|
properties: {
|
|
810
810
|
id: {
|
|
811
811
|
description: 'Its id, the key a run says its option under',
|
|
@@ -848,7 +848,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
848
848
|
},
|
|
849
849
|
AppModeOption: {
|
|
850
850
|
additionalProperties: false,
|
|
851
|
-
description: 'One position of a mode switch
|
|
851
|
+
description: 'One position of a mode switch: what the agent is told, the model it runs on.',
|
|
852
852
|
properties: {
|
|
853
853
|
id: {
|
|
854
854
|
description: 'Its id, what a run says it is in',
|
|
@@ -936,7 +936,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
936
936
|
},
|
|
937
937
|
AppPact: {
|
|
938
938
|
additionalProperties: false,
|
|
939
|
-
description: 'PACT: the businesses it asks for each person
|
|
939
|
+
description: 'PACT: the businesses it asks for each person, and\nwhether it answers as one.',
|
|
940
940
|
properties: {
|
|
941
941
|
connections: {
|
|
942
942
|
description: 'Businesses, over PACT',
|
|
@@ -956,7 +956,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
956
956
|
},
|
|
957
957
|
AppPactBusiness: {
|
|
958
958
|
additionalProperties: false,
|
|
959
|
-
description: "The application answers as a PACT business
|
|
959
|
+
description: "The application answers as a PACT business.\n\nPublished at its deployment's own address: its A2A Agent Card names\nDatalayer as the Provider and the application's owner as the Brand; its\nA2A interface verifies each personal-agent JWT against a registered\nissuer's keys; with `scopes`, a person delegates to a personal agent\nthrough the Provider's device-code sign-in — their Datalayer sign-in — and\nevery answer under their delegation carries a signed receipt.",
|
|
960
960
|
properties: {
|
|
961
961
|
enabled: {
|
|
962
962
|
default: false,
|
|
@@ -992,7 +992,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
992
992
|
},
|
|
993
993
|
AppPactConnection: {
|
|
994
994
|
additionalProperties: false,
|
|
995
|
-
description: "A business the application asks for each person, over PACT 1.0
|
|
995
|
+
description: "A business the application asks for each person, over PACT 1.0.\n\nThe Brand is named by its domain — its Agent Card is at\n`https://<brand>/.well-known/agent-card.json` (PACT §2.1) — and its\nProvider's `audience`, which the Provider assigns at registration and\nthe personal-agent JWT carries. Always in each person's own name:\nPACT acts for a person. No credential is ever part of a spec.",
|
|
996
996
|
properties: {
|
|
997
997
|
id: {
|
|
998
998
|
description: 'Stable within the application: `support`',
|
|
@@ -1029,7 +1029,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1029
1029
|
},
|
|
1030
1030
|
AppPactRegisteredAgent: {
|
|
1031
1031
|
additionalProperties: false,
|
|
1032
|
-
description: 'A personal agent the business accepts (PACT 1.0 §3.1): its issuer, and where its keys are.\n\nRegistered by the Maker, as `pap.company.registered_agents
|
|
1032
|
+
description: 'A personal agent the business accepts (PACT 1.0 §3.1): its issuer, and where its keys are.\n\nRegistered by the Maker, as `pap.company.registered_agents`: a personal-agent JWT is verified against the keys of a registered\nissuer only, and any other is refused.',
|
|
1033
1033
|
properties: {
|
|
1034
1034
|
issuer: {
|
|
1035
1035
|
description: "The personal agent's `iss`, an HTTPS URL",
|
|
@@ -1048,7 +1048,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1048
1048
|
},
|
|
1049
1049
|
AppPage: {
|
|
1050
1050
|
additionalProperties: false,
|
|
1051
|
-
description: "A widget's page written in its code
|
|
1051
|
+
description: "A widget's page written in its code: `@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.",
|
|
1052
1052
|
properties: {
|
|
1053
1053
|
function: {
|
|
1054
1054
|
description: 'The function of its code that runs the page',
|
|
@@ -1098,7 +1098,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1098
1098
|
},
|
|
1099
1099
|
AppPageOutput: {
|
|
1100
1100
|
additionalProperties: false,
|
|
1101
|
-
description: 'One thing a page shows for its inputs
|
|
1101
|
+
description: 'One thing a page shows for its inputs: a value, drawn with a component.',
|
|
1102
1102
|
properties: {
|
|
1103
1103
|
name: {
|
|
1104
1104
|
description: 'Its name: what its code returns it under, and where the page shows it (`/outputs/<name>`)',
|
|
@@ -1114,7 +1114,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1114
1114
|
},
|
|
1115
1115
|
component: {
|
|
1116
1116
|
default: 'Text',
|
|
1117
|
-
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
|
|
1117
|
+
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`), its value what it shows first",
|
|
1118
1118
|
title: 'Component',
|
|
1119
1119
|
type: 'string',
|
|
1120
1120
|
},
|
|
@@ -1131,7 +1131,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1131
1131
|
},
|
|
1132
1132
|
AppPair: {
|
|
1133
1133
|
additionalProperties: false,
|
|
1134
|
-
description: "One of a pair of examples, a PACT business and the personal agent that asks it
|
|
1134
|
+
description: "One of a pair of examples, a PACT business and the personal agent that asks it.\n\nA personal agent's issuer is its own application's, known only once a copy\nexists: when a person has copied both of a pair, the Studio registers the\npersonal agent's copy with the business's copy (`pact.business.registered_agents`)\nand points the personal agent at the business's own domain.",
|
|
1135
1135
|
properties: {
|
|
1136
1136
|
id: {
|
|
1137
1137
|
description: "The pair's id, the same on both of its applications",
|
|
@@ -1149,7 +1149,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1149
1149
|
},
|
|
1150
1150
|
AppPap: {
|
|
1151
1151
|
additionalProperties: false,
|
|
1152
|
-
description: 'Personal Agent Protocol: the companies it works with, and whether it is one.\n\nA `pap` block names the profile it is written for
|
|
1152
|
+
description: 'Personal Agent Protocol: the companies it works with, and whether it is one.\n\nA `pap` block names the profile it is written for: one\nDatalayer speaks, or it is refused in a sentence. An application without the\nblock has none.',
|
|
1153
1153
|
properties: {
|
|
1154
1154
|
profile: {
|
|
1155
1155
|
anyOf: [
|
|
@@ -1212,7 +1212,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1212
1212
|
},
|
|
1213
1213
|
AppPapCompany: {
|
|
1214
1214
|
additionalProperties: false,
|
|
1215
|
-
description: 'The application is a company personal agents work with
|
|
1215
|
+
description: 'The application is a company personal agents work with.',
|
|
1216
1216
|
properties: {
|
|
1217
1217
|
enabled: {
|
|
1218
1218
|
default: false,
|
|
@@ -1329,7 +1329,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1329
1329
|
},
|
|
1330
1330
|
AppPapConnection: {
|
|
1331
1331
|
additionalProperties: false,
|
|
1332
|
-
description: 'A company the application works with as a Personal Agent
|
|
1332
|
+
description: 'A company the application works with as a Personal Agent.\n\nThe company is named by its domain, the discovery input, and nothing else:\nits endpoints, issuer and metadata are what discovery verifies and are kept\nby the deployment, never here, and no credential is ever part of a spec.\n`access` and `as` mean what they mean for every connection.',
|
|
1333
1333
|
properties: {
|
|
1334
1334
|
id: {
|
|
1335
1335
|
description: 'Stable within the application: `orders`',
|
|
@@ -1416,7 +1416,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1416
1416
|
},
|
|
1417
1417
|
AppPapOperation: {
|
|
1418
1418
|
additionalProperties: false,
|
|
1419
|
-
description: "Something a personal agent may ask the application to do for the person,\ndone only once they confirm its exact terms (
|
|
1419
|
+
description: "Something a personal agent may ask the application to do for the person,\ndone only once they confirm its exact terms (Operations v1).\n\nAsked by a personal agent, the application's agent does not call `tool`:\nthe call is proposed, its arguments the terms, and the person confirms\nthat revision before the tool runs, with those arguments and only once.\nAn operation that `allows` instead gives a standing permission once the\nperson confirms it: it calls no tool, and is asked for through the\napplication's API or its server for agents.",
|
|
1420
1420
|
properties: {
|
|
1421
1421
|
action: {
|
|
1422
1422
|
description: "The action's name at this company, e.g. `orders.exchange`",
|
|
@@ -1446,7 +1446,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1446
1446
|
},
|
|
1447
1447
|
],
|
|
1448
1448
|
default: null,
|
|
1449
|
-
description: 'Instead of a tool: the standing permission confirming it gives
|
|
1449
|
+
description: 'Instead of a tool: the standing permission confirming it gives',
|
|
1450
1450
|
},
|
|
1451
1451
|
summary: {
|
|
1452
1452
|
description: 'What the person is shown, with `{term}` for each term, e.g. `Exchange order {order_id} for size {size}`; never written by the model',
|
|
@@ -1510,7 +1510,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1510
1510
|
},
|
|
1511
1511
|
AppPapStanding: {
|
|
1512
1512
|
additionalProperties: false,
|
|
1513
|
-
description: "An operation whose effect is a standing permission (
|
|
1513
|
+
description: "An operation whose effect is a standing permission (the Ledgerly pattern).\n\nConfirmed by the person, it is recorded as the approval in advance they\nwould give in Datalayer: this application may confirm, at the company of\none of its own connections and in the person's account there, operations\nof that class whose terms stay within these limits, so many times, for so\nmany days — and the person reads it back and withdraws it there.",
|
|
1514
1514
|
properties: {
|
|
1515
1515
|
connection: {
|
|
1516
1516
|
description: 'The id of its own company connection the permission is used at',
|
|
@@ -1606,7 +1606,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1606
1606
|
},
|
|
1607
1607
|
AppProfile: {
|
|
1608
1608
|
additionalProperties: false,
|
|
1609
|
-
description: "One of several assistants in one application
|
|
1609
|
+
description: "One of several assistants in one application: a variant of its agent.\n\nThe person picks a profile before the conversation starts, and keeps it to\nthe end: its instructions are told to the agent on top of the\napplication's in every run, its model run in place of the application's\n(a mode's model wins over it), and its starters offered in place of the\napplication's.",
|
|
1610
1610
|
properties: {
|
|
1611
1611
|
id: {
|
|
1612
1612
|
description: 'Its id, what a conversation says it is with',
|
|
@@ -1811,7 +1811,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1811
1811
|
},
|
|
1812
1812
|
AppSamples: {
|
|
1813
1813
|
additionalProperties: false,
|
|
1814
|
-
description: "What it is tried on before it is anybody's
|
|
1814
|
+
description: "What it is tried on before it is anybody's.\n\nPublished with it by Datalayer and read only: what a visitor without an\naccount tries it on, in the browser.",
|
|
1815
1815
|
properties: {
|
|
1816
1816
|
documents: {
|
|
1817
1817
|
description: 'Documents of its `contents`, as Datalayer publishes them',
|
|
@@ -1857,7 +1857,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1857
1857
|
},
|
|
1858
1858
|
AppSignedFetch: {
|
|
1859
1859
|
additionalProperties: false,
|
|
1860
|
-
description: 'Signed fetch: the sites it reads pages of, signed with its Web Bot Auth key
|
|
1860
|
+
description: 'Signed fetch: the sites it reads pages of, signed with its Web Bot Auth key.',
|
|
1861
1861
|
properties: {
|
|
1862
1862
|
sites: {
|
|
1863
1863
|
description: 'Sites, each by its exact domain: read with GET only, every request signed',
|
|
@@ -1873,7 +1873,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1873
1873
|
},
|
|
1874
1874
|
AppSignedFetchSite: {
|
|
1875
1875
|
additionalProperties: false,
|
|
1876
|
-
description: "A website the application reads pages of, each request signed
|
|
1876
|
+
description: "A website the application reads pages of, each request signed.\n\nDecided 2026-10-13: a *signed fetch* names exact sites, an allow-list.\nDatalayer's gateway reads a page there with `GET` only, on its safe\negress path (public addresses only), each request signed with the\napplication's own Web Bot Auth key and recorded; reading is under the\napplication's Rules like any read. Named by its domain: no other host is\nreached, and no credential is ever part of a spec.",
|
|
1877
1877
|
properties: {
|
|
1878
1878
|
id: {
|
|
1879
1879
|
description: 'Stable within the application: `example-verifier`',
|
|
@@ -1911,7 +1911,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1911
1911
|
},
|
|
1912
1912
|
AppSpendLimit: {
|
|
1913
1913
|
additionalProperties: false,
|
|
1914
|
-
description: 'The most one purchase may cost at a merchant
|
|
1914
|
+
description: 'The most one purchase may cost at a merchant.',
|
|
1915
1915
|
properties: {
|
|
1916
1916
|
amount: {
|
|
1917
1917
|
description: 'At most this much, as written: `50`, `12.50`',
|
|
@@ -1944,7 +1944,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
1944
1944
|
},
|
|
1945
1945
|
category: {
|
|
1946
1946
|
default: '',
|
|
1947
|
-
description: 'The heading it is offered under: the starters of one category are shown together, those without one first
|
|
1947
|
+
description: 'The heading it is offered under: the starters of one category are shown together, those without one first',
|
|
1948
1948
|
title: 'Category',
|
|
1949
1949
|
type: 'string',
|
|
1950
1950
|
},
|
|
@@ -2010,7 +2010,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2010
2010
|
},
|
|
2011
2011
|
AppTestCase: {
|
|
2012
2012
|
additionalProperties: false,
|
|
2013
|
-
description: "An example of what the application should do, in plain words.\n\nA case is one message (`ask`) or a short conversation (`turns`): what\nthe person says, chooses and presses, in order, each after the\napplication answered the turn before — and what it should do is judged\non the whole conversation.\n\nWhen plain words are not enough, its code decides it
|
|
2013
|
+
description: "An example of what the application should do, in plain words.\n\nA case is one message (`ask`) or a short conversation (`turns`): what\nthe person says, chooses and presses, in order, each after the\napplication answered the turn before — and what it should do is judged\non the whole conversation.\n\nWhen plain words are not enough, its code decides it: `code`\nnames the function of the application's `app.py` that is given the\nconversation and says whether it passed — `@app.test` writes it. `expect`\nstill says it in words: without its file, the case is judged by them.",
|
|
2014
2014
|
properties: {
|
|
2015
2015
|
ask: {
|
|
2016
2016
|
default: '',
|
|
@@ -2139,7 +2139,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2139
2139
|
},
|
|
2140
2140
|
AppTheme: {
|
|
2141
2141
|
additionalProperties: false,
|
|
2142
|
-
description: 'The theme an application runs in by default
|
|
2142
|
+
description: 'The theme an application runs in by default.',
|
|
2143
2143
|
properties: {
|
|
2144
2144
|
variant: {
|
|
2145
2145
|
$ref: '#/$defs/ThemeVariant',
|
|
@@ -2164,7 +2164,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2164
2164
|
},
|
|
2165
2165
|
AppTool: {
|
|
2166
2166
|
additionalProperties: false,
|
|
2167
|
-
description: "A tool of the application's own, written in its code
|
|
2167
|
+
description: "A tool of the application's own, written in its code: `@app.tool`.\n\nIts agent calls it as any tool; the rules decide each call by what it\n`does` — a rule may name it, by its name alone — and the Canvas lists it.\nWithout its file the agent is not given it.",
|
|
2168
2168
|
properties: {
|
|
2169
2169
|
name: {
|
|
2170
2170
|
description: 'Its name: what the agent calls, and a rule names',
|
|
@@ -2200,7 +2200,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2200
2200
|
},
|
|
2201
2201
|
AppTranslation: {
|
|
2202
2202
|
additionalProperties: false,
|
|
2203
|
-
description: "What a person reads of an application, in another language
|
|
2203
|
+
description: "What a person reads of an application, in another language.\n\nEach part is keyed by what names it in the spec: a starter by its label,\na category by its words, a setting by its field, a command by its name,\na mode and a profile by their ids. What is not translated is shown in\nthe spec's own words; what is translated is shown, never sent, but a\nstarter's message — the agent is written to in the person's language.",
|
|
2204
2204
|
properties: {
|
|
2205
2205
|
name: {
|
|
2206
2206
|
default: '',
|
|
@@ -2317,7 +2317,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2317
2317
|
},
|
|
2318
2318
|
AppUploadKind: {
|
|
2319
2319
|
additionalProperties: false,
|
|
2320
|
-
description: 'A kind of file a person may send, and how large
|
|
2320
|
+
description: 'A kind of file a person may send, and how large.',
|
|
2321
2321
|
properties: {
|
|
2322
2322
|
type: {
|
|
2323
2323
|
description: 'A media type (`application/pdf`), a family of them (`image/*`, `audio/*`) or an extension (`.csv`), lowercase',
|
|
@@ -2340,7 +2340,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2340
2340
|
},
|
|
2341
2341
|
AppUploads: {
|
|
2342
2342
|
additionalProperties: false,
|
|
2343
|
-
description: 'What a person may send in the composer without being asked
|
|
2343
|
+
description: 'What a person may send in the composer without being asked: images, files, audio.\n\nA file of a kind it does not name, larger than its kind takes, or one too\nmany is refused, in a sentence — by the page before it is sent, and by the\nruntime when it is sent all the same.',
|
|
2344
2344
|
properties: {
|
|
2345
2345
|
kinds: {
|
|
2346
2346
|
description: 'The kinds of file it takes, each with its largest size',
|
|
@@ -2366,7 +2366,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2366
2366
|
},
|
|
2367
2367
|
AppVerified: {
|
|
2368
2368
|
additionalProperties: false,
|
|
2369
|
-
description: 'What was verified, and how, each in a sentence a person reads
|
|
2369
|
+
description: 'What was verified, and how, each in a sentence a person reads.\n\nAn example says it on its card and on its page: what was tried live,\nwhat runs on recorded data instead, and what is not verified yet. Said\nby whoever tried it; nothing here is computed.',
|
|
2370
2370
|
properties: {
|
|
2371
2371
|
live: {
|
|
2372
2372
|
description: 'What was tried live, where and when',
|
|
@@ -2398,7 +2398,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2398
2398
|
},
|
|
2399
2399
|
AppVoice: {
|
|
2400
2400
|
additionalProperties: false,
|
|
2401
|
-
description: 'Its voice
|
|
2401
|
+
description: 'Its voice: whether it listens, whether it speaks, with which voice, in which language.\n\nOff unless said. What is said becomes a message, and what is heard is the\nanswer the conversation shows: the text stays the truth.',
|
|
2402
2402
|
properties: {
|
|
2403
2403
|
enabled: {
|
|
2404
2404
|
default: false,
|
|
@@ -2439,7 +2439,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2439
2439
|
type: 'object',
|
|
2440
2440
|
},
|
|
2441
2441
|
BalloonDisplay: {
|
|
2442
|
-
description: "How a floating assistant's balloon shows the conversation
|
|
2442
|
+
description: "How a floating assistant's balloon shows the conversation.",
|
|
2443
2443
|
enum: ['history', 'current'],
|
|
2444
2444
|
title: 'BalloonDisplay',
|
|
2445
2445
|
type: 'string',
|
|
@@ -2451,13 +2451,13 @@ export const APPSPEC_SCHEMA = {
|
|
|
2451
2451
|
type: 'string',
|
|
2452
2452
|
},
|
|
2453
2453
|
CheckStage: {
|
|
2454
|
-
description: 'Where a check of its code runs
|
|
2454
|
+
description: 'Where a check of its code runs, as the built-in checks do.',
|
|
2455
2455
|
enum: ['answer', 'tool_call'],
|
|
2456
2456
|
title: 'CheckStage',
|
|
2457
2457
|
type: 'string',
|
|
2458
2458
|
},
|
|
2459
2459
|
CommerceProtocol: {
|
|
2460
|
-
description: 'The commerce protocol a merchant is reached over
|
|
2460
|
+
description: 'The commerce protocol a merchant is reached over.',
|
|
2461
2461
|
enum: ['ucp', 'acp'],
|
|
2462
2462
|
title: 'CommerceProtocol',
|
|
2463
2463
|
type: 'string',
|
|
@@ -2509,7 +2509,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2509
2509
|
},
|
|
2510
2510
|
HostBridge: {
|
|
2511
2511
|
additionalProperties: false,
|
|
2512
|
-
description: "What the host page and the application say to each other
|
|
2512
|
+
description: "What the host page and the application say to each other.\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`): 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`.",
|
|
2513
2513
|
properties: {
|
|
2514
2514
|
context: {
|
|
2515
2515
|
description: "The host's values it reads: `user`, `page`, or names of the host's own",
|
|
@@ -2538,7 +2538,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2538
2538
|
},
|
|
2539
2539
|
HostFunction: {
|
|
2540
2540
|
additionalProperties: false,
|
|
2541
|
-
description: "A function of the host page the application's agent may call
|
|
2541
|
+
description: "A function of the host page the application's agent may call.",
|
|
2542
2542
|
properties: {
|
|
2543
2543
|
name: {
|
|
2544
2544
|
description: 'Its name, lower-case words joined by `_`: `open_ticket`',
|
|
@@ -2562,7 +2562,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2562
2562
|
type: 'object',
|
|
2563
2563
|
},
|
|
2564
2564
|
HostUser: {
|
|
2565
|
-
description: "What the host page's word on its visitor is worth
|
|
2565
|
+
description: "What the host page's word on its visitor is worth.",
|
|
2566
2566
|
enum: ['claimed', 'signed'],
|
|
2567
2567
|
title: 'HostUser',
|
|
2568
2568
|
type: 'string',
|
|
@@ -2622,7 +2622,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2622
2622
|
type: 'object',
|
|
2623
2623
|
},
|
|
2624
2624
|
PairRole: {
|
|
2625
|
-
description: 'Which side of a pair of examples an application is
|
|
2625
|
+
description: 'Which side of a pair of examples an application is.',
|
|
2626
2626
|
enum: ['business', 'personal_agent'],
|
|
2627
2627
|
title: 'PairRole',
|
|
2628
2628
|
type: 'string',
|
|
@@ -2658,7 +2658,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2658
2658
|
type: 'string',
|
|
2659
2659
|
},
|
|
2660
2660
|
PapStandingAction: {
|
|
2661
|
-
description:
|
|
2661
|
+
description: 'What a standing permission lets the application confirm at another company: a class of action.',
|
|
2662
2662
|
enum: ['write', 'buy'],
|
|
2663
2663
|
title: 'PapStandingAction',
|
|
2664
2664
|
type: 'string',
|
|
@@ -2688,7 +2688,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2688
2688
|
type: 'string',
|
|
2689
2689
|
},
|
|
2690
2690
|
ThemeVariant: {
|
|
2691
|
-
description: "A theme of Datalayer's, as Appearance names it
|
|
2691
|
+
description: "A theme of Datalayer's, as Appearance names it.",
|
|
2692
2692
|
enum: [
|
|
2693
2693
|
'datalayer',
|
|
2694
2694
|
'spatial',
|
|
@@ -2745,13 +2745,13 @@ export const APPSPEC_SCHEMA = {
|
|
|
2745
2745
|
type: 'string',
|
|
2746
2746
|
},
|
|
2747
2747
|
VoiceInput: {
|
|
2748
|
-
description: 'How a person talks to the application
|
|
2748
|
+
description: 'How a person talks to the application.\n\n`push_to_talk`: the microphone in the composer, clicked or held.\n`hands_free`: a conversation by voice — the composer offers *Talk with\nit*; a turn ends after a short silence and is sent, the answer is said,\nand listening goes on; speaking over the agent stops its voice.\nHands-free implies answers said as they are written (`output: always`).',
|
|
2749
2749
|
enum: ['off', 'push_to_talk', 'hands_free'],
|
|
2750
2750
|
title: 'VoiceInput',
|
|
2751
2751
|
type: 'string',
|
|
2752
2752
|
},
|
|
2753
2753
|
VoiceOutput: {
|
|
2754
|
-
description: 'When its answers are heard
|
|
2754
|
+
description: 'When its answers are heard.',
|
|
2755
2755
|
enum: ['off', 'on_request', 'always'],
|
|
2756
2756
|
title: 'VoiceOutput',
|
|
2757
2757
|
type: 'string',
|
|
@@ -2877,7 +2877,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2877
2877
|
type: 'array',
|
|
2878
2878
|
},
|
|
2879
2879
|
protocols: {
|
|
2880
|
-
description: 'The agent protocols it speaks, ids of the protocols catalogue
|
|
2880
|
+
description: 'The agent protocols it speaks, ids of the protocols catalogue: its `pap`, `pact`, `signed_fetch` and `a2a` blocks, and each merchant of `commerce`, are refused unless their protocol is listed, and a planned protocol only while it is not offered',
|
|
2881
2881
|
items: {
|
|
2882
2882
|
type: 'string',
|
|
2883
2883
|
},
|
|
@@ -2885,7 +2885,7 @@ export const APPSPEC_SCHEMA = {
|
|
|
2885
2885
|
type: 'array',
|
|
2886
2886
|
},
|
|
2887
2887
|
ui: {
|
|
2888
|
-
description: 'Its UI plugins, each `{plugin, renderer}
|
|
2888
|
+
description: 'Its UI plugins, each `{plugin, renderer}`: a plugin of `agentspecs/ui`, each once, and the renderer of `agentspecs/ui-renderers` it is exposed through, when it is — one the plugin may be exposed through, and one that is not enabled only while the application is not offered',
|
|
2889
2889
|
items: {
|
|
2890
2890
|
$ref: '#/$defs/UiChoice',
|
|
2891
2891
|
},
|
package/lib/specs/harnesses.js
CHANGED
|
@@ -231,7 +231,7 @@ export const GEMINI_CLI_HARNESS_0_0_1 = {
|
|
|
231
231
|
name: 'Gemini CLI',
|
|
232
232
|
description: "Google's coding agent, which speaks ACP itself when started with --experimental-acp.",
|
|
233
233
|
enabled: false,
|
|
234
|
-
unavailable_because: "the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); Gemini CLI's API host (generativelanguage.googleapis.com) is outside a Datalayer runtime's egress boundary and is not routed through ai-inference, so it
|
|
234
|
+
unavailable_because: "the catalogue offers four harnesses today — Claude Code, Codex, OpenCode and pi (28 October 2026); Gemini CLI's API host (generativelanguage.googleapis.com) is outside a Datalayer runtime's egress boundary and is not routed through ai-inference, so it is not offered there.",
|
|
235
235
|
tags: ['harness'],
|
|
236
236
|
docs: 'https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md',
|
|
237
237
|
acp: {
|
|
@@ -342,7 +342,7 @@ export const OPENCODE_HARNESS_0_0_1 = {
|
|
|
342
342
|
id: 'opencode',
|
|
343
343
|
version: '0.0.1',
|
|
344
344
|
name: 'OpenCode',
|
|
345
|
-
description: "Anomaly's open coding agent, which speaks ACP itself with opencode acp; any model provider it is configured with.",
|
|
345
|
+
description: "Anomaly's open coding agent, which speaks ACP itself with opencode acp; any model provider it is configured with. On Datalayer its model calls go through Datalayer's ai-inference, on the platform's models and paid in credits, with no key of the account's.",
|
|
346
346
|
enabled: true,
|
|
347
347
|
unavailable_because: '',
|
|
348
348
|
tags: ['harness'],
|
package/lib/specs/sceneSchema.js
CHANGED
|
@@ -29,7 +29,7 @@ export const SCENE_SCHEMA = {
|
|
|
29
29
|
},
|
|
30
30
|
AppVerified: {
|
|
31
31
|
additionalProperties: false,
|
|
32
|
-
description: 'What was verified, and how, each in a sentence a person reads
|
|
32
|
+
description: 'What was verified, and how, each in a sentence a person reads.\n\nAn example says it on its card and on its page: what was tried live,\nwhat runs on recorded data instead, and what is not verified yet. Said\nby whoever tried it; nothing here is computed.',
|
|
33
33
|
properties: {
|
|
34
34
|
live: {
|
|
35
35
|
description: 'What was tried live, where and when',
|
|
@@ -605,7 +605,7 @@ export const SCENE_SCHEMA = {
|
|
|
605
605
|
},
|
|
606
606
|
SceneRecording: {
|
|
607
607
|
additionalProperties: false,
|
|
608
|
-
description: 'A transcript recorded once, played when the scene cannot play live
|
|
608
|
+
description: 'A transcript recorded once, played when the scene cannot play live.',
|
|
609
609
|
properties: {
|
|
610
610
|
path: {
|
|
611
611
|
description: 'Its file, beside the scenes: `sales-and-accounting/recording.json`',
|
package/lib/specs/scenes.js
CHANGED
|
@@ -420,7 +420,7 @@ export const CROP_MONITORING_SCENE_0_0_1 = {
|
|
|
420
420
|
live: [],
|
|
421
421
|
recorded: [],
|
|
422
422
|
unverified: [
|
|
423
|
-
'Its runtime is not deployed under the demo account yet, and the rehearsal has not been played
|
|
423
|
+
'Its runtime is not deployed under the demo account yet, and the rehearsal has not been played.',
|
|
424
424
|
],
|
|
425
425
|
},
|
|
426
426
|
},
|
|
@@ -846,7 +846,7 @@ export const DISASTER_ASSESSMENT_SCENE_0_0_1 = {
|
|
|
846
846
|
live: [],
|
|
847
847
|
recorded: [],
|
|
848
848
|
unverified: [
|
|
849
|
-
'Rehearsed on Datalayer on 2026-10-09: three beats of four pass — wildfire 121 s, storm 58 s, alert 98 s — and flood took 256 s against the 240 s it allows, a bound measured when Event response still asked both specialists at once
|
|
849
|
+
'Rehearsed on Datalayer on 2026-10-09: three beats of four pass — wildfire 121 s, storm 58 s, alert 98 s — and flood took 256 s against the 240 s it allows, a bound measured when Event response still asked both specialists at once.',
|
|
850
850
|
],
|
|
851
851
|
},
|
|
852
852
|
},
|
|
@@ -1167,7 +1167,7 @@ export const MONTH_END_CLOSE_SCENE_0_0_1 = {
|
|
|
1167
1167
|
live: [],
|
|
1168
1168
|
recorded: [],
|
|
1169
1169
|
unverified: [
|
|
1170
|
-
'Its runtime is not deployed under the demo account yet, and the rehearsal has not been played
|
|
1170
|
+
'Its runtime is not deployed under the demo account yet, and the rehearsal has not been played.',
|
|
1171
1171
|
],
|
|
1172
1172
|
},
|
|
1173
1173
|
},
|
|
@@ -2400,7 +2400,7 @@ export const SALES_AND_ACCOUNTING_SCENE_0_0_1 = {
|
|
|
2400
2400
|
],
|
|
2401
2401
|
recorded: [],
|
|
2402
2402
|
unverified: [
|
|
2403
|
-
'The rehearsal has not been played as a set
|
|
2403
|
+
'The rehearsal has not been played as a set: the scene is not Live yet.',
|
|
2404
2404
|
],
|
|
2405
2405
|
},
|
|
2406
2406
|
},
|