@datalayer/agent-runtimes 1.3.95 → 1.3.97

package/dist-embed/datalayer-app.js

@@ -1 +1 @@
-(()=>{(function(){const c="datalayer-app-main.js",t=document.currentScript;if(!t||!t.src){console.error("datalayer-app: the script has to be loaded by a script tag with a src, so it knows where its module is.");return}const e=new URL(c,t.src).href;import(e).catch(a=>{const s=a instanceof Error?a.message:String(a),o=`The application could not be loaded: ${e} did not load (${s}).`;console.error(`datalayer-app: ${o}`),document.querySelectorAll("datalayer-app").forEach(n=>{if(n.shadowRoot)return;const r=document.createElement("p");r.textContent=o,n.attachShadow({mode:"open"}).appendChild(r)})})})();})();
+(()=>{(function(){const s="datalayer-app-main.js",t=document.currentScript;if(!t||!t.src){console.error("datalayer-app: the script has to be loaded by a script tag with a src, so it knows where its module is.");return}const n=window;n.__webpack_public_path__===void 0&&(n.__webpack_public_path__="");const e=new URL(s,t.src).href;import(e).catch(a=>{const i=a instanceof Error?a.message:String(a),o=`The application could not be loaded: ${e} did not load (${i}).`;console.error(`datalayer-app: ${o}`),document.querySelectorAll("datalayer-app").forEach(c=>{if(c.shadowRoot)return;const r=document.createElement("p");r.textContent=o,c.attachShadow({mode:"open"}).appendChild(r)})})})();})();

package/lib/apps/__tests__/fixtures/sceneCheckCases.json

@@ -0,0 +1,352 @@
+{
+  "says": "What `loop` refuses of a scene, recorded from agentspecs (plans/STUDIO.md S-10).",
+  "recordedWith": "scripts/record-scene-checks.py",
+  "cases": [
+    {
+      "name": "a scene with nobody on stage",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\n",
+      "says": [
+        "probe: the scene stages nobody: it names a `team`, or writes its `cast`"
+      ]
+    },
+    {
+      "name": "the entry is not in the cast",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: nobody\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n",
+      "says": ["The scene enters at 'nobody', which is not in its cast."]
+    },
+    {
+      "name": "the entry is a system",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: odoo\ncast:\n  - member: odoo\n    server: odoo-accounting\n    persona:\n      name: Odoo\n",
+      "says": [
+        "Its cast makes no team: supervisor 'Odoo' needs a `ref` into the agent catalogue, an `app` from the application catalogue, or a `model` and `instructions` of its own"
+      ]
+    },
+    {
+      "name": "a system asks",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n  - member: odoo\n    server: odoo-accounting\n    persona:\n      name: Odoo\n    talks_to:\n      - member: sales\n        over: a2a\n",
+      "says": [
+        "Its cast makes no team: member 'odoo' is a server: it answers over MCP and asks nobody"
+      ]
+    },
+    {
+      "name": "a member talks to itself",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n    talks_to:\n      - member: sales\n        over: a2a\n",
+      "says": ["Its cast makes no team: member 'sales' talks to itself"]
+    },
+    {
+      "name": "a member talks to nobody of the cast",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n    talks_to:\n      - member: ghost\n        over: a2a\n",
+      "says": [
+        "Its cast makes no team: member 'sales' talks to 'ghost', which is not a member of team 'probe'"
+      ]
+    },
+    {
+      "name": "a system asked over a2a",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n    talks_to:\n      - member: odoo\n        over: a2a\n  - member: odoo\n    server: odoo-accounting\n    persona:\n      name: Odoo\n",
+      "says": [
+        "Its cast makes no team: member 'sales' talks to 'odoo' over a2a, which is a server: a server is asked over mcp"
+      ]
+    },
+    {
+      "name": "an agent asked over mcp",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n    talks_to:\n      - member: books\n        over: mcp\n  - member: books\n    app: accounting\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Accounting\n",
+      "says": [
+        "Its cast makes no team: member 'sales' talks to 'books' over mcp, which is not a server: an agent or an application is asked over a2a"
+      ]
+    },
+    {
+      "name": "a member named twice",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n",
+      "says": ["probe: the cast names 'sales' twice"]
+    },
+    {
+      "name": "two beats with one name",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        answers: words\n  - id: open\n    cue:\n      say: Show them again\n    expect: The books are read again\n    moves:\n      - who: sales\n        answers: words\n",
+      "says": ["probe: the script has two beats named 'open'"]
+    },
+    {
+      "name": "a member placed outside the box",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nstage:\n  positions:\n    sales:\n      x: 40\n      y: 0.5\n",
+      "says": [
+        "probe: stage.positions.sales.x: Input should be less than or equal to 1"
+      ]
+    },
+    {
+      "name": "a member that is nothing at all",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n  - member: ghost\n",
+      "says": [
+        "Its cast makes no team: member 'ghost' needs a `ref` into the agent catalogue, an `app` from the application catalogue, a `server` from the MCP server catalogue, or enough of its own definition (`name`, `goal`) to stand alone"
+      ]
+    },
+    {
+      "name": "the scene wears a member's face",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nemoji: 🧮\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n      face: 🧮\n",
+      "says": [
+        "The scene wears 🧮, a member's face: a scene has a face of its own."
+      ]
+    },
+    {
+      "name": "a system of the setting that is no server",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nsetting:\n  systems:\n    - server: nosuch\n      as: Nope\n",
+      "says": ["There is no MCP server named 'nosuch'."]
+    },
+    {
+      "name": "a system nobody reaches",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nsetting:\n  systems:\n    - server: odoo-accounting\n      as: Odoo\n",
+      "says": [
+        "The system 'Odoo' (odoo-accounting) is on stage, and no member of the cast reaches it."
+      ]
+    },
+    {
+      "name": "a system reached through a connection",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: books\ncast:\n  - member: books\n    app: accounting\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Accounting\nsetting:\n  systems:\n    - server: odoo-accounting\n      as: Odoo\n",
+      "says": []
+    },
+    {
+      "name": "a Frame the catalogue has not",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nsetting:\n  frames:\n    - nosuch\n",
+      "says": ["There is no Frame named 'nosuch'."]
+    },
+    {
+      "name": "the stage places someone not in the cast",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nstage:\n  positions:\n    ghost:\n      x: 0.2\n      y: 0.4\n",
+      "says": ["The stage places 'ghost', which is not in the cast."]
+    },
+    {
+      "name": "a balloon opens first for someone not in the cast",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nstage:\n  opens_first: ghost\n",
+      "says": ["The balloon of 'ghost' opens first, and it is not in the cast."]
+    },
+    {
+      "name": "an address for someone not in the cast",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\ndeployment:\n  addresses:\n    ghost: GHOST_URL\n",
+      "says": ["An address is read for 'ghost', which is not in the cast."]
+    },
+    {
+      "name": "an address for a member in the browser",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: browser\n    persona:\n      name: Sales\ndeployment:\n  addresses:\n    sales: SALES_URL\n",
+      "says": ["'sales' runs in the browser: it has no address."]
+    },
+    {
+      "name": "visitors may watch and a member has no address",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\naudience:\n  who: visitors\n",
+      "says": [
+        "Visitors may watch, and 'sales' runs on a runtime with no address: deployment.addresses names none for it."
+      ]
+    },
+    {
+      "name": "a beat its entry does not answer",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n  - member: books\n    app: accounting\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Accounting\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: books\n        answers: table\n",
+      "says": [
+        "Beat 'open': its cue is answered by nobody — no move is the entry's ('sales')."
+      ]
+    },
+    {
+      "name": "a beat moved by someone not in the cast",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        answers: words\n      - who: ghost\n        answers: words\n",
+      "says": ["Beat 'open': 'ghost' moves, and is not in the cast."]
+    },
+    {
+      "name": "a beat moved by a system",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n  - member: odoo\n    server: odoo-accounting\n    persona:\n      name: Odoo\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        answers: words\n      - who: odoo\n        answers: words\n",
+      "says": [
+        "Beat 'open': 'odoo' moves, and a system answers tool by tool: it asks nobody."
+      ]
+    },
+    {
+      "name": "a move that asks someone not in the cast",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        asks: ghost\n        over: a2a\n        what: the books\n",
+      "says": ["Beat 'open': 'sales' asks 'ghost', which is not in the cast."]
+    },
+    {
+      "name": "a move over mcp that asks no system",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n  - member: books\n    app: accounting\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Accounting\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        asks: books\n        over: mcp\n        what: the books\n",
+      "says": [
+        "Beat 'open': 'sales' asks 'books' over mcp, which is not a system of the scene."
+      ]
+    },
+    {
+      "name": "a move over a2a that asks a system",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n  - member: odoo\n    server: odoo-accounting\n    persona:\n      name: Odoo\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        asks: odoo\n        over: a2a\n        what: the books\n",
+      "says": [
+        "Beat 'open': 'sales' asks 'odoo' over a2a, a system: a system is asked over mcp."
+      ]
+    },
+    {
+      "name": "a move that asks a member it does not talk to",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n  - member: books\n    app: accounting\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Accounting\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        asks: books\n        over: a2a\n        what: the books\n",
+      "says": [
+        "Beat 'open': 'sales' asks 'books', which the team does not have it talk to."
+      ]
+    },
+    {
+      "name": "a branch that goes on to no beat",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        answers: words\n    branch:\n      - decision: there is nothing to read\n        expect: it says so\n        then: nowhere\n",
+      "says": [
+        "Beat 'open': its branch goes on to 'nowhere', which is no beat."
+      ]
+    },
+    {
+      "name": "a rehearsal of a beat that is not in the script",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nrehearsal:\n  beats:\n    - beat: nowhere\n      lines:\n        - 'You → Sales'\n",
+      "says": [
+        "The rehearsal names the beat 'nowhere', which is not in the script."
+      ]
+    },
+    {
+      "name": "a rehearsal that names a beat twice",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        answers: words\nrehearsal:\n  beats:\n    - beat: open\n      lines:\n        - 'You → Sales'\n    - beat: open\n      lines:\n        - 'Sales: a table'\n",
+      "says": ["The rehearsal names the beat 'open' twice."]
+    },
+    {
+      "name": "a rehearsal that names someone not on stage",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        answers: words\nrehearsal:\n  beats:\n    - beat: open\n      lines:\n        - 'You → Stranger'\n",
+      "says": [
+        "The rehearsal of 'open' names 'Stranger', which is not on stage."
+      ]
+    },
+    {
+      "name": "a scene that plays",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n    talks_to:\n      - member: books\n        over: a2a\n  - member: books\n    app: accounting\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Accounting\nsetting:\n  systems:\n    - server: odoo-accounting\n      as: Odoo\n      holds: Datalayer's books\nstage:\n  positions:\n    sales:\n      x: 0\n      y: 0\n    books:\n      x: 0.5\n      y: 0\n  opens_first: sales\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: The books are read\n    moves:\n      - who: sales\n        asks: books\n        over: a2a\n        what: the open invoices\n      - who: sales\n        answers: table\nrehearsal:\n  beats:\n    - beat: open\n      lines:\n        - 'You → Sales'\n        - 'Sales → Accounting'\n        - 'Sales: a table'\n",
+      "says": []
+    },
+    {
+      "name": "a scene of a team that plays",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nteam: sales-and-accounting\ncast:\n  - member: sales\n    persona:\n      name: Sales\n    brief: Ask for the open invoices.\n",
+      "says": []
+    },
+    {
+      "name": "a cast under a team names someone not in it",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nteam: sales-and-accounting\ncast:\n  - member: ghost\n    persona:\n      name: Ghost\n",
+      "says": [
+        "The cast names 'ghost', which is not a member of the team 'sales-and-accounting'."
+      ]
+    },
+    {
+      "name": "a cast under a team says what a member is",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nteam: sales-and-accounting\ncast:\n  - member: sales\n    app: sales\n    persona:\n      name: Sales\n",
+      "says": [
+        "The cast member 'sales' is the team's: it says its persona and its brief, nothing of what it is."
+      ]
+    },
+    {
+      "name": "a move asks a system for a tool it does not offer",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: books\ncast:\n  - member: books\n    app: accounting\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Accounting\nsetting:\n  systems:\n    - server: odoo-accounting\n      as: Odoo\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: It is answered\n    moves:\n      - who: books\n        asks: odoo-accounting\n        over: mcp\n        tool: odoo_accounting_burn_the_books\n",
+      "says": [
+        "Beat 'open': 'books' asks 'odoo-accounting' for 'odoo_accounting_burn_the_books', which odoo-accounting does not offer."
+      ]
+    },
+    {
+      "name": "a move asks for a tool to do what it does not",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: crop\ncast:\n  - member: crop\n    app: crop-monitoring\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Crop\nsetting:\n  systems:\n    - server: earthdata\n      as: Odoo\nscript:\n  - id: look\n    cue:\n      say: What is there\n    expect: It is answered\n    moves:\n      - who: crop\n        asks: earthdata\n        over: mcp\n        tool: download_earth_data_granules\n        does: read\n",
+      "says": [
+        "Beat 'look': 'crop' asks 'earthdata' for 'download_earth_data_granules' to read, and it writes."
+      ]
+    },
+    {
+      "name": "a move asks for a tool no connection of the member offers",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: inbox\ncast:\n  - member: inbox\n    app: inbox-triage\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Inbox\nsetting:\n  systems:\n    - server: google-workspace\n      as: Odoo\nscript:\n  - id: mail\n    cue:\n      say: What came in\n    expect: It is answered\n    moves:\n      - who: inbox\n        asks: google-workspace\n        over: mcp\n        tool: list_calendar_events\n",
+      "says": [
+        "Beat 'mail': 'inbox' asks 'google-workspace' for 'list_calendar_events', a tool no connection of Inbox offers."
+      ]
+    },
+    {
+      "name": "a rehearsal expects a tool a system does not offer",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: books\ncast:\n  - member: books\n    app: accounting\n    role: contributor\n    runs_in: runtime\n    persona:\n      name: Accounting\nsetting:\n  systems:\n    - server: odoo-accounting\n      as: Odoo\nscript:\n  - id: open\n    cue:\n      say: Show the books\n    expect: It is answered\n    moves:\n      - who: books\n        answers: table\nrehearsal:\n  beats:\n    - beat: open\n      lines:\n        - 'Accounting → Odoo: odoo_accounting_burn_the_books'\n        - 'Accounting: a table'\n",
+      "says": [
+        "The rehearsal of 'open' expects 'odoo_accounting_burn_the_books', which odoo-accounting does not offer."
+      ]
+    },
+    {
+      "name": "a cast that is a word",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast: sales\n",
+      "says": ["probe: cast: Input should be a valid list"]
+    },
+    {
+      "name": "a name that is a number",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: 123\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n",
+      "says": ["probe: name: Input should be a valid string"]
+    },
+    {
+      "name": "a scene with no name",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n",
+      "says": ["probe: name is missing"]
+    },
+    {
+      "name": "a field the spec does not have",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\ncolour: red\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n",
+      "says": ["probe: colour is not a field of the spec"]
+    },
+    {
+      "name": "a member with a field it does not have",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\n    mood: happy\n",
+      "says": ["probe: cast.0.mood is not a field of the spec"]
+    },
+    {
+      "name": "a member running nowhere",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: nowhere\n    persona:\n      name: Sales\n",
+      "says": ["probe: cast.0.runs_in: Input should be 'browser' or 'runtime'"]
+    },
+    {
+      "name": "a member's role nobody plays",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: boss\n    runs_in: runtime\n    persona:\n      name: Sales\n",
+      "says": [
+        "probe: cast.0.role: Input should be 'coordinator', 'initiator', 'contributor', 'reviewer' or 'finalizer'"
+      ]
+    },
+    {
+      "name": "an audience that is a word",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\naudience: everyone\n",
+      "says": [
+        "probe: audience: Input should be a valid dictionary or instance of SceneAudience"
+      ]
+    },
+    {
+      "name": "an audience nobody can be",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\naudience:\n  who: nobody-at-all\n",
+      "says": [
+        "probe: audience.who: Input should be 'visitors', 'signed-in' or 'nobody'"
+      ]
+    },
+    {
+      "name": "a ceiling below nothing",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\naudience:\n  ceiling_per_ask: -1\n",
+      "says": [
+        "probe: audience.ceiling_per_ask: Input should be greater than or equal to 0"
+      ]
+    },
+    {
+      "name": "a ceiling that is no number",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\naudience:\n  ceiling_per_ask: lots\n",
+      "says": [
+        "probe: audience.ceiling_per_ask: Input should be a valid number, unable to parse string as a number"
+      ]
+    },
+    {
+      "name": "a rehearsal bound that is no duration",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nrehearsal:\n  within: soon\n",
+      "says": [
+        "probe: rehearsal.within: String should match pattern '^(?:[1-9]\\d*(?:ms|s|m|h))?$'"
+      ]
+    },
+    {
+      "name": "a stage that is a list",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nstage: []\n",
+      "says": [
+        "probe: stage: Input should be a valid dictionary or instance of SceneStage"
+      ]
+    },
+    {
+      "name": "places that are a word",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast:\n  - member: sales\n    app: sales\n    role: initiator\n    runs_in: runtime\n    persona:\n      name: Sales\nstage:\n  positions: everywhere\n",
+      "says": ["probe: stage.positions: Input should be a valid dictionary"]
+    },
+    {
+      "name": "two things wrong at once",
+      "yaml": "schema: loop.scene/v1\nid: probe\nversion: 0.0.1\nname: Probe\nentry: sales\ncast: sales\nrehearsal:\n  within: soon\n",
+      "says": [
+        "probe: cast: Input should be a valid list; rehearsal.within: String should match pattern '^(?:[1-9]\\d*(?:ms|s|m|h))?$'"
+      ]
+    }
+  ]
+}

package/lib/apps/apps/sceneChecks.d.ts

@@ -0,0 +1,92 @@
+import type { SceneSpec } from '../../types/scenes';
+/** The part of a scene a refusal is about: the sections of its spec. */
+export type SceneSection = 'scene' | 'cast' | 'setting' | 'script' | 'stage' | 'audience' | 'rehearsal';
+/** One refusal: the sentence agentspecs says, and the section it is about. */
+export type SceneProblem = {
+    says: string;
+    section: SceneSection;
+};
+/**
+ * The sections a stage is written in (S-09): where each player runs and
+ * what it is given (`stage`, `deployment`, a member's `runs_in`), and what
+ * the audience may do (`audience`).
+ */
+export declare const STAGE_SECTIONS: readonly SceneSection[];
+/**
+ * The parts a person reads one at a time in the spec editor (S-08, S-09),
+ * in the order a scene is written. The scene's own fields are always in
+ * view, so they are not one of them.
+ */
+export declare const SCENE_PARTS: readonly SceneSection[];
+/**
+ * Each section of a scene, and the keys of the spec it is written in.
+ * *Where it plays* is the stage directions and the addresses together: where
+ * each player runs is one thing, said in two keys. Read by the editor's
+ * parts (S-09) and by `sceneShape`, which files a refusal of the scene's
+ * shape under the part whose key it names.
+ */
+export declare const SCENE_SECTION_KEYS: Readonly<Record<SceneSection, readonly string[]>>;
+/** The section a key of the spec is written in; the scene's own otherwise. */
+export declare const sectionOfKey: (key: string) => SceneSection;
+/** What a person reads each section as, in the editor's panel. */
+export declare const SECTION_WORDS: Record<SceneSection, string>;
+/**
+ * The checks that are not the browser's: made by agentspecs when `loop`
+ * loads the scene. Said here so that no second set of them is written.
+ */
+export declare const AGENTSPECS_OWN: readonly string[];
+/** The entry agentspecs reads: the one said, else the initiator, else the first of the cast. */
+export declare function entryOf(spec: SceneSpec): string;
+/**
+ * One of the person's own applications, kept in their Space: what the checks
+ * read of it when a member of the cast is one of them rather than an
+ * application of the catalogue — its name and face, and what its connections
+ * reach. agentspecs reads the catalogue only, so to `loop` a member that is
+ * the person's own application reaches no system at all; the Studio has the
+ * person's applications, and judges them by what they truly reach, in the
+ * same sentences (decided 2026-10-10, S-10).
+ */
+export type SceneOwnApp = {
+    name: string;
+    emoji?: string;
+    connections: readonly {
+        server: string;
+        only?: readonly string[];
+    }[];
+};
+/** The person's own applications, by uid — the reference a scene's cast writes for one. */
+export type SceneOwnApps = Readonly<Record<string, SceneOwnApp>>;
+/**
+ * A line of a rehearsal's shape, as agentspecs reads it (`parse_line`):
+ * *Sales → Accounting* (an ask), *Accounting → Odoo: odoo_*\** (a tool),
+ * *Accounting: a table* (an answer).
+ */
+export declare function transcriptLineOf(text: string): {
+    who: string;
+    whom: string;
+    detail: string;
+} | undefined;
+/**
+ * What is wrong with the shape of the scene, as agentspecs reads it
+ * (`SceneSpec._stages_somebody`), said as `parse_scene` says it — the
+ * scene's id, then the sentence. The first stops, as the reader stops.
+ */
+export declare function sceneShapeProblem(spec: SceneSpec): SceneProblem | undefined;
+/**
+ * What stops a scene from being played, each in agentspecs' sentence with
+ * the section it is about; empty when nothing does.
+ */
+export declare function sceneCheck(spec: SceneSpec, own?: SceneOwnApps, { written, }?: {
+    /**
+     * Whether the spec is what a person wrote, read from its text. A cast
+     * under a team is judged on what was written, and only a text says that:
+     * the catalogue's scenes reach the browser with every member filled in
+     * from its team (`cast_of`), so read from there a valid scene would be
+     * refused for what its team said (seen 2026-10-10).
+     */
+    written?: boolean;
+}): SceneProblem[];
+/** What stops a scene from being played, in agentspecs' sentences; empty when nothing does. */
+export declare const sceneProblems: (spec: SceneSpec, own?: SceneOwnApps) => string[];
+/** The refusals of one section of the spec: the stage's, for S-09's own panel. */
+export declare const problemsOfSections: (problems: readonly SceneProblem[], sections: readonly SceneSection[]) => SceneProblem[];