dyadic 1.7.1 → 1.8.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.8.1 (2026-10-17)
+
+- `client.blackbox.overview(7 | 30)`: the Black Box overview of the last 7 days (the default) or 30. Each count is what `runs.list` gives with
+  the same filter and range.
+- `runs.list` documents the `gaps` filter (`"1"`: only runs whose record has a gap).
+
+## 1.8.0 (2026-10-17)
+
+The Black Box as an execution record.
+
+- `client.blackbox.runs.lineage(id)`: the file versions a run made (`path`, `sha256`, `previous`, the tool call), each with the plan steps under
+  way when it was made (observed, never a claim that the step caused it), and the steps the run moved. A key needs its
+  Black Box content switch.
+- A run (`runs.retrieve`) now carries `actor` (who started it, beside its owner), `costs` (from the usage ledger:
+  credits charged and held, the provider's cost as reported or estimated, cache use; for the key that made it) and
+  `links` (its batch, the plans and steps it moved, re-runs, simulations); its `outcome` is verification alone
+  (`verified`, `contradicted`, `unverified`, `blocked`, `not_applicable`), apart from how it ended (`status`).
+
 ## 1.7.1 (2026-10-17)
 
 - Corrected: `anthropic.messages.batches.create` described message batches as running at half price. Dyadic runs them in the

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "1.7.1";
+export declare const VERSION = "1.8.1";
 export declare const DEFAULT_BASE_URL = "https://dyadic.app/api/openai/v1";
 /** The Anthropic API version the `anthropic` calls speak (sent as anthropic-version, as Anthropic's SDKs do). */
 export declare const ANTHROPIC_VERSION = "2023-06-01";
@@ -1547,11 +1547,14 @@ export declare class Dyadic {
         /** OTLP/HTTP traces: an object is sent as OTLP/JSON, bytes as OTLP protobuf (application/x-protobuf; the answer is then
          * the protobuf ExportTraceServiceResponse, as Binary). */
         sendOtlp: (request: Record<string, unknown> | Uint8Array | ArrayBuffer) => Promise<Record<string, unknown>> | Promise<Binary>;
-        /** Counts for this key's runs: by status and outcome, open findings, recording gaps. */
-        overview: () => Promise<Record<string, unknown>>;
+        /** Counts for this key's runs of the last `days` (7 or 30): by status and outcome, open findings, recording gaps. Each
+         * count is what `runs.list` gives with the same filter and range. */
+        overview: (days?: 7 | 30) => Promise<Record<string, unknown>>;
         /** What the account keeps (recording, capture by kind) and for how long. */
         settings: () => Promise<Record<string, unknown>>;
         runs: {
+            /** Newest first. Filters: q, status, outcome, agent, model, tool, environment, source, since, until, severity, gaps ("1":
+             * runs whose record has a gap), cursor, limit; `next` in the result pages on. */
             list: (query?: Record<string, string | number | undefined>) => Promise<{
                 runs: BlackBoxRunSummary[];
                 next: string | null;
@@ -1568,6 +1571,9 @@ export declare class Dyadic {
                 has_more: boolean;
             }>;
             graph: (id: string) => Promise<Record<string, unknown>>;
+            /** The file versions the run made, each with the plan steps under way when it was made (observed, never a claim that
+             * the step caused it), and the plan steps it moved. A key needs its Black Box content switch. */
+            lineage: (id: string) => Promise<Record<string, unknown>>;
             verify: (id: string) => Promise<VerifyReport>;
             /** The run's signed checkpoints and the anchor (an RFC 3161 timestamp over a Merkle root) that fixes them in time. */
             checkpoints: (id: string) => Promise<{

package/dist/index.js

@@ -1,7 +1,7 @@
 // The official TypeScript SDK for the Dyadic API: Iris
 // through the OpenAI-compatible endpoints at https://dyadic.app/api/openai/v1, and beside them the Anthropic API
 // (/api/anthropic/v1) and OpenRouter's API through the AI gateway (/api/openrouter/v1).
-export const VERSION = "1.7.1";
+export const VERSION = "1.8.1";
 export const DEFAULT_BASE_URL = "https://dyadic.app/api/openai/v1";
 /** The Anthropic API version the `anthropic` calls speak (sent as anthropic-version, as Anthropic's SDKs do). */
 export const ANTHROPIC_VERSION = "2023-06-01";
@@ -560,16 +560,22 @@ export class Dyadic {
                 ? this.request("POST", this.platformURL("/blackbox/otlp/v1/traces"), undefined, false, { idempotent: true, content: request,
                     headers: { "Content-Type": "application/x-protobuf", Accept: "application/x-protobuf" } })
                 : this.request("POST", this.platformURL("/blackbox/otlp/v1/traces"), request, false, { idempotent: true }),
-            /** Counts for this key's runs: by status and outcome, open findings, recording gaps. */
-            overview: () => this.request("GET", this.platformURL("/blackbox/overview")),
+            /** Counts for this key's runs of the last `days` (7 or 30): by status and outcome, open findings, recording gaps. Each
+             * count is what `runs.list` gives with the same filter and range. */
+            overview: (days = 7) => this.request("GET", this.platformURL("/blackbox/overview"), undefined, false, { query: { days } }),
             /** What the account keeps (recording, capture by kind) and for how long. */
             settings: () => this.request("GET", this.platformURL("/blackbox/settings")),
             runs: {
+                /** Newest first. Filters: q, status, outcome, agent, model, tool, environment, source, since, until, severity, gaps ("1":
+                 * runs whose record has a gap), cursor, limit; `next` in the result pages on. */
                 list: (query = {}) => this.request("GET", this.platformURL("/blackbox/runs"), undefined, false, { query }),
                 retrieve: (id) => this.request("GET", this.platformURL(`/blackbox/runs/${id}`)),
                 /** The run's events in chain order; `types` keeps only those types (up to 20). */
                 events: (id, query = {}) => this.request("GET", this.platformURL(`/blackbox/runs/${id}/events`), undefined, false, { query: { after: query.after, limit: query.limit, types: Array.isArray(query.types) ? query.types.join(",") || undefined : query.types } }),
                 graph: (id) => this.request("GET", this.platformURL(`/blackbox/runs/${id}/graph`)),
+                /** The file versions the run made, each with the plan steps under way when it was made (observed, never a claim that
+                 * the step caused it), and the plan steps it moved. A key needs its Black Box content switch. */
+                lineage: (id) => this.request("GET", this.platformURL(`/blackbox/runs/${id}/lineage`)),
                 verify: (id) => this.request("GET", this.platformURL(`/blackbox/runs/${id}/verify`)),
                 /** The run's signed checkpoints and the anchor (an RFC 3161 timestamp over a Merkle root) that fixes them in time. */
                 checkpoints: (id) => this.request("GET", this.platformURL(`/blackbox/runs/${id}/checkpoints`)),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dyadic",
-  "version": "1.7.1",
+  "version": "1.8.1",
   "description": "The official TypeScript and JavaScript SDK for the Dyadic API: runs with your own agents and functions, plus the OpenAI-, Anthropic- and OpenRouter-compatible APIs.",
   "type": "module",
   "main": "./dist/index.js",