@datalayer/agent-runtimes 1.5.6 → 1.5.7

package/lib/protocols/ucp/index.d.ts

@@ -47,6 +47,8 @@ export declare function negotiateCapabilities(profile: Json, reactor: ReactorPla
 export declare function revisionOf(checkout: Json): Promise<string>;
 /** What an agent may see of a checkout: no payment credential, no token. */
 export declare function checkoutSummary(checkout: Json): Json;
+/** What an agent may see of an order: its lines, how far each is fulfilled, its totals and link. */
+export declare function orderSummary(order: Json): Json;
 /** A platform's client of one business, over the REST binding. */
 export declare class UcpClient {
     private readonly business;
@@ -67,6 +69,8 @@ export declare class UcpClient {
     updateCheckout(id: string, update: Json): Promise<Json>;
     getCheckout(id: string): Promise<Json>;
     cancelCheckout(id: string): Promise<Json>;
+    /** After the sale: an order the business placed, its lines and how far each is fulfilled (`read`). */
+    getOrder(id: string): Promise<Json>;
     /** The exact purchase a `ready_for_complete` checkout would make. */
     proposeCompletion(id: string): Promise<CheckoutProposal>;
     /** Complete an approved proposal, once: refused if unapproved, spent, changed or expired. */

package/lib/protocols/ucp/index.js

@@ -16,7 +16,7 @@
  * @module protocols/ucp
  */
 import { contribution, defineContributionPoint, definePlugin, } from '@datalayer/reactor';
-import { ExtendedCheckoutResponseSchema } from '@ucp-js/sdk';
+import { ExtendedCheckoutResponseSchema, OrderSchema } from '@ucp-js/sdk';
 import { InMemoryProposalStore, digest, operationClasses, } from '../commerce';
 import { DEFAULT_ORDER, ProtocolDescriptions, firstContribution, } from '../core';
 export const UCP_VERSION = '2026-08-25';
@@ -131,6 +131,32 @@ export function checkoutSummary(checkout) {
         ...(checkout.order ? { order: { id: checkout.order.id } } : {}),
     };
 }
+function readOrder(body) {
+    if (body?.ucp?.status === 'error') {
+        const said = (body.messages ?? []).map((m) => m.content).join('; ');
+        throw new UcpError(`the business refused: ${said}`);
+    }
+    OrderSchema.parse(body);
+    return body;
+}
+/** What an agent may see of an order: its lines, how far each is fulfilled, its totals and link. */
+export function orderSummary(order) {
+    return {
+        id: order.id,
+        checkoutId: order.checkout_id,
+        permalinkUrl: order.permalink_url,
+        currency: order.currency,
+        lines: (order.line_items ?? []).map((line) => ({
+            title: line.item?.title ?? line.item?.id,
+            quantity: line.quantity?.total,
+            fulfilled: line.quantity?.fulfilled,
+            status: line.status,
+        })),
+        totals: Object.fromEntries((order.totals ?? []).map((t) => [t.type, t.amount])),
+        events: (order.fulfillment?.events ?? []).map((event) => event.type),
+        messages: (order.messages ?? []).map((m) => m.content),
+    };
+}
 /** A platform's client of one business, over the REST binding. */
 export class UcpClient {
     business;
@@ -218,6 +244,10 @@ export class UcpClient {
     async cancelCheckout(id) {
         return readCheckout(await this.call('POST', `/checkout-sessions/${id}/cancel`, {}, crypto.randomUUID()));
     }
+    /** After the sale: an order the business placed, its lines and how far each is fulfilled (`read`). */
+    async getOrder(id) {
+        return readOrder(await this.call('GET', `/orders/${id}`));
+    }
     /** The exact purchase a `ready_for_complete` checkout would make. */
     async proposeCompletion(id) {
         const checkout = await this.getCheckout(id);

package/lib/protocols/ucp/merchant.js

@@ -53,6 +53,8 @@ export function exampleStore(base = 'https://store.example') {
     const checkouts = new Map();
     const replies = new Map();
     const orders = [];
+    // Each order placed, by id: what was bought, as the order answers it.
+    const placed = new Map();
     const render = (checkout) => {
         let subtotal = 0;
         const lines = checkout.lines.map((line, index) => {
@@ -130,7 +132,13 @@ export function exampleStore(base = 'https://store.example') {
             checkouts.set(checkout.id, checkout);
             return { status: 201, body: render(checkout) };
         }
-        const [, , id, action] = path.split('/');
+        const [, collection, id, action] = path.split('/');
+        if (collection === 'orders') {
+            const order = method === 'GET' && !action ? placed.get(id) : undefined;
+            return order
+                ? { status: 200, body: order }
+                : { status: 404, body: { messages: [{ content: 'No such order' }] } };
+        }
         const checkout = checkouts.get(id);
         if (!checkout) {
             return { status: 404, body: { messages: [{ content: 'No checkout' }] } };
@@ -180,7 +188,24 @@ export function exampleStore(base = 'https://store.example') {
             checkout.status = 'completed';
             checkout.order = order;
             orders.push({ order: order.id, checkout: checkout.id });
-            return { status: 200, body: render(checkout) };
+            const rendered = render(checkout);
+            placed.set(order.id, {
+                ucp: { version: UCP_VERSION, status: 'success' },
+                id: order.id,
+                checkout_id: checkout.id,
+                permalink_url: order.permalink_url,
+                line_items: rendered.line_items.map((line) => ({
+                    id: line.id,
+                    item: line.item,
+                    quantity: { total: line.quantity, fulfilled: 0 },
+                    totals: line.totals,
+                    status: 'processing',
+                })),
+                fulfillment: { events: [] },
+                currency: rendered.currency,
+                totals: rendered.totals,
+            });
+            return { status: 200, body: rendered };
         }
         if (method === 'POST' && action === 'cancel') {
             if (checkout.status !== 'completed') {

package/lib/specs/actions.js

@@ -713,6 +713,7 @@ export const PROTOCOL_TOOL_CLASSES = {
             ucp_update_checkout: ['write'],
             ucp_cancel_checkout: ['write'],
             ucp_complete: ['buy'],
+            ucp_get_order: ['read'],
         },
     },
 };
@@ -773,6 +774,7 @@ export const APP_BEHAVIOURS = {
         'odoo-accounting.odoo_accounting_trial_balance': 'do_it',
         'odoo-accounting.odoo_accounting_unreconcile_lines': 'leave_to_me',
     },
+    'bookkeeping-desk': {},
     'change-detection': {
         'earthdata.download_earth_data_granules': 'leave_to_me',
         'earthdata.search_earth_datagranules': 'do_it',
@@ -915,6 +917,7 @@ export const APP_BEHAVIOURS = {
         'google-workspace.update_drive_file': 'leave_to_me',
         'google-workspace.update_paragraph_style': 'leave_to_me',
     },
+    'live-shop-chat': {},
     'model-choice': {},
     'month-end-close': {
         'odoo-accounting.odoo_accounting_aged_balance': 'do_it',
@@ -968,12 +971,16 @@ export const APP_BEHAVIOURS = {
         'odoo-accounting.odoo_accounting_unreconcile_lines': 'leave_to_me',
     },
     'order-desk': {},
+    'order-tracker': {},
     'pipeline-report': {},
     'quote-calculator': {},
     'report-from-a-file': {},
+    'returns-desk': {},
     sales: {},
     'ship-or-fix': {},
+    'shop-concierge': {},
     'shopping-desk': {},
+    'sign-in-desk': {},
     'supplier-comparison': {},
     'support-desk': {},
     'travel-desk': {},
@@ -991,6 +998,7 @@ export const APP_BEHAVIOURS = {
  */
 export const APP_ESCALATIONS = {
     accounting: {},
+    'bookkeeping-desk': {},
     'change-detection': {},
     'crop-monitoring': {},
     'customer-interview': {},
@@ -1033,15 +1041,20 @@ export const APP_ESCALATIONS = {
             },
         ],
     },
+    'live-shop-chat': {},
     'model-choice': {},
     'month-end-close': {},
     'order-desk': {},
+    'order-tracker': {},
     'pipeline-report': {},
     'quote-calculator': {},
     'report-from-a-file': {},
+    'returns-desk': {},
     sales: {},
     'ship-or-fix': {},
+    'shop-concierge': {},
     'shopping-desk': {},
+    'sign-in-desk': {},
     'supplier-comparison': {},
     'support-desk': {},
     'travel-desk': {},

package/lib/specs/apps.d.ts

@@ -9,6 +9,7 @@
  */
 import type { AppBuilt, AppKind, AppSpec } from '../types/agentspecs';
 export declare const ACCOUNTING_APP_0_0_1: AppSpec;
+export declare const BOOKKEEPING_DESK_APP_0_0_1: AppSpec;
 export declare const CHANGE_DETECTION_APP_0_0_1: AppSpec;
 export declare const CROP_MONITORING_APP_0_0_1: AppSpec;
 export declare const CUSTOMER_INTERVIEW_APP_0_0_1: AppSpec;
@@ -18,15 +19,20 @@ export declare const DISASTER_ASSESSMENT_APP_0_0_1: AppSpec;
 export declare const EVENT_RESPONSE_APP_0_0_1: AppSpec;
 export declare const EXCHANGE_DESK_APP_0_0_1: AppSpec;
 export declare const INBOX_TRIAGE_APP_0_0_1: AppSpec;
+export declare const LIVE_SHOP_CHAT_APP_0_0_1: AppSpec;
 export declare const MODEL_CHOICE_APP_0_0_1: AppSpec;
 export declare const MONTH_END_CLOSE_APP_0_0_1: AppSpec;
 export declare const ORDER_DESK_APP_0_0_1: AppSpec;
+export declare const ORDER_TRACKER_APP_0_0_1: AppSpec;
 export declare const PIPELINE_REPORT_APP_0_0_1: AppSpec;
 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 RETURNS_DESK_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 SHOP_CONCIERGE_APP_0_0_1: AppSpec;
 export declare const SHOPPING_DESK_APP_0_0_1: AppSpec;
+export declare const SIGN_IN_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;