@datalayer/agent-runtimes 1.3.103 → 1.3.105

package/lib/pap/index.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { AgentIdentityClient, discoverCompany, } from '@datalayer/personal-agent-protocol';
+function extensionVersions(extensions) {
+    return Object.freeze(Object.fromEntries(Object.entries(extensions).map(([name, value]) => [name, value.version])));
+}
+/**
+ * Use PAP clients while enforcing Agent Runtimes' public-summary boundary.
+ *
+ * Authorization URLs, callback state, assertions, proofs, and tokens are not
+ * represented by this API. Those values remain in deterministic host
+ * services and cross runtime boundaries only as opaque references.
+ */
+export class PapPersonalAgentCapability {
+    #discover;
+    #identity;
+    constructor(options = {}) {
+        this.#discover = options.discover ?? discoverCompany;
+        this.#identity = options.identity ?? new AgentIdentityClient();
+    }
+    async discoverCompany(domain, options = {}) {
+        const company = await this.#discover(domain, options);
+        const { document } = company;
+        const signIn = ['direct', 'device', 'mediated'].filter(method => document.auth?.[method] !== undefined);
+        const interfaces = [
+            ...(document.agent?.protocols.map(protocol => `agent:${protocol.type}`) ??
+                []),
+            ...document.apis.map(api => `api:${api.type}`),
+            ...(document.web === undefined ? [] : ['web']),
+        ];
+        return Object.freeze({
+            organization: document.organization.name,
+            domain: document.organization.domain,
+            protocolVersion: document.protocol_version,
+            issuer: document.auth?.issuer ?? null,
+            signIn: Object.freeze(signIn),
+            interfaces: Object.freeze(interfaces),
+            extensions: extensionVersions(document.extensions),
+        });
+    }
+    async inspectAgent(clientId, options = {}) {
+        const metadata = await this.#identity.fetchMetadata(clientId, options);
+        const keys = await this.#identity.fetchJwks(clientId, options);
+        const signingAlgorithms = [
+            ...new Set(keys.keys.map(key => key.alg ?? (key.kty === 'EC' ? 'ES256' : 'RS256'))),
+        ].sort();
+        return Object.freeze({
+            clientId: metadata.client_id,
+            clientName: metadata.client_name,
+            redirectCount: metadata.redirect_uris.length,
+            signingAlgorithms: Object.freeze(signingAlgorithms),
+            extensions: extensionVersions(metadata.extensions),
+        });
+    }
+}

package/lib/specs/apps.js

@@ -139,6 +139,10 @@ export const ACCOUNTING_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'accounting', 'finance', 'odoo', 'a2a', 'team'],
@@ -287,6 +291,10 @@ export const CHANGE_DETECTION_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: [
@@ -443,6 +451,10 @@ export const CROP_MONITORING_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: [
@@ -596,6 +608,10 @@ export const CUSTOMER_INTERVIEW_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'research', 'python'],
@@ -748,7 +764,44 @@ export const DATA_QUALITY_APP_0_0_1 = {
         ],
         minConfidence: 0.0,
         scenarios: [],
-        decisionModel: 'cloudflare:gtw/typesafe/jev',
+        decisionModel: 'cloudflare:wrk/typesafe/jev',
+    },
+    samples: {
+        documents: [],
+        alternatives: [
+            {
+                name: 'Prices in cents',
+                evidence: 'In the sample orders dataset (12,480 rows), 38 rows from the EU shop carry a unit price one hundred times the catalogue price — 1999 for an item listed at 19.99 — all imported by the same job on 4 March. Divided by one hundred, each matches its catalogue price to the cent. Corrected, total revenue falls by 6.1%.',
+                metrics: {
+                    'Rows affected': 38.0,
+                    'Effect on the result': 6.1,
+                },
+            },
+            {
+                name: 'Duplicate orders',
+                evidence: '96 order ids appear twice with identical lines, timestamps and amounts, all from a retried upload on 19 April. No order id appears three times. Removing the second copies lowers total revenue by 0.9%.',
+                metrics: {
+                    'Rows affected': 96.0,
+                    'Effect on the result': 0.9,
+                },
+            },
+            {
+                name: 'Missing region',
+                evidence: '1,032 rows have an empty region, all imported on 2 March from the partner channel; their shipping addresses are filled in and name a country in every case. Total revenue does not move; revenue by region moves by up to 4.5% once the region is read from the address.',
+                metrics: {
+                    'Rows affected': 1032.0,
+                    'Effect on the result': 4.5,
+                },
+            },
+            {
+                name: 'Very large orders',
+                evidence: '11 orders exceed 40,000 in value, the largest at 182,000. Each is from an account marked as a reseller, and each has an invoice and a delivery record that match its amount. Left out, total revenue would fall by 9.8%, but nothing suggests they are wrong.',
+                metrics: {
+                    'Rows affected': 11.0,
+                    'Effect on the result': 0.0,
+                },
+            },
+        ],
     },
     enabled: true,
     unavailable_because: '',
@@ -874,6 +927,10 @@ export const DECIDE_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'decisions', 'jev'],
@@ -1019,6 +1076,10 @@ export const DISASTER_ASSESSMENT_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: [
@@ -1153,6 +1214,10 @@ export const EVENT_RESPONSE_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: [
@@ -1349,6 +1414,10 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
     ],
     memory: 'mem0',
     notifications: ['email'],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: false,
     unavailable_because: 'It reads and sorts your mail, and a mailbox cannot be connected yet: the Google Workspace connection is still being built.',
     tags: ['example', 'worker', 'mail'],
@@ -1563,7 +1632,39 @@ export const MODEL_CHOICE_APP_0_0_1 = {
                 },
             },
         ],
-        decisionModel: 'cloudflare:gtw/typesafe/jev',
+        decisionModel: 'cloudflare:wrk/typesafe/jev',
+    },
+    samples: {
+        documents: [],
+        alternatives: [
+            {
+                name: 'Large model',
+                evidence: "A sample run of 50 support-ticket summaries: 46 passed. The four failures each left out the customer's account number, which the use case asks for. Every answer kept to the JSON format asked for. Its price per call is published on the Models page, and the run recorded a trajectory for each task.",
+                metrics: {
+                    'Pass rate': 0.92,
+                    'Cost per task': 1.8,
+                    Latency: 6.2,
+                },
+            },
+            {
+                name: 'Medium model',
+                evidence: 'The same 50 summaries: 43 passed. Of the seven failures, four left out the account number and three summarised the wrong ticket of a thread. Two answers broke the JSON format with a trailing comment. Its price per call is published, and every task has its trajectory.',
+                metrics: {
+                    'Pass rate': 0.86,
+                    'Cost per task': 0.6,
+                    Latency: 3.1,
+                },
+            },
+            {
+                name: 'Small model',
+                evidence: 'The same 50 summaries: 34 passed. Most of the 16 failures invented a resolution the thread never reached, and nine answers broke the JSON format. Its billing is not published on the Models page, and the run kept no trajectory for its failures.',
+                metrics: {
+                    'Pass rate': 0.68,
+                    'Cost per task': 0.2,
+                    Latency: 1.4,
+                },
+            },
+        ],
     },
     enabled: true,
     unavailable_because: '',
@@ -1718,6 +1819,10 @@ export const MONTH_END_CLOSE_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'accounting', 'finance', 'odoo', 'a2a', 'scene'],
@@ -2011,6 +2116,10 @@ export const PIPELINE_REPORT_APP_0_0_1 = {
     ],
     memory: '',
     notifications: ['email'],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: false,
     unavailable_because: 'Seven of the twelve checks it names before a report reaches the board cannot run yet, so no report it builds could pass them and be sent.',
     tags: ['example', 'worker', 'sales', 'reporting'],
@@ -2271,6 +2380,16 @@ export const QUOTE_CALCULATOR_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [
+            {
+                name: 'Price list',
+                file: 'price-list.csv',
+                text: 'plan,term,price_per_seat,billed,minimum_seats\nTeam,Monthly,15,each month,1\nTeam,Annual,144,each year,1\nBusiness,Monthly,30,each month,5\nBusiness,Annual,288,each year,5\nEnterprise,Monthly,55,each month,25\nEnterprise,Annual,528,each year,25\n',
+            },
+        ],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'widget'],
@@ -2523,6 +2642,10 @@ export const REPORT_FROM_A_FILE_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'widget', 'python'],
@@ -2650,6 +2773,10 @@ export const SALES_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'sales', 'finance', 'a2a', 'team'],
@@ -2833,7 +2960,39 @@ export const SHIP_OR_FIX_APP_0_0_1 = {
                 },
             },
         ],
-        decisionModel: 'cloudflare:gtw/typesafe/jev',
+        decisionModel: 'cloudflare:wrk/typesafe/jev',
+    },
+    samples: {
+        documents: [],
+        alternatives: [
+            {
+                name: 'Current prompt',
+                evidence: "A sample run of 80 tasks of a reporting agent: 70 passed. Six of the ten failures gave a wrong total in a quarterly figure, which a reader would act on; four put the table's columns in another order than the template asks. Nobody who reads the reports has complained about the column order.",
+                metrics: {
+                    'Pass rate': 0.875,
+                    'Cost per task': 2.4,
+                    Latency: 9.5,
+                },
+            },
+            {
+                name: 'With retrieval',
+                evidence: 'The same 80 tasks with the reports of the last two quarters retrieved first: 76 passed. The four failures are all formatting — a missing unit in a table header — and every figure was right. Each task reads about twice as much, which shows in its cost.',
+                metrics: {
+                    'Pass rate': 0.95,
+                    'Cost per task': 3.9,
+                    Latency: 12.8,
+                },
+            },
+            {
+                name: 'Smaller model',
+                evidence: 'The same 80 tasks on a smaller model: 61 passed. Eleven of the nineteen failures gave a wrong figure, two of them a total off by a factor of a thousand; the others were formatting. It is the cheapest and the fastest of the three.',
+                metrics: {
+                    'Pass rate': 0.7625,
+                    'Cost per task': 0.7,
+                    Latency: 4.1,
+                },
+            },
+        ],
     },
     enabled: true,
     unavailable_because: '',
@@ -3003,7 +3162,39 @@ export const SUPPLIER_COMPARISON_APP_0_0_1 = {
         ],
         minConfidence: 0.0,
         scenarios: [],
-        decisionModel: 'cloudflare:gtw/typesafe/jev',
+        decisionModel: 'cloudflare:wrk/typesafe/jev',
+    },
+    samples: {
+        documents: [],
+        alternatives: [
+            {
+                name: 'Northfield Components',
+                evidence: 'Quotes 18,400 for the 5,000 units, delivery included. Its delivery records show 47 of 50 past deliveries on time. It can make 6,000 units a month. It meets the stated requirements: ISO 9001, delivery within three weeks and payment at 60 days.',
+                metrics: {
+                    Price: 18400.0,
+                    'Delivery reliability': 0.94,
+                    Capacity: 1.0,
+                },
+            },
+            {
+                name: 'Harbor Supply',
+                evidence: 'Quotes 15,900 for the 5,000 units, plus 900 for delivery. 31 of 40 past deliveries arrived on time, the late ones by a week on average. It can make 4,000 units a month, so the order would ship in two parts. It is ISO 9001 certified, and asks for payment at 30 days.',
+                metrics: {
+                    Price: 16800.0,
+                    'Delivery reliability': 0.775,
+                    Capacity: 0.8,
+                },
+            },
+            {
+                name: 'Valley Works',
+                evidence: 'Quotes 17,200 for the 5,000 units, delivery included. 12 of its 15 past deliveries arrived on time. It states a capacity of 10,000 units a month, but sent no figure for the last quarter. It meets the delivery and payment terms; its ISO 9001 certificate expired last year and is being renewed.',
+                metrics: {
+                    Price: 17200.0,
+                    'Delivery reliability': 0.8,
+                    Capacity: 1.0,
+                },
+            },
+        ],
     },
     enabled: true,
     unavailable_because: '',
@@ -3306,6 +3497,10 @@ export const SUPPORT_DESK_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'support'],
@@ -3444,6 +3639,10 @@ export const WEB_RESEARCH_APP_0_0_1 = {
     triggers: [],
     memory: '',
     notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
     enabled: true,
     unavailable_because: '',
     tags: ['example', 'research'],
@@ -3934,7 +4133,43 @@ export const APP_SOURCES = {
                     instructions: 'Can the proposed correction be applied without a person checking each row?',
                 },
             ],
-            decision_model: 'cloudflare:gtw/typesafe/jev',
+            decision_model: 'cloudflare:wrk/typesafe/jev',
+        },
+        samples: {
+            alternatives: [
+                {
+                    name: 'Prices in cents',
+                    evidence: 'In the sample orders dataset (12,480 rows), 38 rows from the EU shop carry a unit price one hundred times the catalogue price — 1999 for an item listed at 19.99 — all imported by the same job on 4 March. Divided by one hundred, each matches its catalogue price to the cent. Corrected, total revenue falls by 6.1%.',
+                    metrics: {
+                        'Rows affected': 38.0,
+                        'Effect on the result': 6.1,
+                    },
+                },
+                {
+                    name: 'Duplicate orders',
+                    evidence: '96 order ids appear twice with identical lines, timestamps and amounts, all from a retried upload on 19 April. No order id appears three times. Removing the second copies lowers total revenue by 0.9%.',
+                    metrics: {
+                        'Rows affected': 96.0,
+                        'Effect on the result': 0.9,
+                    },
+                },
+                {
+                    name: 'Missing region',
+                    evidence: '1,032 rows have an empty region, all imported on 2 March from the partner channel; their shipping addresses are filled in and name a country in every case. Total revenue does not move; revenue by region moves by up to 4.5% once the region is read from the address.',
+                    metrics: {
+                        'Rows affected': 1032.0,
+                        'Effect on the result': 4.5,
+                    },
+                },
+                {
+                    name: 'Very large orders',
+                    evidence: '11 orders exceed 40,000 in value, the largest at 182,000. Each is from an account marked as a reseller, and each has an invoice and a delivery record that match its amount. Left out, total revenue would fall by 9.8%, but nothing suggests they are wrong.',
+                    metrics: {
+                        'Rows affected': 11.0,
+                        'Effect on the result': 0.0,
+                    },
+                },
+            ],
         },
         tags: ['example', 'decision', 'data-quality'],
         icon: 'filter',
@@ -4447,7 +4682,38 @@ export const APP_SOURCES = {
                     },
                 },
             ],
-            decision_model: 'cloudflare:gtw/typesafe/jev',
+            decision_model: 'cloudflare:wrk/typesafe/jev',
+        },
+        samples: {
+            alternatives: [
+                {
+                    name: 'Large model',
+                    evidence: "A sample run of 50 support-ticket summaries: 46 passed. The four failures each left out the customer's account number, which the use case asks for. Every answer kept to the JSON format asked for. Its price per call is published on the Models page, and the run recorded a trajectory for each task.",
+                    metrics: {
+                        'Pass rate': 0.92,
+                        'Cost per task': 1.8,
+                        Latency: 6.2,
+                    },
+                },
+                {
+                    name: 'Medium model',
+                    evidence: 'The same 50 summaries: 43 passed. Of the seven failures, four left out the account number and three summarised the wrong ticket of a thread. Two answers broke the JSON format with a trailing comment. Its price per call is published, and every task has its trajectory.',
+                    metrics: {
+                        'Pass rate': 0.86,
+                        'Cost per task': 0.6,
+                        Latency: 3.1,
+                    },
+                },
+                {
+                    name: 'Small model',
+                    evidence: 'The same 50 summaries: 34 passed. Most of the 16 failures invented a resolution the thread never reached, and nine answers broke the JSON format. Its billing is not published on the Models page, and the run kept no trajectory for its failures.',
+                    metrics: {
+                        'Pass rate': 0.68,
+                        'Cost per task': 0.2,
+                        Latency: 1.4,
+                    },
+                },
+            ],
         },
         tags: ['example', 'decision', 'benchmarks', 'models'],
         icon: 'cpu',
@@ -4986,6 +5252,15 @@ export const APP_SOURCES = {
             hosted: {},
             embedded: {},
         },
+        samples: {
+            documents: [
+                {
+                    name: 'Price list',
+                    file: 'price-list.csv',
+                    text: 'plan,term,price_per_seat,billed,minimum_seats\nTeam,Monthly,15,each month,1\nTeam,Annual,144,each year,1\nBusiness,Monthly,30,each month,5\nBusiness,Annual,288,each year,5\nEnterprise,Monthly,55,each month,25\nEnterprise,Annual,528,each year,25\n',
+                },
+            ],
+        },
         tags: ['example', 'widget'],
         icon: 'number',
         emoji: '🧮',
@@ -5351,7 +5626,38 @@ export const APP_SOURCES = {
                     },
                 },
             ],
-            decision_model: 'cloudflare:gtw/typesafe/jev',
+            decision_model: 'cloudflare:wrk/typesafe/jev',
+        },
+        samples: {
+            alternatives: [
+                {
+                    name: 'Current prompt',
+                    evidence: "A sample run of 80 tasks of a reporting agent: 70 passed. Six of the ten failures gave a wrong total in a quarterly figure, which a reader would act on; four put the table's columns in another order than the template asks. Nobody who reads the reports has complained about the column order.",
+                    metrics: {
+                        'Pass rate': 0.875,
+                        'Cost per task': 2.4,
+                        Latency: 9.5,
+                    },
+                },
+                {
+                    name: 'With retrieval',
+                    evidence: 'The same 80 tasks with the reports of the last two quarters retrieved first: 76 passed. The four failures are all formatting — a missing unit in a table header — and every figure was right. Each task reads about twice as much, which shows in its cost.',
+                    metrics: {
+                        'Pass rate': 0.95,
+                        'Cost per task': 3.9,
+                        Latency: 12.8,
+                    },
+                },
+                {
+                    name: 'Smaller model',
+                    evidence: 'The same 80 tasks on a smaller model: 61 passed. Eleven of the nineteen failures gave a wrong figure, two of them a total off by a factor of a thousand; the others were formatting. It is the cheapest and the fastest of the three.',
+                    metrics: {
+                        'Pass rate': 0.7625,
+                        'Cost per task': 0.7,
+                        Latency: 4.1,
+                    },
+                },
+            ],
         },
         tags: ['example', 'decision', 'benchmarks'],
         icon: 'checklist',
@@ -5443,7 +5749,38 @@ export const APP_SOURCES = {
                     ],
                 },
             ],
-            decision_model: 'cloudflare:gtw/typesafe/jev',
+            decision_model: 'cloudflare:wrk/typesafe/jev',
+        },
+        samples: {
+            alternatives: [
+                {
+                    name: 'Northfield Components',
+                    evidence: 'Quotes 18,400 for the 5,000 units, delivery included. Its delivery records show 47 of 50 past deliveries on time. It can make 6,000 units a month. It meets the stated requirements: ISO 9001, delivery within three weeks and payment at 60 days.',
+                    metrics: {
+                        Price: 18400.0,
+                        'Delivery reliability': 0.94,
+                        Capacity: 1.0,
+                    },
+                },
+                {
+                    name: 'Harbor Supply',
+                    evidence: 'Quotes 15,900 for the 5,000 units, plus 900 for delivery. 31 of 40 past deliveries arrived on time, the late ones by a week on average. It can make 4,000 units a month, so the order would ship in two parts. It is ISO 9001 certified, and asks for payment at 30 days.',
+                    metrics: {
+                        Price: 16800.0,
+                        'Delivery reliability': 0.775,
+                        Capacity: 0.8,
+                    },
+                },
+                {
+                    name: 'Valley Works',
+                    evidence: 'Quotes 17,200 for the 5,000 units, delivery included. 12 of its 15 past deliveries arrived on time. It states a capacity of 10,000 units a month, but sent no figure for the last quarter. It meets the delivery and payment terms; its ISO 9001 certificate expired last year and is being renewed.',
+                    metrics: {
+                        Price: 17200.0,
+                        'Delivery reliability': 0.8,
+                        Capacity: 1.0,
+                    },
+                },
+            ],
         },
         tags: ['example', 'decision', 'procurement'],
         icon: 'package',

package/lib/specs/appspecSchema.js

@@ -1010,6 +1010,81 @@ export const APPSPEC_SCHEMA = {
             title: 'AppRule',
             type: 'object',
         },
+        AppSampleAlternative: {
+            additionalProperties: false,
+            description: 'An alternative a decision is tried on, and what is known about it.',
+            properties: {
+                name: {
+                    description: 'Its name',
+                    title: 'Name',
+                    type: 'string',
+                },
+                evidence: {
+                    description: 'What is known about it: the text its typed questions are asked on',
+                    title: 'Evidence',
+                    type: 'string',
+                },
+                metrics: {
+                    additionalProperties: {
+                        type: 'number',
+                    },
+                    description: "What each metric criterion found for it, by the criterion's name",
+                    title: 'Metrics',
+                    type: 'object',
+                },
+            },
+            required: ['name', 'evidence'],
+            title: 'AppSampleAlternative',
+            type: 'object',
+        },
+        AppSampleDocument: {
+            additionalProperties: false,
+            description: 'A document it answers from, as Datalayer publishes it with the application.',
+            properties: {
+                name: {
+                    description: 'The document, as its `contents` names it',
+                    title: 'Name',
+                    type: 'string',
+                },
+                file: {
+                    description: 'The file it is given as, in a sandbox: `price-list.csv`',
+                    title: 'File',
+                    type: 'string',
+                },
+                text: {
+                    description: 'What it holds',
+                    title: 'Text',
+                    type: 'string',
+                },
+            },
+            required: ['name', 'file', 'text'],
+            title: 'AppSampleDocument',
+            type: 'object',
+        },
+        AppSamples: {
+            additionalProperties: false,
+            description: "What it is tried on before it is anybody's (STUDIO 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.",
+            properties: {
+                documents: {
+                    description: 'Documents of its `contents`, as Datalayer publishes them',
+                    items: {
+                        $ref: '#/$defs/AppSampleDocument',
+                    },
+                    title: 'Documents',
+                    type: 'array',
+                },
+                alternatives: {
+                    description: 'For a decision: alternatives with their evidence',
+                    items: {
+                        $ref: '#/$defs/AppSampleAlternative',
+                    },
+                    title: 'Alternatives',
+                    type: 'array',
+                },
+            },
+            title: 'AppSamples',
+            type: 'object',
+        },
         AppScenario: {
             additionalProperties: false,
             description: 'A named set of weights: one way of looking at the same findings.',
@@ -1900,6 +1975,10 @@ export const APPSPEC_SCHEMA = {
             default: null,
             description: 'For a decision: what it decides',
         },
+        samples: {
+            $ref: '#/$defs/AppSamples',
+            description: "What it is tried on before it is anybody's: published with it by Datalayer, read only",
+        },
         enabled: {
             default: true,
             description: 'Whether it is offered today',