omkit 0.8.13 → 0.8.15

package/README.md

@@ -185,11 +185,11 @@ flakyBackgroundJob().result.catch((e) => console.warn("job failed, carrying on",
 
 Every action's output, events, asserts, snapshots, and lifecycle land on **one timeline** — streamed live to the terminal (curated milestones) and written to a per-run folder:
 
-- `result.json` — the run's tree, per-node status, verdict, and curated artifacts. Each node also carries what its definition declared about itself: the `.describe()` summary, the `.mcp()` exposure, and the `.args()` schema as JSON Schema. Each node also records `calledAt`, the line that launched it, so a built-in step (a `prompt`, a `command`) points back at your code rather than omkit's, and a `step(...)` is defined at the line where you wrote it.
+- `result.json` — the run's tree, per-node status, verdict, and curated artifacts. Each node also carries what its definition declared about itself: the `.describe()` summary, the `.mcp()` exposure, and the `.args()` schema as JSON Schema. Each node also records what it returned (`value`, or a `valueNote` when it was too large or not JSON) and `calledAt`, the line that launched it, so a built-in step (a `prompt`, a `command`) points back at your code rather than omkit's, and a `step(...)` is defined at the line where you wrote it.
 - `raw.jsonl` — every entry, machine-readable.
 - `main.log` + one `.log` per action — the human-readable timelines.
 - `events.log` / `asserts.log` / `snapshots.log` / `artifacts.log` — cross-cutting rollups.
-- `report.html` — the whole run as one self-contained page: a timeline of every action with its events, a flame graph, a flow graph of the tree, per-action details, logs, assertions, the run's snapshots and images, and each action's source (the `<>` button next to a block). Everything is inlined (data, base64 images, d3), so it opens straight from disk and survives being zipped or attached.
+- `report.html` — the whole run as one self-contained page: a timeline of every action with its events, a flame graph, a flow graph of the tree, per-action details, logs, assertions, the run's snapshots and images, each action's source (the `<>` button next to a block), and an Errors tab that collects failures, failed assertions and error output, and can highlight the actions they came from in every graph. Everything is inlined (data, base64 images, d3), so it opens straight from disk and survives being zipped or attached.
 
 `ctx` also gives each action `assert(cond, msg)` (tallies into the run's verdict), `snapshot(name, value)` (captures JSON state to the run folder), and `artifact(name, file, opts?)` (labels a file the action wrote — name, optional description, MIME inferred from the extension — and returns its absolute path) — so a run is an inspectable artifact, not just an exit code. Write the files you label under `ctx.artifactsFolder`, the run's own output folder.
 

package/dist/core/ExecutionTree.js

@@ -391,6 +391,7 @@ export class ExecutionTree {
             duration: node.duration,
             logFile: this.logFile(node.path),
             ...this.metaView(node),
+            ...valueView(node.value),
             children: node.children.map((child) => this.nodeView(child)),
         };
     }
@@ -416,6 +417,7 @@ export class ExecutionTree {
             ...(meta.description === undefined ? {} : { description: { ...meta.description } }),
             ...(meta.mcp === undefined ? {} : { mcp: { ...meta.mcp } }),
             ...(inputSchema === undefined ? {} : { inputSchema }),
+            ...("inline" in meta && meta.inline ? { kind: "step" } : {}),
         };
     }
     /** Test seam: the projected run view (same object written to result.json). */
@@ -506,6 +508,36 @@ const messageOf = (error) => error instanceof Error ? (error.stack ?? error.mess
  * body may hand back anything — a capability handle, a cyclic object — and the run must
  * still write its record; a value that does not survive JSON is dropped, not fatal.
  */
+/** A node's return value is recorded up to this many characters of JSON. */
+const VALUE_CAP = 512 * 1024;
+/**
+ * What a node returned, for the record: the value itself when JSON can carry it and it fits,
+ * otherwise a one-line note saying what it was — so "returned a Page" is still on the record.
+ */
+function valueView(value) {
+    if (value === undefined)
+        return {};
+    const kind = value === null
+        ? "null"
+        : typeof value === "object"
+            ? (value.constructor?.name ?? "object")
+            : typeof value;
+    let text;
+    try {
+        text = JSON.stringify(value);
+    }
+    catch {
+        text = undefined;
+    }
+    if (text === undefined)
+        return { valueNote: `${kind} (not JSON)` };
+    if (text.length > VALUE_CAP) {
+        return {
+            valueNote: `${kind}, ${Math.round(text.length / 1024)} KB of JSON — too large to record`,
+        };
+    }
+    return { value: JSON.parse(text) };
+}
 function serialisable(value) {
     if (value === undefined)
         return undefined;

package/dist/core/step.js

@@ -18,6 +18,7 @@ export function step(name, fn) {
         body: fn,
         definedAt: site,
         calledAt: site,
+        meta: { inline: true },
     };
     // `.result` already resolves the value and rejects on failure/cancel — exactly step's contract.
     return ExecutionTree.require().launch(spec).result;

package/dist/core/types.d.ts

@@ -254,4 +254,6 @@ export interface ActionMeta {
     readonly mcp?: ResolvedMcpExposure;
     /** Converts the declared args schema; called once, at finalize. */
     readonly describeArgs?: () => DescribedArgs;
+    /** Launched by `step(…)` — an inline action with no reusable definition. */
+    readonly inline?: boolean;
 }

package/dist/output/writers/report/report.css

@@ -170,10 +170,18 @@ button { font: inherit; color: inherit; }
 .axis line, .axis path { stroke: var(--line); }
 
 .flow-view, .flame-view { position: absolute; inset: 0; }
+.flame-view { overflow-y: auto; overflow-x: hidden; }
 .flow-view svg, .flame-view svg { width: 100%; height: 100%; display: block; cursor: grab; }
 .flow-card rect.box { fill: var(--raise); stroke: var(--line); rx: 8; }
 .flow-card.selected rect.box { stroke: var(--accent); stroke-width: 2; }
 .flow-card text { fill: var(--text); font-size: 12px; }
+.flow-card text.nm { font-weight: 600; }
+.flow-card .flow-icon { pointer-events: none; }
+.flow-seq { fill: none; stroke: var(--text-3); stroke-width: 1.4; stroke-dasharray: 5 4; }
+.flow-seq.parallel { stroke-dasharray: 1 4; stroke-linecap: round; stroke-width: 2; opacity: 0.8; }
+.flow-arrowhead { fill: var(--text-3); }
+.flow-par { fill: var(--text-3); font-size: 10px; font-style: italic; }
+.flow-shot-t { fill: var(--text-3); font-size: 10.5px; pointer-events: none; }
 .flow-card text.sub { fill: var(--text-3); font-size: 11px; }
 .flow-link { fill: none; stroke: var(--text-3); stroke-width: 1.3; }
 .flame-rect { cursor: pointer; stroke: var(--panel); stroke-width: 1; }
@@ -337,6 +345,7 @@ a.icon-btn { text-decoration: none; }
 .tk-k { color: var(--tk-k); }
 .tk-f { color: var(--tk-f); }
 .tk-t { color: var(--tk-t); }
+.tk-p { color: var(--tk-f); }
 
 /* ── popover tabs, prompt panel, flow snapshot strip ───── */
 .code-pop .cp-tabs { display: flex; gap: 2px; padding: 0 8px; border-bottom: 1px solid var(--line); background: var(--panel-2); }
@@ -355,6 +364,67 @@ a.icon-btn { text-decoration: none; }
 .flow-shots .shot:hover rect { stroke: var(--accent); }
 .flow-shots .shot text { fill: var(--text-3); font: 600 9px var(--mono); pointer-events: none; }
 
+/* ── returned values ───────────────────────────────────── */
+.code-btn path { fill: none; stroke: var(--text-2); stroke-width: 2.6; stroke-linecap: round; stroke-linejoin: round; pointer-events: none; }
+.code-btn:hover path { stroke: var(--accent); }
+.cp-tools { display: flex; align-items: center; justify-content: space-between; gap: 10px; padding: 6px 10px 6px 14px; border-bottom: 1px solid var(--line-soft); font-size: 12px; }
+.btn.small { padding: 3px 9px; font-size: 12px; }
+.btn.small svg { width: 13px; height: 13px; }
+.code-box { border: 1px solid var(--line-soft); border-radius: 8px; background: var(--panel-2); overflow: auto; max-height: 60vh; }
+.code-box .cp-code, .code-pop .cp-code { font: 11.5px/1.65 var(--mono); padding: 8px 0; min-width: max-content; }
+.code-box .cl { display: grid; grid-template-columns: 40px auto; white-space: pre; }
+.code-box .ln { color: var(--text-3); text-align: right; padding-right: 12px; user-select: none; }
+.code-box .lc { padding-right: 14px; }
+
+/* ── errors ────────────────────────────────────────────── */
+.tab-count { display: inline-block; min-width: 18px; padding: 0 6px; border-radius: 999px; background: var(--raise); color: var(--text-2); font-size: 11px; text-align: center; }
+.tab-count.bad { background: rgba(239, 68, 68, 0.16); color: var(--fail); font-weight: 700; }
+.linkish { border: 0; background: none; padding: 0; cursor: pointer; font: inherit; color: var(--accent); }
+.linkish.bad { color: var(--fail); }
+.linkish.warn { color: var(--cancel); }
+.tab-count.warn { background: rgba(245, 158, 11, 0.16); color: var(--cancel); font-weight: 700; }
+.linkish:hover { text-decoration: underline; }
+.err-bar { display: flex; align-items: center; justify-content: space-between; gap: 10px; margin-bottom: 8px; flex-wrap: wrap; }
+.segs { display: flex; border: 1px solid var(--line); border-radius: 7px; overflow: hidden; }
+.seg { border: 0; background: var(--panel); padding: 4px 10px; cursor: pointer; color: var(--text-2); font-size: 12px; }
+.seg + .seg { border-left: 1px solid var(--line); }
+.seg.active { background: var(--accent-soft); color: var(--text); font-weight: 600; }
+.btn.small.active { background: rgba(239, 68, 68, 0.14); color: var(--fail); border-color: var(--fail); }
+.err-sec { margin-bottom: 10px; }
+.err-sec-h { display: flex; align-items: center; gap: 6px; font-weight: 600; font-size: 12px; color: var(--text-2); margin: 6px 0 4px; }
+.err-sec-h svg { width: 13px; height: 13px; color: var(--fail); }
+.err-entry { border: 1px solid var(--line-soft); border-left: 3px solid var(--fail); border-radius: 6px; margin-bottom: 4px; background: var(--panel); }
+.err-entry.output { border-left-color: var(--cancel); }
+.err-entry.assert { border-left-color: #f97316; }
+.err-row { display: flex; align-items: center; gap: 8px; padding: 4px 6px; cursor: pointer; min-width: 0; font-size: 12px; }
+.err-row:hover { background: var(--raise); }
+.err-row .twist { width: 14px; height: 14px; display: grid; place-items: center; color: var(--text-3); flex: none; }
+.err-row .twist svg { width: 11px; height: 11px; transition: transform 0.12s; }
+.err-row .twist.open svg { transform: rotate(90deg); }
+.err-row .t { color: var(--text-2); font-variant-numeric: tabular-nums; flex: none; min-width: 44px; }
+.err-row .who { color: var(--text); font-weight: 600; flex: none; max-width: 220px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.err-row .err-src { color: var(--text-3); font-family: var(--mono); font-size: 11px; flex: none; max-width: 180px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.err-row .msg { flex: 1; min-width: 0; font-family: var(--mono); color: var(--fail); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.err-entry.output .err-row .msg { color: var(--text-2); }
+.err-row .err-n { color: var(--text-3); font-size: 11px; flex: none; }
+.err-row .icon-btn { width: 22px; height: 20px; }
+.err-text { margin: 0 8px 8px 28px; max-height: 260px; }
+.err-kind { color: var(--fail); }
+.errbadge { flex: none; min-width: 16px; height: 16px; padding: 0 5px; border-radius: 999px; background: var(--fail); color: #fff; font-size: 10px; font-weight: 700; display: inline-grid; place-items: center; }
+/* highlight mode — errored nodes in red, the path to them marked, the rest dimmed */
+#app.hl-on .chart g.r:not(.err):not(.err-path),
+#app.hl-on .flame-view g.cell:not(.err):not(.err-path),
+#app.hl-on .flow-card:not(.err):not(.err-path) { opacity: 0.22; }
+#app.hl-on .tree .row:not(.err):not(.err-path) { opacity: 0.4; }
+#app.hl-on .chart g.r.err rect.bar,
+#app.hl-on .flame-view g.cell.err rect { stroke: var(--fail); stroke-width: 2.5; filter: drop-shadow(0 0 5px rgba(239, 68, 68, 0.75)); }
+#app.hl-on .flow-card.err rect.box { stroke: var(--fail); stroke-width: 2.5; filter: drop-shadow(0 0 5px rgba(239, 68, 68, 0.6)); }
+#app.hl-on .chart g.r.err-path rect.bar,
+#app.hl-on .flame-view g.cell.err-path rect,
+#app.hl-on .flow-card.err-path rect.box { stroke: var(--fail); stroke-width: 1.2; stroke-dasharray: 4 3; }
+#app.hl-on .tree .row.err { background: rgba(239, 68, 68, 0.1); }
+.chart g.r, .flame-view g.cell, .flow-card, .tree .row { transition: opacity 0.15s; }
+
 @media (max-width: 1100px) {
   .bottom { grid-template-columns: minmax(0, 1fr); }
   .legend, .overview { display: none; }