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

package/dist/utils/port_collision.js

@@ -3,20 +3,25 @@
  * an actionable hint that names the conflicting port and the env var to
  * override.
  *
- * Docker compose surfaces port collisions through two common error shapes:
- *   - "Bind for 0.0.0.0:3001 failed: port is already allocated"
- *   - "failed to bind host port for 0.0.0.0:7233:.../tcp: address already in use"
+ * Docker wraps the same failure differently across versions and platforms —
+ * Docker 29 on macOS nests it three deep:
  *
- * We match both, extract the host port, then map it back to the env var that
- * sets it. The map prefers a runtime lookup of resolved ports (so a user who
- * already set OUTPUT_API_HOST_PORT=3050 sees that var named when 3050
- * collides) and falls back to a default-port table for the unresolved case.
+ *   Error response from daemon: failed to set up container networking: driver
+ *   failed programming external connectivity on endpoint out-api-1 (a1b2…):
+ *   Bind for 0.0.0.0:3001 failed: port is already allocated
+ *
+ * Matching whole message shapes means a new wrapper silently drops the hint, so
+ * we anchor on the terminal phrase instead and take the host port nearest to it.
+ * That survives wrappers we haven't seen.
+ *
+ * The port is then mapped back to the env var that sets it. The map prefers a
+ * runtime lookup of resolved ports (so a user who already set
+ * OUTPUT_API_HOST_PORT=3050 sees that var named when 3050 collides) and falls
+ * back to a default-port table for the unresolved case.
  */
-const PORT_BIND_PATTERNS = [
-    /Bind for [^:\s]+:(\d+) failed: port is already allocated/,
-    /failed to bind host port for [^:\s]+:(\d+)[^]*?address already in use/,
-    /listen tcp [^:\s]+:(\d+):\s*bind: address already in use/
-];
+const COLLISION_PHRASES = ['port is already allocated', 'address already in use'];
+/** Trailing `:<port>` in a fragment — the host port a bind failure names. */
+const TRAILING_PORT = /:(\d+)(?!.*:\d)/s;
 const DEFAULT_PORT_TO_ENV_VAR = {
     3001: 'OUTPUT_API_HOST_PORT',
     8080: 'OUTPUT_TEMPORAL_UI_HOST_PORT',
@@ -35,8 +40,15 @@ export function extractCollidedPort(stderr) {
     if (!stderr) {
         return null;
     }
-    for (const pattern of PORT_BIND_PATTERNS) {
-        const match = stderr.match(pattern);
+    for (const phrase of COLLISION_PHRASES) {
+        const phraseIndex = stderr.indexOf(phrase);
+        if (phraseIndex === -1) {
+            continue;
+        }
+        // The host port is the last one named before the phrase — every shape puts
+        // it there ("Bind for 0.0.0.0:3001 failed: port is already allocated",
+        // "listen tcp 0.0.0.0:3001: bind: address already in use").
+        const match = stderr.slice(0, phraseIndex).match(TRAILING_PORT);
         if (match) {
             return parseInt(match[1], 10);
         }
@@ -87,6 +99,19 @@ export function formatPortCollisionHint(stderr, resolvedPorts) {
     }
     return formatSingleCollision(port, resolvedPorts);
 }
+/**
+ * Compose a docker-failure message from a caller-supplied core sentence and the
+ * process's recent output: an actionable port-collision hint (when one is
+ * detected) is prepended, and the raw recent output is appended. Shared by the
+ * foreground exit handler and the detached/reconcile path so both surface the
+ * same failure shape.
+ */
+export function formatComposeFailure(reason, output, resolvedPorts) {
+    const hint = formatPortCollisionHint(output, resolvedPorts);
+    const prefix = hint ? `${hint}\n\n` : '';
+    const detail = output ? `\n\nRecent Docker output:\n${output}` : '';
+    return `${prefix}${reason}${detail}`;
+}
 /**
  * Build a hint from a known list of colliding ports. For a single collision
  * the output matches `formatPortCollisionHint` exactly so callers stay

package/dist/utils/port_collision.spec.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { extractCollidedPort, formatPortCollisionHint, formatPortCollisionsHint } from './port_collision.js';
+import { extractCollidedPort, formatPortCollisionHint, formatPortCollisionsHint, formatComposeFailure } from './port_collision.js';
 const DEFAULT_PORTS = { api: 3001, temporalUi: 8080, temporal: 7233 };
 describe('extractCollidedPort', () => {
     it('matches the "Bind for ... port is already allocated" shape', () => {
@@ -22,6 +22,24 @@ describe('extractCollidedPort', () => {
     it('returns null when no bind failure is present', () => {
         expect(extractCollidedPort('some unrelated stderr line')).toBeNull();
     });
+    // Captured verbatim from Docker 29.4.0 on macOS. The bind failure is nested
+    // three wrappers deep; matching whole message shapes missed it.
+    it('extracts the port from Docker 29\'s nested container-networking wrapper', () => {
+        const stderr = 'Error response from daemon: failed to set up container networking: ' +
+            'driver failed programming external connectivity on endpoint out-api-1 ' +
+            '(e72baf85643fb5dc19000acf62c1ad0d11bffc653cabe1fc8861387ec1ebd629): ' +
+            'Bind for 0.0.0.0:3001 failed: port is already allocated';
+        expect(extractCollidedPort(stderr)).toBe(3001);
+    });
+    it('extracts the port from the "ports are not available" wrapper', () => {
+        const stderr = 'Error: ports are not available: exposing port TCP 0.0.0.0:3001 -> 0.0.0.0:0: ' +
+            'listen tcp 0.0.0.0:3001: bind: address already in use';
+        expect(extractCollidedPort(stderr)).toBe(3001);
+    });
+    it('ignores an IP-like prefix and takes the port nearest the failure phrase', () => {
+        const stderr = 'container 172.17.0.2:5432 started\nBind for 0.0.0.0:8080 failed: port is already allocated';
+        expect(extractCollidedPort(stderr)).toBe(8080);
+    });
     it('returns null for empty input', () => {
         expect(extractCollidedPort('')).toBeNull();
     });
@@ -80,3 +98,24 @@ describe('formatPortCollisionsHint', () => {
         expect(hint).toContain('• Port 5432 — stop the process holding it');
     });
 });
+describe('formatComposeFailure', () => {
+    const reason = 'Docker compose failed to start services (exit code 1).';
+    it('prepends the actionable hint when the output names a collision', () => {
+        const message = formatComposeFailure(reason, 'Bind for 0.0.0.0:3001 failed: port is already allocated', DEFAULT_PORTS);
+        expect(message.startsWith('Port 3001 is already in use.')).toBe(true);
+        expect(message).toContain('OUTPUT_API_HOST_PORT=<other port>');
+        expect(message).toContain(reason);
+        expect(message).toContain('Recent Docker output:');
+    });
+    it('omits the output section entirely when nothing was captured', () => {
+        const message = formatComposeFailure(reason, '', DEFAULT_PORTS);
+        expect(message).toBe(reason);
+        expect(message).not.toContain('Recent Docker output:');
+    });
+    it('returns reason plus raw output, with no hint, for an unrecognized failure', () => {
+        const message = formatComposeFailure(reason, 'no such image: outputai/api:dev', DEFAULT_PORTS);
+        expect(message.startsWith(reason)).toBe(true);
+        expect(message).toContain('Recent Docker output:\nno such image');
+        expect(message).not.toContain('is already in use');
+    });
+});

package/dist/utils/resolve_input.d.ts

@@ -1 +1,9 @@
-export declare function resolveInput(workflowName: string, scenario: string | undefined, inputFlag: string | undefined, commandName: string, catalog?: string): Promise<unknown>;
+export type ResolveInputOptions = {
+    workflowName: string;
+    scenario?: string;
+    inputFlag?: string;
+    commandName: string;
+    catalog?: string;
+    json?: boolean;
+};
+export declare function resolveInput(options: ResolveInputOptions): Promise<unknown>;

package/dist/utils/resolve_input.js

@@ -1,7 +1,8 @@
 import { ux } from '@oclif/core';
 import { parseInputFlag } from '#utils/input_parser.js';
 import { resolveScenarioPath, getScenarioNotFoundMessage } from '#utils/scenario_resolver.js';
-export async function resolveInput(workflowName, scenario, inputFlag, commandName, catalog) {
+export async function resolveInput(options) {
+    const { workflowName, scenario, inputFlag, commandName, catalog, json } = options;
     if (inputFlag && scenario) {
         return ux.error('Cannot use both scenario argument and --input flag. Choose one.', { exit: 1 });
     }
@@ -13,7 +14,12 @@ export async function resolveInput(workflowName, scenario, inputFlag, commandNam
         if (!resolution.found) {
             return ux.error(getScenarioNotFoundMessage(workflowName, scenario, resolution.searchedPaths), { exit: 1 });
         }
-        ux.stdout(`Using scenario: ${resolution.path}\n`);
+        // Advisory notice goes to stderr so stdout stays clean for piping, and is
+        // skipped entirely under --json where even stderr is noise to a script
+        // consuming the structured output (same rule as the init hook's banner).
+        if (!json) {
+            ux.stderr(`Using scenario: ${resolution.path}`);
+        }
         return parseInputFlag(resolution.path);
     }
     return ux.error('Input required. Provide either:\n' +

package/dist/utils/resolve_input.spec.d.ts

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

package/dist/utils/resolve_input.spec.js

@@ -0,0 +1,75 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('@oclif/core', () => ({
+    ux: {
+        stdout: vi.fn(),
+        stderr: vi.fn(),
+        error: vi.fn(() => {
+            throw new Error('ux.error called');
+        })
+    }
+}));
+vi.mock('#utils/input_parser.js', () => ({
+    parseInputFlag: vi.fn()
+}));
+vi.mock('#utils/scenario_resolver.js', () => ({
+    resolveScenarioPath: vi.fn(),
+    getScenarioNotFoundMessage: vi.fn()
+}));
+describe('resolveInput', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('emits the scenario notice on stderr so --json stdout stays clean', async () => {
+        const { ux } = await import('@oclif/core');
+        const { parseInputFlag } = await import('#utils/input_parser.js');
+        const { resolveScenarioPath } = await import('#utils/scenario_resolver.js');
+        const { resolveInput } = await import('./resolve_input.js');
+        vi.mocked(resolveScenarioPath).mockResolvedValue({
+            found: true,
+            path: '/scenarios/happy_path.json'
+        });
+        vi.mocked(parseInputFlag).mockReturnValue({ key: 'value' });
+        const result = await resolveInput({
+            workflowName: 'web_search',
+            scenario: 'happy_path',
+            commandName: 'start'
+        });
+        expect(result).toEqual({ key: 'value' });
+        expect(ux.stderr).toHaveBeenCalledWith('Using scenario: /scenarios/happy_path.json');
+        expect(ux.stdout).not.toHaveBeenCalled();
+    });
+    it('suppresses the scenario notice entirely under --json', async () => {
+        const { ux } = await import('@oclif/core');
+        const { parseInputFlag } = await import('#utils/input_parser.js');
+        const { resolveScenarioPath } = await import('#utils/scenario_resolver.js');
+        const { resolveInput } = await import('./resolve_input.js');
+        vi.mocked(resolveScenarioPath).mockResolvedValue({
+            found: true,
+            path: '/scenarios/happy_path.json'
+        });
+        vi.mocked(parseInputFlag).mockReturnValue({ key: 'value' });
+        const result = await resolveInput({
+            workflowName: 'web_search',
+            scenario: 'happy_path',
+            commandName: 'start',
+            json: true
+        });
+        expect(result).toEqual({ key: 'value' });
+        expect(ux.stderr).not.toHaveBeenCalled();
+        expect(ux.stdout).not.toHaveBeenCalled();
+    });
+    it('does not emit the scenario notice when input comes from --input', async () => {
+        const { ux } = await import('@oclif/core');
+        const { parseInputFlag } = await import('#utils/input_parser.js');
+        const { resolveInput } = await import('./resolve_input.js');
+        vi.mocked(parseInputFlag).mockReturnValue({ key: 'value' });
+        await resolveInput({
+            workflowName: 'web_search',
+            inputFlag: '{"key":"value"}',
+            commandName: 'start'
+        });
+        expect(ux.stderr).not.toHaveBeenCalled();
+        expect(ux.stdout).not.toHaveBeenCalled();
+    });
+});

package/dist/views/dev/chrome/footer.d.ts

@@ -8,5 +8,7 @@ export interface FooterState {
     hints?: CommandHint[];
     itemCount?: number;
     itemLabel?: string;
+    /** Attached to a pre-existing stack — quitting leaves services running. */
+    attached?: boolean;
 }
 export declare const Footer: React.FC<FooterState>;

package/dist/views/dev/chrome/footer.js

@@ -5,16 +5,16 @@ import packageJson from '../../../../package.json' with { type: 'json' };
 const GLOBAL_HINT_ROWS = 1;
 const LOCAL_HINT_ROWS = 1;
 export const getHeight = () => GLOBAL_HINT_ROWS + LOCAL_HINT_ROWS;
-const GLOBAL_HINTS = [
+const globalHints = (attached) => [
     { key: 'tab', label: 'next tab' },
     { key: 'shift-tab', label: 'prev tab' },
     { key: '1-4', label: 'tabs' },
     { key: '/', label: 'search' },
     { key: '?', label: 'help' },
-    { key: 'ctrl+c', label: 'quit' }
+    { key: 'ctrl+c', label: attached ? 'detach (keeps running)' : 'quit' }
 ];
 const VERSION = packageJson.version;
 const HintRow = ({ hints }) => (_jsx(Box, { flexDirection: "row", children: hints.length === 0 ? (_jsx(Text, { children: " " })) : hints.map((hint, i) => (_jsxs(React.Fragment, { children: [i > 0 && _jsx(Text, { dimColor: true, children: '  ' }), _jsx(Text, { bold: true, children: hint.key }), _jsx(Text, { dimColor: true, children: ` ${hint.label}` })] }, hint.key))) }));
-export const Footer = ({ hints = [], itemCount, itemLabel }) => {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", children: [_jsx(HintRow, { hints: GLOBAL_HINTS }), typeof itemCount === 'number' && itemLabel && (_jsx(Box, { children: _jsxs(Text, { dimColor: true, children: [itemCount, " ", itemLabel] }) }))] }), _jsxs(Box, { flexDirection: "row", justifyContent: "space-between", children: [_jsx(HintRow, { hints: hints }), _jsxs(Text, { color: "blackBright", children: ["v", VERSION] })] })] }));
+export const Footer = ({ hints = [], itemCount, itemLabel, attached = false }) => {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", children: [_jsx(HintRow, { hints: globalHints(attached) }), typeof itemCount === 'number' && itemLabel && (_jsx(Box, { children: _jsxs(Text, { dimColor: true, children: [itemCount, " ", itemLabel] }) }))] }), _jsxs(Box, { flexDirection: "row", justifyContent: "space-between", children: [_jsx(HintRow, { hints: hints }), _jsxs(Text, { color: "blackBright", children: ["v", VERSION] })] })] }));
 };

package/dist/views/dev/components/workflow_status.js

@@ -4,7 +4,7 @@ const WORKFLOW_STATUS_MAP = {
     running: { icon: '●', color: 'yellow' },
     completed: { icon: '●', color: 'green' },
     failed: { icon: '✗', color: 'red' },
-    canceled: { icon: '○', color: 'gray' },
+    cancelled: { icon: '○', color: 'gray' },
     terminated: { icon: '✗', color: 'gray' },
     timed_out: { icon: '✗', color: 'red' },
     continued_as_new: { icon: '↻', color: 'blue' }

package/dist/views/dev/dev_app.d.ts

@@ -3,4 +3,5 @@ export type Phase = 'waiting' | 'running' | 'failed';
 export declare const DevApp: React.FC<{
     dockerComposePath: string;
     onCleanup: () => Promise<void>;
+    attached?: boolean;
 }>;

package/dist/views/dev/dev_app.js

@@ -150,7 +150,7 @@ const overlayFor = (opts) => {
     }
     return null;
 };
-const Shell = ({ dockerComposePath, onCleanup }) => {
+const Shell = ({ dockerComposePath, onCleanup, attached }) => {
     const { exit } = useApp();
     const ui = useUiState();
     const [phase, setPhase] = useState('waiting');
@@ -160,7 +160,16 @@ const Shell = ({ dockerComposePath, onCleanup }) => {
         onServices: setServices,
         onAllHealthy: () => setPhase('running'),
         onFailure: () => setPhase('failed'),
-        onTimeout: () => exit(new Error('Timeout waiting for services to become healthy'))
+        // An attach/reconcile session monitors a stack it doesn't own, so a slow
+        // health check must not be fatal — drop into the dashboard and keep
+        // polling status. Only an owned fresh start treats the timeout as an error.
+        onTimeout: () => {
+            if (attached) {
+                setPhase('running');
+                return;
+            }
+            exit(new Error('Timeout waiting for services to become healthy'));
+        }
     });
     useStatusRefresh(dockerComposePath, phase !== 'waiting', setServices);
     useWorkflowRunsPolling(phase !== 'waiting', setRuns);
@@ -231,6 +240,6 @@ const Shell = ({ dockerComposePath, onCleanup }) => {
     if (overlay) {
         return (_jsx(Box, { flexDirection: "column", height: rows, paddingX: 1, children: overlay }));
     }
-    return (_jsxs(Box, { flexDirection: "column", height: rows, paddingX: 1, children: [_jsx(Header, { counters: counters }), _jsx(TabBar, { active: ui.tab, borderColor: RULE_PURPLE }), _jsx(SearchBar, { active: ui.search.open }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, height: contentRows, overflow: "hidden", children: [ui.tab === 'workflows' && _jsx(WorkflowsPanel, { workflows: workflows, runs: runs }), ui.tab === 'runs' && _jsx(RunsPanel, { runs: runs, height: contentRows }), ui.tab === 'services' && (_jsx(ServicesPanel, { height: contentRows, phase: phase, services: services, dockerComposePath: dockerComposePath })), ui.tab === 'help' && _jsx(HelpPanel, {})] }), _jsx(Toasts, {}), _jsx(Footer, { hints: footer.hints, itemCount: footer.itemCount, itemLabel: footer.itemLabel })] }));
+    return (_jsxs(Box, { flexDirection: "column", height: rows, paddingX: 1, children: [_jsx(Header, { counters: counters }), _jsx(TabBar, { active: ui.tab, borderColor: RULE_PURPLE }), _jsx(SearchBar, { active: ui.search.open }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, height: contentRows, overflow: "hidden", children: [ui.tab === 'workflows' && _jsx(WorkflowsPanel, { workflows: workflows, runs: runs }), ui.tab === 'runs' && _jsx(RunsPanel, { runs: runs, height: contentRows }), ui.tab === 'services' && (_jsx(ServicesPanel, { height: contentRows, phase: phase, services: services, dockerComposePath: dockerComposePath })), ui.tab === 'help' && _jsx(HelpPanel, {})] }), _jsx(Toasts, {}), _jsx(Footer, { hints: footer.hints, itemCount: footer.itemCount, itemLabel: footer.itemLabel, attached: attached })] }));
 };
-export const DevApp = ({ dockerComposePath, onCleanup }) => (_jsx(UiStateProvider, { children: _jsx(Shell, { dockerComposePath: dockerComposePath, onCleanup: onCleanup }) }));
+export const DevApp = ({ dockerComposePath, onCleanup, attached = false }) => (_jsx(UiStateProvider, { children: _jsx(Shell, { dockerComposePath: dockerComposePath, onCleanup: onCleanup, attached: attached }) }));

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

@@ -2,7 +2,7 @@ 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 { isTerminalStatus } from '#utils/format_workflow_result.js';
 import { createBoundedCache } from '#views/dev/utils/bounded_cache.js';
 const EMPTY_DETAIL = {
     result: null,
@@ -73,7 +73,7 @@ const readTraceLog = async (source) => {
     return JSON.parse(content);
 };
 // Run detail and trace fetches are best-effort. Many statuses (in-progress,
-// failed, canceled) don't have a fully-formed result or trace available at
+// failed, cancelled) don't have a fully-formed result or trace available at
 // any given moment, and that's expected — the caller falls back to
 // EMPTY_DETAIL and the UI renders whatever's there. Swallow everything.
 const fetchTrace = async (workflowId, runId) => {
@@ -104,8 +104,8 @@ const fetchResult = async (workflowId, runId) => {
 };
 // 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));
+// eventually finishes. `isTerminalStatus` is shared with `workflow monitor`.
+export const isTerminalRunStatus = (status) => isTerminalStatus(status) !== undefined;
 export const useRunDetail = (workflowId, runId, status) => {
     const [detail, setDetail] = useState(EMPTY_DETAIL);
     const fetchIdRef = useRef(0);

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

@@ -4,7 +4,7 @@ describe('isTerminalRunStatus', () => {
     it('returns true for completed states', () => {
         expect(isTerminalRunStatus('completed')).toBe(true);
         expect(isTerminalRunStatus('failed')).toBe(true);
-        expect(isTerminalRunStatus('canceled')).toBe(true);
+        expect(isTerminalRunStatus('cancelled')).toBe(true);
         expect(isTerminalRunStatus('terminated')).toBe(true);
         expect(isTerminalRunStatus('timed_out')).toBe(true);
     });

package/dist/views/dev/panels/runs_panel.js

@@ -21,7 +21,7 @@ const STATUS_ORDER = {
     failed: 1,
     timed_out: 2,
     terminated: 3,
-    canceled: 4,
+    cancelled: 4,
     continued_as_new: 5,
     completed: 6
 };
@@ -110,7 +110,7 @@ const DetailPane = ({ run, pane, rows }) => {
             }
             return _jsx(Text, { dimColor: true, children: "\u2014" });
         }
-        if (activePane === 'output' && hasJsonValue(pane.error)) {
+        if (activePane === 'output' && typeof pane.error === 'string') {
             const lines = String(pane.error).split('\n').slice(0, tabContentRows);
             return (_jsx(Box, { flexDirection: "column", children: lines.map((line, i) => (_jsx(Text, { color: "red", wrap: "truncate-end", children: line }, i))) }));
         }

package/oclif.manifest.json

@@ -416,6 +416,41 @@
         "show.js"
       ]
     },
+    "dev:down": {
+      "aliases": [],
+      "args": {},
+      "description": "Stop Output development services started by `output dev`\n\nUseful after `output dev -d`, or when an attached `output dev` session\nleft the services running on quit.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --compose-file ./custom-docker-compose.yml"
+      ],
+      "flags": {
+        "compose-file": {
+          "char": "f",
+          "description": "Path to a custom docker-compose file",
+          "name": "compose-file",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "dev:down",
+      "pluginAlias": "@outputai/cli",
+      "pluginName": "@outputai/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "dev",
+        "down.js"
+      ]
+    },
     "dev:eject": {
       "aliases": [],
       "args": {},
@@ -463,9 +498,10 @@
     "dev": {
       "aliases": [],
       "args": {},
-      "description": "Start Output development services (auto-restarts worker on file changes)\n\nTo run a second dev stack concurrently, override host ports in .env:\n\n  OUTPUT_API_HOST_PORT=3002\n  OUTPUT_TEMPORAL_UI_HOST_PORT=8081\n  OUTPUT_TEMPORAL_HOST_PORT=7234",
+      "description": "Start Output development services (auto-restarts worker on file changes)\n\nIf services are already running (e.g. after `output dev -d`), this attaches\nto monitor them rather than treating our own containers as a port collision.\nQuitting an attached session leaves the services running — stop them with\n`output dev down`.\n\nTo run a second dev stack concurrently, give it its own compose project and\nhost ports in .env — without DOCKER_SERVICE_NAME both checkouts share one\nstack, and the second will attach to the first instead of starting:\n\n  DOCKER_SERVICE_NAME=output-sdk-two\n  OUTPUT_API_HOST_PORT=3002\n  OUTPUT_TEMPORAL_UI_HOST_PORT=8081\n  OUTPUT_TEMPORAL_HOST_PORT=7234",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --detached",
         "<%= config.bin %> <%= command.id %> --compose-file ./custom-docker-compose.yml",
         "<%= config.bin %> <%= command.id %> --image-pull-policy missing"
       ],
@@ -1200,9 +1236,18 @@
         "<%= config.bin %> <%= command.id %> simple basic_input",
         "<%= config.bin %> <%= command.id %> simple --input '{\"values\":[1,2,3]}'",
         "<%= config.bin %> <%= command.id %> simple --input input.json",
-        "<%= config.bin %> <%= command.id %> simple --input '{\"key\":\"value\"}' --catalog my-catalog"
+        "<%= config.bin %> <%= command.id %> simple --input input.json --monitor",
+        "<%= config.bin %> <%= command.id %> simple --input '{\"key\":\"value\"}' --catalog my-catalog",
+        "<%= config.bin %> <%= command.id %> simple --json"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "input": {
           "char": "i",
           "description": "Workflow input as JSON string or file path (overrides scenario)",
@@ -1227,6 +1272,44 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "monitor": {
+          "char": "m",
+          "description": "After starting, attach and stream status updates until the workflow ends (Ctrl+C detaches; the workflow keeps running). Cannot be combined with --json",
+          "name": "monitor",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "include-payloads": {
+          "dependsOn": [
+            "monitor"
+          ],
+          "description": "Include decoded step input/output payloads (requires --monitor)",
+          "helpGroup": "MONITOR",
+          "name": "include-payloads",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interval": {
+          "dependsOn": [
+            "monitor"
+          ],
+          "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. (requires --monitor) [default: 2500]",
+          "helpGroup": "MONITOR",
+          "name": "interval",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "color": {
+          "dependsOn": [
+            "monitor"
+          ],
+          "description": "Colorize status output (use --no-color to disable) (requires --monitor)",
+          "helpGroup": "MONITOR",
+          "name": "color",
+          "allowNo": true,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1236,7 +1319,7 @@
       "pluginName": "@outputai/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1354,10 +1437,8 @@
         "terminate.js"
       ]
     },
-    "workflow:test_eval": {
-      "aliases": [
-        "workflow:test"
-      ],
+    "workflow:test": {
+      "aliases": [],
       "args": {
         "workflowName": {
           "description": "Name of the workflow to test",
@@ -1426,7 +1507,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workflow:test_eval",
+      "id": "workflow:test",
       "pluginAlias": "@outputai/cli",
       "pluginName": "@outputai/cli",
       "pluginType": "core",
@@ -1437,7 +1518,7 @@
         "dist",
         "commands",
         "workflow",
-        "test_eval.js"
+        "test.js"
       ]
     },
     "workflow:dataset:generate": {
@@ -1671,5 +1752,5 @@
       ]
     }
   },
-  "version": "0.10.1-next.f6a7c1a.0"
+  "version": "0.11.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outputai/cli",
-  "version": "0.10.1-next.f6a7c1a.0",
+  "version": "0.11.0",
   "description": "CLI for Output.ai workflow generation",
   "type": "module",
   "main": "dist/index.js",
@@ -27,20 +27,18 @@
     "cli-table3": "0.6.5",
     "date-fns": "4.1.0",
     "debug": "4.4.3",
-    "dotenv": "17.4.2",
     "handlebars": "4.7.9",
     "ink": "7.0.1",
     "ink-spinner": "5.0.0",
-    "js-yaml": "4.1.1",
+    "js-yaml": "4.3.1",
     "json-schema-library": "11.4.0",
-    "ky": "1.14.3",
+    "ky": "2.0.2",
     "react": "19.2.5",
     "semver": "7.7.4",
-    "undici": "8.5.0",
-    "yaml": "^2.8.3",
-    "@outputai/credentials": "0.10.1-next.f6a7c1a.0",
-    "@outputai/evals": "0.10.1-next.f6a7c1a.0",
-    "@outputai/llm": "0.10.1-next.f6a7c1a.0"
+    "undici": "8.9.0",
+    "@outputai/credentials": "0.11.0",
+    "@outputai/evals": "0.11.0",
+    "@outputai/llm": "0.11.0"
   },
   "devDependencies": {
     "@types/cli-progress": "3.11.6",