@datalayer/agent-runtimes 1.5.6 → 1.5.8

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

@@ -24,7 +24,7 @@
  *
  * @module apps/apps/appspec
  */
-import type { AppAccent, AppThemeMode, AppThemeVariant, AppAssistantCharacter, AppEmbedMode, AppCustomComponentSpec, AppVoiceSpec, AppKind, AppLayout, AppPageOutputComponent, AppSpec } from '../../types/agentspecs';
+import type { AppAccent, AppThemeMode, AppThemeVariant, AppAssistantCharacter, AppEmbedMode, PapProfile, AppCustomComponentSpec, AppVoiceSpec, AppKind, AppLayout, AppPageOutputComponent, AppSpec } from '../../types/agentspecs';
 /** The version of the spec itself. */
 export declare const APP_SCHEMA = "loop.app/v1";
 /** The language an application's own words are in, unless it says (LOOP P-26). */
@@ -60,6 +60,15 @@ type Data = Record<string, unknown>;
 export declare function retentionDays(keepFor: string): number;
 /** An application with nothing said: what *Start blank* opens. */
 export declare function emptyAppspec(kind?: AppKind): AppSpec;
+/** The Personal Agent Protocol profiles Datalayer speaks, as agentspecs' `PAP_PROFILES` (PAP_DATALAYER S-03). */
+export declare const PAP_PROFILES: readonly PapProfile[];
+/** The profile a `pap` block is written for when the Studio or a builder starts one. */
+export declare const PAP_PROFILE: PapProfile;
+/**
+ * What is wrong with a `pap` block's profile, in agentspecs' sentence
+ * (`pap_profile_problem`); `undefined` when it is one Datalayer speaks.
+ */
+export declare function papProfileProblem(value: unknown): string | undefined;
 /** An application's voice (VOICE.md VO-41): off unless said. */
 export declare const DEFAULT_VOICE: AppVoiceSpec;
 /** What a page's output may be drawn with (LOOP P-05), and the property of each that shows its value. */

package/lib/apps/apps/appspec.js

@@ -248,6 +248,23 @@ function parseConnection(data) {
         only: texts(data.only),
     };
 }
+/** The Personal Agent Protocol profiles Datalayer speaks, as agentspecs' `PAP_PROFILES` (PAP_DATALAYER S-03). */
+export const PAP_PROFILES = ['draft-01'];
+/** The profile a `pap` block is written for when the Studio or a builder starts one. */
+export const PAP_PROFILE = PAP_PROFILES[PAP_PROFILES.length - 1];
+/**
+ * What is wrong with a `pap` block's profile, in agentspecs' sentence
+ * (`pap_profile_problem`); `undefined` when it is one Datalayer speaks.
+ */
+export function papProfileProblem(value) {
+    if (value === undefined || value === null || value === '') {
+        return `Its \`pap\` block names no Personal Agent Protocol profile: add \`profile: ${PAP_PROFILE}\`.`;
+    }
+    if (!PAP_PROFILES.includes(value)) {
+        return `This application asks for Personal Agent Protocol profile “${String(value)}”; Datalayer speaks ${PAP_PROFILES.join(' or ')}.`;
+    }
+    return undefined;
+}
 const PAP_INTERFACES = ['agent', 'openapi', 'mcp', 'web'];
 const PAP_SIGN_IN = ['direct', 'device', 'mediated'];
 const PAP_DEFAULT_INTERFACES = ['agent'];
@@ -265,6 +282,7 @@ const enumsOf = (value, allowed, otherwise) => {
 function parsePap(data) {
     const company = isData(data.company) ? data.company : {};
     return {
+        profile: data.profile,
         connections: records(data.connections).map(connection => ({
             id: text(connection.id),
             company: text(connection.company),
@@ -297,6 +315,7 @@ function dumpPap(pap) {
     if (!pap)
         return {};
     return new Writer()
+        .text('profile', pap.profile, '\u0000')
         .list('connections', pap.connections.map(connection => new Writer()
         .text('id', connection.id, '\u0000')
         .text('company', connection.company, '\u0000')
@@ -322,8 +341,15 @@ function dumpPap(pap) {
         .text('summary', operation.summary, '\u0000')
         .value('user_approval_required', operation.userApprovalRequired, true).data)).data).data;
 }
-/** PACT (AGENT_PROTOCOLS PI-01): the businesses it asks for each person. */
+/** PACT (AGENT_PROTOCOLS PI-01): the businesses it asks for each person, and as one (PR-13). */
 function parsePact(data) {
+    const business = isData(data.business) ? data.business : {};
+    const scopes = {};
+    if (isData(business.scopes)) {
+        for (const [scope, said] of Object.entries(business.scopes)) {
+            scopes[scope] = text(said);
+        }
+    }
     return {
         connections: records(data.connections).map(connection => ({
             id: text(connection.id),
@@ -332,6 +358,15 @@ function parsePact(data) {
             access: oneOf(connection.access, ['read', 'write'], 'read'),
             scopes: texts(connection.scopes),
         })),
+        business: {
+            enabled: flag(business.enabled, false),
+            brand: text(business.brand),
+            scopes,
+            registeredAgents: records(business.registered_agents).map(agent => ({
+                issuer: text(agent.issuer),
+                jwksUri: text(agent.jwks_uri),
+            })),
+        },
     };
 }
 /** Commerce (AGENT_PROTOCOLS PI-01): the merchants it shops at for each person. */
@@ -373,12 +408,26 @@ function dumpCommerce(commerce) {
 function dumpPact(pact) {
     if (!pact)
         return {};
-    return new Writer().list('connections', pact.connections.map(connection => new Writer()
+    const business = pact.business ?? {
+        enabled: false,
+        brand: '',
+        scopes: {},
+        registeredAgents: [],
+    };
+    return new Writer()
+        .list('connections', pact.connections.map(connection => new Writer()
         .text('id', connection.id, '\u0000')
         .text('brand', connection.brand, '\u0000')
         .text('audience', connection.audience, '\u0000')
         .value('access', connection.access, 'read')
-        .list('scopes', connection.scopes).data)).data;
+        .list('scopes', connection.scopes).data))
+        .part('business', new Writer()
+        .value('enabled', business.enabled, false)
+        .text('brand', business.brand)
+        .part('scopes', { ...business.scopes })
+        .list('registered_agents', business.registeredAgents.map(agent => new Writer()
+        .text('issuer', agent.issuer, '\u0000')
+        .text('jwks_uri', agent.jwksUri, '\u0000').data)).data).data;
 }
 /** A2A (AGENT_PROTOCOLS PR-02): the extensions its Agent Card advertises. */
 function parseA2A(data) {
@@ -942,8 +991,16 @@ export function parseAppspec(document) {
     if (isData(data.decision)) {
         app.decision = parseDecision(data.decision);
     }
-    if (isData(data.pap)) {
-        app.pap = parsePap(data.pap);
+    // A `pap` block names a profile Datalayer speaks, or it is refused and not
+    // read (PAP_DATALAYER S-03); a block saying nothing is no block.
+    if (isData(data.pap) && Object.keys(data.pap).length > 0) {
+        const problem = papProfileProblem(data.pap.profile);
+        if (problem) {
+            problems.push(problem);
+        }
+        else {
+            app.pap = parsePap(data.pap);
+        }
     }
     if (isData(data.pact)) {
         app.pact = parsePact(data.pact);
@@ -1006,7 +1063,8 @@ export function protocolsProblems(app) {
     }
     const configured = {
         pap: Boolean(app.pap && (app.pap.connections.length > 0 || app.pap.company.enabled)),
-        pact: Boolean(app.pact && app.pact.connections.length > 0),
+        pact: Boolean(app.pact &&
+            (app.pact.connections.length > 0 || app.pact.business?.enabled)),
         a2a: Boolean(app.a2a && app.a2a.extensions.length > 0),
     };
     for (const spec of Object.values(PROTOCOL_CATALOGUE)) {

package/lib/apps/core/index.d.ts

@@ -710,7 +710,33 @@ export type LoopChatExtrasValue = {
      * every snapshot the chat receives, `undefined` included.
      */
     onUsage?: (snapshot: ContextSnapshotData | undefined) => void;
+    /**
+     * What the person types goes somewhere else than the agent, live.
+     *
+     * While set, the composer's placeholder is `says` and sending hands the
+     * words to `send`, never to the model or the runtime: a person talking with
+     * a company themselves in a Direct Conversation (PAP_DATALAYER P-08), their
+     * own words sent as theirs. A refusal `send` throws is said under the
+     * composer and the words stay where they were typed. Unset, the composer
+     * talks to the agent again.
+     */
+    sendInstead?: {
+        /** Where the words go, in the person's words, in place of the placeholder. */
+        says: string;
+        send: (text: string) => Promise<void>;
+    };
 };
+/**
+ * The words sent where the extras say instead of to the agent
+ * (`sendInstead`): `null` when they go to the agent as usual; else whether
+ * they were taken, and the refusal in a sentence when they were not.
+ */
+export declare function sendInstead(extras: Pick<LoopChatExtrasValue, 'sendInstead'>, message: string): Promise<{
+    sent: true;
+} | {
+    sent: false;
+    refused: string;
+} | null>;
 export type ChatExtrasContribution = {
     /** Stable id, for the registry and the graph. */
     id: string;

package/lib/apps/core/index.js

@@ -181,6 +181,26 @@ export { LoopA2uiComponent, } from './a2uiComponents';
 // Where the files of an application's folder are served (LOOP P-29): said
 // by the page side its package carries.
 export { LoopAppFiles } from './appFiles';
+/**
+ * The words sent where the extras say instead of to the agent
+ * (`sendInstead`): `null` when they go to the agent as usual; else whether
+ * they were taken, and the refusal in a sentence when they were not.
+ */
+export async function sendInstead(extras, message) {
+    if (!extras.sendInstead) {
+        return null;
+    }
+    try {
+        await extras.sendInstead.send(message);
+        return { sent: true };
+    }
+    catch (error) {
+        return {
+            sent: false,
+            refused: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
 export const LoopChatExtras = defineContributionPoint('loop.chat.extras');
 export const LoopOpeningNotebook = defineContributionPoint('loop.notebook.opening');
 export const LoopOpeningDocument = defineContributionPoint('loop.document.opening');

package/lib/apps/plugins/chat/ChatView.js

@@ -42,7 +42,7 @@ import { BROWSER_CODE_TOOL, dataUrlBase64, givenFilesSentence, sandboxFileName,
 import { useConfig } from '../../../hooks/useConfig';
 import { useSkills, useSkillActions } from '../../../hooks/useSkills';
 import { AI_MODEL_CATALOGUE, isChatModel } from '../../../specs/models';
-import { LoopAgentBlueprint, LoopAgentGate, LoopChatComposer, LoopChatExtras, LoopChatHeader, LoopChatLayout, LoopChatSuggestion, LoopChatSurface, LoopChatTurn, LoopCommand, LoopFrontendTool, LoopRunProps, LoopSlots, agentServerOf, noRuntimeSaid, canOpenView, runForwardedProps, onPromptFocusRequest, onSurfaceRequest, useLoopPromptStore, } from '../../core';
+import { LoopAgentBlueprint, LoopAgentGate, LoopChatComposer, sendInstead, LoopChatExtras, LoopChatHeader, LoopChatLayout, LoopChatSuggestion, LoopChatSurface, LoopChatTurn, LoopCommand, LoopFrontendTool, LoopRunProps, LoopSlots, agentServerOf, noRuntimeSaid, canOpenView, runForwardedProps, onPromptFocusRequest, onSurfaceRequest, useLoopPromptStore, } from '../../core';
 import { messageText, turnWritersOf } from './turnState';
 import { isInactiveSurfaceContribution, orderToolContributions, toolsForChatView, } from './chatViewTools';
 import { agentBundleToolDefinitions, useAgentCommandTools, } from '../../../tools/adapters/commands';
@@ -486,11 +486,27 @@ export default function ChatView({ workspace }) {
          * place "the first prompt" means the same thing regardless of which one
          * a person or a host used.
          */
+        setTransient(null);
+        /*
+         * Words that go elsewhere than the agent (`sendInstead`, PAP_DATALAYER
+         * P-08): a Direct Conversation with a company, the person's own words
+         * sent as theirs. Neither a command nor a turn, and never the model's;
+         * refused, the words stay where they were typed and the reason is said.
+         */
+        const elsewhere = await sendInstead(chatExtrasRef.current, message);
+        if (elsewhere) {
+            if (elsewhere.sent) {
+                setDraft('');
+            }
+            else {
+                setTransient(elsewhere.refused);
+            }
+            return;
+        }
         if (!firstPromptFired.current) {
             firstPromptFired.current = true;
             inputPromptConfig?.firstPromptHook?.();
         }
-        setTransient(null);
         // The turn begins where the message goes out (`sendNow`): a command
         // the workspace runs is not one.
         const outcome = await workspace.submit(message);
@@ -1594,8 +1610,9 @@ export default function ChatView({ workspace }) {
         // send button into a stop — the person keeps a way out.
         isLoading: busy,
         onStop: () => workspace.viewControls.stop?.(),
-        // The reason where the typing would go, read before the person types.
-        placeholder: disabledReason ?? placeholder,
+        // The reason where the typing would go, read before the person types;
+        // where it goes when it goes elsewhere than the agent (P-08).
+        placeholder: disabledReason ?? chatExtras.sendInstead?.says ?? placeholder,
         typingSuggestions: suggestions.map(item => item.text),
         // The same openers behind the composer's suggestions control.
         suggestions: chatSuggestions,

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;