@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.
@@ -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 (PR-02).",
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*, PR-02), 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.",
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 (P-06)',
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 (P-06): `@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.",
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 (P-19).\n\nTyping `/` lists the application's commands; picking one sends its\n`prompt`, `{input}` replaced by the words typed after the command.",
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 (PI-01).',
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 (PI-01).\n\nDecided 2026-10-13: test merchants only, with no real payment — a\npurchase is always asked of the person first (*Ask me first*, PI-21),\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.",
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 (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.",
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 (P-29)",
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 (P-19)',
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 (P-19)',
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 (P-20). None when unsaid',
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` (C-16). 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",
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` (P-20). Each field's own widget when unsaid",
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`) (P-26)',
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 (P-26)",
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 (P-21). None when unsaid: the composer offers no attachment, and a file sent with a message is refused',
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 (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",
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`, 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",
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 (P-19): the person picks one of its options.',
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 (P-19): what the agent is told, the model it runs on.',
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 (PI-01), and\nwhether it answers as one (PR-13).',
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 (PR-13, PI-32; decided 2026-10-13).\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.",
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 (PI-01).\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.",
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` (PR-13,\ndecided 2026-10-13): a personal-agent JWT is verified against the keys of a registered\nissuer only, and any other is refused.',
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 (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.",
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 (P-05): a value, drawn with a component.',
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`, P-17), its value what it shows first",
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\n(PR-13, E-02; decided 2026-10-13).\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.",
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 (S-03): one\nDatalayer speaks, or it is refused in a sentence. An application without the\nblock has none.',
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 (S-01, U-04).',
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 (S-01).\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.',
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 (B-04, 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 (R-07): it calls no tool, and is asked for through the\napplication's API or its server for agents.",
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 (R-07)',
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 (R-07, 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.",
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 (P-20): 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.",
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 (E-06, E-11).\n\nPublished with it by Datalayer and read only: what a visitor without an\naccount tries it on, in the browser.",
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 (EX-11).',
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 (EX-11).\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.",
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 (PI-22).',
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 (P-20)',
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 (P-06): `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.",
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 (T-30).',
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 (P-06): `@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.",
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 (P-26).\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.",
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 (P-21).',
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 (P-21): 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.',
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 (E-14).\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.',
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 (VO-41): 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.',
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 (T-23).",
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 (P-06), as the built-in checks do (R-06).',
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 (PI-01).',
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 (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`, 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`.",
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 (D-10).",
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 (D-21).",
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 (PR-13).',
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: "What a standing permission lets the application confirm at another company (R-02's classes).",
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 (T-30).",
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 (VO-10, VO-12).\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 (VO-13).\nHands-free implies answers said as they are written (`output: always`).',
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 (VO-21).',
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 (PS-02): 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',
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}` (R8): 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',
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
  },
@@ -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 stays unfunded and unoffered there (the user's decision, 28 October 2026).",
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'],
@@ -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 (E-14).\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.',
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 (H-08).',
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`',
@@ -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 (A-14).',
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 (A-14).',
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 (A-14).',
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 (A-14): the scene is not Live yet.',
2403
+ 'The rehearsal has not been played as a set: the scene is not Live yet.',
2404
2404
  ],
2405
2405
  },
2406
2406
  },