@datalayer/agent-runtimes 1.5.3 → 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/apps/plugins/pap-sign-in/PapSignInCard.d.ts

@@ -2,7 +2,9 @@
  * *Sign in at a company*, in the chat (AGENT_PROTOCOLS PI-56): where the
  * gateway's `pap_sign_in` answers, the company's page as a button opening a
  * new tab, the code large and copyable with a code to scan for Device
- * Sign-In, until when, and *I have signed in: check again* — sent as the
+ * Sign-In, Datalayer's own page for Mediated Sign-In (where the person types
+ * what the company asks, never in the chat) with where a code was sent,
+ * until when, and *I have signed in: check again* — sent as the
  * person's next message — when the chat can send one, otherwise a line
  * asking them to say so. What it reads is `signIn`'s.
  *

package/lib/apps/plugins/pap-sign-in/PapSignInCard.js

@@ -25,9 +25,14 @@ export function PapSignInCard({ context, send, }) {
             setCopied(false);
         }
     };
-    return (_jsxs(Box, { as: "section", "aria-label": PAP_SIGN_IN_WORDS.title(read.host), my: 2, p: 3, border: "1px solid", borderColor: "border.default", borderRadius: 2, bg: "canvas.subtle", maxWidth: 480, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 2, mb: 1 }, children: PAP_SIGN_IN_WORDS.title(read.host) }), _jsx(Text, { as: "p", sx: { mt: 0, mb: 2, color: 'fg.muted', fontSize: 1 }, children: read.mode === 'device'
+    const title = read.mode === 'mediated'
+        ? PAP_SIGN_IN_WORDS.mediatedTitle(read.host)
+        : PAP_SIGN_IN_WORDS.title(read.host);
+    return (_jsxs(Box, { as: "section", "aria-label": title, my: 2, p: 3, border: "1px solid", borderColor: "border.default", borderRadius: 2, bg: "canvas.subtle", maxWidth: 480, children: [_jsx(Heading, { as: "h4", sx: { fontSize: 2, mb: 1 }, children: title }), _jsx(Text, { as: "p", sx: { mt: 0, mb: 2, color: 'fg.muted', fontSize: 1 }, children: read.mode === 'device'
                     ? PAP_SIGN_IN_WORDS.device
-                    : PAP_SIGN_IN_WORDS.direct }), read.code ? (_jsxs(Box, { display: "flex", gap: 3, alignItems: "center", flexWrap: "wrap", mb: 2, children: [_jsxs(Box, { children: [_jsx(Text, { as: "div", sx: { fontSize: 0, color: 'fg.muted' }, children: PAP_SIGN_IN_WORDS.code }), _jsx(Text, { as: "div", "aria-live": "polite", sx: {
+                    : read.mode === 'mediated'
+                        ? PAP_SIGN_IN_WORDS.mediated
+                        : PAP_SIGN_IN_WORDS.direct }), read.sentTo ? (_jsx(Text, { as: "p", sx: { mt: 0, mb: 2, fontSize: 1 }, children: PAP_SIGN_IN_WORDS.sentTo(read.sentTo) })) : null, read.code ? (_jsxs(Box, { display: "flex", gap: 3, alignItems: "center", flexWrap: "wrap", mb: 2, children: [_jsxs(Box, { children: [_jsx(Text, { as: "div", sx: { fontSize: 0, color: 'fg.muted' }, children: PAP_SIGN_IN_WORDS.code }), _jsx(Text, { as: "div", "aria-live": "polite", sx: {
                                     fontFamily: 'mono',
                                     fontSize: 5,
                                     fontWeight: 'bold',

package/lib/apps/plugins/pap-sign-in/signIn.d.ts

@@ -1,9 +1,12 @@
 /**
  * What the gateway's `pap_sign_in` tool answers, read and checked
  * (AGENT_PROTOCOLS PI-56, PAP_DATALAYER P-03): the person signs in at a
- * company themselves — on the company's page (`direct`), or by entering a
- * code there (`device`). The chat shows the link, the code and until when;
- * the agent never sees what the person types.
+ * company themselves — on the company's page (`direct`), by entering a
+ * code there (`device`), or by typing what the company asks on Datalayer's
+ * own page (`mediated`), never in the conversation. The chat shows the link,
+ * the code and until when; the agent never sees what the person types. A
+ * business over PACT answers its `pact_sign_in` the same way (a `device`
+ * sign-in at the business).
  *
  * Pure: no React. A test reaches it without a chat around it.
  *
@@ -11,13 +14,15 @@
  */
 /** A sign-in waiting for the person, as the card shows it. */
 export type PapSignInWaiting = {
-    mode: 'direct' | 'device';
-    /** The company's page, `https` only. */
+    mode: 'direct' | 'device' | 'mediated';
+    /** The company's page — Datalayer's own, for `mediated` — `https` only. */
     open: string;
-    /** The company's domain, read from the page's address: what the person can trust. */
+    /** The page's domain, read from its address: what the person can trust. */
     host: string;
     /** The code to enter, for `device`. */
     code?: string;
+    /** Where the company sent a code, for `mediated`, when it did. */
+    sentTo?: string;
     /** Until when, ISO 8601. */
     expiresAt?: string;
 };
@@ -26,6 +31,10 @@ export declare const PAP_SIGN_IN_WORDS: {
     readonly title: (host: string) => string;
     readonly direct: "Open the company’s page, sign in there, and come back here.";
     readonly device: "Open the company’s page and enter this code there.";
+    /** `mediated`: the page is Datalayer's, which names the company and asks what it asks. */
+    readonly mediatedTitle: (host: string) => string;
+    readonly mediated: "Open this page: it names the company and asks what the company needs. Type it there, never in this conversation.";
+    readonly sentTo: (to: string) => string;
     readonly open: (host: string) => string;
     readonly code: "Your code";
     readonly copy: "Copy the code";
@@ -37,9 +46,12 @@ export declare const PAP_SIGN_IN_WORDS: {
     readonly refused: "This sign-in link cannot be opened safely, so it is not shown.";
     readonly qr: (host: string) => string;
 };
-/** `pap_sign_in`, as the gateway names it with or without a prefix. */
+/**
+ * `pap_sign_in` — or a business's `pact_sign_in` (PI-56) — as the gateway
+ * names it with or without a prefix.
+ */
 export declare const PAP_SIGN_IN_TOOL: RegExp;
-/** Whether a tool is `pap_sign_in`, as the gateway names it with or without a prefix. */
+/** Whether a tool is `pap_sign_in` or `pact_sign_in`, as the gateway names it with or without a prefix. */
 export declare const isPapSignInTool: (name: string) => boolean;
 /** The page's address, `https` only; `null` for anything else. */
 export declare function safeSignInUrl(open: unknown): URL | null;

package/lib/apps/plugins/pap-sign-in/signIn.js

@@ -7,6 +7,10 @@ export const PAP_SIGN_IN_WORDS = {
     title: (host) => `Sign in at ${host}`,
     direct: 'Open the company’s page, sign in there, and come back here.',
     device: 'Open the company’s page and enter this code there.',
+    /** `mediated`: the page is Datalayer's, which names the company and asks what it asks. */
+    mediatedTitle: (host) => `Sign in through ${host}`,
+    mediated: 'Open this page: it names the company and asks what the company needs. Type it there, never in this conversation.',
+    sentTo: (to) => `The company sent a code to ${to}.`,
     open: (host) => `Open ${host}`,
     code: 'Your code',
     copy: 'Copy the code',
@@ -18,9 +22,12 @@ export const PAP_SIGN_IN_WORDS = {
     refused: 'This sign-in link cannot be opened safely, so it is not shown.',
     qr: (host) => `A code to scan to open ${host} on your phone`,
 };
-/** `pap_sign_in`, as the gateway names it with or without a prefix. */
-export const PAP_SIGN_IN_TOOL = /(^|[_.:\-/])pap_sign_in$/;
-/** Whether a tool is `pap_sign_in`, as the gateway names it with or without a prefix. */
+/**
+ * `pap_sign_in` — or a business's `pact_sign_in` (PI-56) — as the gateway
+ * names it with or without a prefix.
+ */
+export const PAP_SIGN_IN_TOOL = /(^|[_.:\-/])pa(?:p|ct)_sign_in$/;
+/** Whether a tool is `pap_sign_in` or `pact_sign_in`, as the gateway names it with or without a prefix. */
 export const isPapSignInTool = (name) => PAP_SIGN_IN_TOOL.test(name);
 /** An MCP result's own object: its structured content, or the JSON of its text. */
 function unwrapped(result) {
@@ -73,7 +80,9 @@ export function readPapSignIn(result) {
     if (!data || data.status !== 'waiting_for_the_person') {
         return null;
     }
-    if (data.mode !== 'direct' && data.mode !== 'device') {
+    if (data.mode !== 'direct' &&
+        data.mode !== 'device' &&
+        data.mode !== 'mediated') {
         return null;
     }
     const url = safeSignInUrl(data.open);
@@ -88,6 +97,11 @@ export function readPapSignIn(result) {
         open: url.toString(),
         host: url.hostname,
         ...(typeof data.code === 'string' && data.code ? { code: data.code } : {}),
+        ...(data.mode === 'mediated' &&
+            typeof data.sent_to === 'string' &&
+            data.sent_to
+            ? { sentTo: data.sent_to }
+            : {}),
         ...(typeof data.expires_at === 'string' && data.expires_at
             ? { expiresAt: data.expires_at }
             : {}),

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,7 +693,8 @@ export const PROTOCOL_TOOL_CLASSES = {
         connection: 'pap',
         tools: {
             pap_company: ['read'],
-            pap_ask: ['read'],
+            pap_ask: ['send'],
+            pap_handoff: ['send'],
             pap_sign_in: ['read'],
             pap_sign_in_status: ['read'],
             pap_read: ['read'],
@@ -707,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'],
         },
     },
 };
@@ -974,6 +973,7 @@ export const APP_BEHAVIOURS = {
     'report-from-a-file': {},
     sales: {},
     'ship-or-fix': {},
+    'shopping-desk': {},
     'supplier-comparison': {},
     'support-desk': {},
     'travel-desk': {},
@@ -1041,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;