runwork 0.15.1 → 0.16.0

package/dist/commands/agents.js

@@ -1,160 +0,0 @@
-import { Command } from 'commander';
-import { requireAuth } from '../auth/store.js';
-import { ApiClient } from '../api/client.js';
-import { resolveWorkspace, resolveApp } from '../workspace/resolve.js';
-import { shouldOutputJson, jsonOut } from '../utils/output.js';
-function truncate(text, max) {
-    if (!text)
-        return '';
-    const first = text.split('\n')[0];
-    if (first.length <= max)
-        return first;
-    return first.slice(0, max - 3) + '...';
-}
-const listCommand = new Command('list')
-    .description('List agents in workspace')
-    .option('--workspace <id>', 'Workspace ID')
-    .option('--app <id>', 'Filter by app name or ID')
-    .action(async (opts, command) => {
-    const useJson = shouldOutputJson(command.optsWithGlobals().json);
-    const credentials = requireAuth();
-    const client = new ApiClient(credentials);
-    const { workspaceId, workspaceName } = await resolveWorkspace(client, opts);
-    try {
-        let agents = await client.listAgents(workspaceId);
-        if (opts.app) {
-            agents = agents.filter(a => a.appId === opts.app || a.appName === opts.app);
-        }
-        if (useJson) {
-            jsonOut({ agents });
-            return;
-        }
-        if (agents.length === 0) {
-            console.log('No agents found in this workspace.');
-            return;
-        }
-        console.log(`\nWorkspace: ${workspaceName || workspaceId}\n`);
-        console.log('  ' +
-            'Name'.padEnd(24) +
-            'Type'.padEnd(16) +
-            'App'.padEnd(20) +
-            'Description'.padEnd(42) +
-            'Integrations'.padEnd(20) +
-            'Entities'.padEnd(20) +
-            'Mode');
-        console.log('  ' + '-'.repeat(140));
-        for (const a of agents) {
-            const name = a.agentName.padEnd(24);
-            const type = a.type.padEnd(16);
-            const app = truncate(a.appName, 18).padEnd(20);
-            const desc = truncate(a.description, 40).padEnd(42);
-            const integrations = (a.integrations?.join(', ') || '').padEnd(20);
-            const entities = (a.entities?.join(', ') || '').padEnd(20);
-            const mode = a.deploymentMode || '';
-            console.log(`  ${name}${type}${app}${desc}${integrations}${entities}${mode}`);
-        }
-        console.log('');
-    }
-    catch (err) {
-        console.error('Failed to list agents:', err instanceof Error ? err.message : err);
-        process.exit(1);
-    }
-});
-const statusCommand = new Command('status')
-    .description('Get status of a specific agent')
-    .argument('<name>', 'Agent name')
-    .option('--workspace <id>', 'Workspace ID')
-    .option('--app <id>', 'App name or ID (required)')
-    .action(async (name, opts, command) => {
-    const useJson = shouldOutputJson(command.optsWithGlobals().json);
-    const credentials = requireAuth();
-    const client = new ApiClient(credentials);
-    const { workspaceId } = await resolveWorkspace(client, opts);
-    const { appId } = await resolveApp(client, workspaceId, opts);
-    try {
-        const status = await client.getAgentStatus(workspaceId, name, appId);
-        if (useJson) {
-            jsonOut({ status });
-            return;
-        }
-        console.log(JSON.stringify(status, null, 2));
-    }
-    catch (err) {
-        console.error('Failed to get agent status:', err instanceof Error ? err.message : err);
-        process.exit(1);
-    }
-});
-const executionsCommand = new Command('executions')
-    .description('List agent execution history for workspace')
-    .option('--workspace <id>', 'Workspace ID')
-    .action(async (opts, command) => {
-    const useJson = shouldOutputJson(command.optsWithGlobals().json);
-    const credentials = requireAuth();
-    const client = new ApiClient(credentials);
-    const { workspaceId } = await resolveWorkspace(client, opts);
-    try {
-        const executions = await client.listAgentExecutions(workspaceId);
-        if (useJson) {
-            jsonOut({ executions });
-            return;
-        }
-        if (executions.length === 0) {
-            console.log('No agent executions found.');
-            return;
-        }
-        console.log('  ' +
-            'Session ID'.padEnd(36) +
-            'Agent'.padEnd(22) +
-            'App'.padEnd(22) +
-            'Prompt'.padEnd(52) +
-            'Status'.padEnd(12) +
-            'Duration'.padEnd(12) +
-            'Usage');
-        console.log('  ' + '-'.repeat(160));
-        for (const e of executions) {
-            const sessionId = e.sessionId.padEnd(36);
-            const agent = truncate(e.agentName, 20).padEnd(22);
-            const app = truncate(e.appId, 20).padEnd(22);
-            const prompt = truncate(e.prompt, 50).padEnd(52);
-            const status = e.status.padEnd(12);
-            const duration = e.durationMs != null ? `${e.durationMs}ms` : '';
-            const usage = e.usage
-                ? `${e.usage.inputTokens}/${e.usage.outputTokens}`
-                : '';
-            console.log(`  ${sessionId}${agent}${app}${prompt}${status}${duration.padEnd(12)}${usage}`);
-        }
-        console.log('');
-    }
-    catch (err) {
-        console.error('Failed to list agent executions:', err instanceof Error ? err.message : err);
-        process.exit(1);
-    }
-});
-const executionCommand = new Command('execution')
-    .description('Get execution stream for a specific session')
-    .argument('<sessionId>', 'Session ID')
-    .option('--workspace <id>', 'Workspace ID')
-    .action(async (sessionId, opts, command) => {
-    const useJson = shouldOutputJson(command.optsWithGlobals().json);
-    const credentials = requireAuth();
-    const client = new ApiClient(credentials);
-    const { workspaceId } = await resolveWorkspace(client, opts);
-    try {
-        const stream = await client.getAgentExecutionStream(workspaceId, sessionId);
-        if (useJson) {
-            jsonOut({ stream });
-            return;
-        }
-        process.stdout.write(stream);
-    }
-    catch (err) {
-        console.error('Failed to get agent execution stream:', err instanceof Error ? err.message : err);
-        process.exit(1);
-    }
-});
-export const agentsCommand = new Command('agents')
-    .description('Manage workspace agents and execution history')
-    .addCommand(listCommand)
-    .addCommand(statusCommand)
-    .addCommand(executionsCommand)
-    .addCommand(executionCommand);

package/dist/commands/api-keys.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare const apiKeysCommand: Command;

package/dist/commands/api-keys.js

@@ -1,95 +0,0 @@
-import { Command } from 'commander';
-import { requireAuth } from '../auth/store.js';
-import { ApiClient } from '../api/client.js';
-import { resolveWorkspace, resolveApp } from '../workspace/resolve.js';
-import { shouldOutputJson, jsonOut } from '../utils/output.js';
-import { promptInput } from '../utils/prompt.js';
-const listCommand = new Command('list')
-    .description('List API keys for the workspace')
-    .option('--workspace <id>', 'Workspace ID')
-    .action(async (opts, command) => {
-    const useJson = shouldOutputJson(command.optsWithGlobals().json);
-    const credentials = requireAuth();
-    const client = new ApiClient(credentials);
-    const { workspaceId, workspaceName } = await resolveWorkspace(client, opts);
-    try {
-        const apiKeys = await client.listApiKeys(workspaceId);
-        if (useJson) {
-            jsonOut({ apiKeys });
-            return;
-        }
-        if (apiKeys.length === 0) {
-            console.log('No API keys found in this workspace.');
-            return;
-        }
-        console.log(`\nWorkspace: ${workspaceName || workspaceId}\n`);
-        console.log(`  ${'Name'.padEnd(24)} ${'Key Prefix'.padEnd(16)} ${'App'.padEnd(20)} ${'Active'.padEnd(8)} ${'Requests'.padEnd(10)} ${'Last Used'.padEnd(22)} Created`);
-        console.log('  ' + '-'.repeat(112));
-        for (const k of apiKeys) {
-            const prefix = `${k.keyPrefix}...`;
-            const appLabel = k.appId ? k.appId : 'all';
-            const active = k.isActive ? 'yes' : 'no';
-            const requests = k.requestCount !== undefined ? String(k.requestCount) : '-';
-            const lastUsed = k.lastUsedAt ? new Date(k.lastUsedAt).toLocaleString() : '-';
-            const created = new Date(k.createdAt).toLocaleString();
-            console.log(`  ${k.name.padEnd(24)} ${prefix.padEnd(16)} ${appLabel.padEnd(20)} ${active.padEnd(8)} ${requests.padEnd(10)} ${lastUsed.padEnd(22)} ${created}`);
-        }
-        console.log('');
-    }
-    catch (err) {
-        console.error('Failed to list API keys:', err instanceof Error ? err.message : err);
-        process.exit(1);
-    }
-});
-const createCommand = new Command('create')
-    .description('Create a new API key')
-    .option('--workspace <id>', 'Workspace ID')
-    .option('--name <name>', 'API key name')
-    .option('--app <id>', 'Restrict key to a specific app (name or ID)')
-    .option('--scopes <scopes>', 'Comma-separated list of scopes')
-    .action(async (opts, command) => {
-    const useJson = shouldOutputJson(command.optsWithGlobals().json);
-    const credentials = requireAuth();
-    const client = new ApiClient(credentials);
-    const { workspaceId } = await resolveWorkspace(client, opts);
-    let name = opts.name ?? '';
-    if (!name) {
-        if (process.stdout.isTTY) {
-            name = await promptInput('API key name:');
-            if (!name) {
-                console.error('API key name is required.');
-                process.exit(1);
-            }
-        }
-        else {
-            console.error('API key name is required. Use --name flag.');
-            process.exit(1);
-        }
-    }
-    let appId;
-    if (opts.app) {
-        const resolved = await resolveApp(client, workspaceId, { app: opts.app });
-        appId = resolved.appId;
-    }
-    const scopes = opts.scopes
-        ? opts.scopes.split(',').map((s) => s.trim()).filter(Boolean)
-        : undefined;
-    try {
-        const result = await client.createApiKey(workspaceId, { name, appId, scopes });
-        if (useJson) {
-            jsonOut({ apiKey: result });
-            return;
-        }
-        console.log(`\nAPI key created: ${result.name}`);
-        console.log(`\n  Key: ${result.key}`);
-        console.log(`\n  WARNING: Save this key now - it cannot be retrieved again.\n`);
-    }
-    catch (err) {
-        console.error('Failed to create API key:', err instanceof Error ? err.message : err);
-        process.exit(1);
-    }
-});
-export const apiKeysCommand = new Command('api-keys')
-    .description('Manage workspace API keys')
-    .addCommand(listCommand)
-    .addCommand(createCommand);

package/dist/commands/apps.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare const appsCommand: Command;

package/dist/commands/apps.js

@@ -1,82 +0,0 @@
-import { Command } from 'commander';
-import { requireAuth } from '../auth/store.js';
-import { ApiClient } from '../api/client.js';
-import { resolveWorkspace, resolveApp } from '../workspace/resolve.js';
-import { shouldOutputJson, jsonOut } from '../utils/output.js';
-import { fetchAppInfo, printAppInfo } from '../utils/app-info.js';
-import { runCreateFlow } from './init.js';
-const listCommand = new Command('list')
-    .description('List apps in workspace')
-    .option('--workspace <id>', 'Workspace ID')
-    .action(async (opts, command) => {
-    const useJson = shouldOutputJson(command.optsWithGlobals().json);
-    const credentials = requireAuth();
-    const client = new ApiClient(credentials);
-    const { workspaceId, workspaceName } = await resolveWorkspace(client, opts);
-    try {
-        const apps = await client.listApps(workspaceId);
-        if (useJson) {
-            jsonOut({ apps });
-            return;
-        }
-        if (apps.length === 0) {
-            console.log('No apps in this workspace.');
-            console.log('Create one with: runwork create <name>');
-            return;
-        }
-        console.log(`\nWorkspace: ${workspaceName || workspaceId}\n`);
-        console.log(`  ${'Name'.padEnd(28)} ${'ID'.padEnd(38)} Status`);
-        console.log('  ' + '-'.repeat(80));
-        for (const app of apps) {
-            console.log(`  ${(app.name || '').padEnd(28)} ${app.id}`);
-        }
-        console.log('');
-    }
-    catch (err) {
-        console.error('Failed to list apps:', err instanceof Error ? err.message : err);
-        process.exit(1);
-    }
-});
-const createCommand = new Command('create')
-    .description('Create a new Runwork app')
-    .argument('[name]', 'App name')
-    .action(async (name) => {
-    await runCreateFlow(name);
-});
-const infoCommand = new Command('info')
-    .description('Show detailed app info, preview status, and registries')
-    .argument('[app]', 'App ID, name, or slug')
-    .option('--workspace <id>', 'Workspace ID')
-    .action(async (appArg, opts, command) => {
-    const useJson = shouldOutputJson(command.optsWithGlobals().json);
-    const credentials = requireAuth();
-    const client = new ApiClient(credentials);
-    const { workspaceId, workspaceName } = await resolveWorkspace(client, opts);
-    const { appId, appName } = await resolveApp(client, workspaceId, { app: appArg });
-    let appSlug = appName;
-    try {
-        const appData = await client.getApp(appId);
-        appSlug = appData.slug || appName;
-    }
-    catch {
-        // Fall back to appName as slug
-    }
-    const data = await fetchAppInfo(client, {
-        appId,
-        appName,
-        appSlug,
-        workspaceId,
-        workspaceName,
-        baseUrl: credentials.baseUrl || 'https://runwork.ai',
-    });
-    if (useJson) {
-        jsonOut(data);
-        return;
-    }
-    printAppInfo(data);
-});
-export const appsCommand = new Command('apps')
-    .description('Manage workspace apps')
-    .addCommand(listCommand)
-    .addCommand(createCommand)
-    .addCommand(infoCommand);

package/dist/commands/build-plugin.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare const buildPluginCommand: Command;

package/dist/commands/build-plugin.js

@@ -1,135 +0,0 @@
-import { Command } from 'commander';
-import { existsSync, readFileSync } from 'fs';
-import { resolve, join } from 'path';
-import { homedir } from 'os';
-import { requireAuth } from '../auth/store.js';
-import { ApiClient } from '../api/client.js';
-import { getAdapterBySlug } from '../agents/detect.js';
-import { RUNWORK_MCP_PREFIX, RUNWORK_WORKSPACE_MCP_NAME } from '../agents/types.js';
-import { generateIntroSkill, buildAppSkillDescription } from '../agents/intro-skill.js';
-function loadSetupState(filePath) {
-    if (!existsSync(filePath))
-        return null;
-    try {
-        return JSON.parse(readFileSync(filePath, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-export const buildPluginCommand = new Command('build-plugin')
-    .description('Build an installable plugin archive for an agent (e.g. Claude Desktop)')
-    .requiredOption('--agent <slug>', 'Target agent slug (e.g. claude-desktop)')
-    .option('--output <path>', 'Output zip path', 'runwork-plugin.zip')
-    .action(async (opts) => {
-    const adapter = getAdapterBySlug(opts.agent);
-    if (!adapter) {
-        console.error(`Unknown agent: ${opts.agent}`);
-        process.exit(1);
-    }
-    if (!adapter.buildPluginZip) {
-        console.error(`Agent "${adapter.name}" does not support plugin zip build.`);
-        process.exit(1);
-    }
-    const credentials = requireAuth();
-    // Find the first available setup state so we know which workspace to
-    // pull content from. We don't care about project vs user scope here —
-    // plugin archives are always user-scoped for the agent they're uploaded to.
-    const projectStatePath = join(process.cwd(), '.runwork', 'setup.json');
-    const userStatePath = join(homedir(), '.runwork', 'setup.json');
-    const state = loadSetupState(projectStatePath) ?? loadSetupState(userStatePath);
-    if (!state) {
-        console.error('No setup state found. Run `runwork setup` first.');
-        process.exit(1);
-    }
-    const client = new ApiClient(credentials);
-    // Refresh workspace name/slug if missing or stale (matches sync behavior).
-    if (!state.workspaceName || state.workspaceName === state.workspaceId || !state.workspaceSlug) {
-        try {
-            const workspaces = await client.listWorkspaces();
-            const ws = workspaces.find((w) => w.id === state.workspaceId);
-            if (ws?.name)
-                state.workspaceName = ws.name;
-            if (ws?.slug)
-                state.workspaceSlug = ws.slug;
-        }
-        catch {
-            /* best-effort */
-        }
-    }
-    console.log(`Building plugin for ${adapter.name} from workspace ${state.workspaceName || state.workspaceId}...`);
-    // Fetch the same inputs sync uses. The plugin archive must contain
-    // identical content to what sync would write into the plugin directory,
-    // including workspace team instructions + per-agent extra instructions.
-    const [allSkills, mcpServers, externalSkills, registries, connectedIntegrations, onboardingConfig,] = await Promise.all([
-        client.listWorkspaceSkills(state.workspaceId, true),
-        client.listMcpServers(state.workspaceId),
-        client.listExternalSkills(state.workspaceId),
-        client.getWorkspaceAll(state.workspaceId).catch(() => null),
-        client
-            .listConnectedIntegrations(state.workspaceId)
-            .then((list) => list.map((i) => i.canonicalId ?? i.integrationId))
-            .catch(() => []),
-        client.getOnboardingConfig(state.workspaceId).catch(() => null),
-    ]);
-    const baseUrl = credentials.baseUrl || 'https://runwork.ai';
-    const mcpEntries = mcpServers
-        .filter((s) => s.enabled)
-        .map((s) => ({
-        name: `${RUNWORK_MCP_PREFIX}${s.name}`,
-        url: s.url,
-        transport: s.transport,
-        headers: { Authorization: `Bearer ${credentials.apiKey}` },
-        description: `Runwork MCP server: ${s.name}. Provides tools for interacting with this workspace resource.`,
-    }));
-    mcpEntries.push({
-        name: RUNWORK_WORKSPACE_MCP_NAME,
-        url: `${baseUrl}/api/workspaces/${state.workspaceId}/mcp`,
-        transport: 'streamable-http',
-        headers: { Authorization: `Bearer ${credentials.apiKey}` },
-        description: "Runwork workspace tools: query entities, trigger workflows, manage integrations, run agents, and access shared data across your team's apps.",
-    });
-    const remoteSkills = [];
-    for (const s of externalSkills) {
-        remoteSkills.push({ name: s.name, content: s.content, source: 'external' });
-    }
-    for (const s of allSkills) {
-        if (s.type === 'app' && s.appId && s.content?.trim()) {
-            remoteSkills.push({ name: s.name, content: s.content, source: 'app', appId: s.appId });
-        }
-    }
-    const introSkill = generateIntroSkill({
-        workspaceName: state.workspaceName || state.workspaceId,
-        workspaceId: state.workspaceId,
-        workspaceSlug: state.workspaceSlug,
-        registries,
-        connectedIntegrations,
-        mcpServerCount: mcpEntries.length,
-        skillCount: remoteSkills.length,
-        mcpServerNames: mcpEntries.map((e) => e.name.replace(RUNWORK_MCP_PREFIX, '')),
-        skillNames: remoteSkills.map((s) => s.name),
-    });
-    // When the adapter exposes skills through MCP already, skip duplicating
-    // app skills into the plugin — same rule sync applies per-adapter.
-    const skipAppSkills = adapter.mcpProvidesSkills && mcpEntries.length > 0;
-    const skillFiles = [
-        introSkill,
-        ...remoteSkills
-            .filter((s) => !(skipAppSkills && s.source === 'app'))
-            .map((s) => ({
-            name: s.name,
-            filename: s.name.toLowerCase().replace(/[^a-z0-9]+/g, '-'),
-            content: s.content,
-            description: s.source === 'app'
-                ? buildAppSkillDescription(s.name, registries) || `${s.name} - Runwork workspace application`
-                : `${s.name} - Runwork workspace skill`,
-        })),
-    ];
-    // Merge team instructions + per-agent extra instructions (same rule as sync).
-    const teamInstructions = onboardingConfig?.config?.teamInstructions;
-    const agentExtra = onboardingConfig?.config?.agentConfigs?.[adapter.slug]?.extraInstructions;
-    const mergedInstructions = [teamInstructions, agentExtra].filter(Boolean).join('\n\n') || null;
-    const outputPath = resolve(opts.output);
-    await adapter.buildPluginZip(skillFiles, mcpEntries, mergedInstructions, outputPath);
-    console.log(`Wrote ${outputPath}`);
-});

package/dist/commands/clone.d.ts

@@ -1,60 +0,0 @@
-import { Command } from 'commander';
-import { ApiClient } from '../api/client.js';
-import type { Credentials, AppInfo } from '../types.js';
-import { type SyncErrorReason } from '../git/classify-sync-error.js';
-/**
- * Outcome of overlaying the app's git-tracked source on top of the template.
- * `pulled: false` with `reason: 'empty-remote'` is the expected, benign state
- * for a brand-new app (nothing pushed yet). Any other `reason` is a real
- * failure that left a template-only scaffold -- the caller must NOT report
- * success, since editing it would edit the wrong code (friction log #1).
- */
-export interface CloneSource {
-    pulled: boolean;
-    reason?: 'empty-remote' | SyncErrorReason;
-    detail?: string;
-}
-export interface CloneResult {
-    appId: string;
-    appName: string;
-    slug: string;
-    directory: string;
-    workspaceId: string;
-    workspaceName: string;
-    source: CloneSource;
-}
-export declare function execClone(client: ApiClient, app: AppInfo, directory?: string, creds?: Credentials | null): Promise<CloneResult>;
-/**
- * Turn a failed-pull error into a CloneSource: an empty remote (benign,
- * brand-new app) vs a classified real failure (auth/network/no-remote) that
- * leaves a template-only scaffold.
- */
-export declare function pullOutcomeFromError(err: unknown): CloneSource;
-/**
- * A clone is a real failure -- a template-only scaffold rather than the app's
- * code -- when the source pull didn't happen for any reason other than an
- * empty remote. Callers must not report success in that case.
- */
-export declare function isCloneSourceFailure(source: CloneSource): boolean;
-/**
- * Reconcile positional args with --app. When --app is provided, the first
- * positional argument is intended as the *directory* -- not another appId
- * -- because the app is already disambiguated by the option. Without this,
- * `runwork clone --app foo C:\path\to\dir` ends up parsing `C:\path\to\dir`
- * as `appId` (which is then ignored because `--app` wins), leaving
- * `directory` undefined and silently cloning into the slug under cwd.
- */
-export declare function normalizeCloneArgs(appId: string | undefined, directory: string | undefined, options: {
-    app?: string;
-} | undefined): {
-    appId: string | undefined;
-    directory: string | undefined;
-};
-/**
- * Help epilogue shown under `runwork clone --help`. Agents tend to read help
- * before running, so we surface the restricted-mount caveat (friction log #9)
- * here. Exported so it can be asserted on directly (commander's help-text
- * hooks aren't reflected by `helpInformation()`).
- */
-export declare const RESTRICTED_FS_HELP = "\nNote for AI agents: clone into a normal working directory. Some sandboxed\n\"outputs\" mounts (e.g. certain agent environments) disallow the unlink\noperations git uses for pack files, which can corrupt the repo with errors\nlike \"unable to unlink '.git/objects/pack/...': Operation not permitted\". If\nyou hit that, clone into your home directory or another standard path instead.";
-export declare const cloneCommand: Command;