@outputai/cli 0.10.1-next.b7b2fbe.0 → 0.10.1-next.bf95a6f.0

package/dist/api/generated/api.d.ts

@@ -66,22 +66,29 @@ export interface Workflow {
     /** Alternative names that resolve to this workflow */
     aliases?: string[];
 }
+/**
+ * Legacy trace information containing nested destinations
+ * @nullable
+ */
+export type TraceInfoV1 = {
+    /** Available destinations for trace data */
+    destinations?: {
+        /** Absolute path to local trace file, omitted if not saved locally */
+        local?: string;
+        /** Remote trace location (e.g., S3 URI), omitted if not saved remotely */
+        remote?: string;
+    };
+} | null;
 /**
  * Available destinations for trace data
+ * @nullable
  */
-export type TraceInfoDestinations = {
+export type TraceInfoV2 = {
     /** Absolute path to local trace file, omitted if not saved locally */
     local?: string;
     /** Remote trace location (e.g., S3 URI), omitted if not saved remotely */
     remote?: string;
-};
-/**
- * An object with information about the trace generated by the execution
- */
-export interface TraceInfo {
-    /** Available destinations for trace data */
-    destinations?: TraceInfoDestinations;
-}
+} | null;
 /**
  * The workflow input
  */
@@ -148,7 +155,7 @@ export declare const WorkflowRunInfoStatus: {
     readonly running: "running";
     readonly completed: "completed";
     readonly failed: "failed";
-    readonly canceled: "canceled";
+    readonly cancelled: "cancelled";
     readonly terminated: "terminated";
     readonly timed_out: "timed_out";
     readonly continued_as_new: "continued_as_new";
@@ -180,7 +187,7 @@ export interface WorkflowRunsResponse {
  */
 export type WorkflowStatusResponseStatus = typeof WorkflowStatusResponseStatus[keyof typeof WorkflowStatusResponseStatus];
 export declare const WorkflowStatusResponseStatus: {
-    readonly canceled: "canceled";
+    readonly cancelled: "cancelled";
     readonly completed: "completed";
     readonly continued_as_new: "continued_as_new";
     readonly failed: "failed";
@@ -204,20 +211,33 @@ export interface WorkflowStatusResponse {
 /**
  * The workflow execution status
  */
-export type WorkflowResultResponseStatus = typeof WorkflowResultResponseStatus[keyof typeof WorkflowResultResponseStatus];
-export declare const WorkflowResultResponseStatus: {
+export type WorkflowResultStatus = typeof WorkflowResultStatus[keyof typeof WorkflowResultStatus];
+export declare const WorkflowResultStatus: {
     readonly completed: "completed";
     readonly failed: "failed";
-    readonly canceled: "canceled";
+    readonly cancelled: "cancelled";
     readonly terminated: "terminated";
     readonly timed_out: "timed_out";
     readonly continued_as_new: "continued_as_new";
 };
+/**
+ * Structured error details captured from the workflow or activity failure
+ * @nullable
+ */
+export type SerializedWorkflowError = {
+    /** Failing activity type, omitted when the failure did not originate in an activity */
+    activityType?: string;
+    /** Original error class name */
+    name?: string;
+    /** Original error message */
+    message?: string;
+    [key: string]: unknown;
+} | null;
 /**
  * Structured failure details if the workflow failed, null otherwise
  * @nullable
  */
-export type WorkflowResultResponseErrorDetails = {
+export type WorkflowResultV1ResponseErrorDetails = {
     /**
        * Friendly failure message (from the underlying application error)
        * @nullable
@@ -246,29 +266,64 @@ export type WorkflowResultResponseErrorDetails = {
         [key: string]: unknown;
     } | null;
 } | null | null;
-export interface WorkflowResultResponse {
+/**
+ * Legacy wrapped workflow result
+ * @deprecated
+ */
+export interface WorkflowResultV1Response {
     /** The workflow execution id */
-    workflowId?: string;
-    /** The specific run id for this execution */
-    runId?: string;
+    workflowId: string;
+    /**
+       * The specific run id for this execution
+       * @nullable
+       */
+    runId: string | null;
+    status: WorkflowResultStatus;
     /** The original input passed to the workflow, null if unavailable */
-    input?: unknown;
+    input: unknown | null;
     /** The result of workflow, null if workflow failed */
-    output?: unknown;
-    trace?: TraceInfo;
-    /** The workflow execution status */
-    status?: WorkflowResultResponseStatus;
+    output: unknown | null;
+    trace: TraceInfoV1 | null;
     /**
        * Error message if workflow failed, null otherwise
        * @nullable
        */
-    error?: string | null;
+    error: string | null;
     /**
        * Structured failure details if the workflow failed, null otherwise
        * @nullable
        */
-    errorDetails?: WorkflowResultResponseErrorDetails;
+    errorDetails: WorkflowResultV1ResponseErrorDetails;
 }
+/**
+ * Workflow result response version
+ */
+export type WorkflowResultV2ResponseV = typeof WorkflowResultV2ResponseV[keyof typeof WorkflowResultV2ResponseV];
+export declare const WorkflowResultV2ResponseV: {
+    readonly NUMBER_2: "2";
+};
+/**
+ * Current workflow result with direct output and memo-based trace information
+ */
+export interface WorkflowResultV2Response {
+    /** Workflow result response version */
+    v: WorkflowResultV2ResponseV;
+    /** The workflow execution id */
+    workflowId: string;
+    /**
+       * The specific run id for this execution
+       * @nullable
+       */
+    runId: string | null;
+    status: WorkflowResultStatus;
+    /** The original input passed to the workflow, null if unavailable */
+    input: unknown | null;
+    /** Direct workflow output, null if no output is available */
+    output: unknown | null;
+    trace: TraceInfoV2 | null;
+    error: (SerializedWorkflowError | null) | null;
+}
+export type WorkflowResultResponse = WorkflowResultV2Response | WorkflowResultV1Response;
 export interface WorkflowInputResponse {
     /** The workflow execution id */
     workflowId: string;
@@ -393,6 +448,12 @@ export type GetWorkflowIdHistoryParams = {
      * Include decoded input/output payloads in events
      */
     includePayloads?: boolean;
+    /**
+     * When set, long-poll for a new event once caught up to the end of history instead of returning immediately, bounding the block by this many milliseconds. Clamped to the server's configured maximum — a caller can shorten the wait but never exceed it. Omit for an immediate response; on timeout returns the same page's cursor unchanged with an empty events array so the caller can retry. Lets a poller keep the block roughly aligned with its own tick interval.
+    
+     * @minimum 1
+     */
+    longPollTimeoutMs?: number;
 };
 /**
  * Workflow metadata (null on subsequent pages)
@@ -431,6 +492,12 @@ export type GetWorkflowIdRunsRidHistoryParams = {
      * Include decoded input/output payloads in events
      */
     includePayloads?: boolean;
+    /**
+     * When set, long-poll for a new event once caught up to the end of history instead of returning immediately, bounding the block by this many milliseconds. Clamped to the server's configured maximum — a caller can shorten the wait but never exceed it. Omit for an immediate response; on timeout returns the same page's cursor unchanged with an empty events array so the caller can retry. Lets a poller keep the block roughly aligned with its own tick interval.
+    
+     * @minimum 1
+     */
+    longPollTimeoutMs?: number;
 };
 /**
  * Workflow metadata (null on subsequent pages)

package/dist/api/generated/api.js

@@ -19,13 +19,13 @@ export const WorkflowRunInfoStatus = {
     running: 'running',
     completed: 'completed',
     failed: 'failed',
-    canceled: 'canceled',
+    cancelled: 'cancelled',
     terminated: 'terminated',
     timed_out: 'timed_out',
     continued_as_new: 'continued_as_new',
 };
 export const WorkflowStatusResponseStatus = {
-    canceled: 'canceled',
+    cancelled: 'cancelled',
     completed: 'completed',
     continued_as_new: 'continued_as_new',
     failed: 'failed',
@@ -34,14 +34,17 @@ export const WorkflowStatusResponseStatus = {
     timed_out: 'timed_out',
     unspecified: 'unspecified',
 };
-export const WorkflowResultResponseStatus = {
+export const WorkflowResultStatus = {
     completed: 'completed',
     failed: 'failed',
-    canceled: 'canceled',
+    cancelled: 'cancelled',
     terminated: 'terminated',
     timed_out: 'timed_out',
     continued_as_new: 'continued_as_new',
 };
+export const WorkflowResultV2ResponseV = {
+    NUMBER_2: '2',
+};
 ;
 export const getGetHealthUrl = () => {
     return `/health`;

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.b7b2fbe.0}
+    image: outputai/api:${OUTPUT_API_VERSION:-0.10.1-next.bf95a6f.0}
     init: true
     networks:
       - main
@@ -118,7 +118,7 @@ services:
       - OUTPUT_CATALOG_ID=${OUTPUT_CATALOG_ID:-main}
       - OUTPUT_REDIS_URL=redis://redis:6379
       - OUTPUT_TRACE_LOCAL_ON=${OUTPUT_TRACE_LOCAL_ON:-true}
-      - OUTPUT_TRACE_HOST_PATH=${PWD}/logs
+      - OUTPUT_TRACE_HOST_PATH=${OUTPUT_TRACE_HOST_PATH:-${PWD}/logs}
       - OUTPUT_TRACE_HTTP_VERBOSE=${OUTPUT_TRACE_HTTP_VERBOSE:-true}
       - OUTPUT_ENABLE_ATTRIBUTE_SIGNAL_EMISSION=${OUTPUT_ENABLE_ATTRIBUTE_SIGNAL_EMISSION:-false}
       - TEMPORAL_ADDRESS=temporal:7233

package/dist/commands/dev/down.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class DevDown extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        'compose-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/dev/down.js

@@ -0,0 +1,34 @@
+import { Command, Flags } from '@oclif/core';
+import { validateDockerEnvironment, stopDockerCompose, resolveDockerComposePath } from '#services/docker.js';
+import { getErrorMessage } from '#utils/error_utils.js';
+export default class DevDown extends Command {
+    static description = [
+        'Stop Output development services started by `output dev`',
+        '',
+        'Useful after `output dev -d`, or when an attached `output dev` session',
+        'left the services running on quit.'
+    ].join('\n');
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --compose-file ./custom-docker-compose.yml'
+    ];
+    static args = {};
+    static flags = {
+        'compose-file': Flags.string({
+            description: 'Path to a custom docker-compose file',
+            required: false,
+            char: 'f'
+        })
+    };
+    async run() {
+        const { flags } = await this.parse(DevDown);
+        validateDockerEnvironment();
+        try {
+            const dockerComposePath = await resolveDockerComposePath(flags['compose-file']);
+            await stopDockerCompose(dockerComposePath);
+        }
+        catch (error) {
+            this.error(getErrorMessage(error), { exit: 1 });
+        }
+    }
+}

package/dist/commands/dev/down.spec.js

@@ -0,0 +1,71 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import * as dockerService from '#services/docker.js';
+import DevDown from './down.js';
+vi.mock('#services/docker.js', () => ({
+    validateDockerEnvironment: vi.fn(),
+    stopDockerCompose: vi.fn().mockResolvedValue(undefined),
+    resolveDockerComposePath: vi.fn().mockResolvedValue('/path/to/docker-compose-dev.yml')
+}));
+const makeCmd = () => {
+    const cmd = new DevDown([], {});
+    cmd.log = vi.fn();
+    cmd.error = vi.fn();
+    Object.defineProperty(cmd, 'parse', {
+        value: vi.fn().mockResolvedValue({ flags: { 'compose-file': undefined }, args: {} }),
+        configurable: true
+    });
+    return cmd;
+};
+describe('dev down command', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(dockerService.validateDockerEnvironment).mockReturnValue(undefined);
+        vi.mocked(dockerService.stopDockerCompose).mockResolvedValue(undefined);
+        vi.mocked(dockerService.resolveDockerComposePath).mockResolvedValue('/path/to/docker-compose-dev.yml');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('command structure', () => {
+        it('should have a description mentioning stopping services', () => {
+            expect(DevDown.description).toBeDefined();
+            expect(DevDown.description).toContain('Stop');
+        });
+        it('should have no required arguments', () => {
+            expect(Object.keys(DevDown.args)).toHaveLength(0);
+        });
+        it('should have a compose-file flag', () => {
+            expect(DevDown.flags['compose-file']).toBeDefined();
+            expect(DevDown.flags['compose-file'].char).toBe('f');
+        });
+    });
+    describe('run', () => {
+        it('validates docker and stops the default stack', async () => {
+            const cmd = makeCmd();
+            await cmd.run();
+            expect(dockerService.validateDockerEnvironment).toHaveBeenCalled();
+            expect(dockerService.stopDockerCompose).toHaveBeenCalledWith('/path/to/docker-compose-dev.yml');
+            expect(cmd.error).not.toHaveBeenCalled();
+        });
+        it('errors with the command formatter when the compose file is missing', async () => {
+            vi.mocked(dockerService.resolveDockerComposePath).mockRejectedValue(new Error('File not found'));
+            const cmd = makeCmd();
+            cmd.error = vi.fn(() => {
+                throw new Error('oclif-error-thrown');
+            });
+            await expect(cmd.run()).rejects.toThrow();
+            expect(cmd.error).toHaveBeenCalledWith(expect.stringContaining('File not found'), { exit: 1 });
+            expect(dockerService.stopDockerCompose).not.toHaveBeenCalled();
+        });
+        it('surfaces a teardown failure as an actionable error', async () => {
+            vi.mocked(dockerService.stopDockerCompose).mockRejectedValue(new Error('compose down failed'));
+            const cmd = makeCmd();
+            cmd.error = vi.fn(() => {
+                throw new Error('oclif-error-thrown');
+            });
+            await expect(cmd.run()).rejects.toThrow();
+            expect(cmd.error).toHaveBeenCalledWith(expect.stringContaining('compose down failed'), { exit: 1 });
+        });
+    });
+});

package/dist/commands/dev/index.d.ts

@@ -10,4 +10,8 @@ export default class Dev extends Command {
     };
     private dockerProcess;
     run(): Promise<void>;
+    private probePorts;
+    private probePortsIfFreshStart;
+    private getServiceStatusOrWarn;
+    private upDetachedOrError;
 }