@mycompbox/compbox-cli 1.13.0

package/commands/install.js

@@ -0,0 +1,88 @@
+import { Command } from 'commander';
+import ora from 'ora';
+import chalk from 'chalk';
+import { ApiClient } from '../utils/api-client.js';
+import { FileManager } from '../utils/file-manager.js';
+import { TableFormatter } from '../utils/table-formatter.js';
+export const installCommand = new Command('install')
+    .description('Install a Skill Pack from the registry')
+    .argument('<pack-name>', 'Name of the pack to install (e.g., @mycompbox/pack-example)')
+    .option('-v, --version <version>', 'Specific version to install (default: latest)')
+    .option('--registry <url>', 'Custom registry URL')
+    .option('--token <token>', 'API token for authentication (or set COMPBOX_TOKEN env var)')
+    .action(async (packName, options) => {
+    const spinner = ora('Installing Skill Pack...').start();
+    try {
+        // Initialize clients
+        const apiClient = new ApiClient(options.registry, options.token);
+        const fileManager = new FileManager();
+        // Fetch pack manifest
+        spinner.text = `Fetching ${packName}...`;
+        const manifest = await apiClient.getPackManifest(packName, options.version);
+        spinner.text = `Downloading ${manifest.name}@${manifest.version}...`;
+        const packFiles = await apiClient.downloadPackFiles(packName, options.version);
+        // Clean up old files if this pack was previously installed (upgrade scenario)
+        const existingManifest = await fileManager.readManifest();
+        const existingPack = existingManifest.installedPacks[manifest.name];
+        if (existingPack?.files.length) {
+            spinner.text = 'Removing previous version files...';
+            await fileManager.deletePackFiles(existingPack.files);
+        }
+        // Clean up deprecated files declared by the pack (handles upgrades without prior manifest)
+        if (manifest.deprecatedFiles?.length) {
+            spinner.text = 'Removing deprecated files...';
+            await fileManager.deletePackFiles(manifest.deprecatedFiles);
+        }
+        // Copy files to .github directory
+        spinner.text = 'Installing files...';
+        const installedFiles = await fileManager.copyFilesToGithub(packFiles, manifest.name);
+        // Merge MCP configuration if present
+        if (manifest.mcpConfig) {
+            spinner.text = 'Merging MCP configuration...';
+            await fileManager.mergeMcpConfig(manifest.mcpConfig);
+        }
+        // Update local manifest
+        spinner.text = 'Updating manifest...';
+        await fileManager.addPackToManifest(manifest.name, manifest.version, installedFiles);
+        // Sync installation with registry (best-effort)
+        try {
+            spinner.text = 'Syncing with registry...';
+            await apiClient.recordInstallation(manifest.name, manifest.version);
+        }
+        catch (error) {
+            // Non-critical: local install succeeded, warn and continue
+            const msg = error instanceof Error ? error.message : 'Unknown error';
+            spinner.warn(chalk.yellow(`Registry sync failed: ${msg}`));
+            console.log(chalk.gray('  The pack was installed locally, but the registry may be out of sync.'));
+            spinner.start();
+        }
+        spinner.succeed(TableFormatter.success(`Installed ${manifest.name}@${manifest.version}`));
+        // Show next steps
+        console.log('\n' + chalk.bold('Next steps:'));
+        console.log(chalk.gray('  1. Review the installed files in .github/'));
+        console.log(chalk.gray('  2. Commit the changes to version control'));
+        console.log(chalk.gray('  3. Use the new skills and agents in your project'));
+        if (manifest.mcpConfig) {
+            console.log(chalk.gray('  4. MCP configuration has been updated'));
+        }
+    }
+    catch (error) {
+        spinner.fail(TableFormatter.error('Installation failed'));
+        if (error instanceof Error) {
+            console.error(chalk.red(`\nError: ${error.message}`));
+            // Provide helpful hints based on error type
+            if (error.message.includes('ENOTFOUND') || error.message.includes('ECONNREFUSED')) {
+                console.error(chalk.yellow('\nTip: Check your network connection and registry URL'));
+            }
+            else if (error.message.includes('404')) {
+                console.error(chalk.yellow('\nTip: Verify the pack name and version exist in the registry'));
+                console.error(chalk.gray('Run: compbox list --available'));
+            }
+            else if (error.message.includes('EACCES')) {
+                console.error(chalk.yellow('\nTip: Check file permissions in the .github directory'));
+            }
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=install.js.map

package/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}

package/commands/list.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const listCommand: Command;
+//# sourceMappingURL=list.d.ts.map

package/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,eAAO,MAAM,WAAW,SAyJpB,CAAC"}

package/commands/list.js

@@ -0,0 +1,141 @@
+import { Command } from 'commander';
+import ora from 'ora';
+import chalk from 'chalk';
+import { ApiClient } from '../utils/api-client.js';
+import { FileManager } from '../utils/file-manager.js';
+import { VersionResolver } from '../utils/version-resolver.js';
+import { TableFormatter } from '../utils/table-formatter.js';
+export const listCommand = new Command('list')
+    .description('List installed and available Skill Packs')
+    .option('--installed', 'Show only installed packs')
+    .option('--available', 'Show only available packs from registry')
+    .option('--registry <url>', 'Custom registry URL')
+    .option('--token <token>', 'API token for authentication (or set COMPBOX_TOKEN env var)')
+    .action(async (options) => {
+    const spinner = ora('Loading packs...').start();
+    try {
+        const apiClient = new ApiClient(options.registry, options.token);
+        const fileManager = new FileManager();
+        // Determine what to show
+        const showInstalled = options.installed ?? !options.available;
+        const showAvailable = options.available ?? !options.installed;
+        let installedPacks = {};
+        let availablePacks = [];
+        // Fetch installed packs
+        if (showInstalled) {
+            try {
+                const manifest = await fileManager.readManifest();
+                installedPacks = manifest.installedPacks;
+            }
+            catch {
+                // No manifest yet - no packs installed
+            }
+        }
+        // Fetch available packs from registry
+        if (showAvailable) {
+            try {
+                availablePacks = await apiClient.listPacks();
+            }
+            catch (error) {
+                spinner.warn(chalk.yellow('Could not fetch available packs from registry'));
+                if (error instanceof Error) {
+                    console.error(chalk.gray(`  ${error.message}`));
+                }
+            }
+        }
+        spinner.stop();
+        // Display results based on mode
+        if (options.installed) {
+            // Show only installed packs
+            if (Object.keys(installedPacks).length === 0) {
+                console.log(TableFormatter.warning('No packs installed'));
+                console.log(chalk.gray('\nInstall a pack: compbox install <pack-name>'));
+                return;
+            }
+            console.log(chalk.bold('\nInstalled Packs:'));
+            const rows = Object.entries(installedPacks).map(([name, info]) => ({
+                name,
+                version: info.version,
+                installedVersion: info.installedAt,
+            }));
+            console.log(TableFormatter.formatInstalledPacks(rows));
+        }
+        else if (options.available) {
+            // Show only available packs
+            if (availablePacks.length === 0) {
+                console.log(TableFormatter.warning('No packs available in registry'));
+                return;
+            }
+            console.log(chalk.bold('\nAvailable Packs:'));
+            const rows = availablePacks.map((pack) => ({
+                name: pack.name,
+                version: pack.latestVersion,
+                description: pack.description,
+            }));
+            console.log(TableFormatter.formatAvailablePacks(rows));
+        }
+        else {
+            // Show combined view
+            const combinedPacks = new Map();
+            // Add available packs
+            for (const pack of availablePacks) {
+                combinedPacks.set(pack.name, {
+                    name: pack.name,
+                    version: pack.latestVersion,
+                    description: pack.description,
+                });
+            }
+            // Merge with installed packs and check for updates
+            for (const [name, installed] of Object.entries(installedPacks)) {
+                const existing = combinedPacks.get(name);
+                if (existing) {
+                    // Check if update is available
+                    const versionInfo = VersionResolver.compareVersions(installed.version, existing.version);
+                    combinedPacks.set(name, {
+                        ...existing,
+                        installedVersion: installed.version,
+                        updateAvailable: versionInfo.needsUpdate
+                            ? existing.version
+                            : undefined,
+                    });
+                }
+                else {
+                    // Pack is installed but not in registry (custom or removed)
+                    combinedPacks.set(name, {
+                        name,
+                        version: installed.version,
+                        installedVersion: installed.version,
+                        description: 'Not in registry',
+                    });
+                }
+            }
+            const rows = Array.from(combinedPacks.values()).sort((a, b) => a.name.localeCompare(b.name));
+            if (rows.length === 0) {
+                console.log(TableFormatter.warning('No packs found'));
+                console.log(chalk.gray('\nInstall a pack: compbox install <pack-name>'));
+                return;
+            }
+            console.log(chalk.bold('\nSkill Packs:'));
+            console.log(TableFormatter.formatCombinedPacks(rows));
+            // Show summary
+            const installedCount = Object.keys(installedPacks).length;
+            const availableCount = availablePacks.length;
+            const updatesAvailable = rows.filter((r) => r.updateAvailable).length;
+            console.log('');
+            console.log(chalk.gray(`Installed: ${String(installedCount)}`));
+            console.log(chalk.gray(`Available: ${String(availableCount)}`));
+            if (updatesAvailable > 0) {
+                console.log(chalk.yellow(`Updates available: ${String(updatesAvailable)}`));
+                console.log(chalk.gray('\nRun: compbox update --yes'));
+            }
+        }
+    }
+    catch (error) {
+        spinner.fail(TableFormatter.error('Failed to list packs'));
+        if (error instanceof Error) {
+            console.error(chalk.red(`\nError: ${error.message}`));
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=list.js.map

package/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"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"}

package/commands/login.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `compbox login` — authenticate the employee to central and persist pairing
+ * config locally.
+ *
+ * Flow:
+ *   1. Resolve the central API base URL (flag → existing config → prompt).
+ *   2. Authenticate with email + password (JWT exchange).
+ *   3. Mint a long-lived per-employee CompBox API token.
+ *   4. Persist the central URL, token, and resolved identity to
+ *      `~/.compbox/config.json` (0600). The AI provider secret is handled
+ *      separately by `compbox configure` and never touches this file.
+ */
+import { Command } from 'commander';
+export declare const loginCommand: Command;
+//# sourceMappingURL=login.d.ts.map

package/commands/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BpC,eAAO,MAAM,YAAY,SAuFrB,CAAC"}

package/commands/login.js

@@ -0,0 +1,102 @@
+/**
+ * `compbox login` — authenticate the employee to central and persist pairing
+ * config locally.
+ *
+ * Flow:
+ *   1. Resolve the central API base URL (flag → existing config → prompt).
+ *   2. Authenticate with email + password (JWT exchange).
+ *   3. Mint a long-lived per-employee CompBox API token.
+ *   4. Persist the central URL, token, and resolved identity to
+ *      `~/.compbox/config.json` (0600). The AI provider secret is handled
+ *      separately by `compbox configure` and never touches this file.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { hostname } from 'os';
+import { AuthClient, AuthClientError } from '../utils/auth-client.js';
+import { readConfig, updateConfig } from '../utils/config-store.js';
+import { promptText, promptSecret } from '../utils/prompt.js';
+import { isLoopbackUrl, LOOPBACK_NOTICE } from '../utils/loopback.js';
+async function resolveBaseUrl(option) {
+    if (option && option.trim().length > 0) {
+        return option.trim();
+    }
+    const existing = readConfig().apiBaseUrl;
+    if (existing && existing.trim().length > 0) {
+        return existing.trim();
+    }
+    const entered = await promptText('Central CompBox API URL: ');
+    if (entered.length === 0) {
+        throw new Error('A central API URL is required.');
+    }
+    return entered;
+}
+export const loginCommand = new Command('login')
+    .description('Authenticate to central CompBox and store your pairing config')
+    .option('--url <url>', 'Central CompBox API base URL')
+    .option('--email <email>', 'Account email (otherwise prompted)')
+    .option('--password <password>', 'Account password (otherwise prompted; prefer the prompt to keep it out of shell history)')
+    .option('--token-name <name>', 'Name for the generated API token')
+    .action(async (options) => {
+    try {
+        const baseUrl = await resolveBaseUrl(options.url);
+        const client = new AuthClient(baseUrl);
+        const email = options.email && options.email.trim().length > 0
+            ? options.email.trim()
+            : await promptText('Email: ');
+        if (email.length === 0) {
+            throw new Error('Email is required.');
+        }
+        const password = options.password && options.password.length > 0
+            ? options.password
+            : await promptSecret('Password: ');
+        if (password.length === 0) {
+            throw new Error('Password is required.');
+        }
+        console.log(chalk.gray(`\nAuthenticating to ${baseUrl}...`));
+        const loginResult = await client.login(email, password);
+        const tokenName = options.tokenName && options.tokenName.trim().length > 0
+            ? options.tokenName.trim()
+            : `compbox-cli@${hostname()}`;
+        console.log(chalk.gray('Provisioning your per-employee API token...'));
+        const apiToken = await client.createApiToken(loginResult.accessToken, tokenName);
+        updateConfig({
+            apiBaseUrl: client.baseUrl,
+            apiToken: apiToken.token,
+            apiTokenId: apiToken.id,
+            userId: loginResult.user.id,
+            email: loginResult.user.email,
+            userName: loginResult.user.name,
+        });
+        console.log(chalk.green(`\n✔ Paired as ${loginResult.user.name} <${loginResult.user.email}>`));
+        console.log(chalk.gray(`  Central URL:  ${client.baseUrl}`));
+        console.log(chalk.gray(`  Token:        ${tokenName} (stored locally)`));
+        if (isLoopbackUrl(client.baseUrl)) {
+            // Non-blocking: localhost is a valid dev target, but make it impossible
+            // to silently believe this reaches the cloud central.
+            console.log(chalk.yellow(`\n⚠ ${LOOPBACK_NOTICE}`));
+        }
+        console.log('\n' + chalk.bold('Next step:'));
+        console.log(chalk.gray('  Run `compbox configure` to select your AI mode, pair this device, and write the MCP config.'));
+        console.log(chalk.gray('  `compbox configure` will then tell you how to start the Agent Runner service on this machine.'));
+    }
+    catch (error) {
+        if (error instanceof AuthClientError) {
+            console.error(chalk.red(`\nLogin failed: ${error.message}`));
+            if (error.status === 401) {
+                console.error(chalk.yellow('Tip: double-check your email and password.'));
+            }
+            else if (error.status === 0) {
+                console.error(chalk.yellow('Tip: verify the central API URL and your network connection.'));
+            }
+        }
+        else if (error instanceof Error) {
+            console.error(chalk.red(`\nLogin failed: ${error.message}`));
+        }
+        else {
+            console.error(chalk.red('\nLogin failed: unknown error'));
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=login.js.map

package/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"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"}

package/commands/publish.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const publishCommand: Command;
+//# sourceMappingURL=publish.d.ts.map

package/commands/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,eAAO,MAAM,cAAc,SAuIvB,CAAC"}

package/commands/publish.js

@@ -0,0 +1,102 @@
+import { Command } from 'commander';
+import ora from 'ora';
+import chalk from 'chalk';
+import { ApiClient } from '../utils/api-client.js';
+import { PackBundler } from '../utils/pack-bundler.js';
+import { TableFormatter } from '../utils/table-formatter.js';
+export const publishCommand = new Command('publish')
+    .description('Publish a Skill Pack to the registry')
+    .option('--registry <url>', 'Custom registry URL')
+    .option('--token <token>', 'Authentication token (or set COMPBOX_API_TOKEN env var)')
+    .option('--dry-run', 'Validate the pack without publishing')
+    .action(async (options) => {
+    const spinner = ora('Preparing pack for publishing...').start();
+    try {
+        const bundler = new PackBundler();
+        // Validate pack
+        spinner.text = 'Validating pack...';
+        const validation = await bundler.validatePack(options.dryRun);
+        if (!validation.valid) {
+            spinner.fail(TableFormatter.error('Pack validation failed'));
+            console.error(chalk.red('\nErrors:'));
+            for (const error of validation.errors) {
+                console.error(chalk.red(`  ✗ ${error}`));
+            }
+            process.exit(1);
+        }
+        if (validation.warnings.length > 0) {
+            spinner.warn(chalk.yellow('Pack has warnings'));
+            for (const warning of validation.warnings) {
+                console.warn(chalk.yellow(`  ⚠ ${warning}`));
+            }
+            console.log('');
+        }
+        else {
+            spinner.succeed(TableFormatter.success('Pack validation passed'));
+        }
+        // Bundle the pack
+        spinner.start('Bundling pack files...');
+        const bundled = await bundler.bundlePack();
+        if (options.dryRun) {
+            spinner.succeed(TableFormatter.success('Dry run complete'));
+            console.log(chalk.bold('\nPack contents:'));
+            console.log(chalk.cyan(`  Name: ${bundled.manifest.name}`));
+            console.log(chalk.cyan(`  Version: ${bundled.manifest.version}`));
+            console.log(chalk.cyan(`  Description: ${bundled.manifest.description}`));
+            if (bundled.manifest.author) {
+                console.log(chalk.cyan(`  Author: ${bundled.manifest.author}`));
+            }
+            console.log(chalk.cyan(`  Files: ${String(Object.keys(bundled.files).length)}`));
+            console.log(chalk.bold('\nFile list:'));
+            for (const filePath of Object.keys(bundled.files)) {
+                console.log(chalk.gray(`  - ${filePath}`));
+            }
+            console.log(chalk.green('\n✓ Pack is ready to publish. Remove --dry-run to upload.'));
+            return;
+        }
+        // Get authentication token
+        const token = options.token ?? process.env.COMPBOX_API_TOKEN;
+        if (!token) {
+            spinner.fail(TableFormatter.error('Authentication required'));
+            console.error(chalk.red('\nError: No authentication token provided. Use --token or set COMPBOX_API_TOKEN env var.'));
+            process.exit(1);
+        }
+        // Publish to registry
+        spinner.start(`Publishing ${bundled.manifest.name}@${bundled.manifest.version}...`);
+        const apiClient = new ApiClient(options.registry);
+        // Resolve pack UUID (POST routes require UUID, not scoped names)
+        spinner.text = `Resolving pack ${bundled.manifest.name}...`;
+        const packId = await apiClient.getPackId(bundled.manifest.name);
+        // Step 1: Publish version with manifest
+        spinner.text = `Publishing version ${bundled.manifest.version}...`;
+        await apiClient.publishVersion(packId, bundled.manifest.version, bundled.manifest, token);
+        // Step 2: Upload files
+        const fileEntries = Object.entries(bundled.files).map(([filePath, content]) => ({
+            path: filePath,
+            content,
+        }));
+        spinner.text = `Uploading ${String(fileEntries.length)} files...`;
+        await apiClient.uploadFiles(packId, bundled.manifest.version, fileEntries, token);
+        spinner.succeed(TableFormatter.success(`Published ${bundled.manifest.name}@${bundled.manifest.version}`));
+        console.log(chalk.bold('\nInstall with:'));
+        console.log(chalk.cyan(`  compbox install ${bundled.manifest.name}`));
+    }
+    catch (error) {
+        spinner.fail(TableFormatter.error('Publish failed'));
+        if (error instanceof Error) {
+            console.error(chalk.red(`\nError: ${error.message}`));
+            // Provide helpful hints
+            if (error.message.includes('401') || error.message.includes('Unauthorized')) {
+                console.error(chalk.yellow('\nTip: Check your authentication token is valid'));
+            }
+            else if (error.message.includes('409') || error.message.includes('already exists')) {
+                console.error(chalk.yellow('\nTip: Version already published. Bump the version in .compbox/pack.json'));
+            }
+            else if (error.message.includes('ENOENT')) {
+                console.error(chalk.yellow('\nTip: Make sure .compbox/pack.json exists with valid file references'));
+            }
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=publish.js.map

package/commands/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"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"}

package/commands/run.d.ts

@@ -0,0 +1,76 @@
+/**
+ * `compbox run` — the Agent Runner daemon (ENG-E23 / ENG-122).
+ *
+ * Long-polls central for the next job assigned to this machine, claims it,
+ * and dispatches by type. This command IS the process a service supervisor
+ * (launchd / systemd via `brew services`, or a Windows Service) keeps alive —
+ * see the ENG-122 distribution decision (Homebrew tap + PowerShell installer,
+ * no hand-rolled installer).
+ *
+ * Scope note (ENG-122-1/2/4, honestly reflecting what's implemented): the
+ * poll/claim/dispatch/heartbeat/reconnect mechanics are complete. Real agent
+ * invocation is implemented for `job.type: epic_request` under BOTH
+ * `agentMode: api-key` (Anthropic Messages API directly) and
+ * `agentMode: claude-subscription` (shells out to the local `claude` CLI,
+ * using whichever account is logged in — personal Pro/Max or a Team seat) —
+ * see agent-invoker.ts. `start_execution` jobs still fall back to the honest
+ * "not implemented" completion below rather than faking anything — nobody
+ * is ever left staring at a silent "awaiting_input" forever; the browser's
+ * ENG-123-2 failure banner surfaces the reason.
+ */
+import { Command } from 'commander';
+import { type StartExecutionPayload } from '@mycompbox/shared';
+import { MailboxClient } from '../utils/mailbox-client.js';
+import { type AgentRuntimeProbe } from '../utils/claude-runtime.js';
+/**
+ * Whether the agent-runtime heartbeat is due. Driven SOLELY by when the runtime
+ * status was last *sent* (`lastRuntimeSentMs`), never by next-job activity — this
+ * is the invariant whose violation (gating on a timer that next-job reset every
+ * ~25s) previously starved the 60s heartbeat so the status was never transmitted
+ * and machines showed "agent runtime not found" despite being able to run jobs.
+ * `lastRuntimeSentMs === 0` (nothing sent yet) is always due.
+ */
+export declare function runtimeHeartbeatDue(nowMs: number, lastRuntimeSentMs: number, intervalMs?: number): boolean;
+/**
+ * Runs the agent-runtime probe (ENG-136), swallowing ANY error: a probe must
+ * never stop the daemon loop or block job dispatch. `probeAgentRuntime` is
+ * contractually non-rejecting, but we defend against it anyway — on a thrown
+ * error we log a gray warning and return `previous` (the last known-good probe,
+ * or `undefined` at startup) so the daemon keeps reporting the most recent
+ * status rather than dropping it.
+ *
+ * Extracted (and exported) as a pure-ish, dependency-injectable unit so the
+ * error-swallowing behavior is testable without spawning a real `claude`.
+ */
+export declare function safeProbeAgentRuntime(probe: () => Promise<AgentRuntimeProbe>, previous: AgentRuntimeProbe | undefined, log?: (message: string) => void): Promise<AgentRuntimeProbe | undefined>;
+/**
+ * One idle-heartbeat cycle (ENG-136): refresh the cached runtime probe (errors
+ * swallowed by {@link safeProbeAgentRuntime}) and send an explicit heartbeat
+ * carrying the latest known runtime status. The heartbeat POST body is the SOLE
+ * ingestion channel for runtime status — next-job is a GET and cannot carry it
+ * (architect correction H3).
+ *
+ * Heartbeat failure is best-effort (swallowed) — the next successful next-job
+ * call heartbeats server-side anyway. Returns `{ runtime, sent }` so the caller
+ * updates its cache regardless, but only advances its heartbeat clock when the
+ * ping actually landed.
+ */
+export declare function runHeartbeatCycle(deps: {
+    client: Pick<MailboxClient, 'heartbeat'>;
+    machineToken: string;
+    probe: () => Promise<AgentRuntimeProbe>;
+    previous: AgentRuntimeProbe | undefined;
+    log?: (message: string) => void;
+}): Promise<{
+    runtime: AgentRuntimeProbe | undefined;
+    sent: boolean;
+}>;
+/**
+ * Parse a claimed job's `payload` into a {@link StartExecutionPayload}, or null
+ * if malformed. The mailbox delivers `payload` as `unknown` — already an object
+ * in the common case (the API deserializes the stored JSON string, matching how
+ * `parseSeedPayload` treats it), but tolerant of a raw JSON string too.
+ */
+export declare function parseStartExecutionPayload(payload: unknown): StartExecutionPayload | null;
+export declare const runCommand: Command;
+//# sourceMappingURL=run.d.ts.map

package/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAMtF,OAAO,EACL,aAAa,EAGd,MAAM,4BAA4B,CAAC;AAQpC,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AA4BpC;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,UAAU,GAAE,MAA8B,GACzC,OAAO,CAET;AAUD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,EACvC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,GAAG,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAA8C,GACvE,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAQxC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CASrE;AAaD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,qBAAqB,GAAG,IAAI,CAmBzF;AA0LD,eAAO,MAAM,UAAU,SA+KnB,CAAC"}