bitfab 0.72.0 → 0.73.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e1f7e41d0dcac668a09e2c2bf57e1d1c928ba5943e51d526e83a43009987369
-  data.tar.gz: 80600ab8d5c6a7230799d08b70346de0a68e79beded3858f4321c66f061456c0
+  metadata.gz: 1a30e89baf273769afece482948a0ff108d9a1a2481fad9b2edbcbf8169a344f
+  data.tar.gz: c6807a2ba664c08f1626b879242fab202a37859f0c8c3af2c833e6fc5df74b0d
 SHA512:
-  metadata.gz: 3d062220939f258721a0359f5cef0fecac374810b2203c8a74efafbe4f626b7e220249dd34beb5d91896154d6f560dc3a98347693e161f4615c51afb4464627c
-  data.tar.gz: b7d66ca98007fbdc7d6f0d334e909711be612ae9892316da02ad25e08dcc43cbb48853e110af5ec979edab56836ca5f4c67c72ec8d0c7121bbd27404dba43fac
+  metadata.gz: fffcdc93382999f0f4e087f8cdeab967768afebfc14ef98d9235257102604d5a9e2203d4953f5fa2f04e77c4656fdd14d08113276c5ccbb34162663bdd9a2180
+  data.tar.gz: 123101bb86a8eafa4fb4f89e86f1856a29e9d262adfc134b0fbad9ca505e9bf51b46532df51658509d1d7c54b7d7362c0faa8ebb71cd15b3cc880660eb4707a4

data/lib/bitfab/assertions.rb

@@ -32,11 +32,13 @@ module Bitfab
     # "kind" says who decides the assertion: "judge" (the LLM judge), "code"
     # ("code" decides every replay), or "hybrid" ("code" decides what it can
     # and returns "defer" for the rest). Send "code" or "hybrid" together with
-    # "code", {"source" => ..., "spanNames" => [...]}. "source" is the body of a
-    # TypeScript (or plain JavaScript) function called with spans (each
-    # {name, input, output, metadata}, in start order), input, and output,
-    # returning "pass", "fail", or "defer" (hybrid only), or {result, reason},
-    # within one second. "spanNames" lists every span a correct run is
+    # "code", {"source" => ..., "spanNames" => [...]}. "source" is the body of
+    # an async TypeScript (or plain JavaScript) function called with spans
+    # (each {name, index, hasData}, in start order, without its data), input,
+    # and output. It reads span data with await named("span name") or await
+    # span.data(), and returns "pass", "fail", or "defer" (hybrid only), or
+    # {result, reason}, with one second of compute and the data of at most 50
+    # spans loaded within ten seconds. "spanNames" lists every span a correct run is
     # expected to produce. Code that cannot run on the trace, or that returns
     # "defer" for a "code" assertion, is refused. Omit both to keep them, or
     # pass "kind" => "judge" to remove the code. Returned assertions carry

data/lib/bitfab/scenarios.rb

@@ -9,14 +9,22 @@ module Bitfab
     RECORDS_KEYS_IN_DATA = %w[records sources].freeze
     private_constant :RECORDS_KEYS_IN_DATA
 
+    # Reads the scenario built from trace_id, in any creation state, and returns its hash. "creationStatus" is
+    # "empty" when nothing has started building it, "generating" while Bitfab builds it or waits for the scenario
+    # callback to save it, "created" once it is built, and "error" when building failed, with "creationError" saying
+    # why. "trigger", "data", "triggerSummary", and "dataSummary" are nil until the scenario is built. After
+    # generate_scenario, poll this until "creationStatus" is "created" or "error". A trace with no scenario at all
+    # raises an error.
     def get_scenario(trace_id)
       @http_client.get(scenario_path(trace_id))["scenario"]
     end
 
-    # Starts building the scenario for trace_id and returns at once, without waiting for it. Read it later with
-    # get_scenario. Returns {"status", "traceId", "scenarioId"}: "status" is "started" while Bitfab builds it in the
-    # background, or "already_generated" when the trace already has a scenario, which is left as it is and named by
-    # "scenarioId". "scenarioId" is nil while the trace has no scenario yet.
+    # Starts building the scenario for trace_id and returns at once, without waiting for it. Poll get_scenario until
+    # its "creationStatus" is "created" or "error". Returns {"status", "traceId", "scenarioId", "creationStatus"}:
+    # "status" is "started" while Bitfab builds it in the background, or "already_generated" when the trace already
+    # has a scenario, which is left as it is and named by "scenarioId". A scenario whose build failed is started
+    # again. "scenarioId" is nil while the trace has no scenario yet, and "creationStatus" is the scenario's creation
+    # status right after the call.
     #
     # A replay, a trace outside the organization, or a trace Bitfab cannot build a scenario for (not
     # noah-agent-turn and no scenario callback) raises an error. Adding a trace to a dataset starts the same build

data/lib/bitfab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bitfab
-  VERSION = "0.72.0"
+  VERSION = "0.73.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bitfab
 version: !ruby/object:Gem::Version
-  version: 0.72.0
+  version: 0.73.0
 platform: ruby
 authors:
 - Harvest Team