@almadar/std 17.0.2 → 17.1.0

package/behaviors/lolo/spec/codec/lolo-source.gen/src_prepare.in

@@ -25,13 +25,17 @@
                       events: (array/unique (array/map (object/get @machine "transitions") (fn tr (object/get @tr "event")))),
                       listenTypes: (object/fromEntries (array/map (array/filter @evs (fn ev (> (array/len (default (object/get @ev "payloadSchema") [])) 0))) (fn ev [(object/get @ev "key") FILL{@config.payloadType ## trait => @tn ## event => CASE{(object/get @ev "key") ## "keep"}}]))),
                       emitTypes: (object/fromEntries (array/map (array/filter @ems (fn ev (> (array/len (default (object/get @ev "payloadSchema") [])) 0))) (fn ev [(object/get @ev "event") FILL{@config.payloadType ## trait => @tn ## event => CASE{(object/get @ev "event") ## "keep"}}])))
-                      emitVoid: (array/map (array/filter @ems (fn ev (= (array/len (default (object/get @ev "payloadSchema") [])) 0))) (fn ev (object/get @ev "event"))) }))))))))))
+                      emitVoid: (array/map (array/filter @ems (fn ev (= (array/len (default (object/get @ev "payloadSchema") [])) 0))) (fn ev (object/get @ev "event")))
+                      orbital: (object/get @o "name")
+                      listenRows: (array/map (array/filter (default (object/get @t "listens") []) (fn l (= (object/get (default (object/get @l "source") { kind: "" }) "kind") "trait")))
+                        (fn l { source: (default (object/get (default (object/get @l "source") { kind: "" }) "trait") ""), event: (object/get @l "event"), trigger: (default (object/get @l "triggers") (object/get @l "event")), guard: (object/get @l "guard" null), map: (object/get @l "payloadMapping" null) })) }))))))))))
         (set @entity.groups (array/concat
           (if @config.renderModels (array/map @entity.containers (fn c (array/map (object/get @c "fields") (fn f [0, (object/get @f "default" null)])))) [])
           (array/map @entity.traits (fn t
             (array/concat
               [(array/concat [0] (array/map (object/get @t "knobs") (fn kb (object/get @kb "default" null))))]
-              (array/map (object/get @t "transitions") (fn tr (array/concat [0, (if (!= (object/get @tr "guard" null) null) (object/get @tr "guard") true)] (default (object/get @tr "effects" []) [])))))))))
+              (array/map (object/get @t "transitions") (fn tr (array/concat [0, (if (!= (object/get @tr "guard" null) null) (object/get @tr "guard") true)] (default (object/get @tr "effects" []) []))))
+              (array/map (object/get @t "listenRows") (fn lr [0, (if (!= (object/get @lr "guard" null) null) (object/get @lr "guard") true), (default (object/get @lr "map" null) {})])))))))
         (set @entity.groupCtx (array/concat
           (if @config.renderModels (array/map @entity.containers (fn c { emitTypes: {}, emitVoid: [], defaults: {} })) [])
           (array/map @entity.traits (fn t

package/behaviors/lolo/spec/codec/lolo-source.gen/src_trait.in

@@ -56,11 +56,18 @@
         (emit SOURCE_RENDER_FAILED { error: "a render is already in progress" })
       LOLO_READ_FAILED -> ready
         (emit SOURCE_RENDER_FAILED { error: (default @payload.error "the source could not be read") })
-      LOLO_READ -> rendering
+      LOLO_READ -> rendering when (not (array/some (object/get @payload.result "orbitals") (fn co (array/some (object/get @co "traits") (fn ct (!= (object/get @ct "ref" null) null))))))
         (set @entity.program @payload.result)
         (emit SRC_PREPARE { })
+      LOLO_READ -> reading when (and (array/some (object/get @payload.result "orbitals") (fn co (array/some (object/get @co "traits") (fn ct (!= (object/get @ct "ref" null) null))))) (!= @entity.path ""))
+        (program/read @entity.source { resolve: true, text: false, path: @entity.path } { emit: { success: LOLO_RESOLVED, failure: LOLO_READ_FAILED } })
+      LOLO_READ -> ready when (and (array/some (object/get @payload.result "orbitals") (fn co (array/some (object/get @co "traits") (fn ct (!= (object/get @ct "ref" null) null))))) (= @entity.path ""))
+        (emit SOURCE_RENDER_FAILED { error: "a program that composes behaviors renders from its composed program, which needs the source's absolute path" })
+      LOLO_RESOLVED -> rendering
+        (set @entity.program @payload.result.program)
+        (emit SRC_PREPARE { })
       LOLO_INSPECTED -> rendering
-        (set @entity.program @payload.result.authoredProgram)
+        (set @entity.program (if (array/some (object/get @payload.result.authoredProgram "orbitals") (fn co (array/some (object/get @co "traits") (fn ct (!= (object/get @ct "ref" null) null))))) @payload.result.program @payload.result.authoredProgram))
         (set @entity.types @payload.result.types)
         (set @entity.expected @payload.result.expected)
         (set @entity.models @payload.result.models)
@@ -124,6 +131,9 @@
       LOLO_READ { result : SrcProgram! }
         @description "Internal: the program read by program/read."
         @tier "internal"
+      LOLO_RESOLVED { result : SrcResolved! }
+        @description "Internal: the composed program, read by program/read with resolve, of a program that composes behaviors."
+        @tier "internal"
       LOLO_INSPECTED { result : SrcInspect! }
         @description "Internal: the program and its types read by program/read with inspect."
         @tier "internal"

package/behaviors/lolo/spec/codec/lolo-source.parity/agent-step.lolo

@@ -1,5 +1,6 @@
 app agent-step-example [
-  version: "1.0.0"
+  version: "1.0.0",
+  description: "Course example of a tool-using agent loop that plans, acts on a chosen tool, records the observation and answers or stops at a step budget, used as a native renderer parity example against the kernel's answers."
 ]
 orbital Agent {
   entity Run [runtime] {

package/behaviors/lolo/spec/codec/lolo-source.parity/agent-step.server.lolo

@@ -1,5 +1,6 @@
 app agent-step-example [
   version: "1.0.0",
+  description: "Server variant of the course example of a tool-using agent loop that plans, acts on a chosen tool, records the observation and answers or stops at a step budget, composed with the std HTTP server for the native server parity run against the kernel's answers.",
   net: { "127.0.0.1:4999": [listen] }
 ]
 uses Server from "std/behaviors/std-http-server"

package/behaviors/lolo/spec/codec/lolo-source.parity/chunk.lolo

@@ -1,5 +1,6 @@
 app chunk-example [
-  version: "1.0.0"
+  version: "1.0.0",
+  description: "Course example of splitting document text into overlapping windows, refusing window settings that cannot make progress, used as a native renderer parity example against the kernel's answers."
 ]
 orbital Chunking {
   entity Doc [runtime] {

package/behaviors/lolo/spec/codec/lolo-source.parity/chunk.server.lolo

@@ -1,5 +1,6 @@
 app chunk-example [
   version: "1.0.0",
+  description: "Server variant of the course example of splitting document text into overlapping windows, refusing window settings that cannot make progress, composed with the std HTTP server for the native server parity run against the kernel's answers.",
   net: { "127.0.0.1:4999": [listen] }
 ]
 uses Server from "std/behaviors/std-http-server"

package/behaviors/lolo/spec/codec/lolo-source.parity/compose-pair.events.json

@@ -0,0 +1,36 @@
+{
+  "steps": [
+    {
+      "trait": "Arena",
+      "event": "INIT",
+      "payload": {}
+    },
+    {
+      "trait": "Score",
+      "event": "INIT",
+      "payload": {}
+    },
+    {
+      "trait": "Arena",
+      "event": "HIT",
+      "payload": {
+        "n": 1
+      }
+    },
+    {
+      "trait": "Arena",
+      "event": "HIT",
+      "payload": {
+        "n": 2
+      }
+    },
+    {
+      "trait": "Score",
+      "event": "UNITS_CHANGED",
+      "payload": {
+        "enemiesAlive": 0,
+        "playersAlive": 1
+      }
+    }
+  ]
+}

package/behaviors/lolo/spec/codec/lolo-source.parity/compose-pair.replay.goldens.json

@@ -0,0 +1,91 @@
+{
+  "atom": "codec/lolo-source.fixtures/compose-pair.lolo",
+  "trait": "Arena",
+  "orbital": "ArenaOrbital",
+  "note": "kernel answers for the composed-mode fixture: a local trait's emit drives a composed std atom with call-site config; each step's ordered emits and its trait's row",
+  "cases": [
+    {
+      "id": "compose-pair",
+      "steps": [
+        {
+          "trait": "Arena",
+          "event": "INIT",
+          "payload": {},
+          "expect": {
+            "exactEmits": [],
+            "entity": {}
+          }
+        },
+        {
+          "trait": "Score",
+          "event": "INIT",
+          "payload": {},
+          "expect": {
+            "exactEmits": [],
+            "entity": {
+              "score": 0,
+              "scoreBaseline": 3
+            }
+          }
+        },
+        {
+          "trait": "Arena",
+          "event": "HIT",
+          "payload": {
+            "n": 1
+          },
+          "expect": {
+            "exactEmits": [
+              {
+                "event": "WAVE",
+                "payload": {
+                  "enemiesAlive": 2,
+                  "playersAlive": 1
+                }
+              }
+            ],
+            "entity": {
+              "enemies": 2
+            }
+          }
+        },
+        {
+          "trait": "Arena",
+          "event": "HIT",
+          "payload": {
+            "n": 2
+          },
+          "expect": {
+            "exactEmits": [
+              {
+                "event": "WAVE",
+                "payload": {
+                  "enemiesAlive": 0,
+                  "playersAlive": 1
+                }
+              }
+            ],
+            "entity": {
+              "enemies": 0
+            }
+          }
+        },
+        {
+          "trait": "Score",
+          "event": "UNITS_CHANGED",
+          "payload": {
+            "enemiesAlive": 0,
+            "playersAlive": 1
+          },
+          "expect": {
+            "exactEmits": [],
+            "entity": {
+              "score": 15,
+              "scoreBaseline": 0
+            }
+          }
+        }
+      ]
+    }
+  ]
+}

package/behaviors/lolo/spec/codec/lolo-source.parity/cosine.lolo

@@ -1,5 +1,6 @@
 app cosine-example [
-  version: "1.0.0"
+  version: "1.0.0",
+  description: "Course example of cosine similarity between two number vectors in one client trait, used as a native renderer parity example against the kernel's answers."
 ]
 orbital Similarity {
   entity Pair [runtime] {

package/behaviors/lolo/spec/codec/lolo-source.parity/cosine.server.lolo

@@ -1,5 +1,6 @@
 app cosine-example [
   version: "1.0.0",
+  description: "Server variant of the course example of cosine similarity between two number vectors in one client trait, composed with the std HTTP server for the native server parity run against the kernel's answers.",
   net: { "127.0.0.1:4999": [listen] }
 ]
 uses Server from "std/behaviors/std-http-server"

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/kotlin/compose-pair.kt

@@ -0,0 +1,31 @@
+import generated.*
+import kotlinx.serialization.json.Json
+import kotlinx.serialization.json.JsonPrimitive
+import kotlinx.serialization.json.buildJsonObject
+import kotlinx.serialization.json.jsonArray
+import kotlinx.serialization.json.jsonObject
+import kotlinx.serialization.json.jsonPrimitive
+
+fun main(args: Array<String>) {
+    val json = Json { encodeDefaults = true }
+    val spec = json.parseToJsonElement(java.io.File(args[0]).readText()).jsonObject
+    val row = { json.decodeFromJsonElement(Match.serializer(), buildJsonObject { put("id", JsonPrimitive("1")) }) }
+    val program = Program(row(), row())
+    spec.getValue("steps").jsonArray.forEachIndexed { i, step ->
+        val s = step.jsonObject
+        val n = program.log.size
+        val key = "ArenaOrbital." + s.getValue("trait").jsonPrimitive.content
+        program.dispatch(key, s.getValue("event").jsonPrimitive.content, s.getValue("payload"))
+        for ((_, event, payload) in program.log.drop(n)) {
+            println(buildJsonObject {
+                put("step", JsonPrimitive(i))
+                put("event", JsonPrimitive(event))
+                put("payload", payload)
+            })
+        }
+        println(buildJsonObject {
+            put("step", JsonPrimitive(i))
+            put("entity", program.entry(key)?.entity?.invoke() ?: JsonPrimitive("missing"))
+        })
+    }
+}

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/kotlin/router-trio.kt

@@ -0,0 +1,31 @@
+import generated.*
+import kotlinx.serialization.json.Json
+import kotlinx.serialization.json.JsonPrimitive
+import kotlinx.serialization.json.buildJsonObject
+import kotlinx.serialization.json.jsonArray
+import kotlinx.serialization.json.jsonObject
+import kotlinx.serialization.json.jsonPrimitive
+
+fun main(args: Array<String>) {
+    val json = Json { encodeDefaults = true }
+    val spec = json.parseToJsonElement(java.io.File(args[0]).readText()).jsonObject
+    val row = { json.decodeFromJsonElement(Tally.serializer(), buildJsonObject { put("id", JsonPrimitive("1")) }) }
+    val program = Program(row(), row(), row())
+    spec.getValue("steps").jsonArray.forEachIndexed { i, step ->
+        val s = step.jsonObject
+        val n = program.log.size
+        val key = "TrioOrbital." + s.getValue("trait").jsonPrimitive.content
+        program.dispatch(key, s.getValue("event").jsonPrimitive.content, s.getValue("payload"))
+        for ((_, event, payload) in program.log.drop(n)) {
+            println(buildJsonObject {
+                put("step", JsonPrimitive(i))
+                put("event", JsonPrimitive(event))
+                put("payload", payload)
+            })
+        }
+        println(buildJsonObject {
+            put("step", JsonPrimitive(i))
+            put("entity", program.entry(key)?.entity?.invoke() ?: JsonPrimitive("missing"))
+        })
+    }
+}

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/kotlin/store-pair.kt

@@ -0,0 +1,31 @@
+import generated.*
+import kotlinx.serialization.json.Json
+import kotlinx.serialization.json.JsonPrimitive
+import kotlinx.serialization.json.buildJsonObject
+import kotlinx.serialization.json.jsonArray
+import kotlinx.serialization.json.jsonObject
+import kotlinx.serialization.json.jsonPrimitive
+
+fun main(args: Array<String>) {
+    val json = Json { encodeDefaults = true }
+    val spec = json.parseToJsonElement(java.io.File(args[0]).readText()).jsonObject
+    val row = json.decodeFromJsonElement(Note.serializer(), buildJsonObject { put("id", JsonPrimitive("1")) })
+    val program = Program(row, MemoryStore())
+    val key = "StoreOrbital.Notes"
+    spec.getValue("steps").jsonArray.forEachIndexed { i, step ->
+        val s = step.jsonObject
+        val n = program.log.size
+        program.dispatch("StoreOrbital." + s.getValue("trait").jsonPrimitive.content, s.getValue("event").jsonPrimitive.content, s.getValue("payload"))
+        for ((_, event, payload) in program.log.drop(n)) {
+            println(buildJsonObject {
+                put("step", JsonPrimitive(i))
+                put("event", JsonPrimitive(event))
+                put("payload", payload)
+            })
+        }
+        println(buildJsonObject {
+            put("step", JsonPrimitive(i))
+            put("entity", program.entry(key)?.entity?.invoke() ?: JsonPrimitive("missing"))
+        })
+    }
+}

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/python/compose-pair.py

@@ -0,0 +1,18 @@
+import dataclasses
+import json
+import sys
+
+sys.path[:0] = [sys.argv[1]]
+import rendered
+from orbital_app.generated.entities import Match
+
+spec = json.load(open(sys.argv[2]))
+keys = ["ArenaOrbital.Arena", "ArenaOrbital.Score"]
+program = rendered.Program({k: Match(id="1") for k in keys})
+for i, step in enumerate(spec["steps"]):
+    n = len(program.log)
+    key = "ArenaOrbital." + step["trait"]
+    program.dispatch(key, step["event"], step["payload"])
+    for _trait, event, out in program.log[n:]:
+        print(json.dumps({"step": i, "event": event, "payload": out}, sort_keys=True))
+    print(json.dumps({"step": i, "entity": dataclasses.asdict(program.traits[key].entity)}, sort_keys=True))

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/python/router-trio.py

@@ -0,0 +1,18 @@
+import dataclasses
+import json
+import sys
+
+sys.path[:0] = [sys.argv[1]]
+import rendered
+from orbital_app.generated.entities import Tally
+
+spec = json.load(open(sys.argv[2]))
+keys = ["TrioOrbital.Lead", "TrioOrbital.Echo", "TrioOrbital.Tail"]
+program = rendered.Program({k: Tally(id="1") for k in keys})
+for i, step in enumerate(spec["steps"]):
+    n = len(program.log)
+    key = "TrioOrbital." + step["trait"]
+    program.dispatch(key, step["event"], step["payload"])
+    for _trait, event, out in program.log[n:]:
+        print(json.dumps({"step": i, "event": event, "payload": out}, sort_keys=True))
+    print(json.dumps({"step": i, "entity": dataclasses.asdict(program.traits[key].entity)}, sort_keys=True))

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/python/store-pair.py

@@ -0,0 +1,17 @@
+import dataclasses
+import json
+import sys
+
+sys.path[:0] = [sys.argv[1]]
+import rendered
+from orbital_app.generated.entities import Note
+
+spec = json.load(open(sys.argv[2]))
+key = "StoreOrbital.Notes"
+program = rendered.Program({key: Note(id="1")}, rendered.MemoryStore())
+for i, step in enumerate(spec["steps"]):
+    n = len(program.log)
+    program.dispatch("StoreOrbital." + step["trait"], step["event"], step["payload"])
+    for _trait, event, out in program.log[n:]:
+        print(json.dumps({"step": i, "event": event, "payload": out}, sort_keys=True))
+    print(json.dumps({"step": i, "entity": dataclasses.asdict(program.traits[key].entity)}, sort_keys=True))

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/rust/compose-pair.rs

@@ -0,0 +1,37 @@
+mod generated;
+mod lolo;
+
+use generated::entities::Match;
+use serde::Deserialize;
+
+#[derive(Deserialize)]
+struct Step {
+    #[serde(rename = "trait")]
+    trait_name: String,
+    event: String,
+    payload: serde_json::Value,
+}
+
+#[derive(Deserialize)]
+struct Spec {
+    steps: Vec<Step>,
+}
+
+fn row() -> Match {
+    serde_json::from_value(serde_json::json!({ "id": "1" })).expect("row")
+}
+
+fn main() {
+    let path = std::env::args().nth(1).expect("events file argument");
+    let spec: Spec = serde_json::from_str(&std::fs::read_to_string(path).expect("read events")).expect("parse events");
+    let mut program = lolo::Program::new((row(), row()));
+    for (i, step) in spec.steps.into_iter().enumerate() {
+        let n = program.router.log.len();
+        let key = format!("ArenaOrbital.{}", step.trait_name);
+        program.dispatch(&key, &step.event, step.payload);
+        for (_, event, payload) in &program.router.log[n..] {
+            println!("{}", serde_json::json!({"step": i, "event": event, "payload": payload}));
+        }
+        println!("{}", serde_json::json!({"step": i, "entity": program.router.entity_of(&key)}));
+    }
+}

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/rust/router-trio.rs

@@ -0,0 +1,37 @@
+mod generated;
+mod lolo;
+
+use generated::entities::Tally;
+use serde::Deserialize;
+
+#[derive(Deserialize)]
+struct Step {
+    #[serde(rename = "trait")]
+    trait_name: String,
+    event: String,
+    payload: serde_json::Value,
+}
+
+#[derive(Deserialize)]
+struct Spec {
+    steps: Vec<Step>,
+}
+
+fn row() -> Tally {
+    serde_json::from_value(serde_json::json!({ "id": "1" })).expect("row")
+}
+
+fn main() {
+    let path = std::env::args().nth(1).expect("events file argument");
+    let spec: Spec = serde_json::from_str(&std::fs::read_to_string(path).expect("read events")).expect("parse events");
+    let mut program = lolo::Program::new((row(), row(), row()));
+    for (i, step) in spec.steps.into_iter().enumerate() {
+        let n = program.router.log.len();
+        let key = format!("TrioOrbital.{}", step.trait_name);
+        program.dispatch(&key, &step.event, step.payload);
+        for (_, event, payload) in &program.router.log[n..] {
+            println!("{}", serde_json::json!({"step": i, "event": event, "payload": payload}));
+        }
+        println!("{}", serde_json::json!({"step": i, "entity": program.router.entity_of(&key)}));
+    }
+}

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/rust/store-pair.rs

@@ -0,0 +1,36 @@
+mod generated;
+mod lolo;
+
+use generated::entities::Note;
+use lolo::Store;
+use serde::Deserialize;
+
+#[derive(Deserialize)]
+struct Step {
+    #[serde(rename = "trait")]
+    trait_name: String,
+    event: String,
+    payload: serde_json::Value,
+}
+
+#[derive(Deserialize)]
+struct Spec {
+    steps: Vec<Step>,
+}
+
+fn main() {
+    let path = std::env::args().nth(1).expect("events file argument");
+    let spec: Spec = serde_json::from_str(&std::fs::read_to_string(path).expect("read events")).expect("parse events");
+    let row: Note = serde_json::from_value(serde_json::json!({ "id": "1" })).expect("row");
+    let store: std::rc::Rc<std::cell::RefCell<dyn Store>> = std::rc::Rc::new(std::cell::RefCell::new(lolo::MemoryStore::default()));
+    let mut program = lolo::Program::new((row,), store);
+    let key = "StoreOrbital.Notes";
+    for (i, step) in spec.steps.into_iter().enumerate() {
+        let n = program.router.log.len();
+        program.dispatch(&format!("StoreOrbital.{}", step.trait_name), &step.event, step.payload);
+        for (_, event, payload) in &program.router.log[n..] {
+            println!("{}", serde_json::json!({"step": i, "event": event, "payload": payload}));
+        }
+        println!("{}", serde_json::json!({"step": i, "entity": program.router.entity_of(key)}));
+    }
+}

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/swift/compose-pair.swift

@@ -0,0 +1,24 @@
+import Foundation
+
+func json(_ value: Any) throws -> String {
+    String(decoding: try JSONSerialization.data(withJSONObject: value, options: [.sortedKeys, .fragmentsAllowed]), as: UTF8.self)
+}
+
+func run() throws {
+    let spec = try JSONSerialization.jsonObject(with: Data(contentsOf: URL(fileURLWithPath: CommandLine.arguments[1]))) as? [String: Any] ?? [:]
+    let dec = JSONDecoder()
+    let row = try JSONSerialization.data(withJSONObject: ["id": "1"])
+    let program = Program(try dec.decode(Match.self, from: row), try dec.decode(Match.self, from: row))
+    let steps = spec["steps"] as? [[String: Any]] ?? []
+    for (i, step) in steps.enumerated() {
+        let n = program.log.count
+        let key = "ArenaOrbital." + (step["trait"] as? String ?? "")
+        program.dispatch(key, step["event"] as? String ?? "", try JSONSerialization.data(withJSONObject: step["payload"] ?? [:]))
+        for entry in program.log[n...] {
+            print("{\"step\":\(i),\"event\":\(try json(entry.event)),\"payload\":\(String(decoding: entry.payload, as: UTF8.self))}")
+        }
+        print("{\"step\":\(i),\"entity\":\(String(decoding: program.entry(key)?.entity() ?? Data("{}".utf8), as: UTF8.self))}")
+    }
+}
+
+try run()

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/swift/router-trio.swift

@@ -0,0 +1,24 @@
+import Foundation
+
+func json(_ value: Any) throws -> String {
+    String(decoding: try JSONSerialization.data(withJSONObject: value, options: [.sortedKeys, .fragmentsAllowed]), as: UTF8.self)
+}
+
+func run() throws {
+    let spec = try JSONSerialization.jsonObject(with: Data(contentsOf: URL(fileURLWithPath: CommandLine.arguments[1]))) as? [String: Any] ?? [:]
+    let dec = JSONDecoder()
+    let row = try JSONSerialization.data(withJSONObject: ["id": "1"])
+    let program = Program(try dec.decode(Tally.self, from: row), try dec.decode(Tally.self, from: row), try dec.decode(Tally.self, from: row))
+    let steps = spec["steps"] as? [[String: Any]] ?? []
+    for (i, step) in steps.enumerated() {
+        let n = program.log.count
+        let key = "TrioOrbital." + (step["trait"] as? String ?? "")
+        program.dispatch(key, step["event"] as? String ?? "", try JSONSerialization.data(withJSONObject: step["payload"] ?? [:]))
+        for entry in program.log[n...] {
+            print("{\"step\":\(i),\"event\":\(try json(entry.event)),\"payload\":\(String(decoding: entry.payload, as: UTF8.self))}")
+        }
+        print("{\"step\":\(i),\"entity\":\(String(decoding: program.entry(key)?.entity() ?? Data("{}".utf8), as: UTF8.self))}")
+    }
+}
+
+try run()

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/swift/store-pair.swift

@@ -0,0 +1,23 @@
+import Foundation
+
+func json(_ value: Any) throws -> String {
+    String(decoding: try JSONSerialization.data(withJSONObject: value, options: [.sortedKeys, .fragmentsAllowed]), as: UTF8.self)
+}
+
+func run() throws {
+    let spec = try JSONSerialization.jsonObject(with: Data(contentsOf: URL(fileURLWithPath: CommandLine.arguments[1]))) as? [String: Any] ?? [:]
+    let row = try JSONSerialization.data(withJSONObject: ["id": "1"])
+    let program = Program(try JSONDecoder().decode(Note.self, from: row), store: MemoryStore())
+    let key = "StoreOrbital.Notes"
+    let steps = spec["steps"] as? [[String: Any]] ?? []
+    for (i, step) in steps.enumerated() {
+        let n = program.log.count
+        program.dispatch("StoreOrbital." + (step["trait"] as? String ?? ""), step["event"] as? String ?? "", try JSONSerialization.data(withJSONObject: step["payload"] ?? [:]))
+        for entry in program.log[n...] {
+            print("{\"step\":\(i),\"event\":\(try json(entry.event)),\"payload\":\(String(decoding: entry.payload, as: UTF8.self))}")
+        }
+        print("{\"step\":\(i),\"entity\":\(String(decoding: program.entry(key)?.entity() ?? Data("{}".utf8), as: UTF8.self))}")
+    }
+}
+
+try run()

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/typescript/compose-pair.mts

@@ -0,0 +1,24 @@
+import { readFileSync } from 'node:fs';
+import type { EventPayload } from '@almadar/core';
+import { Program } from './packages/shared/src/traits/rendered.ts';
+import type { Match } from './packages/shared/src/types/entities.ts';
+
+interface Step {
+  trait: string;
+  event: string;
+  payload: EventPayload;
+}
+interface Spec {
+  steps: Step[];
+}
+
+const spec: Spec = JSON.parse(readFileSync(process.argv[2] ?? '', 'utf8'));
+const row = (): Match => ({ id: '1', createdAt: '', updatedAt: '' });
+const program = new Program({ 'ArenaOrbital.Arena': row(), 'ArenaOrbital.Score': row() });
+spec.steps.forEach((step, i) => {
+  const n = program.log.length;
+  const key = 'ArenaOrbital.' + step.trait;
+  program.dispatch(key, step.event, step.payload);
+  for (const e of program.log.slice(n)) console.log(JSON.stringify({ step: i, event: e.event, payload: e.payload }));
+  console.log(JSON.stringify({ step: i, entity: program.traits[key]?.entity }));
+});

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/typescript/router-trio.mts

@@ -0,0 +1,24 @@
+import { readFileSync } from 'node:fs';
+import type { EventPayload } from '@almadar/core';
+import { Program } from './packages/shared/src/traits/rendered.ts';
+import type { Tally } from './packages/shared/src/types/entities.ts';
+
+interface Step {
+  trait: string;
+  event: string;
+  payload: EventPayload;
+}
+interface Spec {
+  steps: Step[];
+}
+
+const spec: Spec = JSON.parse(readFileSync(process.argv[2] ?? '', 'utf8'));
+const row = (): Tally => ({ id: '1', createdAt: '', updatedAt: '' });
+const program = new Program({ 'TrioOrbital.Lead': row(), 'TrioOrbital.Echo': row(), 'TrioOrbital.Tail': row() });
+spec.steps.forEach((step, i) => {
+  const n = program.log.length;
+  const key = 'TrioOrbital.' + step.trait;
+  program.dispatch(key, step.event, step.payload);
+  for (const e of program.log.slice(n)) console.log(JSON.stringify({ step: i, event: e.event, payload: e.payload }));
+  console.log(JSON.stringify({ step: i, entity: program.traits[key]?.entity }));
+});

package/behaviors/lolo/spec/codec/lolo-source.parity/drivers/typescript/store-pair.mts

@@ -0,0 +1,22 @@
+import { readFileSync } from 'node:fs';
+import type { EventPayload } from '@almadar/core';
+import { MemoryStore, Program } from './packages/shared/src/traits/rendered.ts';
+
+interface Step {
+  trait: string;
+  event: string;
+  payload: EventPayload;
+}
+interface Spec {
+  steps: Step[];
+}
+
+const spec: Spec = JSON.parse(readFileSync(process.argv[2] ?? '', 'utf8'));
+const key = 'StoreOrbital.Notes';
+const program = new Program({ [key]: { id: '1', createdAt: '', updatedAt: '' } }, new MemoryStore());
+spec.steps.forEach((step, i) => {
+  const n = program.log.length;
+  program.dispatch('StoreOrbital.' + step.trait, step.event, step.payload);
+  for (const e of program.log.slice(n)) console.log(JSON.stringify({ step: i, event: e.event, payload: e.payload }));
+  console.log(JSON.stringify({ step: i, entity: program.traits[key]?.entity }));
+});