dyadic 1.7.1 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 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.0";
 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";
@@ -1568,6 +1568,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.0";
 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";
@@ -570,6 +570,9 @@ export class Dyadic {
                 /** 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.0",
   "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",