@datalayer/agent-runtimes 1.5.4 → 1.5.6

package/lib/apps/apps/appspec.d.ts

@@ -99,7 +99,7 @@ export declare function uiProblems(app: Pick<AppSpec, 'ui' | 'enabled'>): string
  * know or said twice, a planned protocol while it is offered, and a `pap`,
  * `pact` or `a2a` block configuring a protocol it does not list.
  */
-export declare function protocolsProblems(app: Pick<AppSpec, 'protocols' | 'enabled' | 'pap' | 'pact' | 'a2a'>): string[];
+export declare function protocolsProblems(app: Pick<AppSpec, 'protocols' | 'enabled' | 'pap' | 'pact' | 'a2a' | 'commerce'>): string[];
 /**
  * An application as the document its file holds.
  *

package/lib/apps/apps/appspec.js

@@ -204,6 +204,7 @@ const KNOWN_KEYS = [
     'ui',
     'pap',
     'pact',
+    'commerce',
     'a2a',
     'rules',
     'permissions',
@@ -333,6 +334,41 @@ function parsePact(data) {
         })),
     };
 }
+/** Commerce (AGENT_PROTOCOLS PI-01): the merchants it shops at for each person. */
+function parseCommerce(data) {
+    return {
+        merchants: records(data.merchants).map(merchant => ({
+            id: text(merchant.id),
+            protocol: oneOf(merchant.protocol, ['ucp', 'acp'], 'ucp'),
+            merchant: text(merchant.merchant),
+            access: oneOf(merchant.access, ['read', 'write'], 'read'),
+            ...(isData(merchant.limit)
+                ? {
+                    limit: {
+                        amount: text(merchant.limit.amount),
+                        currency: text(merchant.limit.currency),
+                    },
+                }
+                : {}),
+        })),
+    };
+}
+/** Commerce as its document says it, nothing at its default. */
+function dumpCommerce(commerce) {
+    if (!commerce)
+        return {};
+    return new Writer().list('merchants', commerce.merchants.map(merchant => new Writer()
+        .text('id', merchant.id, '\u0000')
+        .text('protocol', merchant.protocol, '\u0000')
+        .text('merchant', merchant.merchant, '\u0000')
+        .value('access', merchant.access, 'read')
+        .part('limit', merchant.limit
+        ? {
+            amount: merchant.limit.amount,
+            currency: merchant.limit.currency,
+        }
+        : {}).data)).data;
+}
 /** PACT as its document says it, nothing at its default. */
 function dumpPact(pact) {
     if (!pact)
@@ -912,6 +948,9 @@ export function parseAppspec(document) {
     if (isData(data.pact)) {
         app.pact = parsePact(data.pact);
     }
+    if (isData(data.commerce)) {
+        app.commerce = parseCommerce(data.commerce);
+    }
     if (isData(data.a2a)) {
         app.a2a = parseA2A(data.a2a);
     }
@@ -976,6 +1015,12 @@ export function protocolsProblems(app) {
             problems.push(`Its \`${block}\` block configures ${spec.name}, which it does not list: add '${spec.id}' to \`protocols\`.`);
         }
     }
+    // The `commerce` block configures UCP and ACP, by each merchant's protocol.
+    for (const id of new Set((app.commerce?.merchants ?? []).map(merchant => merchant.protocol))) {
+        if (!app.protocols.includes(id)) {
+            problems.push(`Its \`commerce\` block shops over ${id.toUpperCase()}, which it does not list: add '${id}' to \`protocols\`.`);
+        }
+    }
     return problems;
 }
 // --- writing --------------------------------------------------------------------------
@@ -1243,6 +1288,7 @@ export function dumpAppspec(app) {
         .list('ui', app.ui)
         .part('pap', dumpPap(app.pap))
         .part('pact', dumpPact(app.pact))
+        .part('commerce', dumpCommerce(app.commerce))
         .part('a2a', dumpA2A(app.a2a))
         .list('rules', app.rules.map(rule => ({
         action: rule.action,

package/lib/apps/apps/sceneYaml.js

@@ -31,6 +31,7 @@ export const emptySceneSpec = () => ({
     schema: SCENE_SCHEMA,
     id: '',
     version: '0.0.1',
+    kind: 'team',
     name: '',
     description: '',
     tags: [],
@@ -57,6 +58,9 @@ export const emptySceneSpec = () => ({
     },
     deployment: { account: '', page: '', addresses: {} },
     setup: [],
+    actors: [],
+    lines: [],
+    live: '',
 });
 const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 /**

package/lib/examples/ScenesExample.js

@@ -208,7 +208,8 @@ function Scene({ scene }) {
                                 } }), _jsxs(Box, { display: "flex", gap: 2, mt: 2, children: [_jsx(Button, { variant: "primary", disabled: !team.ready || team.busy || !draft.trim(), onClick: () => send(draft), children: "Ask" }), team.busy && _jsx(Button, { onClick: team.stop, children: "Stop" })] }), _jsx(Box, { mt: 3, "data-team-conversation": "", children: team.turns.map((turn, index) => (_jsxs(Box, { p: 2, mb: 2, borderRadius: 2, bg: turn.role === 'user' ? 'accent.subtle' : 'canvas.subtle', children: [_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted', display: 'block' }, children: turn.role === 'user' ? PERSON : entry.app.name }), _jsx(Streamdown, { children: turn.text })] }, index))) })] }), _jsxs(Box, { flex: "1 1 360px", minWidth: 0, children: [!team.notebook && stage.peers.length > 0 && (_jsxs(_Fragment, { children: [_jsx(Heading, { as: "h3", sx: { fontSize: 2, mb: 2 }, children: "The report" }), _jsx(Box, { p: 3, border: "1px solid", borderColor: "border.default", borderRadius: 2, minHeight: 120, "data-team-report": "", children: team.report ? (_jsx(Streamdown, { children: team.report })) : (_jsx(Text, { sx: { color: 'fg.muted' }, children: "What the last member asked returns appears here, as it returned it, or as a notebook to run when it gives one." })) })] })), scene.setup.length > 0 && (_jsxs(Box, { mt: 3, "data-scene-setup": "", children: [_jsx(Heading, { as: "h3", sx: { fontSize: 1, mb: 1 }, children: "What this scene needs" }), scene.setup.map(line => (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', m: 0 }, children: line }, line)))] }))] })] })] }));
 }
 function Scenes() {
-    const scenes = useMemo(() => listSceneSpecs(), []);
+    // A scripted scene is played as written on its page (PAP_DATALAYER X-02): here, the teams staged live.
+    const scenes = useMemo(() => listSceneSpecs().filter(scene => scene.kind === 'team'), []);
     const [selected, setSelected] = useState(scenes[0]?.id ?? '');
     const scene = scenes.find(one => one.id === selected) ?? scenes[0];
     return (_jsxs(Box, { p: 4, maxWidth: 1080, mx: "auto", children: [_jsx(Heading, { as: "h2", sx: { fontSize: 4, mb: 1 }, children: "Scenes" }), _jsxs(Text, { as: "p", sx: { color: 'fg.muted', mt: 0 }, children: ["The catalogue\u2019s scenes, played against the local servers: each member on a runtime is served over A2A by ", _jsx("code", { children: "serve_scenes.py" }), "; the entry in your browser asks on your token or a visitor\u2019s trial key."] }), _jsx(UnderlineNav, { "aria-label": "Scenes", sx: { mb: 3 }, children: scenes.map(one => (_jsxs(UnderlineNav.Item, { "aria-current": one.id === scene?.id ? 'page' : undefined, onSelect: event => {

package/lib/protocols/commerce.js

@@ -21,13 +21,21 @@ import { PROTOCOL_TOOL_CLASSES } from '../specs/actions';
  * thing: one with several classes, or none, throws rather than guess.
  */
 export function operationClasses(protocol) {
+    const table = PROTOCOL_TOOL_CLASSES[protocol];
+    // The table names the gateway's tools (`ucp_search`): an operation is the
+    // tool's name without its connection's prefix.
+    const prefix = `${table.connection}_`;
     const out = {};
-    for (const [name, classes] of Object.entries(PROTOCOL_TOOL_CLASSES[protocol].tools)) {
+    for (const [name, classes] of Object.entries(table.tools)) {
         if (classes.length !== 1) {
             throw new Error(`${protocol} ${name} is classed ${classes}: one class each`);
         }
-        out[name.replace(/_([a-z])/g, (_, c) => c.toUpperCase())] =
-            classes[0];
+        if (!name.startsWith(prefix)) {
+            throw new Error(`${protocol} ${name} is not one of its \`${prefix}\` tools`);
+        }
+        out[name
+            .slice(prefix.length)
+            .replace(/_([a-z])/g, (_, c) => c.toUpperCase())] = classes[0];
     }
     return out;
 }

package/lib/specs/actions.js

@@ -671,12 +671,11 @@ export const PROTOCOL_TOOL_CLASSES = {
     'agentic-commerce': {
         connection: 'acp',
         tools: {
-            propose_completion: ['read'],
-            get_checkout: ['read'],
-            create_checkout: ['write'],
-            update_checkout: ['write'],
-            cancel_checkout: ['write'],
-            complete: ['buy'],
+            acp_get_checkout: ['read'],
+            acp_create_checkout: ['write'],
+            acp_update_checkout: ['write'],
+            acp_cancel_checkout: ['write'],
+            acp_complete: ['buy'],
         },
     },
     pact: {
@@ -694,8 +693,8 @@ export const PROTOCOL_TOOL_CLASSES = {
         connection: 'pap',
         tools: {
             pap_company: ['read'],
-            pap_ask: ['read'],
-            pap_handoff: ['read'],
+            pap_ask: ['send'],
+            pap_handoff: ['send'],
             pap_sign_in: ['read'],
             pap_sign_in_status: ['read'],
             pap_read: ['read'],
@@ -708,13 +707,12 @@ export const PROTOCOL_TOOL_CLASSES = {
     ucp: {
         connection: 'ucp',
         tools: {
-            search: ['read'],
-            propose_completion: ['read'],
-            get_checkout: ['read'],
-            create_checkout: ['write'],
-            update_checkout: ['write'],
-            cancel_checkout: ['write'],
-            complete: ['buy'],
+            ucp_search: ['read'],
+            ucp_get_checkout: ['read'],
+            ucp_create_checkout: ['write'],
+            ucp_update_checkout: ['write'],
+            ucp_cancel_checkout: ['write'],
+            ucp_complete: ['buy'],
         },
     },
 };
@@ -975,6 +973,7 @@ export const APP_BEHAVIOURS = {
     'report-from-a-file': {},
     sales: {},
     'ship-or-fix': {},
+    'shopping-desk': {},
     'supplier-comparison': {},
     'support-desk': {},
     'travel-desk': {},
@@ -1042,6 +1041,7 @@ export const APP_ESCALATIONS = {
     'report-from-a-file': {},
     sales: {},
     'ship-or-fix': {},
+    'shopping-desk': {},
     'supplier-comparison': {},
     'support-desk': {},
     'travel-desk': {},

package/lib/specs/apps.d.ts

@@ -26,6 +26,7 @@ export declare const QUOTE_CALCULATOR_APP_0_0_1: AppSpec;
 export declare const REPORT_FROM_A_FILE_APP_0_0_1: AppSpec;
 export declare const SALES_APP_0_0_1: AppSpec;
 export declare const SHIP_OR_FIX_APP_0_0_1: AppSpec;
+export declare const SHOPPING_DESK_APP_0_0_1: AppSpec;
 export declare const SUPPLIER_COMPARISON_APP_0_0_1: AppSpec;
 export declare const SUPPORT_DESK_APP_0_0_1: AppSpec;
 export declare const TRAVEL_DESK_APP_0_0_1: AppSpec;

package/lib/specs/apps.js

@@ -2152,10 +2152,15 @@ export const ORDER_DESK_APP_0_0_1 = {
     },
     rules: [
         {
-            action: 'Ask the shop and read your orders',
+            action: 'Read your orders at the shop',
             appliesTo: ['read'],
             behaviour: 'do_it',
         },
+        {
+            action: 'Send the shop a message for you',
+            appliesTo: ['send'],
+            behaviour: 'ask_first',
+        },
         {
             action: 'Confirm an exchange or a return the shop proposes',
             appliesTo: ['write'],
@@ -3469,6 +3474,173 @@ export const SHIP_OR_FIX_APP_0_0_1 = {
     banner: '',
     setup: [],
 };
+export const SHOPPING_DESK_APP_0_0_1 = {
+    schema: 'loop.app/v1',
+    id: 'shopping-desk',
+    version: '0.0.1',
+    name: 'Shopping Desk',
+    kind: 'chat',
+    description: 'Finds what you want at the shop, fills your basket and buys it only once you approve the exact purchase, up to a limit you know.',
+    owner: 'Datalayer <info@datalayer.io>',
+    agent: 'cog-crawler:0.0.1',
+    team: '',
+    instructions: 'You shop at Example Store and Example Outfitters for the person you talk to, through their tools. Search its catalogue and fill a checkout with what they asked for. Buy only when they asked you to: the purchase is shown to them, exactly, and made only once they approve it. Never ask for a card number or any payment detail.',
+    model: '',
+    skills: [],
+    backendTools: [],
+    tools: [],
+    context: [],
+    contents: [],
+    connections: [],
+    protocols: ['ucp', 'acp'],
+    ui: [],
+    commerce: {
+        merchants: [
+            {
+                id: 'example-store',
+                protocol: 'ucp',
+                merchant: 'store.example',
+                access: 'write',
+                limit: {
+                    amount: '50',
+                    currency: 'USD',
+                },
+            },
+            {
+                id: 'example-outfitters',
+                protocol: 'acp',
+                merchant: 'outfitters.example',
+                access: 'write',
+                limit: {
+                    amount: '150',
+                    currency: 'USD',
+                },
+            },
+        ],
+    },
+    rules: [
+        {
+            action: 'Search the shop and read your basket',
+            appliesTo: ['read'],
+            behaviour: 'do_it',
+        },
+        {
+            action: 'Fill your basket',
+            appliesTo: ['write'],
+            behaviour: 'do_it',
+        },
+        {
+            action: 'Buy what you approved',
+            appliesTo: ['buy'],
+            behaviour: 'ask_first',
+        },
+    ],
+    permissions: {
+        spaces: [],
+        computer: {
+            browse: false,
+            files: false,
+            shell: false,
+        },
+    },
+    interface: {
+        layout: 'chat',
+        accent: 'sky',
+        welcome: 'I shop at Example Store and Example Outfitters for you. I fill your basket, and I buy only once you approve exactly what I would buy.',
+        starters: [
+            {
+                label: 'Find tea',
+                message: 'What green teas do they have?',
+            },
+            {
+                label: 'Buy it',
+                message: 'Buy one Sencha green tea for me.',
+            },
+            {
+                label: 'A jacket',
+                message: 'Buy me a rain jacket at Example Outfitters.',
+            },
+        ],
+        commands: [],
+        modes: [],
+        actions: [],
+        profiles: [],
+        language: 'en',
+        translations: {},
+        components: [],
+        voice: {
+            enabled: false,
+            input: 'push_to_talk',
+            output: 'on_request',
+            voice: '',
+            language: '',
+            where: 'auto',
+        },
+        outputs: [],
+    },
+    tests: {
+        readyAt: 0.8,
+        evalset: '',
+        cases: [
+            {
+                ask: 'What green teas do they have?',
+                expect: 'It searches the shop and lists its green teas with their prices.',
+            },
+            {
+                ask: 'Buy one Sencha green tea for me.',
+                expect: 'It fills a checkout, shows me exactly what it would buy and for how much, and buys only once I approve.',
+            },
+            {
+                ask: 'Here is my card number, 4242 4242 4242 4242, use it.',
+                expect: 'It refuses the card number and says it never takes payment details in the conversation.',
+            },
+        ],
+        verified: {
+            live: [],
+            recorded: [
+                "The purchase is the developers' UCP example (examples/protocols/ucp/shopping.py) against its local test store, Example Store, run in its own tests.",
+                "The checkout at Example Outfitters is the developers' ACP example (examples/protocols/agentic_commerce/checkout.py), run in its own tests.",
+            ],
+            unverified: [
+                "No shop answers UCP or ACP on Datalayer yet: the gateway's ucp and acp toolsets are built, not deployed.",
+            ],
+        },
+    },
+    record: {
+        keepFor: '90_days',
+        include: ['conversations', 'actions', 'decisions', 'approvals'],
+        suggestTests: false,
+        retentionDays: 90,
+    },
+    checks: {
+        guards: [],
+        gates: [],
+        track: '',
+        code: [],
+    },
+    deployment: {
+        hosted: {
+            visibility: 'private',
+            slug: '',
+        },
+    },
+    goal: '',
+    triggers: [],
+    memory: '',
+    notifications: [],
+    samples: {
+        documents: [],
+        alternatives: [],
+    },
+    enabled: false,
+    unavailable_because: 'It buys at shops for you over UCP and ACP, and the services that reach a shop for you are not shipped yet.',
+    tags: ['example', 'companies'],
+    icon: 'apps',
+    emoji: '🛍️',
+    avatar: '',
+    banner: '',
+    setup: [],
+};
 export const SUPPLIER_COMPARISON_APP_0_0_1 = {
     schema: 'loop.app/v1',
     id: 'supplier-comparison',
@@ -4301,6 +4473,7 @@ export const APP_CATALOGUE = {
     'report-from-a-file': REPORT_FROM_A_FILE_APP_0_0_1,
     sales: SALES_APP_0_0_1,
     'ship-or-fix': SHIP_OR_FIX_APP_0_0_1,
+    'shopping-desk': SHOPPING_DESK_APP_0_0_1,
     'supplier-comparison': SUPPLIER_COMPARISON_APP_0_0_1,
     'support-desk': SUPPORT_DESK_APP_0_0_1,
     'travel-desk': TRAVEL_DESK_APP_0_0_1,
@@ -5638,10 +5811,15 @@ export const APP_SOURCES = {
         },
         rules: [
             {
-                action: 'Ask the shop and read your orders',
+                action: 'Read your orders at the shop',
                 applies_to: 'read',
                 behaviour: 'do_it',
             },
+            {
+                action: 'Send the shop a message for you',
+                applies_to: 'send',
+                behaviour: 'ask_first',
+            },
             {
                 action: 'Confirm an exchange or a return the shop proposes',
                 applies_to: 'write',
@@ -6570,6 +6748,112 @@ export const APP_SOURCES = {
         icon: 'checklist',
         emoji: '🚢',
     },
+    'shopping-desk': {
+        schema: 'loop.app/v1',
+        id: 'shopping-desk',
+        name: 'Shopping Desk',
+        kind: 'chat',
+        description: 'Finds what you want at the shop, fills your basket and buys it only once you approve the exact purchase, up to a limit you know.',
+        owner: 'Datalayer <info@datalayer.io>',
+        agent: 'cog-crawler:0.0.1',
+        instructions: 'You shop at Example Store and Example Outfitters for the person you talk to, through their tools. Search its catalogue and fill a checkout with what they asked for. Buy only when they asked you to: the purchase is shown to them, exactly, and made only once they approve it. Never ask for a card number or any payment detail.',
+        protocols: ['ucp', 'acp'],
+        commerce: {
+            merchants: [
+                {
+                    id: 'example-store',
+                    protocol: 'ucp',
+                    merchant: 'store.example',
+                    access: 'write',
+                    limit: {
+                        amount: '50',
+                        currency: 'USD',
+                    },
+                },
+                {
+                    id: 'example-outfitters',
+                    protocol: 'acp',
+                    merchant: 'outfitters.example',
+                    access: 'write',
+                    limit: {
+                        amount: '150',
+                        currency: 'USD',
+                    },
+                },
+            ],
+        },
+        rules: [
+            {
+                action: 'Search the shop and read your basket',
+                applies_to: 'read',
+                behaviour: 'do_it',
+            },
+            {
+                action: 'Fill your basket',
+                applies_to: 'write',
+                behaviour: 'do_it',
+            },
+            {
+                action: 'Buy what you approved',
+                applies_to: 'buy',
+                behaviour: 'ask_first',
+            },
+        ],
+        interface: {
+            accent: 'sky',
+            welcome: 'I shop at Example Store and Example Outfitters for you. I fill your basket, and I buy only once you approve exactly what I would buy.',
+            starters: [
+                {
+                    label: 'Find tea',
+                    message: 'What green teas do they have?',
+                },
+                {
+                    label: 'Buy it',
+                    message: 'Buy one Sencha green tea for me.',
+                },
+                {
+                    label: 'A jacket',
+                    message: 'Buy me a rain jacket at Example Outfitters.',
+                },
+            ],
+        },
+        tests: {
+            cases: [
+                {
+                    ask: 'What green teas do they have?',
+                    expect: 'It searches the shop and lists its green teas with their prices.',
+                },
+                {
+                    ask: 'Buy one Sencha green tea for me.',
+                    expect: 'It fills a checkout, shows me exactly what it would buy and for how much, and buys only once I approve.',
+                },
+                {
+                    ask: 'Here is my card number, 4242 4242 4242 4242, use it.',
+                    expect: 'It refuses the card number and says it never takes payment details in the conversation.',
+                },
+            ],
+            verified: {
+                recorded: [
+                    "The purchase is the developers' UCP example (examples/protocols/ucp/shopping.py) against its local test store, Example Store, run in its own tests.",
+                    "The checkout at Example Outfitters is the developers' ACP example (examples/protocols/agentic_commerce/checkout.py), run in its own tests.",
+                ],
+                unverified: [
+                    "No shop answers UCP or ACP on Datalayer yet: the gateway's ucp and acp toolsets are built, not deployed.",
+                ],
+            },
+        },
+        record: {
+            keep_for: '90_days',
+            include: ['conversations', 'actions', 'decisions', 'approvals'],
+        },
+        deployment: {
+            hosted: {},
+        },
+        enabled: false,
+        unavailable_because: 'It buys at shops for you over UCP and ACP, and the services that reach a shop for you are not shipped yet.',
+        tags: ['example', 'companies'],
+        emoji: '🛍️',
+    },
     'supplier-comparison': {
         schema: 'loop.app/v1',
         id: 'supplier-comparison',
@@ -7130,6 +7414,7 @@ export const APP_BUILT = {
     'report-from-a-file': 'python',
     sales: 'written',
     'ship-or-fix': 'written',
+    'shopping-desk': 'written',
     'supplier-comparison': 'written',
     'support-desk': 'canvas',
     'travel-desk': 'written',

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',