@almadar/std 16.143.0 → 16.145.0

package/behaviors/registry/ml/atoms/std-ml-label-capture.orb

@@ -0,0 +1,367 @@
+{
+  "description": "std-ml-label-capture — records a labeled example (input, verdict, source rung, observed outcome) so that expensive top-rung answers become training data for a cheaper rung later. Generic: it knows nothing about grading or students. sampleRate gates what fraction of examples are kept (1 = capture all); sink tags which named destination the example is attributed to.",
+  "ledger": {
+    "entries": {
+      "ent_01KYBM8SK7FG0R2GXW69YPGA2M": {
+        "bakedName": "LabeledExample",
+        "curName": "LabeledExample",
+        "id": "ent_01KYBM8SK7FG0R2GXW69YPGA2M",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYBM8SK86WYGVMBYJKQ9J3AG": {
+        "bakedName": "LABEL_CAPTURED",
+        "curName": "LABEL_CAPTURED",
+        "id": "evt_01KYBM8SK86WYGVMBYJKQ9J3AG",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBM8SK85P7TQJB7PYMA4M7F",
+        "renames": []
+      },
+      "evt_01KYBM8SK8J7G5ZWPYH8WGW6TM": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYBM8SK8J7G5ZWPYH8WGW6TM",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBM8SK85P7TQJB7PYMA4M7F",
+        "renames": []
+      },
+      "evt_01KYBM8SK8NT8HZ2CR5Y8SAE19": {
+        "bakedName": "CAPTURE",
+        "curName": "CAPTURE",
+        "id": "evt_01KYBM8SK8NT8HZ2CR5Y8SAE19",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBM8SK85P7TQJB7PYMA4M7F",
+        "renames": []
+      },
+      "orb_01KYBM8SK73XT1SZTRNEF8YTQ5": {
+        "bakedName": "MlLabelCaptureOrbital",
+        "curName": "MlLabelCaptureOrbital",
+        "id": "orb_01KYBM8SK73XT1SZTRNEF8YTQ5",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYBM8SK8KGFQFKA4WST4DAFM": {
+        "bakedName": "MlLabelCapturePage",
+        "curName": "MlLabelCapturePage",
+        "id": "pag_01KYBM8SK8KGFQFKA4WST4DAFM",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBM8SK85P7TQJB7PYMA4M7F": {
+        "bakedName": "LabelCaptureListener",
+        "curName": "LabelCaptureListener",
+        "id": "trt_01KYBM8SK85P7TQJB7PYMA4M7F",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-ml-label-capture",
+  "orbitals": [
+    {
+      "entity": {
+        "collection": "ml_labels",
+        "fields": [
+          {
+            "name": "id",
+            "primaryKey": true,
+            "required": true,
+            "type": "string"
+          },
+          {
+            "description": "The input that was judged.",
+            "name": "input",
+            "type": "string"
+          },
+          {
+            "description": "The verdict/output produced by the rung.",
+            "name": "verdict",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "Which rung produced the verdict.",
+            "name": "source",
+            "type": "string"
+          },
+          {
+            "description": "The observed ground-truth outcome, once known.",
+            "name": "outcome",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "Named destination this example is attributed to.",
+            "name": "sink",
+            "type": "string"
+          },
+          {
+            "default": 0.0,
+            "name": "recordedAt",
+            "type": "number"
+          }
+        ],
+        "id": "ent_01KYBM8SK7FG0R2GXW69YPGA2M",
+        "name": "LabeledExample",
+        "persistence": "persistent"
+      },
+      "id": "orb_01KYBM8SK73XT1SZTRNEF8YTQ5",
+      "name": "MlLabelCaptureOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYBM8SK8KGFQFKA4WST4DAFM",
+          "name": "MlLabelCapturePage",
+          "path": "/ml-label-capture",
+          "traits": [
+            {
+              "ref": "LabelCaptureListener",
+              "refId": "trt_01KYBM8SK85P7TQJB7PYMA4M7F"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "sampleRate": {
+              "default": 1.0,
+              "description": "Fraction of examples to keep (1 = capture all). A prob/flip trial per observation.",
+              "label": "Sample rate",
+              "tier": "policy",
+              "type": "float"
+            },
+            "sink": {
+              "default": "",
+              "description": "Named destination this batch of examples is attributed to; interpreted downstream (the physical label store is not yet decided).",
+              "label": "Label sink",
+              "tier": "infra",
+              "type": "string"
+            }
+          },
+          "emits": [
+            {
+              "description": "Fired after a labeled example is persisted.",
+              "event": "LABEL_CAPTURED",
+              "eventId": "evt_01KYBM8SK86WYGVMBYJKQ9J3AG",
+              "payloadSchema": [
+                {
+                  "name": "source",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "sink",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "input",
+              "outcome",
+              "recordedAt",
+              "sink",
+              "source",
+              "verdict"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "LabeledExample": "ent_01KYBM8SK7FG0R2GXW69YPGA2M"
+          },
+          "id": "trt_01KYBM8SK85P7TQJB7PYMA4M7F",
+          "linkedEntity": "LabeledExample",
+          "linkedEntityId": "ent_01KYBM8SK7FG0R2GXW69YPGA2M",
+          "name": "LabelCaptureListener",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYBM8SK8J7G5ZWPYH8WGW6TM",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01KYBM8SK8NT8HZ2CR5Y8SAE19",
+                "key": "CAPTURE",
+                "name": "Capture",
+                "payloadSchema": [
+                  {
+                    "name": "input",
+                    "required": true,
+                    "type": "json"
+                  },
+                  {
+                    "name": "verdict",
+                    "required": true,
+                    "type": "json"
+                  },
+                  {
+                    "name": "source",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "outcome",
+                    "type": "json"
+                  }
+                ]
+              },
+              {
+                "description": "Fired after a labeled example is persisted.",
+                "id": "evt_01KYBM8SK86WYGVMBYJKQ9J3AG",
+                "key": "LABEL_CAPTURED",
+                "name": "Label Captured",
+                "payloadSchema": [
+                  {
+                    "name": "source",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "sink",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "primary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.input",
+                    null
+                  ],
+                  [
+                    "set",
+                    "@entity.verdict",
+                    null
+                  ],
+                  [
+                    "set",
+                    "@entity.source",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.outcome",
+                    null
+                  ],
+                  [
+                    "set",
+                    "@entity.sink",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.recordedAt",
+                    0.0
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYBM8SK8J7G5ZWPYH8WGW6TM",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.input",
+                    "@payload.input"
+                  ],
+                  [
+                    "set",
+                    "@entity.verdict",
+                    "@payload.verdict"
+                  ],
+                  [
+                    "set",
+                    "@entity.source",
+                    "@payload.source"
+                  ],
+                  [
+                    "set",
+                    "@entity.outcome",
+                    "@payload.outcome"
+                  ],
+                  [
+                    "set",
+                    "@entity.sink",
+                    "@config.sink"
+                  ],
+                  [
+                    "set",
+                    "@entity.recordedAt",
+                    "@now"
+                  ],
+                  [
+                    "if",
+                    [
+                      "prob/flip",
+                      "@config.sampleRate"
+                    ],
+                    [
+                      "do",
+                      [
+                        "persist",
+                        "create",
+                        "LabeledExample",
+                        {
+                          "input": "@entity.input",
+                          "outcome": "@entity.outcome",
+                          "recordedAt": "@entity.recordedAt",
+                          "sink": "@entity.sink",
+                          "source": "@entity.source",
+                          "verdict": "@entity.verdict"
+                        }
+                      ],
+                      [
+                        "emit",
+                        "LABEL_CAPTURED",
+                        {
+                          "sink": "@entity.sink",
+                          "source": "@entity.source"
+                        }
+                      ]
+                    ],
+                    null
+                  ]
+                ],
+                "event": "CAPTURE",
+                "eventId": "evt_01KYBM8SK8NT8HZ2CR5Y8SAE19",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}