@datalayer/agent-runtimes 1.3.113 → 1.4.0

package/lib/protocols/commerce.d.ts

@@ -1,14 +1,13 @@
+import type { ActionClass } from '../types/agentspecs';
+type Json = Record<string, any>;
 /**
- * What every commerce protocol shares (AGENT_PROTOCOLS §3, one approval
- * model) — the twin of `agent_runtimes.protocols.commerce`. A purchase over
- * UCP or the Agentic Commerce Protocol is an exact, revisioned
- * {@link CheckoutProposal}, approved by the person through the host's
- * {@link CheckoutApprover} (contributed to each plugin's `<protocol>.approver`),
- * and completed once ({@link ProposalStore}).
- *
- * @module protocols/commerce
+ * Each operation's action class (F-10) for Rules (R-05), as agentspecs
+ * classes a protocol's tools (`protocol-tools/<protocol>.yaml`,
+ * AGENT_PROTOCOLS PR-54), named as the TypeScript client names them
+ * (`complete_checkout` → `completeCheckout`). A commerce operation does one
+ * thing: one with several classes, or none, throws rather than guess.
  */
-type Json = Record<string, any>;
+export declare function operationClasses(protocol: string): Record<string, ActionClass>;
 /** One exact purchase, proposed to a person before it is made. */
 export interface CheckoutProposal {
     id: string;

package/lib/protocols/commerce.js

@@ -2,6 +2,35 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
+/**
+ * What every commerce protocol shares (AGENT_PROTOCOLS §3, one approval
+ * model) — the twin of `agent_runtimes.protocols.commerce`. A purchase over
+ * UCP or the Agentic Commerce Protocol is an exact, revisioned
+ * {@link CheckoutProposal}, approved by the person through the host's
+ * {@link CheckoutApprover} (contributed to each plugin's `<protocol>.approver`),
+ * and completed once ({@link ProposalStore}).
+ *
+ * @module protocols/commerce
+ */
+import { PROTOCOL_TOOL_CLASSES } from '../specs/actions';
+/**
+ * Each operation's action class (F-10) for Rules (R-05), as agentspecs
+ * classes a protocol's tools (`protocol-tools/<protocol>.yaml`,
+ * AGENT_PROTOCOLS PR-54), named as the TypeScript client names them
+ * (`complete_checkout` → `completeCheckout`). A commerce operation does one
+ * thing: one with several classes, or none, throws rather than guess.
+ */
+export function operationClasses(protocol) {
+    const out = {};
+    for (const [name, classes] of Object.entries(PROTOCOL_TOOL_CLASSES[protocol].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];
+    }
+    return out;
+}
 /** A proposal in words, for the person and the model: never a credential. */
 export function proposalSummary(proposal) {
     const items = proposal.lines

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

@@ -18,16 +18,11 @@ export declare const SHOPPING_SERVICE = "dev.ucp.shopping";
 export declare const CHECKOUT_CAPABILITY = "dev.ucp.shopping.checkout";
 export declare const PROFILE_PATH = "/.well-known/ucp";
 export declare const UCP_PLUGIN = "agent-runtimes.protocols.ucp";
-/** Each operation's action class (F-10), for Rules (R-05). */
-export declare const UCP_ACTION_CLASSES: {
-    readonly search: "read";
-    readonly proposeCompletion: "read";
-    readonly getCheckout: "read";
-    readonly createCheckout: "write";
-    readonly updateCheckout: "write";
-    readonly cancelCheckout: "write";
-    readonly complete: "buy";
-};
+/**
+ * Each operation's action class (F-10), for Rules (R-05): agentspecs'
+ * `protocol-tools/ucp.yaml` (AGENT_PROTOCOLS PR-54).
+ */
+export declare const UCP_ACTION_CLASSES: Record<string, import("../../types").ActionClass>;
 export { InMemoryProposalStore, proposalSummary, type CheckoutApprover, type CheckoutProposal, type ProposalStore, } from '../commerce';
 export declare class UcpError extends Error {
 }

package/lib/protocols/ucp/index.js

@@ -17,23 +17,18 @@
  */
 import { contribution, defineContributionPoint, definePlugin, } from '@datalayer/reactor';
 import { ExtendedCheckoutResponseSchema } from '@ucp-js/sdk';
-import { InMemoryProposalStore, digest, } from '../commerce';
+import { InMemoryProposalStore, digest, operationClasses, } from '../commerce';
 import { DEFAULT_ORDER, ProtocolDescriptions, firstContribution, } from '../core';
 export const UCP_VERSION = '2026-08-25';
 export const SHOPPING_SERVICE = 'dev.ucp.shopping';
 export const CHECKOUT_CAPABILITY = 'dev.ucp.shopping.checkout';
 export const PROFILE_PATH = '/.well-known/ucp';
 export const UCP_PLUGIN = 'agent-runtimes.protocols.ucp';
-/** Each operation's action class (F-10), for Rules (R-05). */
-export const UCP_ACTION_CLASSES = {
-    search: 'read',
-    proposeCompletion: 'read',
-    getCheckout: 'read',
-    createCheckout: 'write',
-    updateCheckout: 'write',
-    cancelCheckout: 'write',
-    complete: 'buy',
-};
+/**
+ * Each operation's action class (F-10), for Rules (R-05): agentspecs'
+ * `protocol-tools/ucp.yaml` (AGENT_PROTOCOLS PR-54).
+ */
+export const UCP_ACTION_CLASSES = operationClasses('ucp');
 export { InMemoryProposalStore, proposalSummary, } from '../commerce';
 export class UcpError extends Error {
 }

package/lib/specs/actions.d.ts

@@ -17,6 +17,14 @@ export declare const BACKEND_TOOL_ACTIONS: Record<string, ActionClass[]>;
  * names were read off the running server; absent when nobody looked.
  */
 export declare const SERVER_ACTIONS: Record<string, ServerActionsSpec>;
+/**
+ * What each agent protocol's tools do, by protocol id: the prefix its
+ * connections take (`pap:<domain>`) and each tool's classes (PR-54).
+ */
+export declare const PROTOCOL_TOOL_CLASSES: Record<string, {
+    connection: string;
+    tools: Record<string, ActionClass[]>;
+}>;
 /**
  * What each application of the catalogue does about each classed tool of the
  * servers it connects to, as agentspecs decides it. What the rules engine has

package/lib/specs/actions.js

@@ -663,6 +663,60 @@ export const SERVER_ACTIONS = {
         signs: {},
     },
 };
+/**
+ * What each agent protocol's tools do, by protocol id: the prefix its
+ * connections take (`pap:<domain>`) and each tool's classes (PR-54).
+ */
+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'],
+        },
+    },
+    pact: {
+        connection: 'pact',
+        tools: {
+            pact_brand: ['read'],
+            pact_ask: ['read'],
+            pact_sign_in: ['read'],
+            pact_sign_in_status: ['read'],
+            pact_ask_for_person: ['write'],
+            pact_disconnect: ['write'],
+        },
+    },
+    pap: {
+        connection: 'pap',
+        tools: {
+            pap_company: ['read'],
+            pap_ask: ['read'],
+            pap_sign_in: ['read'],
+            pap_sign_in_status: ['read'],
+            pap_read: ['read'],
+            pap_mcp_tools: ['read'],
+            pap_mcp_call: ['write'],
+            pap_confirm: ['write', 'buy'],
+            pap_disconnect: ['write'],
+        },
+    },
+    ucp: {
+        connection: 'ucp',
+        tools: {
+            search: ['read'],
+            propose_completion: ['read'],
+            get_checkout: ['read'],
+            create_checkout: ['write'],
+            update_checkout: ['write'],
+            cancel_checkout: ['write'],
+            complete: ['buy'],
+        },
+    },
+};
 /**
  * What each application of the catalogue does about each classed tool of the
  * servers it connects to, as agentspecs decides it. What the rules engine has
@@ -922,6 +976,7 @@ export const APP_BEHAVIOURS = {
     'ship-or-fix': {},
     'supplier-comparison': {},
     'support-desk': {},
+    'travel-desk': {},
     'web-research': {
         'tavily.tavily_crawl': 'do_it',
         'tavily.tavily_extract': 'do_it',
@@ -988,5 +1043,6 @@ export const APP_ESCALATIONS = {
     'ship-or-fix': {},
     'supplier-comparison': {},
     'support-desk': {},
+    'travel-desk': {},
     'web-research': {},
 };