@bglocation/tune-context 2.4.0 → 3.0.0

package/eval/arm.mjs

@@ -96,13 +96,17 @@ export function ledgerArmAt(entries, tsIso) {
  * The row's timestamp: when the prompt was submitted, or the first **readable**
  * one of the remaining fields.
  *
- * One definition for both readers (the ledger window and `pass_order`), because
- * two of them already drifted apart once: `??` only falls through on null, so it
+ * One definition for every reader — the ledger window, `pass_order`, and the
+ * natural-work attribution in analyze.mjs (TASK-089), which asks the same ledger
+ * the same question about a row that is NOT on an `exp/` branch. Exported for
+ * that reason: a second "when did this row happen" would be a second answer.
+ *
+ * Two of these readers already drifted apart once: `??` only falls through on null, so it
  * stopped at a `ts_submit` that was a string but unparseable — and a row the
  * ledger DID cover came out as `conflict:no-ledger-entry`, i.e. a run to be
  * repeated (§7) because of a cosmetic defect in the data.
  */
-function rowTs(row) {
+export function rowTimestamp(row) {
   for (const value of [row.ts_submit, row.ts_first_assistant, row.ts_end]) {
     if (msOf(value) !== null) return value;
   }
@@ -110,7 +114,7 @@ function rowTs(row) {
 }
 
 function rowMs(row) {
-  return msOf(rowTs(row));
+  return msOf(rowTimestamp(row));
 }
 
 function armFields(row, { ledger, ledgerAvailable }) {
@@ -133,7 +137,7 @@ function armFields(row, { ledger, ledgerAvailable }) {
     return { exp_task: parsed.task, exp_arm: parsed.arm, exp_arm_source: 'branch', exp_ledger_arm: '' };
   }
 
-  const fromLedger = ledgerArmAt(ledger, rowTs(row));
+  const fromLedger = ledgerArmAt(ledger, rowTimestamp(row));
   if (fromLedger === null) {
     return { exp_task: parsed.task, exp_arm: '', exp_arm_source: 'conflict:no-ledger-entry', exp_ledger_arm: '' };
   }

package/eval/pricing.mjs

@@ -115,7 +115,29 @@ export const GEO_MULTIPLIERS = { global: 1, not_available: 1, us: 1.1 };
 /** $10 per 1,000 searches. Web FETCH is free — only search is billed. */
 export const WEB_SEARCH_USD = 0.01;
 
-const TOKEN_CLASSES = ['input', 'cache_read', 'cache_write_5m', 'cache_write_1h', 'output'];
+/**
+ * The five priced classes, paired with the field each one is read from on a
+ * prompt-metrics row. Two vocabularies for one fact — `input`/`output` are cost
+ * classes, `input_tokens`/`output_tokens` are row fields — and this is the one
+ * place that knows the translation, because costOfTokens() below is already its
+ * other reader. Anything that folds tokens up (eval/analyze.mjs) reads it from
+ * here rather than retyping the list: a sixth class added to the collector's
+ * emptyTokens() must not be able to fall out of a downstream total by being
+ * forgotten in a hand-written array.
+ *
+ * `cache_write_unsplit` is deliberately NOT here. It is not a priced class — it
+ * is the admission that a write's TTL is unknown, and a row carrying it is
+ * refused rather than priced.
+ */
+export const TOKEN_CLASS_FIELDS = [
+  ['input', 'input_tokens'],
+  ['cache_read', 'cache_read'],
+  ['cache_write_5m', 'cache_write_5m'],
+  ['cache_write_1h', 'cache_write_1h'],
+  ['output', 'output_tokens'],
+];
+
+const TOKEN_CLASSES = TOKEN_CLASS_FIELDS.map(([className]) => className);
 
 function emptyCost() {
   return Object.fromEntries(TOKEN_CLASSES.map((c) => [c, 0]));
@@ -371,6 +393,15 @@ function usd(n) {
   return `$${n.toFixed(4)}`;
 }
 
+/**
+ * An amount for human eyes, including the case where there is none. An
+ * uncomputable total prints as the word, never as `$0.0000` — the whole file
+ * exists to stop an unknown cost reading as a cheap one.
+ */
+export function formatUsd(n) {
+  return Number.isFinite(n) ? usd(n) : 'unknown (NOT $0)';
+}
+
 function count(n) {
   return n.toLocaleString('en-US');
 }