@outputai/cli 0.10.1-next.eaf62a3.0 → 0.10.1-next.f6a7c1a.0

package/dist/utils/waterfall.d.ts

@@ -8,7 +8,7 @@
  * Atlas's `StepGantt`; the bar geometry mirrors its leftPct/widthPct as integer
  * terminal columns.
  */
-import type { Span } from '#services/workflow_history/correlator.js';
+import type { Span, SpanStatus } from '#services/workflow_history/correlator.js';
 export interface WaterfallOptions {
     width: number;
     color: boolean;
@@ -22,6 +22,8 @@ export interface BarGeometry {
 }
 export declare const FULL_BLOCK = "\u2588";
 export declare const THIN_BLOCK = "\u258F";
+export declare const ANSI: Record<SpanStatus | 'dim' | 'reset', string>;
+export declare function makeTint(color: boolean): (text: string, code: string) => string;
 export declare function pickTickStep(totalMs: number): number;
 export declare function buildTicks(totalMs: number): number[];
 export declare function formatTickLabel(ms: number): string;

package/dist/utils/waterfall.js

@@ -12,7 +12,7 @@ const TICK_STEPS_MS = [
     60 * 60_000, 2 * 60 * 60_000, 6 * 60 * 60_000, 12 * 60 * 60_000, 24 * 60 * 60_000
 ];
 const TARGET_TICKS = 8;
-const ANSI = {
+export const ANSI = {
     completed: '',
     running: '',
     failed: '',
@@ -20,6 +20,12 @@ const ANSI = {
     dim: '',
     reset: ''
 };
+// Shared by renderWaterfall and monitor_log's live status lines so there's one
+// place that knows how to wrap text in an ANSI code (and reset it) -- or not,
+// when color is disabled.
+export function makeTint(color) {
+    return (text, code) => (color ? `${code}${text}${ANSI.reset}` : text);
+}
 function clamp(value, lo, hi) {
     return Math.min(Math.max(value, lo), hi);
 }
@@ -162,7 +168,7 @@ export default function renderWaterfall(spans, totalDurationMs, options) {
     if (spans.length === 0) {
         return [header, 'No steps found for this run.'].filter(Boolean).join('\n\n');
     }
-    const tint = (text, code) => (color ? `${code}${text}${ANSI.reset}` : text);
+    const tint = makeTint(color);
     const labelFor = (span) => labels?.get(span.id) ?? span.name;
     const durationFor = (span) => formatDurationLabel(Math.max(0, span.durationMs));
     const longestLabel = Math.max(...spans.map(s => labelFor(s).length));

package/dist/views/dev/hooks/use_run_detail.js

@@ -2,13 +2,16 @@ import { useEffect, useRef, useState } from 'react';
 import { readFile } from 'node:fs/promises';
 import { getWorkflowIdResult, getWorkflowIdRunsRidResult, getWorkflowIdTraceLog, getWorkflowIdRunsRidTraceLog } from '#api/generated/api.js';
 import { normalizeWorkflowStatus } from '#utils/normalize_workflow_status.js';
+import { TERMINAL_STATUSES } from '#utils/format_workflow_result.js';
+import { createBoundedCache } from '#views/dev/utils/bounded_cache.js';
 const EMPTY_DETAIL = {
     result: null,
     trace: null,
     steps: [],
     loading: false
 };
-const runDetailCache = new Map();
+const RUN_DETAIL_CACHE_MAX = 50;
+const runDetailCache = createBoundedCache(RUN_DETAIL_CACHE_MAX);
 const stepNameOf = (node) => {
     if (node.name) {
         return node.name;
@@ -99,13 +102,9 @@ const fetchResult = async (workflowId, runId) => {
         return null;
     }
 };
-/**
- * Statuses that mean the workflow has stopped advancing. The cache is
- * intentionally only populated for these — partial results from a still-
- * running workflow would otherwise stick and stall the UI when the run
- * eventually finishes.
- */
-const TERMINAL_STATUSES = new Set(['completed', 'failed', 'canceled', 'terminated', 'timed_out']);
+// The cache is intentionally only populated for terminal statuses — partial results
+// from a still-running workflow would otherwise stick and stall the UI when the run
+// eventually finishes. `TERMINAL_STATUSES` is shared with `workflow monitor`.
 export const isTerminalRunStatus = (status) => Boolean(status && TERMINAL_STATUSES.has(status));
 export const useRunDetail = (workflowId, runId, status) => {
     const [detail, setDetail] = useState(EMPTY_DETAIL);

package/dist/views/dev/hooks/use_step_graph.js

@@ -3,6 +3,7 @@ import { fetchWorkflowHistory } from '#services/workflow_history.js';
 import buildSpanLabels from '#utils/span_labels.js';
 import { isTerminalRunStatus } from '#views/dev/hooks/use_run_detail.js';
 import { usePoll, POLL_INTERVAL_MS } from '#views/dev/hooks/use_poll.js';
+import { createBoundedCache } from '#views/dev/utils/bounded_cache.js';
 const EMPTY_GRAPH = {
     spans: [],
     totalDurationMs: 0,
@@ -11,7 +12,8 @@ const EMPTY_GRAPH = {
     loading: false,
     error: null
 };
-const stepGraphCache = new Map();
+const STEP_GRAPH_CACHE_MAX = 50;
+const stepGraphCache = createBoundedCache(STEP_GRAPH_CACHE_MAX);
 /**
  * Fetches a run's correlated step spans for the dev TUI's waterfall overlay,
  * reusing the same `fetchWorkflowHistory` path as the `workflow history` CLI

package/dist/views/dev/utils/bounded_cache.d.ts

@@ -0,0 +1,14 @@
+export interface BoundedCache<K, V extends {}> {
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    clear(): void;
+    size(): number;
+}
+/**
+ * A small LRU cache backed by an insertion-ordered `Map`, capped at `maxSize`
+ * entries. Reading a key refreshes its recency; once the cap is exceeded the
+ * least-recently-used entries are evicted. Drop-in compatible with the
+ * `Map.get` / `Map.set` calls it replaces.
+ */
+export declare const createBoundedCache: <K, V extends {}>(maxSize: number) => BoundedCache<K, V>;

package/dist/views/dev/utils/bounded_cache.js

@@ -0,0 +1,42 @@
+/**
+ * A small LRU cache backed by an insertion-ordered `Map`, capped at `maxSize`
+ * entries. Reading a key refreshes its recency; once the cap is exceeded the
+ * least-recently-used entries are evicted. Drop-in compatible with the
+ * `Map.get` / `Map.set` calls it replaces.
+ */
+export const createBoundedCache = (maxSize) => {
+    if (maxSize < 1) {
+        throw new Error('createBoundedCache: maxSize must be >= 1');
+    }
+    const entries = new Map();
+    return {
+        get(key) {
+            const value = entries.get(key);
+            if (value === undefined) {
+                return value;
+            }
+            entries.delete(key);
+            entries.set(key, value);
+            return value;
+        },
+        set(key, value) {
+            entries.delete(key);
+            entries.set(key, value);
+            if (entries.size > maxSize) {
+                const oldest = entries.keys().next();
+                if (!oldest.done) {
+                    entries.delete(oldest.value);
+                }
+            }
+        },
+        has(key) {
+            return entries.has(key);
+        },
+        clear() {
+            entries.clear();
+        },
+        size() {
+            return entries.size;
+        }
+    };
+};

package/dist/views/dev/utils/bounded_cache.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/views/dev/utils/bounded_cache.spec.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from 'vitest';
+import { createBoundedCache } from './bounded_cache.js';
+describe('createBoundedCache', () => {
+    it('round-trips set and get', () => {
+        const cache = createBoundedCache(3);
+        cache.set('a', 1);
+        expect(cache.get('a')).toBe(1);
+        expect(cache.get('missing')).toBeUndefined();
+    });
+    it('evicts the oldest entry once maxSize is exceeded', () => {
+        const cache = createBoundedCache(2);
+        cache.set('a', 1);
+        cache.set('b', 2);
+        cache.set('c', 3);
+        expect(cache.has('a')).toBe(false);
+        expect(cache.get('b')).toBe(2);
+        expect(cache.get('c')).toBe(3);
+    });
+    it('refreshes recency on get so the touched entry survives eviction', () => {
+        const cache = createBoundedCache(2);
+        cache.set('a', 1);
+        cache.set('b', 2);
+        // Touch 'a' so 'b' becomes the least-recently-used entry.
+        expect(cache.get('a')).toBe(1);
+        cache.set('c', 3);
+        expect(cache.has('a')).toBe(true);
+        expect(cache.has('b')).toBe(false);
+        expect(cache.has('c')).toBe(true);
+    });
+    it('updates an existing key in place without growing', () => {
+        const cache = createBoundedCache(2);
+        cache.set('a', 1);
+        cache.set('a', 2);
+        expect(cache.get('a')).toBe(2);
+        expect(cache.size()).toBe(1);
+    });
+    it('supports has and clear', () => {
+        const cache = createBoundedCache(2);
+        cache.set('a', 1);
+        expect(cache.has('a')).toBe(true);
+        cache.clear();
+        expect(cache.has('a')).toBe(false);
+        expect(cache.size()).toBe(0);
+    });
+    it('never exceeds maxSize', () => {
+        const cache = createBoundedCache(3);
+        Array.from({ length: 100 }, (_, i) => i).forEach(i => {
+            cache.set(`key-${i}`, i);
+            expect(cache.size()).toBeLessThanOrEqual(3);
+        });
+        expect(cache.size()).toBe(3);
+    });
+});

package/oclif.manifest.json

@@ -905,6 +905,80 @@
         "list.js"
       ]
     },
+    "workflow:monitor": {
+      "aliases": [],
+      "args": {
+        "workflowId": {
+          "description": "The workflow ID to monitor",
+          "name": "workflowId",
+          "required": true
+        }
+      },
+      "description": "Attach to a workflow run and stream status updates until it ends",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> wf-12345",
+        "<%= config.bin %> <%= command.id %> wf-12345 --run-id 2fe0b36b-...",
+        "<%= config.bin %> <%= command.id %> wf-12345 --format json"
+      ],
+      "flags": {
+        "run-id": {
+          "char": "r",
+          "description": "Monitor a specific run (defaults to the latest run; continue-as-new chains are followed regardless)",
+          "name": "run-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "include-payloads": {
+          "description": "Include decoded step input/output payloads",
+          "name": "include-payloads",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interval": {
+          "description": "Poll interval in milliseconds. Once a resumed poll is long-polling server-side for new events, this also bounds how long that block may last (capped at the server's configured max), so an idle workflow's update cadence is roughly twice this value (the long-poll bound, then this sleep) rather than a much longer, separate server default.",
+          "name": "interval",
+          "default": 2500,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "color": {
+          "description": "Colorize status output (use --no-color to disable)",
+          "name": "color",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workflow:monitor",
+      "pluginAlias": "@outputai/cli",
+      "pluginName": "@outputai/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workflow",
+        "monitor.js"
+      ]
+    },
     "workflow:plan": {
       "aliases": [],
       "args": {},
@@ -1597,5 +1671,5 @@
       ]
     }
   },
-  "version": "0.10.1-next.eaf62a3.0"
+  "version": "0.10.1-next.f6a7c1a.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outputai/cli",
-  "version": "0.10.1-next.eaf62a3.0",
+  "version": "0.10.1-next.f6a7c1a.0",
   "description": "CLI for Output.ai workflow generation",
   "type": "module",
   "main": "dist/index.js",
@@ -38,9 +38,9 @@
     "semver": "7.7.4",
     "undici": "8.5.0",
     "yaml": "^2.8.3",
-    "@outputai/credentials": "0.10.1-next.eaf62a3.0",
-    "@outputai/llm": "0.10.1-next.eaf62a3.0",
-    "@outputai/evals": "0.10.1-next.eaf62a3.0"
+    "@outputai/credentials": "0.10.1-next.f6a7c1a.0",
+    "@outputai/evals": "0.10.1-next.f6a7c1a.0",
+    "@outputai/llm": "0.10.1-next.f6a7c1a.0"
   },
   "devDependencies": {
     "@types/cli-progress": "3.11.6",