runwork 0.5.1 → 0.6.1

package/dist/utils/help-json.js

@@ -0,0 +1,85 @@
+/**
+ * JSON help output for AI agents.
+ *
+ * When --json is active (explicitly or via non-TTY), `runwork --help` and
+ * `runwork <command> --help` output a machine-readable command tree instead
+ * of Commander's human-readable text.
+ *
+ * This lets an agent discover the full CLI surface in a single call.
+ */
+function serializeOption(opt) {
+    const result = {
+        flags: opt.flags,
+        description: opt.description,
+        required: opt.required,
+        optional: opt.optional,
+        variadic: opt.variadic,
+    };
+    if (opt.defaultValue !== undefined)
+        result.defaultValue = opt.defaultValue;
+    if (opt.argChoices)
+        result.choices = opt.argChoices;
+    if (opt.envVar)
+        result.envVar = opt.envVar;
+    return result;
+}
+function serializeArgument(arg) {
+    const result = {
+        name: arg.name(),
+        description: arg.description,
+        required: arg.required,
+        variadic: arg.variadic,
+    };
+    if (arg.defaultValue !== undefined)
+        result.defaultValue = arg.defaultValue;
+    if (arg.argChoices)
+        result.choices = arg.argChoices;
+    return result;
+}
+function serializeCommand(cmd) {
+    const subcommands = cmd.commands
+        .filter((c) => !c._hidden)
+        .map(serializeCommand);
+    // Get command-level options (exclude inherited global options)
+    const options = cmd.options
+        .filter((o) => !o.hidden)
+        .map(serializeOption);
+    const registeredArguments = cmd.registeredArguments ?? [];
+    return {
+        name: cmd.name(),
+        description: cmd.description(),
+        aliases: cmd.aliases(),
+        usage: cmd.usage(),
+        options,
+        arguments: registeredArguments.map(serializeArgument),
+        subcommands,
+    };
+}
+/**
+ * Serialize the full command tree to a JSON-friendly structure.
+ */
+export function buildHelpJson(program) {
+    const globalOptions = program.options
+        .filter((o) => !o.hidden)
+        .map(serializeOption);
+    const commands = program.commands
+        .filter((c) => !c._hidden)
+        .map(serializeCommand);
+    return {
+        version: program.version() ?? 'unknown',
+        name: program.name(),
+        description: program.description(),
+        usage: program.usage(),
+        globalOptions,
+        commands,
+    };
+}
+/**
+ * Serialize a single command (for `runwork <cmd> --help --json`).
+ */
+export function buildCommandHelpJson(cmd, version) {
+    return {
+        version,
+        ...serializeCommand(cmd),
+    };
+}

package/dist/utils/resolve.d.ts

@@ -0,0 +1,12 @@
+import type { ApiClient } from '../api/client.js';
+import type { AppInfo, WorkspaceInfo } from '../types.js';
+/**
+ * Resolve a workspace by name or ID from the user's accessible workspaces.
+ * Tries exact ID match first, then case-insensitive name match.
+ */
+export declare function resolveWorkspace(client: ApiClient, nameOrId: string): Promise<WorkspaceInfo>;
+/**
+ * Resolve an app by name or ID from the user's accessible apps.
+ * Tries exact ID match first, then case-insensitive name match.
+ */
+export declare function resolveApp(client: ApiClient, nameOrId: string): Promise<AppInfo>;

package/dist/utils/resolve.js

@@ -0,0 +1,52 @@
+/**
+ * Resolve a workspace by name or ID from the user's accessible workspaces.
+ * Tries exact ID match first, then case-insensitive name match.
+ */
+export async function resolveWorkspace(client, nameOrId) {
+    const workspaces = await client.listWorkspaces();
+    if (workspaces.length === 0) {
+        console.error('No workspaces found. Create one at runwork.ai first.');
+        process.exit(1);
+    }
+    // Exact ID match
+    const byId = workspaces.find(w => w.id === nameOrId);
+    if (byId)
+        return byId;
+    // Case-insensitive name match
+    const lower = nameOrId.toLowerCase();
+    const byName = workspaces.filter(w => w.name.toLowerCase() === lower);
+    if (byName.length === 1)
+        return byName[0];
+    if (byName.length > 1) {
+        console.error(`Ambiguous workspace name "${nameOrId}". Matches: ${byName.map(w => `${w.name} (${w.id})`).join(', ')}`);
+        process.exit(1);
+    }
+    console.error(`Workspace "${nameOrId}" not found. Available: ${workspaces.map(w => w.name).join(', ')}`);
+    process.exit(1);
+}
+/**
+ * Resolve an app by name or ID from the user's accessible apps.
+ * Tries exact ID match first, then case-insensitive name match.
+ */
+export async function resolveApp(client, nameOrId) {
+    const apps = await client.listApps();
+    if (apps.length === 0) {
+        console.error('No apps found.');
+        process.exit(1);
+    }
+    // Exact ID match
+    const byId = apps.find(a => a.id === nameOrId);
+    if (byId)
+        return byId;
+    // Case-insensitive name match
+    const lower = nameOrId.toLowerCase();
+    const byName = apps.filter(a => a.name.toLowerCase() === lower);
+    if (byName.length === 1)
+        return byName[0];
+    if (byName.length > 1) {
+        console.error(`Ambiguous app name "${nameOrId}". Matches: ${byName.map(a => `${a.name} (${a.id})`).join(', ')}`);
+        process.exit(1);
+    }
+    console.error(`App "${nameOrId}" not found. Available: ${apps.map(a => a.name).join(', ')}`);
+    process.exit(1);
+}

package/dist/utils/setup-state.d.ts

@@ -0,0 +1,3 @@
+import type { SetupState } from '../types.js';
+/** Load setup state, checking project-level then user-level. */
+export declare function loadSetupState(): SetupState | null;

package/dist/utils/setup-state.js

@@ -0,0 +1,19 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+/** Load setup state, checking project-level then user-level. */
+export function loadSetupState() {
+    const projectPath = join(process.cwd(), '.runwork', 'setup.json');
+    const userPath = join(homedir(), '.runwork', 'setup.json');
+    for (const p of [projectPath, userPath]) {
+        if (existsSync(p)) {
+            try {
+                return JSON.parse(readFileSync(p, 'utf-8'));
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}

package/dist/utils/sqlite.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Query a SQLite database using better-sqlite3.
+ * Cross-platform, no CLI dependency.
+ * Opens database in readonly mode with a 5-second busy timeout.
+ * Returns empty string on any error (missing DB, locked, corrupted).
+ */
+export declare function querySqlite(dbPath: string, sql: string): string;

package/dist/utils/sqlite.js

@@ -0,0 +1,24 @@
+import Database from 'better-sqlite3';
+/**
+ * Query a SQLite database using better-sqlite3.
+ * Cross-platform, no CLI dependency.
+ * Opens database in readonly mode with a 5-second busy timeout.
+ * Returns empty string on any error (missing DB, locked, corrupted).
+ */
+export function querySqlite(dbPath, sql) {
+    let db = null;
+    try {
+        db = new Database(dbPath, { readonly: true, timeout: 5000 });
+        const rows = db.prepare(sql).all();
+        return rows.map(row => Object.values(row).join('|')).join('\n');
+    }
+    catch {
+        return '';
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch { /* ignore close errors */ }
+    }
+}

package/dist/utils/which.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cross-platform binary detection.
+ * Uses `which` on macOS/Linux, `where.exe` on Windows.
+ * Returns the resolved path on success, null if not found.
+ */
+export declare function whichBinary(name: string): string | null;

package/dist/utils/which.js

@@ -0,0 +1,18 @@
+import { execFileSync } from 'child_process';
+import { platform } from 'os';
+/**
+ * Cross-platform binary detection.
+ * Uses `which` on macOS/Linux, `where.exe` on Windows.
+ * Returns the resolved path on success, null if not found.
+ */
+export function whichBinary(name) {
+    try {
+        const cmd = platform() === 'win32' ? 'where.exe' : 'which';
+        const result = execFileSync(cmd, [name], { stdio: 'pipe' }).toString().trim();
+        // `where.exe` may return multiple lines; take the first
+        return result.split(/[\r\n]+/)[0].trim() || null;
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runwork",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "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)",
@@ -34,6 +34,7 @@
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
+    "test:local": "RUNWORK_TEST_LOCAL_AGENTS=1 vitest run",
     "prepublishOnly": "bun run prebuild && tsc",
     "release": "npm publish && npm dist-tag add runwork@$(node -p \"require('./package.json').version\") next",
     "release:binaries": "bun run scripts/release-binaries.ts",
@@ -42,16 +43,18 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.1.0",
+    "better-sqlite3": "^12.8.0",
     "chokidar": "^4.0.0",
     "commander": "^13.0.0",
-    "curlconverter": "^4.12.0",
     "fflate": "^0.8.2",
     "open": "^10.0.0",
-    "picocolors": "^1.1.1"
+    "picocolors": "^1.1.1",
+    "smol-toml": "^1.6.1"
   },
   "devDependencies": {
-    "typescript": "^5.7.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
     "vitest": "^3.2.0"
   },
   "engines": {

package/dist/agents/copilot-cli.d.ts

@@ -1,10 +0,0 @@
-import type { AgentAdapter, McpServerEntry, SkillFile } from './types.js';
-export declare class CopilotCliAdapter implements AgentAdapter {
-    name: string;
-    slug: string;
-    detect(): Promise<boolean>;
-    supportsMcpScope(_scope: 'project' | 'user'): boolean;
-    supportsSkills(): boolean;
-    writeMcpServers(servers: McpServerEntry[], scope: 'project' | 'user'): Promise<void>;
-    writeSkills(_skills: SkillFile[], _scope: 'project' | 'user'): Promise<void>;
-}

package/dist/agents/copilot-cli.js

@@ -1,46 +0,0 @@
-import { execFileSync } from 'child_process';
-import { join } from 'path';
-import { homedir } from 'os';
-import { mergeJsonMcpServers } from './utils/json-config.js';
-export class CopilotCliAdapter {
-    name = 'GitHub Copilot CLI';
-    slug = 'copilot-cli';
-    async detect() {
-        try {
-            execFileSync('which', ['copilot'], { stdio: 'pipe' });
-            return true;
-        }
-        catch {
-            try {
-                execFileSync('gh', ['copilot', '--version'], { stdio: 'pipe' });
-                return true;
-            }
-            catch {
-                return false;
-            }
-        }
-    }
-    supportsMcpScope(_scope) {
-        return true;
-    }
-    supportsSkills() {
-        return false;
-    }
-    async writeMcpServers(servers, scope) {
-        const filePath = scope === 'project'
-            ? join(process.cwd(), '.copilot', 'mcp-config.json')
-            : join(homedir(), '.copilot', 'mcp-config.json');
-        const entries = {};
-        for (const s of servers) {
-            entries[s.name] = {
-                type: 'http',
-                url: s.url,
-                ...(s.headers ? { headers: s.headers } : {}),
-            };
-        }
-        mergeJsonMcpServers(filePath, entries, 'mcpServers');
-    }
-    async writeSkills(_skills, _scope) {
-        // Not supported
-    }
-}

package/dist/agents/copilot-vscode.d.ts

@@ -1,10 +0,0 @@
-import type { AgentAdapter, McpServerEntry, SkillFile } from './types.js';
-export declare class CopilotVscodeAdapter implements AgentAdapter {
-    name: string;
-    slug: string;
-    detect(): Promise<boolean>;
-    supportsMcpScope(scope: 'project' | 'user'): boolean;
-    supportsSkills(): boolean;
-    writeMcpServers(servers: McpServerEntry[], _scope: 'project' | 'user'): Promise<void>;
-    writeSkills(_skills: SkillFile[], _scope: 'project' | 'user'): Promise<void>;
-}

package/dist/agents/copilot-vscode.js

@@ -1,37 +0,0 @@
-import { execFileSync } from 'child_process';
-import { join } from 'path';
-import { mergeJsonMcpServers } from './utils/json-config.js';
-export class CopilotVscodeAdapter {
-    name = 'GitHub Copilot (VS Code)';
-    slug = 'copilot-vscode';
-    async detect() {
-        try {
-            const output = execFileSync('code', ['--list-extensions'], { stdio: 'pipe', encoding: 'utf-8' });
-            return output.includes('GitHub.copilot');
-        }
-        catch {
-            return false;
-        }
-    }
-    supportsMcpScope(scope) {
-        return scope === 'project';
-    }
-    supportsSkills() {
-        return false;
-    }
-    async writeMcpServers(servers, _scope) {
-        const filePath = join(process.cwd(), '.vscode', 'mcp.json');
-        const entries = {};
-        for (const s of servers) {
-            entries[s.name] = {
-                type: 'http',
-                url: s.url,
-                ...(s.headers ? { headers: s.headers } : {}),
-            };
-        }
-        mergeJsonMcpServers(filePath, entries, 'servers');
-    }
-    async writeSkills(_skills, _scope) {
-        // Not supported
-    }
-}