@datalayer/agent-runtimes 1.5.4 → 1.5.7

package/lib/types/agentspecs.d.ts

@@ -540,6 +540,33 @@ export interface AppPactConnectionSpec {
 export interface AppPactSpec {
     connections: AppPactConnectionSpec[];
 }
+/** The most one purchase may cost at a merchant (AGENT_PROTOCOLS PI-22). */
+export interface AppSpendLimitSpec {
+    /** As written: `50`, `12.50`. */
+    amount: string;
+    /** ISO 4217: `USD`. */
+    currency: string;
+}
+/**
+ * A merchant the application shops at for each person, over UCP or ACP
+ * (AGENT_PROTOCOLS PI-01). Test merchants only, every purchase asked of the
+ * person (decided 2026-10-13). Never a credential.
+ */
+export interface AppCommerceMerchantSpec {
+    /** Stable within the application: `example-store`. */
+    id: string;
+    protocol: 'ucp' | 'acp';
+    /** The merchant's domain: `store.example`. */
+    merchant: string;
+    /** `read`: searches and reads; `write`: also fills a checkout and buys, each purchase asked. */
+    access: 'read' | 'write';
+    /** The most one purchase may cost: required for `write`. */
+    limit?: AppSpendLimitSpec;
+}
+/** UCP and ACP: the merchants it shops at for each person. */
+export interface AppCommerceSpec {
+    merchants: AppCommerceMerchantSpec[];
+}
 /**
  * An A2A extension the application's Agent Card advertises, beside the
  * runtime's own (AGENT_PROTOCOLS PR-02). Its params are public: never a
@@ -1145,6 +1172,8 @@ export interface AppSpec {
     pap?: AppPapSpec;
     /** PACT: the businesses it asks for each person (AGENT_PROTOCOLS PI-01). */
     pact?: AppPactSpec;
+    /** UCP and ACP: the merchants it shops at for each person (AGENT_PROTOCOLS PI-01). */
+    commerce?: AppCommerceSpec;
     /** A2A: the extensions its Agent Card advertises (AGENT_PROTOCOLS PR-02). */
     a2a?: AppA2ASpec;
     rules: AppRuleSpec[];

package/lib/types/scenes.d.ts

@@ -210,11 +210,57 @@ export interface SceneDeploymentSpec {
     addresses: Record<string, string>;
 }
 /** Specification for a scene: a team, staged. */
+/** Somebody on a scripted scene: a person, an application, a company (PAP_DATALAYER X-02). */
+export interface SceneActorSpec {
+    id: string;
+    /** The name the audience sees. */
+    name: string;
+    /** One emoji, drawn before the name. */
+    face: string;
+    /** What it is, in a few words. */
+    is: string;
+}
+/** What the audience reads on a scripted line: rows and sentences, never a credential. */
+export interface SceneCardSpec {
+    kind: 'found' | 'sign-in' | 'approval' | 'done' | 'record';
+    title: string;
+    /** Its rows: each a label and a value. */
+    rows: [string, string][];
+    /** Its sentences. */
+    lines: string[];
+}
+/** The audience's turn on a scripted line: the scene waits for them. */
+export interface SceneTurnSpec {
+    /** What saying yes is called. */
+    yes: string;
+    /** What saying no is called; empty when there is nothing to refuse. */
+    no: string;
+    /** What happens once they said no: the scene ends there. */
+    declined: string;
+}
+/** One line of a scripted scene. */
+export interface SceneLineSpec {
+    /** Who acts: an actor's id. */
+    from: string;
+    /** To whom; empty when nobody is addressed. */
+    to: string;
+    /** What they say or do, in a sentence; in quotes when it is said. */
+    says: string;
+    card?: SceneCardSpec;
+    /** What happened underneath, in a visitor's words; empty when nothing is said. */
+    how: string;
+    turn?: SceneTurnSpec;
+}
 export interface SceneSpec {
     /** The version of the spec itself: `loop.scene/v1`. */
     schema: string;
     id: string;
     version: string;
+    /**
+     * `team`: a team staged, live; `scripted`: actors and lines written out,
+     * played as written, with no team, cast or script (PAP_DATALAYER X-02).
+     */
+    kind: 'team' | 'scripted';
     /** The tab's name. */
     name: string;
     description: string;
@@ -238,4 +284,10 @@ export interface SceneSpec {
     setup: string[];
     /** The last rehearsal played on Datalayer, what *Live* is read from; none when never played. */
     played?: ScenePlayedSpec;
+    /** A scripted scene's actors; empty on one that stages a team. */
+    actors: SceneActorSpec[];
+    /** A scripted scene's lines, in order; empty on one that stages a team. */
+    lines: SceneLineSpec[];
+    /** A scripted scene: what of it runs on Datalayer today; empty on one that stages a team. */
+    live: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.5.4",
+    "version": "1.5.7",
     "type": "module",
     "workspaces": [
         ".",

package/scripts/codegen/generate_apps.py

@@ -156,8 +156,8 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
             mode="json", by_alias=True
         ):
             spec.pop("pap")
-        # PACT and A2A's extensions the same way (AGENT_PROTOCOLS PI-01, PR-02).
-        for block in ("pact", "a2a"):
+        # PACT, commerce and A2A's extensions the same way (AGENT_PROTOCOLS PI-01, PR-02).
+        for block in ("pact", "commerce", "a2a"):
             if block in spec and spec[block] == type(getattr(app, block))().model_dump(
                 mode="json", by_alias=True
             ):

package/scripts/codegen/generate_scenes.py

@@ -88,10 +88,17 @@ def load_specs(specs_dir: Path) -> list[dict[str, Any]]:
     for identity in sorted(scenes):
         scene = scenes[identity]
         spec = scene.model_dump(mode="json", by_alias=True)
-        spec["entry"] = scene.entry_of()
-        spec["cast"] = [
-            member.model_dump(mode="json", by_alias=True) for member in scene.cast_of()
-        ]
+        # A scripted scene stages no team (PAP_DATALAYER X-02): no entry, no cast.
+        scripted = spec.get("kind") == "scripted"
+        spec["entry"] = "" if scripted else scene.entry_of()
+        spec["cast"] = (
+            []
+            if scripted
+            else [
+                member.model_dump(mode="json", by_alias=True)
+                for member in scene.cast_of()
+            ]
+        )
         for beat, data in zip(scene.script, spec["script"]):
             data["shows"] = [kind.value for kind in beat.shown]
         spec["setup"] = scenes_module.scene_setup(scene)