@datalayer/agent-runtimes 1.5.3 → 1.5.6

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

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