vigthoria-cli 1.13.20 → 1.13.23

package/completions/_vigthoria

@@ -0,0 +1,49 @@
+#compdef vigthoria vig vigthoria-chat
+# Generated from contracts/phase-0/command-manifest.json; do not edit.
+_vigthoria() {
+  local -a commands
+  commands=(
+    'agent:Start agentic mode - AI can read/write files, run commands'
+    'auth:Manage Vigthoria CLI authentication'
+    'background:Run and manage detached Vigthoria Agent jobs'
+    'bridge:Inspect local DevTools Bridge availability for browser debugging tasks'
+    'cancel:Cancel an in-flight V3 agent run (by context_id), or use --all to cancel every active run'
+    'chat:Start interactive chat with Vigthoria AI'
+    'chat-resume:Resume the latest chat session for the current or specified project'
+    'commands:List every CLI command grouped by command family'
+    'config:Configure Vigthoria CLI settings'
+    'deploy:Deploy and host your project on Vigthoria infrastructure'
+    'device:Android Developer Bridge commands via local ADB'
+    'devtools:DevTools Bridge commands for browser debugging'
+    'doctor:Run local Vigthoria CLI diagnostics (no network calls unless --check-api)'
+    'edit:Edit a file with AI assistance'
+    'explain:Explain code in a file'
+    'fix:Fix issues in a file'
+    'fork:Fork from an existing V3 agent run with new instructions'
+    'game:Create, run, and validate Babylon/VGE game projects'
+    'generate:Generate code from description'
+    'history:List recent V3 agent runs'
+    'hub:Discover, search, and activate Vigthoria API modules'
+    'hyper-loop:Hyper Loop Legion orchestrator commands'
+    'init:Initialize Vigthoria in current project'
+    'legion:Run parallel tasks via Hyper Loop Legion orchestrator'
+    'login:Login to Vigthoria Coder (prompts for credentials when run without flags)'
+    'logout:Logout from Vigthoria Coder'
+    'menu:Open the interactive command-family menu'
+    'music:Generate songs with Vigthoria Music AI / ACE-Step'
+    'operator:Start BMAD operator mode for infrastructure and system workflows'
+    'preview:Preview project locally with visual diffs and proof validation'
+    'replay:Replay events from a V3 agent run step-by-step'
+    'repo:Push and pull projects to/from your Vigthoria Community Repository'
+    'review:Review code quality'
+    'security:Run security scans, scores, and fix plans via Vigthoria MCP security tools'
+    'status:Show authentication and subscription status'
+    'update:Check for updates and upgrade Vigthoria CLI. Default manifest: https://extension.vigthoria.io/downloads/manifest.json'
+    'v4:Launch Vigthoria V4 Operating Agent (DeerFlow 2.0 harness)'
+    'v4-menu:Internal: interactive V3/V4 agent + provider picker used by the V4 Operating Agent launcher'
+    'wallet:Inspect monetary Vigthoria Credits used for Cloud, API, Video, and other PAYG services'
+    'workflow:List, instantiate, and run repeatable VigFlow workflows'
+  )
+  _describe 'command' commands
+}
+_vigthoria "$@"

package/completions/vigthoria.bash

@@ -0,0 +1,6 @@
+# Generated from contracts/phase-0/command-manifest.json; do not edit.
+_vigthoria_completions() {
+  local cur="${COMP_WORDS[COMP_CWORD]}"
+  COMPREPLY=( $(compgen -W 'agent auth background bridge cancel chat chat-resume commands config deploy device devtools doctor edit explain fix fork game generate history hub hyper-loop init legion login logout menu music operator preview replay repo review security status update v4 v4-menu wallet workflow' -- "$cur") )
+}
+complete -F _vigthoria_completions vigthoria vig vigthoria-chat

package/completions/vigthoria.fish

@@ -0,0 +1,41 @@
+# Generated from contracts/phase-0/command-manifest.json; do not edit.
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'agent' -d 'Start agentic mode - AI can read/write files, run commands'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'auth' -d 'Manage Vigthoria CLI authentication'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'background' -d 'Run and manage detached Vigthoria Agent jobs'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'bridge' -d 'Inspect local DevTools Bridge availability for browser debugging tasks'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'cancel' -d 'Cancel an in-flight V3 agent run (by context_id), or use --all to cancel every active run'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'chat' -d 'Start interactive chat with Vigthoria AI'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'chat-resume' -d 'Resume the latest chat session for the current or specified project'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'commands' -d 'List every CLI command grouped by command family'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'config' -d 'Configure Vigthoria CLI settings'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'deploy' -d 'Deploy and host your project on Vigthoria infrastructure'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'device' -d 'Android Developer Bridge commands via local ADB'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'devtools' -d 'DevTools Bridge commands for browser debugging'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'doctor' -d 'Run local Vigthoria CLI diagnostics (no network calls unless --check-api)'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'edit' -d 'Edit a file with AI assistance'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'explain' -d 'Explain code in a file'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'fix' -d 'Fix issues in a file'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'fork' -d 'Fork from an existing V3 agent run with new instructions'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'game' -d 'Create, run, and validate Babylon/VGE game projects'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'generate' -d 'Generate code from description'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'history' -d 'List recent V3 agent runs'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'hub' -d 'Discover, search, and activate Vigthoria API modules'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'hyper-loop' -d 'Hyper Loop Legion orchestrator commands'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'init' -d 'Initialize Vigthoria in current project'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'legion' -d 'Run parallel tasks via Hyper Loop Legion orchestrator'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'login' -d 'Login to Vigthoria Coder (prompts for credentials when run without flags)'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'logout' -d 'Logout from Vigthoria Coder'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'menu' -d 'Open the interactive command-family menu'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'music' -d 'Generate songs with Vigthoria Music AI / ACE-Step'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'operator' -d 'Start BMAD operator mode for infrastructure and system workflows'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'preview' -d 'Preview project locally with visual diffs and proof validation'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'replay' -d 'Replay events from a V3 agent run step-by-step'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'repo' -d 'Push and pull projects to/from your Vigthoria Community Repository'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'review' -d 'Review code quality'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'security' -d 'Run security scans, scores, and fix plans via Vigthoria MCP security tools'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'status' -d 'Show authentication and subscription status'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'update' -d 'Check for updates and upgrade Vigthoria CLI. Default manifest: https://extension.vigthoria.io/downloads/manifest.json'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'v4' -d 'Launch Vigthoria V4 Operating Agent (DeerFlow 2.0 harness)'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'v4-menu' -d 'Internal: interactive V3/V4 agent + provider picker used by the V4 Operating Agent launcher'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'wallet' -d 'Inspect monetary Vigthoria Credits used for Cloud, API, Video, and other PAYG services'
+complete -c vigthoria -c vig -c vigthoria-chat -n '__fish_use_subcommand' -a 'workflow' -d 'List, instantiate, and run repeatable VigFlow workflows'

package/dist/commands/auth.d.ts

@@ -2,6 +2,7 @@ import { Command } from 'commander';
 export interface AuthConfig {
     apiUrl: string;
     token?: string;
+    refreshToken?: string;
     v3ServiceKey?: string;
     user?: {
         id?: string;

package/dist/commands/auth.js

@@ -1,13 +1,11 @@
 import chalk from 'chalk';
-import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'fs';
-import { homedir } from 'os';
-import path from 'path';
 import readline from 'readline';
 import { Config } from '../utils/config.js';
 import { clearGatewayPreflightCache } from '../utils/cli-state.js';
+import { AuthSessionService } from '../utils/auth-session.js';
+import { assertTrustedEndpoint, guardedFetch } from '../utils/network-policy.js';
+import { CliCommandError, commandFailure } from '../utils/command-contract.js';
 const DEFAULT_API_URL = 'https://coder.vigthoria.io';
-const CONFIG_DIR = path.join(homedir(), '.vigthoria');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
 const KNOWN_AUTH_BASE_URLS = ['https://coder.vigthoria.io'];
 class HttpError extends Error {
     status;
@@ -27,68 +25,13 @@ function uniqueStrings(values) {
     return [...new Set(values.filter(Boolean))];
 }
 function getApiUrl() {
-    return trimTrailingSlash(process.env.VIGTHORIA_API_URL || DEFAULT_API_URL);
-}
-function derivePeerHost(baseUrl) {
-    if (baseUrl.includes('://api.vigthoria.io')) {
-        return baseUrl.replace('://api.vigthoria.io', '://coder.vigthoria.io');
-    }
-    if (baseUrl.includes('://coder.vigthoria.io')) {
-        return baseUrl.replace('://coder.vigthoria.io', '://api.vigthoria.io');
-    }
-    return undefined;
+    const configured = trimTrailingSlash(process.env.VIGTHORIA_API_URL || DEFAULT_API_URL);
+    return trimTrailingSlash(assertTrustedEndpoint(configured, { audience: 'coder', credentialBearing: true, ignoreOffline: true }).toString());
 }
 function getAuthBaseCandidates(seedBaseUrl) {
     const seed = trimTrailingSlash(seedBaseUrl || getApiUrl());
-    const peer = derivePeerHost(seed);
-    return uniqueStrings([seed, ...(peer ? [peer] : []), ...KNOWN_AUTH_BASE_URLS]).map(trimTrailingSlash);
-}
-function ensureConfigDir() {
-    if (!existsSync(CONFIG_DIR)) {
-        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-    }
-    try {
-        chmodSync(CONFIG_DIR, 0o700);
-    }
-    catch {
-        // Best-effort on non-POSIX filesystems.
-    }
-}
-function syncSharedConfig(config) {
-    try {
-        const shared = new Config();
-        shared.set('apiUrl', trimTrailingSlash(config.apiUrl || getApiUrl()));
-        if (config.token) {
-            shared.set('authToken', config.token);
-        }
-        if (config.user?.id) {
-            shared.set('userId', String(config.user.id));
-        }
-        if (config.user?.email) {
-            shared.set('email', String(config.user.email));
-        }
-        // Always overwrite (never conditionally skip) so a fresh login can never
-        // leave a stale/rotated key behind from a prior session — a falsy value
-        // here explicitly clears the cache, forcing ensureV3ServiceKey() to fetch
-        // a real one on next use instead of silently trusting stale state.
-        shared.set('v3ServiceKey', config.v3ServiceKey || null);
-    }
-    catch {
-        // Keep legacy auth flow working even if shared config write fails.
-    }
-}
-function clearSharedConfigAuth() {
-    try {
-        const shared = new Config();
-        shared.set('authToken', null);
-        shared.set('refreshToken', null);
-        shared.set('userId', null);
-        shared.set('email', null);
-        shared.set('v3ServiceKey', null);
-    }
-    catch {
-        // Ignore shared config clear failures during logout.
-    }
+    return uniqueStrings([seed, ...KNOWN_AUTH_BASE_URLS])
+        .map((candidate) => trimTrailingSlash(assertTrustedEndpoint(candidate, { audience: 'coder', credentialBearing: true, ignoreOffline: true }).toString()));
 }
 function humanMessage(error) {
     const raw = error instanceof Error ? error.message : String(error);
@@ -128,16 +71,17 @@ function extractAuthUser(payload, fallbackEmail) {
     return fallbackEmail ? { email: fallbackEmail } : undefined;
 }
 export function loadAuthConfig() {
-    if (!existsSync(CONFIG_FILE)) {
-        return { apiUrl: getApiUrl() };
-    }
     try {
-        const parsed = JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
+        const shared = new Config();
         return {
-            apiUrl: trimTrailingSlash(parsed.apiUrl || getApiUrl()),
-            token: parsed.token || parsed.authToken,
-            v3ServiceKey: typeof parsed.v3ServiceKey === 'string' ? parsed.v3ServiceKey : undefined,
-            user: parsed.user,
+            apiUrl: trimTrailingSlash(String(shared.get('apiUrl') || getApiUrl())),
+            token: shared.get('authToken') || undefined,
+            refreshToken: shared.get('refreshToken') || undefined,
+            v3ServiceKey: shared.get('v3ServiceKey') || undefined,
+            user: {
+                id: shared.get('userId') || undefined,
+                email: shared.get('email') || undefined,
+            },
         };
     }
     catch (error) {
@@ -146,25 +90,23 @@ export function loadAuthConfig() {
     }
 }
 export function saveAuthConfig(config) {
-    ensureConfigDir();
-    writeFileSync(CONFIG_FILE, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
-    try {
-        chmodSync(CONFIG_FILE, 0o600);
-    }
-    catch {
-        // Best-effort on non-POSIX filesystems.
-    }
-    syncSharedConfig(config);
+    if (!config.token)
+        throw new Error('Cannot persist an authentication record without a token.');
+    const shared = new Config();
+    shared.setAuth({
+        token: config.token,
+        refreshToken: config.refreshToken,
+        userId: config.user?.id,
+        email: config.user?.email,
+        apiUrl: trimTrailingSlash(config.apiUrl || getApiUrl()),
+        v3ServiceKey: config.v3ServiceKey || null,
+    });
     // A fresh login must never be blocked by a stale cached gateway-preflight
     // failure from a prior (invalid) session.
     clearGatewayPreflightCache();
 }
 export function clearAuthConfig() {
-    if (existsSync(CONFIG_FILE)) {
-        rmSync(CONFIG_FILE, { force: true });
-    }
-    clearSharedConfigAuth();
-    clearGatewayPreflightCache();
+    new AuthSessionService(new Config()).clearLocalCredentials();
 }
 export function getAuthToken() {
     return process.env.VIGTHORIA_TOKEN || loadAuthConfig().token;
@@ -176,7 +118,7 @@ async function requestJson(url, init) {
     const timeoutHandle = setTimeout(() => controller.abort(), timeoutMs);
     let response;
     try {
-        response = await fetch(url, {
+        response = await guardedFetch(url, {
             ...init,
             signal: controller.signal,
             headers: {
@@ -184,7 +126,7 @@ async function requestJson(url, init) {
                 'content-type': 'application/json',
                 ...(init.headers || {}),
             },
-        });
+        }, { audience: 'coder' });
     }
     catch (error) {
         const name = error?.name;
@@ -277,12 +219,6 @@ async function ask(question, hidden = false) {
         rl.close();
     }
 }
-function markSuccessExit() {
-    process.exitCode = 0;
-}
-function markErrorExit() {
-    process.exitCode = 1;
-}
 export async function login(email, password) {
     try {
         const resolvedEmail = (email || '').trim();
@@ -315,15 +251,22 @@ export async function login(email, password) {
                     }
                     const normalizedBase = trimTrailingSlash(base);
                     const v3ServiceKey = await fetchV3ServiceKey(normalizedBase, token);
+                    const identity = extractAuthUser(result, resolvedEmail);
+                    const refreshToken = result.tokens?.refresh_token || undefined;
+                    await new AuthSessionService(new Config()).validateAndPersistToken(token, {
+                        apiUrl: normalizedBase,
+                        refreshToken,
+                        identity: { userId: identity?.id, email: identity?.email },
+                        v3ServiceKey: v3ServiceKey || null,
+                    });
                     const config = {
                         apiUrl: normalizedBase,
                         token,
-                        user: extractAuthUser(result, resolvedEmail),
+                        ...(refreshToken ? { refreshToken } : {}),
+                        user: identity,
                         ...(v3ServiceKey ? { v3ServiceKey } : {}),
                         success: true,
                     };
-                    saveAuthConfig(config);
-                    markSuccessExit();
                     return config;
                 }
                 catch (error) {
@@ -339,8 +282,12 @@ export async function login(email, password) {
     }
     catch (error) {
         const message = humanMessage(error);
-        markErrorExit();
-        throw new Error(message);
+        if (error instanceof HttpError && error.code === 'SUBSCRIPTION_REQUIRED') {
+            throw new CliCommandError(message, {
+                code: 'SUBSCRIPTION_REQUIRED', category: 'authorization', status: error.status, cause: error,
+            });
+        }
+        throw commandFailure(error, { code: 'LOGIN_FAILED', category: 'authentication', message });
     }
 }
 export async function logout() {
@@ -372,7 +319,6 @@ export async function logout() {
         }
     }
     clearAuthConfig();
-    process.exitCode = 0;
 }
 export async function whoami() {
     const config = loadAuthConfig();
@@ -424,32 +370,33 @@ export async function whoami() {
 }
 export async function doctor() {
     const config = loadAuthConfig();
+    const shared = new Config();
     const report = {
         nodeVersion: process.version,
         platform: process.platform,
         arch: process.arch,
-        configFile: CONFIG_FILE,
+        configFile: shared.getConfigPath(),
         loggedIn: Boolean(config.token),
         apiUrl: config.apiUrl,
     };
-    process.exitCode = 0;
     return report;
 }
 export async function handleLogin(options = {}) {
     try {
         if (options.token) {
+            const apiUrl = getApiUrl();
+            const v3ServiceKey = await fetchV3ServiceKey(apiUrl, options.token);
+            await new AuthSessionService(new Config()).validateAndPersistToken(options.token, {
+                apiUrl,
+                v3ServiceKey: v3ServiceKey || null,
+            });
             const config = {
-                apiUrl: getApiUrl(),
+                apiUrl,
                 token: options.token,
+                ...(v3ServiceKey ? { v3ServiceKey } : {}),
                 success: true,
             };
-            const v3ServiceKey = await fetchV3ServiceKey(config.apiUrl, options.token);
-            if (v3ServiceKey) {
-                config.v3ServiceKey = v3ServiceKey;
-            }
-            saveAuthConfig(config);
             console.log(chalk.green('Logged in successfully with API token.'));
-            process.exitCode = 0;
             return config;
         }
         let email = options.email?.trim();
@@ -502,24 +449,19 @@ export async function handleLogin(options = {}) {
         }
         catch { /* non-fatal */ }
         console.log(`API: ${config.apiUrl}`);
-        process.exitCode = 0;
         return config;
     }
     catch (error) {
-        console.error(chalk.red(`Login failed: ${humanMessage(error)}`));
-        process.exitCode = 1;
-        return undefined;
+        throw commandFailure(error, { code: 'LOGIN_FAILED', category: 'authentication', message: humanMessage(error) });
     }
 }
 export async function handleLogout(_options) {
     try {
         await logout();
         console.log(chalk.green('Logged out successfully.'));
-        process.exitCode = 0;
     }
     catch (error) {
-        console.error(chalk.red(`Logout failed: ${humanMessage(error)}`));
-        process.exitCode = 1;
+        throw commandFailure(error, { code: 'LOGOUT_FAILED', message: humanMessage(error) });
     }
 }
 export async function statusAction() {
@@ -532,7 +474,6 @@ export async function statusAction() {
         const effectiveToken = sharedToken || legacyConfig.token || '';
         if (!effectiveToken) {
             console.log(chalk.yellow('Not logged in.'));
-            process.exitCode = 0;
             return;
         }
         const authProbeHeaders = {
@@ -550,10 +491,9 @@ export async function statusAction() {
             // Network failures should not force logout status.
         }
         if (!authLooksValid) {
-            console.log(chalk.yellow('Not logged in. Session expired or invalid.'));
-            console.log(chalk.gray('Run: vigthoria login'));
-            process.exitCode = 1;
-            return;
+            throw new CliCommandError('Not logged in. Session expired or invalid. Run: vigthoria login', {
+                code: 'AUTH_SESSION_INVALID', category: 'authentication',
+            });
         }
         let user = legacyConfig.user;
         try {
@@ -595,11 +535,9 @@ export async function statusAction() {
         console.log(`Coder API: ${coderStatus}`);
         console.log(`Models API: ${modelsStatus}`);
         console.log(`API: ${effectiveApiUrl}`);
-        process.exitCode = 0;
     }
     catch (error) {
-        console.error(chalk.red(`Unable to read status: ${humanMessage(error)}`));
-        process.exitCode = 1;
+        throw commandFailure(error, { code: 'AUTH_STATUS_FAILED', message: humanMessage(error) });
     }
 }
 export function registerAuthCommands(program) {
@@ -628,16 +566,13 @@ export function registerAuthCommands(program) {
             const user = await whoami();
             if (!user) {
                 console.log(chalk.yellow('Not logged in.'));
-                process.exitCode = 0;
                 return;
             }
             console.log(chalk.green('Logged in.'));
             console.log(user.email || user.name || user.id || 'Authenticated user');
-            process.exitCode = 0;
         }
         catch (error) {
-            console.error(chalk.red(`Unable to fetch account: ${humanMessage(error)}`));
-            process.exitCode = 1;
+            throw commandFailure(error, { code: 'AUTH_WHOAMI_FAILED', message: humanMessage(error) });
         }
     });
 }

package/dist/commands/background.d.ts

@@ -8,8 +8,6 @@ interface BackgroundOptions {
     model?: string;
 }
 export declare class BackgroundCommand {
-    private config;
-    private logger;
     private api;
     constructor(config: Config, logger: Logger);
     start(promptParts: string[], options?: BackgroundOptions): Promise<void>;