@datalayer/agent-runtimes 1.5.4 → 1.5.7

package/lib/specs/appspecSchema.js

@@ -201,6 +201,62 @@ export const APPSPEC_SCHEMA = {
             title: 'AppCommand',
             type: 'object',
         },
+        AppCommerce: {
+            additionalProperties: false,
+            description: 'Commerce: the merchants it shops at for each person (AGENT_PROTOCOLS PI-01).',
+            properties: {
+                merchants: {
+                    description: 'Merchants, over UCP or ACP: test merchants only for now',
+                    items: {
+                        $ref: '#/$defs/AppCommerceMerchant',
+                    },
+                    title: 'Merchants',
+                    type: 'array',
+                },
+            },
+            title: 'AppCommerce',
+            type: 'object',
+        },
+        AppCommerceMerchant: {
+            additionalProperties: false,
+            description: "A merchant the application shops at for each person, over UCP or ACP (AGENT_PROTOCOLS 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.",
+            properties: {
+                id: {
+                    description: 'Stable within the application: `example-store`',
+                    title: 'Id',
+                    type: 'string',
+                },
+                protocol: {
+                    $ref: '#/$defs/CommerceProtocol',
+                    description: '`ucp` or `acp`',
+                },
+                merchant: {
+                    description: "The merchant's domain: `store.example`",
+                    title: 'Merchant',
+                    type: 'string',
+                },
+                access: {
+                    $ref: '#/$defs/Access',
+                    default: 'read',
+                    description: 'How far: `read` (searches and reads its checkouts), or `write` (also fills a checkout and buys, each purchase asked of the person)',
+                },
+                limit: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/AppSpendLimit',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'The most one purchase may cost there: required for `write`',
+                },
+            },
+            required: ['id', 'protocol', 'merchant'],
+            title: 'AppCommerceMerchant',
+            type: 'object',
+        },
         AppComputer: {
             additionalProperties: false,
             description: 'What the application may do on its own computer. Each is off until it is turned on.',
@@ -1446,6 +1502,25 @@ export const APPSPEC_SCHEMA = {
             title: 'AppSpaceGrant',
             type: 'object',
         },
+        AppSpendLimit: {
+            additionalProperties: false,
+            description: 'The most one purchase may cost at a merchant (AGENT_PROTOCOLS PI-22).',
+            properties: {
+                amount: {
+                    description: 'At most this much, as written: `50`, `12.50`',
+                    title: 'Amount',
+                    type: 'string',
+                },
+                currency: {
+                    description: 'Its currency, ISO 4217: `USD`',
+                    title: 'Currency',
+                    type: 'string',
+                },
+            },
+            required: ['amount', 'currency'],
+            title: 'AppSpendLimit',
+            type: 'object',
+        },
         AppStarter: {
             additionalProperties: false,
             description: 'A first message offered to the user.',
@@ -1974,6 +2049,12 @@ export const APPSPEC_SCHEMA = {
             title: 'CheckStage',
             type: 'string',
         },
+        CommerceProtocol: {
+            description: 'The commerce protocol a merchant is reached over (AGENT_PROTOCOLS PI-01).',
+            enum: ['ucp', 'acp'],
+            title: 'CommerceProtocol',
+            type: 'string',
+        },
         CriterionKind: {
             description: 'How a criterion is assessed.',
             enum: ['metric', 'noul', 'choice', 'score'],
@@ -2311,7 +2392,7 @@ export const APPSPEC_SCHEMA = {
             type: 'array',
         },
         protocols: {
-            description: 'The agent protocols it speaks, ids of the protocols catalogue (AGENT_PROTOCOLS PS-02): its `pap`, `pact` and `a2a` blocks are refused unless their protocol is listed, and a planned protocol only while it is not offered',
+            description: 'The agent protocols it speaks, ids of the protocols catalogue (AGENT_PROTOCOLS PS-02): its `pap`, `pact` 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',
             items: {
                 type: 'string',
             },
@@ -2334,6 +2415,10 @@ export const APPSPEC_SCHEMA = {
             $ref: '#/$defs/AppPact',
             description: 'PACT: businesses it asks for each person',
         },
+        commerce: {
+            $ref: '#/$defs/AppCommerce',
+            description: 'UCP and ACP: merchants it shops at for each person',
+        },
         a2a: {
             $ref: '#/$defs/AppA2A',
             description: 'A2A: the extensions its Agent Card advertises',

package/lib/specs/protocols.js

@@ -41,12 +41,12 @@ export const ACP_PROTOCOL_0_0_1 = {
     id: 'acp',
     version: '0.0.1',
     name: 'Agentic Commerce Protocol',
-    description: 'Checkout sessions at a seller, completed with a delegated payment token the model never sees. Planned in applications: the client exists, purchases wait on a source of payment tokens.',
+    description: 'Checkout sessions at a seller, completed with a payment the model never sees. In applications at test merchants only, with no real payment token (decided 2026-10-13): each purchase asked of the person first, made at most once.',
     publisher: 'OpenAI, Stripe',
     layer: 'commerce',
     specUrl: 'https://github.com/agentic-commerce-protocol/agentic-commerce-protocol',
     specVersion: '2026-04-17',
-    status: 'planned',
+    status: 'shipped',
     connects: 'Sellers, to check out with a delegated payment',
     packages: {
         python: ['agent-runtimes'],
@@ -145,12 +145,12 @@ export const UCP_PROTOCOL_0_0_1 = {
     id: 'ucp',
     version: '0.0.1',
     name: 'Universal Commerce Protocol',
-    description: 'Shopping at a merchant: catalogue, checkout and orders, every purchase an exact proposal the person approves. Planned in applications: the client exists, purchases wait on a source of payment tokens.',
+    description: 'Shopping at a merchant: catalogue, checkout and orders, every purchase an exact proposal the person approves. In applications at test merchants only, with no real payment (decided 2026-10-13): each purchase asked of the person first, made at most once.',
     publisher: 'Google, with Shopify and retailers',
     layer: 'commerce',
     specUrl: 'https://github.com/Universal-Commerce-Protocol/ucp',
     specVersion: '2026-08-25',
-    status: 'planned',
+    status: 'shipped',
     connects: 'Merchants, to search, check out and follow orders',
     packages: {
         python: ['ucp-sdk', 'agent-runtimes'],

package/lib/specs/sceneSchema.js

@@ -116,6 +116,35 @@ export const SCENE_SCHEMA = {
             title: 'RehearsalBeat',
             type: 'object',
         },
+        SceneActor: {
+            additionalProperties: false,
+            description: 'Somebody on a scripted scene: a person, an application, a company — never a team member.',
+            properties: {
+                id: {
+                    description: 'Its id, as the lines name it',
+                    title: 'Id',
+                    type: 'string',
+                },
+                name: {
+                    description: 'The name the audience sees',
+                    title: 'Name',
+                    type: 'string',
+                },
+                face: {
+                    description: 'One emoji, drawn before the name',
+                    title: 'Face',
+                    type: 'string',
+                },
+                is: {
+                    description: 'What it is, in a few words',
+                    title: 'Is',
+                    type: 'string',
+                },
+            },
+            required: ['id', 'name', 'face', 'is'],
+            title: 'SceneActor',
+            type: 'object',
+        },
         SceneAudience: {
             additionalProperties: false,
             description: 'Who may watch and ask, and what an ask may cost.',
@@ -242,6 +271,47 @@ export const SCENE_SCHEMA = {
             title: 'SceneBranch',
             type: 'object',
         },
+        SceneCard: {
+            additionalProperties: false,
+            description: 'What the audience reads on a line: rows and sentences, never a credential.',
+            properties: {
+                kind: {
+                    $ref: '#/$defs/SceneCardKind',
+                },
+                title: {
+                    title: 'Title',
+                    type: 'string',
+                },
+                rows: {
+                    description: 'Its rows: each a label and a value',
+                    items: {
+                        items: {
+                            type: 'string',
+                        },
+                        type: 'array',
+                    },
+                    title: 'Rows',
+                    type: 'array',
+                },
+                lines: {
+                    description: 'Its sentences',
+                    items: {
+                        type: 'string',
+                    },
+                    title: 'Lines',
+                    type: 'array',
+                },
+            },
+            required: ['kind', 'title'],
+            title: 'SceneCard',
+            type: 'object',
+        },
+        SceneCardKind: {
+            description: 'What a card of a scripted line is.',
+            enum: ['found', 'sign-in', 'approval', 'done', 'record'],
+            title: 'SceneCardKind',
+            type: 'string',
+        },
         SceneCastMember: {
             additionalProperties: false,
             description: 'A member of the cast.\n\nOn a staged team, it names a member of the team (`member`) and says only\nhow it appears here (`persona`) and what it is for in this scene\n(`brief`). Written inline — a scene with no `team` — it is the member:\nwhat it is (`app`, `ref` or `server`), its `role`, where it `runs_in`\nand whom it `talks_to`, as a team member says them.',
@@ -370,6 +440,67 @@ export const SCENE_SCHEMA = {
             title: 'SceneDeployment',
             type: 'object',
         },
+        SceneKind: {
+            description: 'What a scene plays: a team, live (`team`), or lines written out (`scripted`).',
+            enum: ['team', 'scripted'],
+            title: 'SceneKind',
+            type: 'string',
+        },
+        SceneLine: {
+            additionalProperties: false,
+            description: 'One line of a scripted scene: who acts, to whom, what they say or do.',
+            properties: {
+                from: {
+                    description: "Who acts: an actor's id",
+                    title: 'From',
+                    type: 'string',
+                },
+                to: {
+                    default: '',
+                    description: 'To whom, when somebody is addressed',
+                    title: 'To',
+                    type: 'string',
+                },
+                says: {
+                    description: 'What they say or do, in a sentence; in quotes when it is said',
+                    title: 'Says',
+                    type: 'string',
+                },
+                card: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/SceneCard',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'What the audience reads',
+                },
+                how: {
+                    default: '',
+                    description: "What happened underneath, in a visitor's words",
+                    title: 'How',
+                    type: 'string',
+                },
+                turn: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/SceneTurn',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: "The audience's turn: the scene waits",
+                },
+            },
+            required: ['from', 'says'],
+            title: 'SceneLine',
+            type: 'object',
+        },
         SceneMove: {
             additionalProperties: false,
             description: 'One member asking another over a protocol, or answering the audience.',
@@ -680,6 +811,32 @@ export const SCENE_SCHEMA = {
             title: 'SceneTranscript',
             type: 'object',
         },
+        SceneTurn: {
+            additionalProperties: false,
+            description: "The audience's turn on a scripted line: the scene waits for them.",
+            properties: {
+                yes: {
+                    description: 'What saying yes is called',
+                    title: 'Yes',
+                    type: 'string',
+                },
+                no: {
+                    default: '',
+                    description: 'What saying no is called; none when there is nothing to refuse',
+                    title: 'No',
+                    type: 'string',
+                },
+                declined: {
+                    default: '',
+                    description: 'What happens once they said no: the scene ends there',
+                    title: 'Declined',
+                    type: 'string',
+                },
+            },
+            required: ['yes'],
+            title: 'SceneTurn',
+            type: 'object',
+        },
         StagePosition: {
             additionalProperties: false,
             description: 'Where a member stands: fractions of the box, left to right and top to bottom.',
@@ -757,7 +914,7 @@ export const SCENE_SCHEMA = {
         },
     },
     additionalProperties: false,
-    description: 'Specification for a scene: a team, staged.',
+    description: 'Specification for a scene: a team, staged — or, `kind: scripted`, lines written out.',
     properties: {
         schema: {
             description: 'The version of the spec itself',
@@ -806,6 +963,11 @@ export const SCENE_SCHEMA = {
             title: 'Emoji',
             type: 'string',
         },
+        kind: {
+            $ref: '#/$defs/SceneKind',
+            default: 'team',
+            description: '`team`: a team staged, live; `scripted`: lines written out, played as written, with no team or cast',
+        },
         team: {
             default: '',
             description: 'The team it stages, `id` or `id:version`',
@@ -854,6 +1016,28 @@ export const SCENE_SCHEMA = {
             $ref: '#/$defs/SceneDeployment',
             description: 'Where it plays',
         },
+        actors: {
+            description: "A scripted scene's actors",
+            items: {
+                $ref: '#/$defs/SceneActor',
+            },
+            title: 'Actors',
+            type: 'array',
+        },
+        lines: {
+            description: "A scripted scene's lines, in order",
+            items: {
+                $ref: '#/$defs/SceneLine',
+            },
+            title: 'Lines',
+            type: 'array',
+        },
+        live: {
+            default: '',
+            description: 'A scripted scene: what of it runs on Datalayer today, said honestly',
+            title: 'Live',
+            type: 'string',
+        },
     },
     required: ['id', 'name'],
     title: 'Scene spec',

package/lib/specs/scenes.d.ts

@@ -11,7 +11,13 @@ import type { SceneSpec } from '../types/scenes';
 export declare const CROP_MONITORING_SCENE_0_0_1: SceneSpec;
 export declare const DISASTER_ASSESSMENT_SCENE_0_0_1: SceneSpec;
 export declare const MONTH_END_CLOSE_SCENE_0_0_1: SceneSpec;
+export declare const PACT_A_PERSONAL_AGENT_AT_A_BUSINESS_SCENE_0_0_1: SceneSpec;
+export declare const PAP_A_PERSON_AND_A_COMPANY_SCENE_0_0_1: SceneSpec;
+export declare const PAP_APPROVE_ONCE_SCENE_0_0_1: SceneSpec;
+export declare const PAP_TWO_COMPANIES_SCENE_0_0_1: SceneSpec;
+export declare const PAP_YOUR_APPLICATION_A_COMPANY_SCENE_0_0_1: SceneSpec;
 export declare const SALES_AND_ACCOUNTING_SCENE_0_0_1: SceneSpec;
+export declare const UCP_A_PURCHASE_APPROVED_SCENE_0_0_1: SceneSpec;
 export declare const SCENE_CATALOGUE: Record<string, SceneSpec>;
 /** A scene, by `id` or `id:version`, or undefined. */
 export declare function getSceneSpec(ref: string): SceneSpec | undefined;