runwork 0.3.0 → 0.4.0

package/dist/generated/version.js

@@ -1,2 +1,2 @@
 // Auto-generated by scripts/embed-types.ts -- do not edit
-export const VERSION = "0.3.0";
+export const VERSION = "0.4.0";

package/dist/index.js

@@ -9,13 +9,17 @@ import { upgradeCommand } from './commands/upgrade.js';
 import { logoutCommand } from './commands/logout.js';
 import { integrationsCommand } from './commands/integrations.js';
 import { openCommand } from './commands/open.js';
+import { infoCommand } from './commands/info.js';
 import { handleGitCredentialRequest } from './git/credentials.js';
 import { VERSION } from './generated/version.js';
 const program = new Command();
 program
     .name('runwork')
     .description('Runwork CLI - local development for Runwork apps')
-    .version(VERSION);
+    .version(VERSION)
+    .option('--json', 'Output as JSON (auto-enabled when stdout is not a TTY)');
+// Info first -- it's the agent discovery entry point
+program.addCommand(infoCommand);
 program.addCommand(loginCommand);
 program.addCommand(initCommand);
 program.addCommand(cloneCommand);
@@ -26,6 +30,7 @@ program.addCommand(upgradeCommand);
 program.addCommand(logoutCommand);
 program.addCommand(integrationsCommand);
 program.addCommand(openCommand);
+program.addHelpText('after', '\nFor AI agents: run "runwork info --json" to discover app context and available commands.');
 const credentialHelper = program
     .command('git-credential-helper', { hidden: true })
     .argument('<action>', 'Credential action (get/store/erase)')

package/dist/logs/tailer.d.ts

@@ -7,6 +7,7 @@ interface TailerOptions {
     toFile: boolean;
     intervalMs?: number;
     getFilter?: () => 'all' | 'events' | 'runtime';
+    useJson?: boolean;
 }
 export declare function formatLogLine(tag: string, line: string): string;
 export declare function formatRelativeTime(eventTimestamp?: string): string;

package/dist/logs/tailer.js

@@ -54,7 +54,7 @@ export function startLogTailer(options) {
     let seenEventIds = new Set();
     let stopped = false;
     let timer;
-    function writeLineFiltered(line, tag) {
+    function writeLineFiltered(line, tag, jsonData) {
         // Always write to file (stripped of ANSI codes)
         if (toFile) {
             try {
@@ -64,9 +64,14 @@ export function startLogTailer(options) {
                 // Silently ignore file write errors
             }
         }
-        // Filter for terminal
         if (!toTerminal)
             return;
+        // JSON mode: emit NDJSON line
+        if (options.useJson && jsonData) {
+            process.stdout.write(JSON.stringify(jsonData) + '\n');
+            return;
+        }
+        // Human mode: apply filter and print colored line
         const filter = options.getFilter?.() || 'all';
         if (filter === 'events' && tag !== 'EVENT')
             return;
@@ -91,7 +96,9 @@ export function startLogTailer(options) {
                 const newContent = logs.stdout.slice(lastStdoutLength);
                 const lines = newContent.split('\n').filter(Boolean);
                 for (const line of lines) {
-                    writeLineFiltered(formatLogLine('RUNTIME', line), 'RUNTIME');
+                    writeLineFiltered(formatLogLine('RUNTIME', line), 'RUNTIME', {
+                        event: 'log', type: 'runtime', message: line, timestamp: new Date().toISOString(),
+                    });
                 }
                 lastStdoutLength = logs.stdout.length;
             }
@@ -99,7 +106,9 @@ export function startLogTailer(options) {
                 const newContent = logs.stderr.slice(lastStderrLength);
                 const lines = newContent.split('\n').filter(Boolean);
                 for (const line of lines) {
-                    writeLineFiltered(formatLogLine('ERROR', line), 'ERROR');
+                    writeLineFiltered(formatLogLine('ERROR', line), 'ERROR', {
+                        event: 'log', type: 'error', message: line, timestamp: new Date().toISOString(),
+                    });
                 }
                 lastStderrLength = logs.stderr.length;
             }
@@ -135,7 +144,9 @@ export function startLogTailer(options) {
                         }
                     }
                     const relTime = gray(formatRelativeTime(event.timestamp));
-                    writeLineFiltered(`  ${relTime} ${yellow('EVENT  ')}  ${event.type}: ${detail}`, 'EVENT');
+                    writeLineFiltered(`  ${relTime} ${yellow('EVENT  ')}  ${event.type}: ${detail}`, 'EVENT', {
+                        event: 'log', type: 'event', eventType: event.type, detail, metadata: event.metadata || {}, timestamp: event.timestamp,
+                    });
                     seenEventIds.add(event.id);
                 }
                 // Cap the set size to prevent unbounded growth (keep last 200 IDs)

package/dist/types.d.ts

@@ -26,3 +26,61 @@ export interface WorkspaceInfo {
     id: string;
     name: string;
 }
+export interface RegistryEntity {
+    entityName: string;
+    appId: string;
+    appName: string;
+    schema?: Record<string, unknown>;
+    deploymentMode?: 'preview' | 'production';
+}
+export interface RegistrySchedule {
+    name: string;
+    appId: string;
+    appName: string;
+    schedule?: string;
+    description?: string;
+    deploymentMode?: 'preview' | 'production';
+}
+export interface RegistryWorkflow {
+    name: string;
+    appId: string;
+    appName: string;
+    description?: string;
+    deploymentMode?: 'preview' | 'production';
+}
+export interface RegistryAgent {
+    name: string;
+    appId: string;
+    appName: string;
+    type?: string;
+    description?: string;
+    deploymentMode?: 'preview' | 'production';
+}
+export interface RegistryEndpoint {
+    appId: string;
+    appName: string;
+    path: string;
+    method: string;
+    description?: string;
+    deploymentMode?: 'preview' | 'production';
+}
+export interface RegistryComponent {
+    componentName: string;
+    appId: string;
+    appName: string;
+    deploymentMode?: 'preview' | 'production';
+}
+export interface RegistryFileStorage {
+    appId: string;
+    appName: string;
+    deploymentMode?: 'preview' | 'production';
+}
+export interface WorkspaceAllData {
+    entities: RegistryEntity[];
+    schedules: RegistrySchedule[];
+    workflows: RegistryWorkflow[];
+    agents: RegistryAgent[];
+    endpoints: RegistryEndpoint[];
+    components: RegistryComponent[];
+    fileStorages: RegistryFileStorage[];
+}

package/dist/utils/__tests__/output.test.d.ts

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

package/dist/utils/__tests__/output.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect, vi } from 'vitest';
+import { shouldOutputJson, jsonOut, jsonLine } from '../output.js';
+describe('shouldOutputJson', () => {
+    it('returns true when json flag is true', () => {
+        expect(shouldOutputJson(true)).toBe(true);
+    });
+    it('returns false when json flag is false (--no-json)', () => {
+        expect(shouldOutputJson(false)).toBe(false);
+    });
+    it('returns false when undefined and stdout is TTY', () => {
+        const original = process.stdout.isTTY;
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        expect(shouldOutputJson(undefined)).toBe(false);
+        Object.defineProperty(process.stdout, 'isTTY', { value: original, writable: true });
+    });
+    it('returns true when undefined and stdout is not TTY', () => {
+        const original = process.stdout.isTTY;
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        expect(shouldOutputJson(undefined)).toBe(true);
+        Object.defineProperty(process.stdout, 'isTTY', { value: original, writable: true });
+    });
+});
+describe('jsonOut', () => {
+    it('writes JSON to stdout with newline', () => {
+        const spy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        jsonOut({ hello: 'world' });
+        expect(spy).toHaveBeenCalledWith('{"hello":"world"}\n');
+        spy.mockRestore();
+    });
+});
+describe('jsonLine', () => {
+    it('writes a single NDJSON line', () => {
+        const spy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        jsonLine({ event: 'test', ts: 123 });
+        expect(spy).toHaveBeenCalledWith('{"event":"test","ts":123}\n');
+        spy.mockRestore();
+    });
+});

package/dist/utils/output.d.ts

@@ -0,0 +1,17 @@
+/**
+ * JSON output utilities for agent-friendly CLI.
+ *
+ * When stdout is not a TTY (piped/captured by an agent), output switches
+ * to machine-readable JSON automatically. The --json flag forces it.
+ */
+/**
+ * Determine whether to output JSON based on:
+ * 1. Explicit --json flag (true)
+ * 2. Explicit --no-json flag (false)
+ * 3. Auto-detect: non-TTY stdout means agent/pipe, output JSON
+ */
+export declare function shouldOutputJson(jsonFlag: boolean | undefined): boolean;
+/** Write a single JSON object to stdout (for one-shot commands). */
+export declare function jsonOut(data: unknown): void;
+/** Write one NDJSON line to stdout (for streaming commands). */
+export declare function jsonLine(data: unknown): void;

package/dist/utils/output.js

@@ -0,0 +1,27 @@
+/**
+ * JSON output utilities for agent-friendly CLI.
+ *
+ * When stdout is not a TTY (piped/captured by an agent), output switches
+ * to machine-readable JSON automatically. The --json flag forces it.
+ */
+/**
+ * Determine whether to output JSON based on:
+ * 1. Explicit --json flag (true)
+ * 2. Explicit --no-json flag (false)
+ * 3. Auto-detect: non-TTY stdout means agent/pipe, output JSON
+ */
+export function shouldOutputJson(jsonFlag) {
+    if (jsonFlag === true)
+        return true;
+    if (jsonFlag === false)
+        return false;
+    return !process.stdout.isTTY;
+}
+/** Write a single JSON object to stdout (for one-shot commands). */
+export function jsonOut(data) {
+    process.stdout.write(JSON.stringify(data) + '\n');
+}
+/** Write one NDJSON line to stdout (for streaming commands). */
+export function jsonLine(data) {
+    process.stdout.write(JSON.stringify(data) + '\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runwork",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "CLI for Runwork: develop, preview, and deploy Runwork apps from your local machine.",
   "license": "UNLICENSED",
   "author": "Runwork <info@runwork.ai> (https://www.runwork.ai)",