@almadar/std 16.143.0 → 16.145.0

package/behaviors/registry/ml/atoms/std-ml-lookup.orb

@@ -0,0 +1,473 @@
+{
+  "description": "Rung R1 of the intelligence ladder — finds the candidate value in a list of accepted values; abstains when nothing matches.",
+  "ledger": {
+    "entries": {
+      "ent_01KYBMJJT4DMQ50X37K7WJ7XDD": {
+        "bakedName": "KeyLookup",
+        "curName": "KeyLookup",
+        "id": "ent_01KYBMJJT4DMQ50X37K7WJ7XDD",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYBMJJT48QRYPT14NG0GMXMY": {
+        "bakedName": "KEY_MISS",
+        "curName": "KEY_MISS",
+        "id": "evt_01KYBMJJT48QRYPT14NG0GMXMY",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBMJJT4887BT5V7KWCDW7XR",
+        "renames": []
+      },
+      "evt_01KYBMJJT4K8ANYTCSAH8QZ0JC": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYBMJJT4K8ANYTCSAH8QZ0JC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBMJJT4887BT5V7KWCDW7XR",
+        "renames": []
+      },
+      "evt_01KYBMJJT4NBFQTG784CP78ERD": {
+        "bakedName": "LOOKUP",
+        "curName": "LOOKUP",
+        "id": "evt_01KYBMJJT4NBFQTG784CP78ERD",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBMJJT4887BT5V7KWCDW7XR",
+        "renames": []
+      },
+      "evt_01KYBMJJT4XY85SQDER4Q9CHW1": {
+        "bakedName": "KEY_HIT",
+        "curName": "KEY_HIT",
+        "id": "evt_01KYBMJJT4XY85SQDER4Q9CHW1",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBMJJT4887BT5V7KWCDW7XR",
+        "renames": []
+      },
+      "evt_01KYC09GZR0684YDEM0BAP2W5X": {
+        "bakedName": "RESET",
+        "curName": "RESET",
+        "id": "evt_01KYC09GZR0684YDEM0BAP2W5X",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBMJJT4887BT5V7KWCDW7XR",
+        "renames": []
+      },
+      "orb_01KYBMJJT4GF4NBRN7SX8PTDSE": {
+        "bakedName": "MlLookupOrbital",
+        "curName": "MlLookupOrbital",
+        "id": "orb_01KYBMJJT4GF4NBRN7SX8PTDSE",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYBMJJT4GJK8ZDFRAM7HJ9HR": {
+        "bakedName": "MlLookupPage",
+        "curName": "MlLookupPage",
+        "id": "pag_01KYBMJJT4GJK8ZDFRAM7HJ9HR",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBMJJT4887BT5V7KWCDW7XR": {
+        "bakedName": "LookupRun",
+        "curName": "LookupRun",
+        "id": "trt_01KYBMJJT4887BT5V7KWCDW7XR",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-ml-lookup",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "default": false,
+            "name": "matched",
+            "type": "boolean"
+          },
+          {
+            "default": "idle",
+            "name": "status",
+            "type": "string",
+            "values": [
+              "idle",
+              "checked"
+            ]
+          }
+        ],
+        "id": "ent_01KYBMJJT4DMQ50X37K7WJ7XDD",
+        "name": "KeyLookup",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYBMJJT4GF4NBRN7SX8PTDSE",
+      "name": "MlLookupOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYBMJJT4GJK8ZDFRAM7HJ9HR",
+          "name": "MlLookupPage",
+          "path": "/ml-lookup",
+          "traits": [
+            {
+              "ref": "LookupRun",
+              "refId": "trt_01KYBMJJT4887BT5V7KWCDW7XR"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "matchField": {
+              "default": "",
+              "description": "When the accepted list holds objects rather than scalars, the field to compare against the candidate; empty compares each element itself",
+              "label": "Match field",
+              "tier": "domain",
+              "type": "string"
+            },
+            "normalize": {
+              "default": true,
+              "description": "Trim and lowercase both sides before comparing",
+              "label": "Normalize",
+              "tier": "policy",
+              "type": "boolean"
+            }
+          },
+          "emits": [
+            {
+              "description": "Fired when the candidate matches an entry in the accepted list",
+              "event": "KEY_HIT",
+              "eventId": "evt_01KYBMJJT4XY85SQDER4Q9CHW1",
+              "payloadSchema": [
+                {
+                  "name": "candidate",
+                  "required": true,
+                  "type": "any"
+                },
+                {
+                  "name": "entry",
+                  "required": true,
+                  "type": "any"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            },
+            {
+              "description": "Abstain — candidate matches nothing in the accepted list; the next rung should take over. request echoes the originating request untouched so the next rung can project its own inputs out of it",
+              "event": "KEY_MISS",
+              "eventId": "evt_01KYBMJJT48QRYPT14NG0GMXMY",
+              "payloadSchema": [
+                {
+                  "name": "candidate",
+                  "required": true,
+                  "type": "any"
+                },
+                {
+                  "name": "request",
+                  "type": "object"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            }
+          ],
+          "entityRefIds": {
+            "KeyLookup": "ent_01KYBMJJT4DMQ50X37K7WJ7XDD"
+          },
+          "id": "trt_01KYBMJJT4887BT5V7KWCDW7XR",
+          "linkedEntity": "KeyLookup",
+          "linkedEntityId": "ent_01KYBMJJT4DMQ50X37K7WJ7XDD",
+          "name": "LookupRun",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYBMJJT4K8ANYTCSAH8QZ0JC",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01KYBMJJT4NBFQTG784CP78ERD",
+                "key": "LOOKUP",
+                "name": "Lookup",
+                "payloadSchema": [
+                  {
+                    "name": "candidate",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "accepted",
+                    "required": true,
+                    "type": "[any]"
+                  },
+                  {
+                    "name": "request",
+                    "type": "object"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01KYC09GZR0684YDEM0BAP2W5X",
+                "key": "RESET",
+                "name": "Reset"
+              },
+              {
+                "description": "Fired when the candidate matches an entry in the accepted list",
+                "id": "evt_01KYBMJJT4XY85SQDER4Q9CHW1",
+                "key": "KEY_HIT",
+                "name": "Key Hit",
+                "payloadSchema": [
+                  {
+                    "name": "candidate",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "entry",
+                    "required": true,
+                    "type": "any"
+                  }
+                ],
+                "tier": "primary"
+              },
+              {
+                "description": "Abstain — candidate matches nothing in the accepted list; the next rung should take over. request echoes the originating request untouched so the next rung can project its own inputs out of it",
+                "id": "evt_01KYBMJJT48QRYPT14NG0GMXMY",
+                "key": "KEY_MISS",
+                "name": "Key Miss",
+                "payloadSchema": [
+                  {
+                    "name": "candidate",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "request",
+                    "type": "object"
+                  }
+                ],
+                "tier": "primary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              },
+              {
+                "name": "checked"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.matched",
+                    false
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYBMJJT4K8ANYTCSAH8QZ0JC",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "let",
+                    [
+                      [
+                        "candStr",
+                        [
+                          "str/concat",
+                          "@payload.candidate"
+                        ]
+                      ],
+                      [
+                        "candNorm",
+                        [
+                          "if",
+                          "@config.normalize",
+                          [
+                            "str/lower",
+                            [
+                              "str/trim",
+                              "@candStr"
+                            ]
+                          ],
+                          "@candStr"
+                        ]
+                      ],
+                      [
+                        "found",
+                        [
+                          "array/find",
+                          "@payload.accepted",
+                          [
+                            "fn",
+                            "item",
+                            [
+                              "let",
+                              [
+                                [
+                                  "raw",
+                                  [
+                                    "if",
+                                    [
+                                      "==",
+                                      "@config.matchField",
+                                      ""
+                                    ],
+                                    "@item",
+                                    [
+                                      "object/get",
+                                      "@item",
+                                      "@config.matchField"
+                                    ]
+                                  ]
+                                ],
+                                [
+                                  "rawStr",
+                                  [
+                                    "str/concat",
+                                    "@raw"
+                                  ]
+                                ],
+                                [
+                                  "rawNorm",
+                                  [
+                                    "if",
+                                    "@config.normalize",
+                                    [
+                                      "str/lower",
+                                      [
+                                        "str/trim",
+                                        "@rawStr"
+                                      ]
+                                    ],
+                                    "@rawStr"
+                                  ]
+                                ]
+                              ],
+                              [
+                                "==",
+                                "@rawNorm",
+                                "@candNorm"
+                              ]
+                            ]
+                          ]
+                        ]
+                      ]
+                    ],
+                    [
+                      "if",
+                      [
+                        "!=",
+                        "@found",
+                        null
+                      ],
+                      [
+                        "do",
+                        [
+                          "set",
+                          "@entity.matched",
+                          true
+                        ],
+                        [
+                          "set",
+                          "@entity.status",
+                          "checked"
+                        ],
+                        [
+                          "emit",
+                          "KEY_HIT",
+                          {
+                            "candidate": "@payload.candidate",
+                            "entry": "@found"
+                          }
+                        ]
+                      ],
+                      [
+                        "do",
+                        [
+                          "set",
+                          "@entity.matched",
+                          false
+                        ],
+                        [
+                          "set",
+                          "@entity.status",
+                          "checked"
+                        ],
+                        [
+                          "emit",
+                          "KEY_MISS",
+                          {
+                            "candidate": "@payload.candidate",
+                            "request": "@payload.request"
+                          }
+                        ]
+                      ]
+                    ]
+                  ]
+                ],
+                "event": "LOOKUP",
+                "eventId": "evt_01KYBMJJT4NBFQTG784CP78ERD",
+                "from": "idle",
+                "to": "checked"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "checked"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYBMJJT4K8ANYTCSAH8QZ0JC",
+                "from": "checked",
+                "to": "checked"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.matched",
+                    false
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "RESET",
+                "eventId": "evt_01KYC09GZR0684YDEM0BAP2W5X",
+                "from": "checked",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}