@outputai/cli 0.10.1-next.2cbd0a2.0 → 0.10.1-next.2e221c7.0

package/dist/api/http_client.js

@@ -18,7 +18,7 @@ const apiState = {};
 function getApi() {
     if (!apiState.api) {
         apiState.api = ky.create({
-            prefixUrl: config.apiUrl,
+            prefix: config.apiUrl,
             timeout: config.requestTimeout,
             retry: {
                 limit: 2,
@@ -28,7 +28,7 @@ function getApi() {
             throwHttpErrors: false,
             hooks: {
                 beforeRequest: [
-                    request => {
+                    ({ request }) => {
                         if (config.apiToken) {
                             request.headers.set('Authorization', `Basic ${config.apiToken}`);
                         }

package/dist/assets/docker/docker-compose-dev.yml

@@ -80,7 +80,7 @@ services:
         condition: service_healthy
       worker:
         condition: service_healthy
-    image: outputai/api:${OUTPUT_API_VERSION:-0.10.1-next.2cbd0a2.0}
+    image: outputai/api:${OUTPUT_API_VERSION:-0.10.1-next.2e221c7.0}
     init: true
     networks:
       - main

package/dist/commands/workflow/run.js

@@ -63,7 +63,14 @@ export default class WorkflowRun extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(WorkflowRun);
-        const input = await resolveInput(args.workflowName, args.scenario, flags.input, 'run', flags.catalog);
+        const input = await resolveInput({
+            workflowName: args.workflowName,
+            scenario: args.scenario,
+            inputFlag: flags.input,
+            commandName: 'run',
+            catalog: flags.catalog,
+            json: this.jsonEnabled()
+        });
         this.log(`Executing workflow: ${args.workflowName}...`);
         const response = await executeWorkflow({
             body: {

package/dist/commands/workflow/run.spec.js

@@ -64,7 +64,12 @@ describe('workflow run command', () => {
                 headers: new Headers()
             });
             await cmd.run();
-            expect(resolveInput).toHaveBeenCalledWith('my_workflow', undefined, undefined, 'run', undefined);
+            expect(resolveInput).toHaveBeenCalledWith(expect.objectContaining({
+                workflowName: 'my_workflow',
+                commandName: 'run',
+                catalog: undefined,
+                json: false
+            }));
             expect(postWorkflowRun).toHaveBeenCalledTimes(1);
             expect(postWorkflowRun).toHaveBeenCalledWith({ workflowName: 'my_workflow', input: { key: 'value' }, catalog: undefined }, expect.objectContaining({ config: { timeout: 600000 } }));
             expect(cmd.log).toHaveBeenCalledWith('Executing workflow: my_workflow...');
@@ -83,7 +88,12 @@ describe('workflow run command', () => {
                 headers: new Headers()
             });
             await cmd.run();
-            expect(resolveInput).toHaveBeenCalledWith('my_workflow', 'basic', undefined, 'run', 'my-catalog');
+            expect(resolveInput).toHaveBeenCalledWith(expect.objectContaining({
+                workflowName: 'my_workflow',
+                scenario: 'basic',
+                commandName: 'run',
+                catalog: 'my-catalog'
+            }));
             expect(postWorkflowRun).toHaveBeenCalledWith(expect.objectContaining({ catalog: 'my-catalog' }), expect.anything());
         });
         it('retries when response has Retry-After and succeeds on second attempt', async () => {

package/dist/commands/workflow/start.d.ts

@@ -1,6 +1,8 @@
 import { Command } from '@oclif/core';
+import { type PostWorkflowStart200 } from '#api/generated/api.js';
 export default class WorkflowStart extends Command {
     static description: string;
+    static enableJsonFlag: boolean;
     static examples: string[];
     static args: {
         workflowName: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -10,6 +12,6 @@ export default class WorkflowStart extends Command {
         input: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         catalog: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<void>;
+    run(): Promise<PostWorkflowStart200>;
     catch(error: Error): Promise<void>;
 }

package/dist/commands/workflow/start.js

@@ -4,11 +4,13 @@ import { handleApiError } from '#utils/error_handler.js';
 import { resolveInput } from '#utils/resolve_input.js';
 export default class WorkflowStart extends Command {
     static description = 'Start a workflow asynchronously without waiting for completion';
+    static enableJsonFlag = true;
     static examples = [
         '<%= 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 \'{"key":"value"}\' --catalog my-catalog',
+        '<%= config.bin %> <%= command.id %> simple --json'
     ];
     static args = {
         workflowName: Args.string({
@@ -37,7 +39,14 @@ export default class WorkflowStart extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(WorkflowStart);
-        const input = await resolveInput(args.workflowName, args.scenario, flags.input, 'start', flags.catalog);
+        const input = await resolveInput({
+            workflowName: args.workflowName,
+            scenario: args.scenario,
+            inputFlag: flags.input,
+            commandName: 'start',
+            catalog: flags.catalog,
+            json: this.jsonEnabled()
+        });
         this.log(`Starting workflow: ${args.workflowName}...`);
         const response = await postWorkflowStart({
             workflowName: args.workflowName,
@@ -57,6 +66,7 @@ export default class WorkflowStart extends Command {
             `Use "workflow result ${result.workflowId || '<workflow-id>'}" to get the workflow result when complete`
         ].join('\n');
         this.log(`\n${output}`);
+        return result;
     }
     async catch(error) {
         return handleApiError(error, (...args) => this.error(...args), {

package/dist/commands/workflow/start.spec.js

@@ -36,13 +36,17 @@ describe('workflow start command', () => {
             expect(WorkflowStart.flags.catalog.env).toBe('OUTPUT_CATALOG_ID');
             expect(WorkflowStart.flags.catalog.char).toBe('c');
         });
+        it('enables the built-in --json flag', async () => {
+            const WorkflowStart = (await import('./start.js')).default;
+            expect(WorkflowStart.enableJsonFlag).toBe(true);
+        });
     });
     describe('run()', () => {
-        const createCommand = async (flagOverrides = {}) => {
+        const createCommand = async (flagOverrides = {}, argv = ['my_workflow']) => {
             const WorkflowStart = (await import('./start.js')).default;
             const { postWorkflowStart } = await import('#api/generated/api.js');
             const { resolveInput } = await import('#utils/resolve_input.js');
-            const cmd = new WorkflowStart(['my_workflow'], {});
+            const cmd = new WorkflowStart(argv, {});
             cmd.log = vi.fn();
             cmd.error = vi.fn(() => {
                 throw new Error('error called');
@@ -61,9 +65,15 @@ describe('workflow start command', () => {
                 status: 200,
                 headers: new Headers()
             });
-            await cmd.run();
-            expect(resolveInput).toHaveBeenCalledWith('my_workflow', undefined, undefined, 'start', 'my-catalog');
+            const result = await cmd.run();
+            expect(resolveInput).toHaveBeenCalledWith(expect.objectContaining({
+                workflowName: 'my_workflow',
+                commandName: 'start',
+                catalog: 'my-catalog',
+                json: false
+            }));
             expect(postWorkflowStart).toHaveBeenCalledWith(expect.objectContaining({ workflowName: 'my_workflow', catalog: 'my-catalog' }));
+            expect(result).toEqual({ workflowId: 'wf-123' });
         });
         it('passes undefined catalog through when none is set', async () => {
             const { cmd, postWorkflowStart, resolveInput } = await createCommand();
@@ -74,7 +84,22 @@ describe('workflow start command', () => {
                 headers: new Headers()
             });
             await cmd.run();
-            expect(resolveInput).toHaveBeenCalledWith('my_workflow', undefined, undefined, 'start', undefined);
+            expect(resolveInput).toHaveBeenCalledWith(expect.objectContaining({
+                workflowName: 'my_workflow',
+                commandName: 'start',
+                catalog: undefined
+            }));
+        });
+        it('tells resolveInput to stay quiet when --json is set', async () => {
+            const { cmd, postWorkflowStart, resolveInput } = await createCommand({}, ['my_workflow', 'basic', '--json']);
+            resolveInput.mockResolvedValue({});
+            postWorkflowStart.mockResolvedValue({
+                data: { workflowId: 'wf-123' },
+                status: 200,
+                headers: new Headers()
+            });
+            await cmd.run();
+            expect(resolveInput).toHaveBeenCalledWith(expect.objectContaining({ json: true }));
         });
     });
 });

package/dist/generated/framework_version.json

@@ -1,3 +1,3 @@
 {
-    "framework": "0.10.1-next.2cbd0a2.0"
+    "framework": "0.10.1-next.2e221c7.0"
 }

package/dist/templates/agent_instructions/CLAUDE.md.template

@@ -44,7 +44,7 @@ config/
 ## Key Conventions
 
 - **Workflows are deterministic**: No I/O, no `Date.now()`, no `Math.random()` in `workflow.ts`. All side effects go in steps or evaluators.
-- **HTTP clients**: Always use `httpClient` from `@outputai/http` -- never raw `fetch` or `axios`. This enables automatic tracing and cost tracking.
+- **HTTP clients**: Use `outputFetch` or `createKyClient` from `@outputai/http` instead of raw `fetch` or `axios`. Requests are automatically traced; use `addRequestCost` when cost tracking is needed.
 - **LLM calls**: Use `generateText` from `@outputai/llm` with `.prompt` files. Never call LLM APIs directly.
 
 ---

package/dist/templates/project/src/clients/jina.ts.template

@@ -1,4 +1,4 @@
-import { httpClient } from '@outputai/http';
+import { createKyClient } from '@outputai/http';
 
 export interface JinaReaderResponse {
   code: number;
@@ -12,13 +12,13 @@ export interface JinaReaderResponse {
   };
 }
 
-const jinaClient = httpClient( {
-  prefixUrl: 'https://r.jina.ai',
+const client = createKyClient( {
+  prefix: 'https://r.jina.ai',
   timeout: 30000
 } );
 
 export async function fetchBlogContent( url: string ): Promise<JinaReaderResponse> {
-  const response = await jinaClient.post( '', {
+  const response = await client.post( '', {
     json: { url },
     headers: {
       'Accept': 'application/json',

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/oclif.manifest.json

@@ -1236,9 +1236,17 @@
         "<%= 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 '{\"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)",
@@ -1272,7 +1280,7 @@
       "pluginName": "@outputai/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -1707,5 +1715,5 @@
       ]
     }
   },
-  "version": "0.10.1-next.2cbd0a2.0"
+  "version": "0.10.1-next.2e221c7.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outputai/cli",
-  "version": "0.10.1-next.2cbd0a2.0",
+  "version": "0.10.1-next.2e221c7.0",
   "description": "CLI for Output.ai workflow generation",
   "type": "module",
   "main": "dist/index.js",
@@ -33,14 +33,14 @@
     "ink-spinner": "5.0.0",
     "js-yaml": "4.1.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/evals": "0.10.1-next.2cbd0a2.0",
-    "@outputai/llm": "0.10.1-next.2cbd0a2.0",
-    "@outputai/credentials": "0.10.1-next.2cbd0a2.0"
+    "@outputai/evals": "0.10.1-next.2e221c7.0",
+    "@outputai/credentials": "0.10.1-next.2e221c7.0",
+    "@outputai/llm": "0.10.1-next.2e221c7.0"
   },
   "devDependencies": {
     "@types/cli-progress": "3.11.6",