@almadar/std 16.143.0 → 16.145.0

package/dist/behaviors/registry/ml/atoms/std-ml-infer.orb

@@ -0,0 +1,770 @@
+{
+  "description": "std-ml-infer — the learned rung (R4) of the intelligence ladder, and the seam between a .lolo circuit and a trained model deployed on masar (or off-the-shelf HuggingFace weights) reached through the ml service. Sends the caller-supplied input straight to call-service ml infer, then guards the raw output before it ever becomes an effect: validates it against the declared outputContract, clamps it into range, and only then decides. Emits INFERRED when the output satisfies the contract and confidence clears confidenceFloor — carrying the clamped output, confidence, and an empty violations list. Otherwise abstains with INFER_ABSTAINED, whose reason is one of: low confidence (contract satisfied but below floor, violations empty), contract violation (violations populated via contract/violations for diagnosis), or unavailable (the service call itself failed — a masar cold start or a down endpoint, never surfaced as a user-visible error). Use when a numeric or tensor-shaped model answer needs a licensed guard before becoming a decision — classification scores, regressions, embedding-derived predictions — and the next rung (R5 generative) should take over on any abstain.",
+  "ledger": {
+    "entries": {
+      "ent_01KYBPCRRYA4RY273R7TFF3VRF": {
+        "bakedName": "Inference",
+        "curName": "Inference",
+        "id": "ent_01KYBPCRRYA4RY273R7TFF3VRF",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYBPCRRY1764RNVM07X1HN1W": {
+        "bakedName": "RESET",
+        "curName": "RESET",
+        "id": "evt_01KYBPCRRY1764RNVM07X1HN1W",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+        "renames": []
+      },
+      "evt_01KYBPCRRY2FMY57YT8MYD3NWX": {
+        "bakedName": "INFER_CALL_FAILED",
+        "curName": "INFER_CALL_FAILED",
+        "id": "evt_01KYBPCRRY2FMY57YT8MYD3NWX",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+        "renames": []
+      },
+      "evt_01KYBPCRRY466WKYEHEYJJD4NJ": {
+        "bakedName": "INFER_ABSTAINED",
+        "curName": "INFER_ABSTAINED",
+        "id": "evt_01KYBPCRRY466WKYEHEYJJD4NJ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+        "renames": []
+      },
+      "evt_01KYBPCRRY49ZNB6TD5ZPAY80T": {
+        "bakedName": "INFERRED_RAW",
+        "curName": "INFERRED_RAW",
+        "id": "evt_01KYBPCRRY49ZNB6TD5ZPAY80T",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+        "renames": []
+      },
+      "evt_01KYBPCRRYDEDF9WYPE4KRR2Q6": {
+        "bakedName": "INFERRED",
+        "curName": "INFERRED",
+        "id": "evt_01KYBPCRRYDEDF9WYPE4KRR2Q6",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+        "renames": []
+      },
+      "evt_01KYBPCRRYVWRB6GXDRKPNX561": {
+        "bakedName": "INFER",
+        "curName": "INFER",
+        "id": "evt_01KYBPCRRYVWRB6GXDRKPNX561",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+        "renames": []
+      },
+      "evt_01KYBPCRRYXAYYDX6TXDJ6ZD49": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYBPCRRYXAYYDX6TXDJ6ZD49",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+        "renames": []
+      },
+      "orb_01KYBPCRRYEW3P2BD0V50BY174": {
+        "bakedName": "MlInferOrbital",
+        "curName": "MlInferOrbital",
+        "id": "orb_01KYBPCRRYEW3P2BD0V50BY174",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYBPCRRY18XQ2SBPNFRTP0SN": {
+        "bakedName": "MlInferPage",
+        "curName": "MlInferPage",
+        "id": "pag_01KYBPCRRY18XQ2SBPNFRTP0SN",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX": {
+        "bakedName": "InferenceRun",
+        "curName": "InferenceRun",
+        "id": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-ml-infer",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "default": {},
+            "name": "input",
+            "type": "object"
+          },
+          {
+            "default": [],
+            "items": {
+              "type": "number"
+            },
+            "name": "output",
+            "type": "array"
+          },
+          {
+            "default": 0.0,
+            "name": "confidence",
+            "type": "number"
+          },
+          {
+            "default": [],
+            "items": {
+              "type": "object"
+            },
+            "name": "violations",
+            "type": "array"
+          },
+          {
+            "default": "",
+            "name": "reason",
+            "type": "string"
+          },
+          {
+            "default": {},
+            "name": "request",
+            "type": "object"
+          },
+          {
+            "default": "idle",
+            "name": "status",
+            "type": "string",
+            "values": [
+              "idle",
+              "inferring",
+              "resolved"
+            ]
+          }
+        ],
+        "id": "ent_01KYBPCRRYA4RY273R7TFF3VRF",
+        "name": "Inference",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYBPCRRYEW3P2BD0V50BY174",
+      "name": "MlInferOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYBPCRRY18XQ2SBPNFRTP0SN",
+          "name": "MlInferPage",
+          "path": "/ml-infer",
+          "traits": [
+            {
+              "ref": "InferenceRun",
+              "refId": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "confidenceFloor": {
+              "default": 0.7,
+              "description": "Minimum service-reported confidence required to answer; below this the atom abstains with reason low confidence",
+              "label": "Confidence floor",
+              "tier": "policy",
+              "type": "float"
+            },
+            "model": {
+              "default": "",
+              "description": "hf:<id> for off-the-shelf weights, or a masar checkpoint id, forwarded to the ml service infer action",
+              "label": "Model reference",
+              "tier": "infra",
+              "type": "string"
+            },
+            "outputContract": {
+              "default": {
+                "ranges": {}
+              },
+              "description": "Declared shape and per-dimension ranges the model output must satisfy; a failing check abstains with reason contract violation. Omit shape to assert ranges only — an empty shape [] asserts a SCALAR output, it does not mean unconstrained",
+              "label": "Output contract",
+              "properties": {
+                "ranges": {
+                  "items": {
+                    "properties": {
+                      "max": {
+                        "name": "max",
+                        "required": true,
+                        "type": "number"
+                      },
+                      "min": {
+                        "name": "min",
+                        "required": true,
+                        "type": "number"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "ranges",
+                  "required": false,
+                  "type": "object"
+                },
+                "shape": {
+                  "items": {
+                    "type": "number"
+                  },
+                  "name": "shape",
+                  "required": false,
+                  "type": "array"
+                }
+              },
+              "tier": "domain",
+              "type": "OutputContract"
+            }
+          },
+          "emits": [
+            {
+              "description": "Raw ml.infer service result, flattened onto the payload by the call-service effect executor",
+              "event": "INFERRED_RAW",
+              "eventId": "evt_01KYBPCRRY49ZNB6TD5ZPAY80T",
+              "payloadSchema": [
+                {
+                  "name": "output",
+                  "required": true,
+                  "type": "[float]"
+                },
+                {
+                  "name": "confidence",
+                  "required": true,
+                  "type": "number"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "call-service infer failure signal — a masar cold start or a down endpoint lands here, not as a user-visible error",
+              "event": "INFER_CALL_FAILED",
+              "eventId": "evt_01KYBPCRRY2FMY57YT8MYD3NWX",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "The service answered, the output satisfies outputContract, and confidence clears confidenceFloor — output already clamped",
+              "event": "INFERRED",
+              "eventId": "evt_01KYBPCRRYDEDF9WYPE4KRR2Q6",
+              "payloadSchema": [
+                {
+                  "name": "output",
+                  "required": true,
+                  "type": "[float]"
+                },
+                {
+                  "name": "confidence",
+                  "required": true,
+                  "type": "float"
+                },
+                {
+                  "name": "violations",
+                  "required": true,
+                  "type": "[object]"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            },
+            {
+              "description": "The abstain — reason is one of: low confidence, contract violation, unavailable. violations is populated only on the contract violation path. request echoes the originating request untouched so the next rung can project its own inputs out of it",
+              "event": "INFER_ABSTAINED",
+              "eventId": "evt_01KYBPCRRY466WKYEHEYJJD4NJ",
+              "payloadSchema": [
+                {
+                  "name": "reason",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "violations",
+                  "required": true,
+                  "type": "[object]"
+                },
+                {
+                  "name": "request",
+                  "type": "object"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            }
+          ],
+          "entityRefIds": {
+            "Inference": "ent_01KYBPCRRYA4RY273R7TFF3VRF"
+          },
+          "id": "trt_01KYBPCRRYRDWPJQ44M6MKZ2YX",
+          "linkedEntity": "Inference",
+          "linkedEntityId": "ent_01KYBPCRRYA4RY273R7TFF3VRF",
+          "name": "InferenceRun",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYBPCRRYXAYYDX6TXDJ6ZD49",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01KYBPCRRYVWRB6GXDRKPNX561",
+                "key": "INFER",
+                "name": "Infer",
+                "payloadSchema": [
+                  {
+                    "name": "input",
+                    "required": true,
+                    "type": "object"
+                  },
+                  {
+                    "name": "request",
+                    "type": "object"
+                  }
+                ]
+              },
+              {
+                "description": "Raw ml.infer service result, flattened onto the payload by the call-service effect executor",
+                "id": "evt_01KYBPCRRY49ZNB6TD5ZPAY80T",
+                "key": "INFERRED_RAW",
+                "name": "Inferred Raw",
+                "payloadSchema": [
+                  {
+                    "name": "output",
+                    "required": true,
+                    "type": "[float]"
+                  },
+                  {
+                    "name": "confidence",
+                    "required": true,
+                    "type": "number"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "call-service infer failure signal — a masar cold start or a down endpoint lands here, not as a user-visible error",
+                "id": "evt_01KYBPCRRY2FMY57YT8MYD3NWX",
+                "key": "INFER_CALL_FAILED",
+                "name": "Infer Call Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "id": "evt_01KYBPCRRY1764RNVM07X1HN1W",
+                "key": "RESET",
+                "name": "Reset"
+              },
+              {
+                "description": "The service answered, the output satisfies outputContract, and confidence clears confidenceFloor — output already clamped",
+                "id": "evt_01KYBPCRRYDEDF9WYPE4KRR2Q6",
+                "key": "INFERRED",
+                "name": "Inferred",
+                "payloadSchema": [
+                  {
+                    "name": "output",
+                    "required": true,
+                    "type": "[float]"
+                  },
+                  {
+                    "name": "confidence",
+                    "required": true,
+                    "type": "float"
+                  },
+                  {
+                    "name": "violations",
+                    "required": true,
+                    "type": "[object]"
+                  }
+                ],
+                "tier": "primary"
+              },
+              {
+                "description": "The abstain — reason is one of: low confidence, contract violation, unavailable. violations is populated only on the contract violation path. request echoes the originating request untouched so the next rung can project its own inputs out of it",
+                "id": "evt_01KYBPCRRY466WKYEHEYJJD4NJ",
+                "key": "INFER_ABSTAINED",
+                "name": "Infer Abstained",
+                "payloadSchema": [
+                  {
+                    "name": "reason",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "violations",
+                    "required": true,
+                    "type": "[object]"
+                  },
+                  {
+                    "name": "request",
+                    "type": "object"
+                  }
+                ],
+                "tier": "primary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              },
+              {
+                "name": "inferring"
+              },
+              {
+                "name": "resolved"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.input",
+                    {}
+                  ],
+                  [
+                    "set",
+                    "@entity.output",
+                    []
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.violations",
+                    []
+                  ],
+                  [
+                    "set",
+                    "@entity.reason",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.request",
+                    {}
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYBPCRRYXAYYDX6TXDJ6ZD49",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.input",
+                    "@payload.input"
+                  ],
+                  [
+                    "set",
+                    "@entity.request",
+                    "@payload.request"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "inferring"
+                  ],
+                  [
+                    "call-service",
+                    "ml",
+                    "infer",
+                    {
+                      "input": "@entity.input",
+                      "model": "@config.model"
+                    },
+                    {
+                      "emit": {
+                        "failure": "INFER_CALL_FAILED",
+                        "success": "INFERRED_RAW"
+                      }
+                    }
+                  ]
+                ],
+                "event": "INFER",
+                "eventId": "evt_01KYBPCRRYVWRB6GXDRKPNX561",
+                "from": "idle",
+                "to": "inferring"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.output",
+                    "@payload.output"
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    "@payload.confidence"
+                  ],
+                  [
+                    "let",
+                    [
+                      [
+                        "validation",
+                        [
+                          "contract/validate-output",
+                          "@entity.output",
+                          "@config.outputContract"
+                        ]
+                      ]
+                    ],
+                    [
+                      "if",
+                      [
+                        "object/get",
+                        "@validation",
+                        "valid"
+                      ],
+                      [
+                        "if",
+                        [
+                          ">=",
+                          "@entity.confidence",
+                          "@config.confidenceFloor"
+                        ],
+                        [
+                          "do",
+                          [
+                            "set",
+                            "@entity.output",
+                            [
+                              "contract/clamp-output",
+                              "@entity.output",
+                              "@config.outputContract"
+                            ]
+                          ],
+                          [
+                            "set",
+                            "@entity.violations",
+                            []
+                          ],
+                          [
+                            "set",
+                            "@entity.reason",
+                            ""
+                          ],
+                          [
+                            "set",
+                            "@entity.status",
+                            "resolved"
+                          ],
+                          [
+                            "emit",
+                            "INFERRED",
+                            {
+                              "confidence": "@entity.confidence",
+                              "output": "@entity.output",
+                              "violations": "@entity.violations"
+                            }
+                          ]
+                        ],
+                        [
+                          "do",
+                          [
+                            "set",
+                            "@entity.violations",
+                            []
+                          ],
+                          [
+                            "set",
+                            "@entity.reason",
+                            "low confidence"
+                          ],
+                          [
+                            "set",
+                            "@entity.status",
+                            "resolved"
+                          ],
+                          [
+                            "emit",
+                            "INFER_ABSTAINED",
+                            {
+                              "reason": "low confidence",
+                              "request": "@entity.request",
+                              "violations": "@entity.violations"
+                            }
+                          ]
+                        ]
+                      ],
+                      [
+                        "do",
+                        [
+                          "set",
+                          "@entity.violations",
+                          [
+                            "contract/violations",
+                            "@entity.output",
+                            "@config.outputContract"
+                          ]
+                        ],
+                        [
+                          "set",
+                          "@entity.reason",
+                          "contract violation"
+                        ],
+                        [
+                          "set",
+                          "@entity.status",
+                          "resolved"
+                        ],
+                        [
+                          "emit",
+                          "INFER_ABSTAINED",
+                          {
+                            "reason": "contract violation",
+                            "request": "@entity.request",
+                            "violations": "@entity.violations"
+                          }
+                        ]
+                      ]
+                    ]
+                  ]
+                ],
+                "event": "INFERRED_RAW",
+                "eventId": "evt_01KYBPCRRY49ZNB6TD5ZPAY80T",
+                "from": "inferring",
+                "to": "resolved"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.output",
+                    []
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.violations",
+                    []
+                  ],
+                  [
+                    "set",
+                    "@entity.reason",
+                    "unavailable"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "resolved"
+                  ],
+                  [
+                    "emit",
+                    "INFER_ABSTAINED",
+                    {
+                      "reason": "unavailable",
+                      "request": "@entity.request",
+                      "violations": "@entity.violations"
+                    }
+                  ]
+                ],
+                "event": "INFER_CALL_FAILED",
+                "eventId": "evt_01KYBPCRRY2FMY57YT8MYD3NWX",
+                "from": "inferring",
+                "to": "resolved"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "resolved"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYBPCRRYXAYYDX6TXDJ6ZD49",
+                "from": "resolved",
+                "to": "resolved"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.input",
+                    {}
+                  ],
+                  [
+                    "set",
+                    "@entity.output",
+                    []
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.violations",
+                    []
+                  ],
+                  [
+                    "set",
+                    "@entity.reason",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.request",
+                    {}
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "RESET",
+                "eventId": "evt_01KYBPCRRY1764RNVM07X1HN1W",
+                "from": "resolved",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}