@almadar/std 16.144.0 → 16.146.0

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

@@ -0,0 +1,622 @@
+{
+  "description": "Generative rung (R5) — structured LLM verdict from a closed category set, via the llm.classify service seam. Bottom of the fall-through: always answers or fails, never abstains.",
+  "ledger": {
+    "entries": {
+      "ent_01KYBN0QT3HD015YZ1STMQFY82": {
+        "bakedName": "ClassifierVerdict",
+        "curName": "ClassifierVerdict",
+        "id": "ent_01KYBN0QT3HD015YZ1STMQFY82",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYBN0QT30XVF7W16J30ANCMJ": {
+        "bakedName": "CLASSIFY",
+        "curName": "CLASSIFY",
+        "id": "evt_01KYBN0QT30XVF7W16J30ANCMJ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+        "renames": []
+      },
+      "evt_01KYBN0QT35ZC6DMT51562ZVB7": {
+        "bakedName": "CLASSIFIED_RAW",
+        "curName": "CLASSIFIED_RAW",
+        "id": "evt_01KYBN0QT35ZC6DMT51562ZVB7",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+        "renames": []
+      },
+      "evt_01KYBN0QT3CDGRK7KXX3Q0BZYF": {
+        "bakedName": "RESET",
+        "curName": "RESET",
+        "id": "evt_01KYBN0QT3CDGRK7KXX3Q0BZYF",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+        "renames": []
+      },
+      "evt_01KYBN0QT3EA98HV7HR0KHMATC": {
+        "bakedName": "CLASSIFIED",
+        "curName": "CLASSIFIED",
+        "id": "evt_01KYBN0QT3EA98HV7HR0KHMATC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+        "renames": []
+      },
+      "evt_01KYBN0QT3KCCWJWNER5MRE69Z": {
+        "bakedName": "CLASSIFY_CALL_FAILED",
+        "curName": "CLASSIFY_CALL_FAILED",
+        "id": "evt_01KYBN0QT3KCCWJWNER5MRE69Z",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+        "renames": []
+      },
+      "evt_01KYBN0QT3SYGKNNR4H6Z4MM0J": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYBN0QT3SYGKNNR4H6Z4MM0J",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+        "renames": []
+      },
+      "evt_01KYBN0QT4G0C4HKHV44ZW54NB": {
+        "bakedName": "CLASSIFY_FAILED",
+        "curName": "CLASSIFY_FAILED",
+        "id": "evt_01KYBN0QT4G0C4HKHV44ZW54NB",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+        "renames": []
+      },
+      "orb_01KYBN0QT323PSVR93E1FQ30HN": {
+        "bakedName": "MlClassifyOrbital",
+        "curName": "MlClassifyOrbital",
+        "id": "orb_01KYBN0QT323PSVR93E1FQ30HN",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYBN0QT49SGH6M9XJN4FPTR9": {
+        "bakedName": "MlClassifyPage",
+        "curName": "MlClassifyPage",
+        "id": "pag_01KYBN0QT49SGH6M9XJN4FPTR9",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBN0QT30GWRAF1975RP6W1M": {
+        "bakedName": "ClassifyRun",
+        "curName": "ClassifyRun",
+        "id": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-ml-classify",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "default": "",
+            "name": "text",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "name": "category",
+            "type": "string"
+          },
+          {
+            "default": 0.0,
+            "name": "confidence",
+            "type": "number"
+          },
+          {
+            "default": "",
+            "name": "reasoning",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "name": "errorMessage",
+            "type": "string"
+          },
+          {
+            "default": {},
+            "name": "request",
+            "type": "object"
+          },
+          {
+            "default": "idle",
+            "name": "status",
+            "type": "string",
+            "values": [
+              "idle",
+              "classifying",
+              "done"
+            ]
+          }
+        ],
+        "id": "ent_01KYBN0QT3HD015YZ1STMQFY82",
+        "name": "ClassifierVerdict",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYBN0QT323PSVR93E1FQ30HN",
+      "name": "MlClassifyOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYBN0QT49SGH6M9XJN4FPTR9",
+          "name": "MlClassifyPage",
+          "path": "/ml-classify",
+          "traits": [
+            {
+              "ref": "ClassifyRun",
+              "refId": "trt_01KYBN0QT30GWRAF1975RP6W1M"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "categories": {
+              "default": [],
+              "description": "Closed set of category labels the LLM must choose from",
+              "items": {
+                "type": "string"
+              },
+              "label": "Categories",
+              "tier": "domain",
+              "type": "[string]"
+            },
+            "model": {
+              "default": "",
+              "description": "Model override forwarded to the classify call",
+              "label": "Model",
+              "tier": "infra",
+              "type": "string"
+            },
+            "provider": {
+              "default": "",
+              "description": "Reserved for provider selection; LLMServiceActions.classify (packages/almadar-llm/src/contracts.ts) takes no provider param today, so this knob is not forwarded to the call",
+              "label": "Provider",
+              "tier": "infra",
+              "type": "string"
+            }
+          },
+          "emits": [
+            {
+              "description": "Raw llm.classify service result, flattened onto the payload by the call-service effect executor",
+              "event": "CLASSIFIED_RAW",
+              "eventId": "evt_01KYBN0QT35ZC6DMT51562ZVB7",
+              "payloadSchema": [
+                {
+                  "name": "category",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "confidence",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "reasoning",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "call-service classify failure signal",
+              "event": "CLASSIFY_CALL_FAILED",
+              "eventId": "evt_01KYBN0QT3KCCWJWNER5MRE69Z",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "Structured LLM verdict — closed-set category with confidence and reasoning",
+              "event": "CLASSIFIED",
+              "eventId": "evt_01KYBN0QT3EA98HV7HR0KHMATC",
+              "payloadSchema": [
+                {
+                  "name": "category",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "confidence",
+                  "required": true,
+                  "type": "float"
+                },
+                {
+                  "name": "reasoning",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            },
+            {
+              "description": "The classify service call failed; this rung never abstains, only answers or fails",
+              "event": "CLASSIFY_FAILED",
+              "eventId": "evt_01KYBN0QT4G0C4HKHV44ZW54NB",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            }
+          ],
+          "entityRefIds": {
+            "ClassifierVerdict": "ent_01KYBN0QT3HD015YZ1STMQFY82"
+          },
+          "id": "trt_01KYBN0QT30GWRAF1975RP6W1M",
+          "linkedEntity": "ClassifierVerdict",
+          "linkedEntityId": "ent_01KYBN0QT3HD015YZ1STMQFY82",
+          "name": "ClassifyRun",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYBN0QT3SYGKNNR4H6Z4MM0J",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01KYBN0QT30XVF7W16J30ANCMJ",
+                "key": "CLASSIFY",
+                "name": "Classify",
+                "payloadSchema": [
+                  {
+                    "name": "text",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "request",
+                    "type": "object"
+                  }
+                ]
+              },
+              {
+                "description": "Raw llm.classify service result, flattened onto the payload by the call-service effect executor",
+                "id": "evt_01KYBN0QT35ZC6DMT51562ZVB7",
+                "key": "CLASSIFIED_RAW",
+                "name": "Classified Raw",
+                "payloadSchema": [
+                  {
+                    "name": "category",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "confidence",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "reasoning",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "call-service classify failure signal",
+                "id": "evt_01KYBN0QT3KCCWJWNER5MRE69Z",
+                "key": "CLASSIFY_CALL_FAILED",
+                "name": "Classify Call Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "id": "evt_01KYBN0QT3CDGRK7KXX3Q0BZYF",
+                "key": "RESET",
+                "name": "Reset"
+              },
+              {
+                "description": "Structured LLM verdict — closed-set category with confidence and reasoning",
+                "id": "evt_01KYBN0QT3EA98HV7HR0KHMATC",
+                "key": "CLASSIFIED",
+                "name": "Classified",
+                "payloadSchema": [
+                  {
+                    "name": "category",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "confidence",
+                    "required": true,
+                    "type": "float"
+                  },
+                  {
+                    "name": "reasoning",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "primary"
+              },
+              {
+                "description": "The classify service call failed; this rung never abstains, only answers or fails",
+                "id": "evt_01KYBN0QT4G0C4HKHV44ZW54NB",
+                "key": "CLASSIFY_FAILED",
+                "name": "Classify Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "primary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              },
+              {
+                "name": "classifying"
+              },
+              {
+                "name": "done"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.text",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.category",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.errorMessage",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.request",
+                    {}
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYBN0QT3SYGKNNR4H6Z4MM0J",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.text",
+                    "@payload.text"
+                  ],
+                  [
+                    "set",
+                    "@entity.request",
+                    "@payload.request"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "classifying"
+                  ],
+                  [
+                    "call-service",
+                    "llm",
+                    "classify",
+                    {
+                      "categories": "@config.categories",
+                      "model": "@config.model",
+                      "text": "@payload.text"
+                    },
+                    {
+                      "emit": {
+                        "failure": "CLASSIFY_CALL_FAILED",
+                        "success": "CLASSIFIED_RAW"
+                      }
+                    }
+                  ]
+                ],
+                "event": "CLASSIFY",
+                "eventId": "evt_01KYBN0QT30XVF7W16J30ANCMJ",
+                "from": "idle",
+                "to": "classifying"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.category",
+                    "@payload.category"
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    "@payload.confidence"
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    "@payload.reasoning"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "done"
+                  ],
+                  [
+                    "emit",
+                    "CLASSIFIED",
+                    {
+                      "category": "@entity.category",
+                      "confidence": "@entity.confidence",
+                      "reasoning": "@entity.reasoning"
+                    }
+                  ]
+                ],
+                "event": "CLASSIFIED_RAW",
+                "eventId": "evt_01KYBN0QT35ZC6DMT51562ZVB7",
+                "from": "classifying",
+                "to": "done"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.category",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.errorMessage",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "done"
+                  ],
+                  [
+                    "emit",
+                    "CLASSIFY_FAILED",
+                    {
+                      "error": "@entity.errorMessage"
+                    }
+                  ]
+                ],
+                "event": "CLASSIFY_CALL_FAILED",
+                "eventId": "evt_01KYBN0QT3KCCWJWNER5MRE69Z",
+                "from": "classifying",
+                "to": "done"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "done"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYBN0QT3SYGKNNR4H6Z4MM0J",
+                "from": "done",
+                "to": "done"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.text",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.category",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.errorMessage",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.request",
+                    {}
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "RESET",
+                "eventId": "evt_01KYBN0QT3CDGRK7KXX3Q0BZYF",
+                "from": "done",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}