@agent-wire/terminal 1.7.6 → 1.7.9

package/dist/cli.js

@@ -1,144 +1,41 @@
 #!/usr/bin/env node
 import { loadConfig, saveConfig } from './config.js';
-import { CONFIG_DIR } from './config.js';
 import { WireAPI } from './api.js';
 import { startBackgroundWorkLoop } from './background-worker.js';
 import { acquireLock, releaseLock, isWorkerRunning } from './lockfile.js';
 import { runWaitCommand } from './wait-cli.js';
-import { formatLocalPullReport, pullLocalSubscriptions, writeDefaultLocalPullManifest } from './local-pull.js';
-import { readFileSync, writeFileSync, watch as fsWatch, existsSync, mkdirSync } from 'fs';
-import { resolve, join } from 'path';
-import { createInterface } from 'readline';
-import { walkDirectory, computeDiff, pushFiles, pullFiles, generatePreview, parseManifest, serializeManifest, updateManifest, resolveConflicts, } from './sync/index.js';
+import { runProjectedCommand } from './cli-projection.js';
+import { resumeToken } from './resume.js';
 const args = process.argv.slice(2);
 const command = args[0];
 const commandHelpRequested = args.includes('--help') || args.includes('-h');
 function printInitUsage() {
-    console.error('Usage: agent-wire-terminal init [--token TOKEN]');
+    console.error('Usage: npx -y @agent-wire/terminal init [--token TOKEN]');
     console.error('');
-    console.error('Register this node with the Wire network.');
-    console.error('Requires an API token from /api/v1/register or WIRE_API_TOKEN env var.');
+    console.error('Resume the existing agent identified by your saved API token.');
+    console.error('Terminal 1.7.9+: set WIRE_API_TOKEN_FILE to the absolute path of your API token file.');
+    console.error('WIRE_API_TOKEN is supported on every terminal version.');
+    console.error('Token precedence: WIRE_API_TOKEN > WIRE_API_TOKEN_FILE > saved config.');
 }
 function printStartUsage() {
-    console.error('Usage: agent-wire-terminal start');
+    console.error('Usage: npx -y @agent-wire/terminal start');
     console.error('');
     console.error('Run standalone node daemon. Acquires a PID lock, polls for work, and earns credits.');
 }
 function printServeUsage() {
-    console.error('Usage: agent-wire-terminal serve [options]');
+    console.error('Usage: npx -y @agent-wire/terminal serve [options]');
     console.error('');
     console.error('Start MCP server. Defaults to stdio transport.');
+    console.error('Terminal 1.7.9+ for Claude/other MCP clients: env: { "WIRE_API_TOKEN_FILE": "/absolute/path/to/token" }');
+    console.error('WIRE_API_TOKEN is the alternative on every terminal version.');
+    console.error('In file mode, wire_identify registration/device-resume tokens are session-only.');
+    console.error('Restarts resume the identity in the file; have your operator provision that file to keep a new identity.');
     console.error('');
     console.error('Options:');
     console.error('  --http         Use HTTP transport instead of stdio');
     console.error('  --port PORT    HTTP port (default: 3200)');
     console.error('  --no-worker    Skip background work loop');
 }
-function printBalanceUsage() {
-    console.error('Usage: agent-wire-terminal balance');
-    console.error('');
-    console.error('Check operator pool credits, reputation, and jobs.');
-}
-function printStatusUsage() {
-    console.error('Usage: agent-wire-terminal status');
-    console.error('');
-    console.error('Show current config: API URL, token, node ID, and capabilities.');
-}
-function printSyncUsage() {
-    console.error('Usage: agent-wire-terminal sync --dir PATH --corpus SLUG --action diff|push|pull|preview [options]');
-    console.error('');
-    console.error('Sync local directory with a Wire corpus.');
-    console.error('');
-    console.error('Options:');
-    console.error('  --dir PATH       Local directory to sync (required)');
-    console.error('  --corpus SLUG    Wire corpus slug (required)');
-    console.error('  --action ACTION  diff|push|pull|preview (required)');
-    console.error('  --watch          Watch for changes, auto-push (push only)');
-    console.error('  --publish        Publish documents on push (default: draft)');
-    console.error('  --market-native-docs-ingest MODE');
-    console.error('                   Route push through /wire/sync and dispatch market-native');
-    console.error('                   docs ingest. MODE: off|auto|all (default: off)');
-    console.error('                   Oversized docs use 8000-token windows with 2000-token overlap.');
-    console.error('  --yes            Skip confirmation prompts');
-}
-function printPullUsage() {
-    console.error('Usage: agent-wire-terminal pull [--manifest PATH] [--init] [--dry-run] [--json]');
-    console.error('');
-    console.error('Pull subscribed Wire contribution bodies into local cache/skill files.');
-    console.error('Default manifest: ~/.wire-node/sync-manifest.json');
-}
-function printChainUsage() {
-    console.error('Usage: agent-wire-terminal chain run --chain HANDLE_OR_UUID --input-json JSON --quote');
-    console.error('       agent-wire-terminal chain run --chain HANDLE_OR_UUID --input-json JSON --quote-id TOKEN [--async-ack|--timeout-ms MS]');
-    console.error('       agent-wire-terminal chain run --chain HANDLE_OR_UUID --input-json JSON --auto --max-credits N [--async-ack|--timeout-ms MS]');
-    console.error('       agent-wire-terminal chain poll --chain HANDLE_OR_UUID --run-handle HANDLE_PATH [--include-steps]');
-    console.error('');
-    console.error('Quote, execute, or poll a canonical Wire chain.');
-    console.error('');
-    console.error('Options:');
-    console.error('  --chain VALUE          Chain handle, UUID, or canonical target (required)');
-    console.error('  --input-json JSON      JSON object input (default: {})');
-    console.error('  --quote                Request quote mode');
-    console.error('  --quote-id TOKEN       Execute trusted mode with quote token');
-    console.error('  --auto                 Quote server-side and execute only when price is <= --max-credits');
-    console.error('  --max-credits N        Required with --auto; positive integer price cap');
-    console.error('  --async-ack            Return immediately with a pollable async run handle');
-    console.error('  --timeout-ms MS        Trusted invoke deadline (default: 600000ms; max: 1800000ms)');
-    console.error('  --run-handle HANDLE    Async run handle path for chain poll');
-    console.error('  --run-id UUID          Diagnostic async run id for chain poll');
-    console.error('  --entry-mode MODE      direct|start (default: direct)');
-    console.error('  --chain-id UUID        Optional chain UUID to bind in quote');
-    console.error('  --include-steps        Include step_results in execute response');
-}
-function printSurfaceUsage() {
-    console.error('Usage: agent-wire-terminal s [list|init]');
-    console.error('       agent-wire-terminal s SHORTCUT [--input-json JSON] [--quote|--quote-id TOKEN|--auto --max-credits N] [--async-ack|--timeout-ms MS]');
-    console.error('       agent-wire-terminal surface SHORTCUT [--input-json JSON] [--quote|--quote-id TOKEN|--auto --max-credits N] [--async-ack|--timeout-ms MS]');
-    console.error('');
-    console.error('Resolve local surface/holster shortcuts to canonical Wire chain runs.');
-    console.error('');
-    console.error('Options:');
-    console.error('  --holster PATH         Shortcut holster JSON path (default: ~/.wire-node/surface-shortcuts.json)');
-    console.error('  --input-json JSON      JSON object merged over shortcut input');
-    console.error('  --quote                Request quote mode (default when --quote-id is absent)');
-    console.error('  --quote-id TOKEN       Execute trusted mode with quote token');
-    console.error('  --auto                 Quote server-side and execute only when price is <= --max-credits');
-    console.error('  --max-credits N        Required with --auto; positive integer price cap');
-    console.error('  --async-ack            Return immediately with a pollable async run handle');
-    console.error('  --timeout-ms MS        Trusted invoke deadline (default: 600000ms; max: 1800000ms)');
-    console.error('  --entry-mode MODE      direct|start (default from shortcut or direct)');
-    console.error('  --chain-id UUID        Optional chain UUID to bind in quote');
-    console.error('  --include-steps        Include step_results in execute response');
-    console.error('');
-    console.error('Seeded canary input:');
-    console.error('  agent-wire-terminal s canary --input-json \'{"battery_ref":"pr77-smoke","test_run_id":"surface-smoke-001","subject_agent":"agent/playful/codex-newman","source_principal":"agent/playful/codex-kramer"}\' --quote');
-    console.error('  source_principal and subject_agent must be different.');
-}
-function readFlag(argv, flag) {
-    const idx = argv.indexOf(flag);
-    if (idx === -1)
-        return undefined;
-    return argv[idx + 1];
-}
-function parseInputJson(raw) {
-    if (!raw)
-        return {};
-    const parsed = JSON.parse(raw);
-    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new Error('--input-json must parse to a JSON object');
-    }
-    return parsed;
-}
-function parsePositiveIntegerFlag(argv, flag) {
-    const raw = readFlag(argv, flag);
-    if (raw === undefined)
-        return undefined;
-    const parsed = Number(raw);
-    if (!Number.isInteger(parsed) || parsed <= 0) {
-        throw new Error(`${flag} must be a positive integer`);
-    }
-    return parsed;
-}
 async function init() {
     console.error('Wire Node -- Initializing...');
     const config = loadConfig();
@@ -146,37 +43,38 @@ async function init() {
     const tokenIdx = args.indexOf('--token');
     if (tokenIdx !== -1 && args[tokenIdx + 1]) {
         config.apiToken = args[tokenIdx + 1];
+        delete config.apiTokenFile;
     }
     if (!config.apiToken) {
         console.error('No API token configured.');
-        console.error('   Usage: agent-wire-terminal init --token YOUR_TOKEN');
+        console.error('   Usage: npx -y @agent-wire/terminal init --token YOUR_TOKEN');
         process.exit(1);
     }
     const api = new WireAPI(config);
     try {
-        const node = await api.registerNode(config.nodeName, config.capabilities);
-        config.nodeId = node.node_id;
+        const resumed = await resumeToken(api, config.apiToken);
         saveConfig(config);
-        console.error(`Node registered: ${node.node_id}`);
+        console.error(`Agent resumed: ${resumed.name} (${resumed.identity.pseudoId})`);
         console.error(`   Name: ${config.nodeName}`);
         console.error(`   Capabilities: ${config.capabilities.join(', ')}`);
-        console.error(`   Status: ${node.status}`);
-        console.error('\n   Run "agent-wire-terminal start" to begin earning credits.');
+        console.error(`   Status: ${resumed.identity.verificationStatus}`);
+        console.error('\n   Run "npx -y @agent-wire/terminal serve" to use this agent over MCP.');
     }
     catch (err) {
-        console.error('Registration failed:', err.message);
+        console.error('Resume failed:', err.message);
         process.exit(1);
     }
 }
 async function start() {
     const config = loadConfig();
     if (!config.apiToken) {
-        console.error('No API token. Run "agent-wire-terminal init --token YOUR_TOKEN" first.');
+        console.error('No API token. Run "npx -y @agent-wire/terminal init --token YOUR_TOKEN" first.');
         process.exit(1);
     }
     if (!config.nodeId) {
-        console.error('Node not registered. Run "agent-wire-terminal init" first.');
-        process.exit(1);
+        const node = await new WireAPI(config).registerNode(config.nodeName, config.capabilities);
+        config.nodeId = node.node_id;
+        saveConfig(config);
     }
     // One node per machine — acquire PID lock
     const existingPid = isWorkerRunning();
@@ -231,845 +129,48 @@ async function serve() {
         port,
     });
 }
-async function balance() {
-    const config = loadConfig();
-    if (!config.apiToken) {
-        console.error('No API token. Run "agent-wire-terminal init --token YOUR_TOKEN" first.');
-        process.exit(1);
-    }
-    const api = new WireAPI(config);
-    try {
-        const result = await api.getBalance();
-        console.log('Wire Node -- Balance');
-        console.log('');
-        // Credits summary (Pillar 15 — operator pool is the sole source of truth)
-        const rep = result.reputation;
-        const creditsBalance = rep?.pool_balance;
-        const totalEarned = rep?.total_credits_earned;
-        const jobsCompleted = rep?.jobs_completed;
-        if (creditsBalance !== undefined) {
-            const wireTake = totalEarned !== undefined
-                ? Math.round(totalEarned * 0.025)
-                : undefined;
-            const earnedStr = totalEarned !== undefined ? ` (earned: ${totalEarned.toLocaleString()}` : '';
-            const takeStr = wireTake !== undefined ? ` | wire take: ${wireTake.toLocaleString()})` : '';
-            console.log(`   Credits: ${creditsBalance.toLocaleString()}${earnedStr}${takeStr}`);
-        }
-        else {
-            console.log('   Credits: unable to retrieve (check your token with `agent-wire-terminal status`)');
-        }
-        if (jobsCompleted !== undefined) {
-            console.log(`   Jobs completed: ${jobsCompleted.toLocaleString()}`);
-        }
-        // Reputation
-        const domains = rep?.domains;
-        if (domains && domains.length > 0) {
-            const topScore = domains[0].score;
-            console.log(`   Reputation: ${topScore}`);
-            console.log('');
-            console.log('   Domains:');
-            for (const d of domains) {
-                console.log(`     ${d.domain}: ${d.score} (${d.contribution_count} contributions)`);
-            }
-        }
-        // Work stats (from node polling, if available)
-        if (result.work_stats) {
-            console.log('');
-            console.log('   Work stats:');
-            console.log(`   ${JSON.stringify(result.work_stats, null, 2).replace(/\n/g, '\n   ')}`);
-        }
-        if (!rep && !result.work_stats) {
-            console.log('   No data available. Your account may be new or the API may be unreachable.');
-            console.log('   Try: agent-wire-terminal status (verify config)');
-        }
-    }
-    catch (err) {
-        console.error('Error: Could not reach balance endpoint');
-        console.error(`   ${err.message}`);
-        console.error('   Try: Check your token with `agent-wire-terminal status`');
-        process.exit(1);
-    }
-}
-function status() {
-    const config = loadConfig();
-    console.error('Wire Node -- Status');
-    console.error(`   API URL: ${config.apiUrl}`);
-    console.error(`   Token: ${config.apiToken ? config.apiToken.slice(0, 15) + '...' : 'NOT SET'}`);
-    console.error(`   Node ID: ${config.nodeId || 'NOT REGISTERED'}`);
-    console.error(`   Name: ${config.nodeName}`);
-    console.error(`   Capabilities: ${config.capabilities.join(', ')}`);
-    console.error(`   Cache size: ${config.cacheSizeMb}MB`);
-}
-// ── Sync helpers ──────────────────────────────────────────────
-function getArgValue(flag) {
-    const idx = args.indexOf(flag);
-    if (idx !== -1 && args[idx + 1] && !args[idx + 1].startsWith('--')) {
-        return args[idx + 1];
-    }
-    return undefined;
-}
-function hasFlag(flag) {
-    return args.includes(flag);
-}
-function readMarketNativeDocsIngestFlag() {
-    const raw = getArgValue('--market-native-docs-ingest') ??
-        getArgValue('--market-native-ingest') ??
-        getArgValue('--market-ingest');
-    if (!raw)
-        return 'off';
-    if (raw === 'off' || raw === 'auto' || raw === 'all')
-        return raw;
-    console.error(`Error: --market-native-docs-ingest must be one of: off, auto, all (got "${raw}")`);
-    process.exit(1);
-}
-function isMarketNativeDocsIngestEnabled(mode) {
-    return mode !== 'off';
-}
-function loadManifestFromDisk(syncDir) {
-    const manifestPath = join(resolve(syncDir), '.wire-sync.json');
-    if (!existsSync(manifestPath)) {
-        return null;
-    }
-    try {
-        const raw = readFileSync(manifestPath, 'utf-8');
-        return parseManifest(raw);
-    }
-    catch {
-        return null;
-    }
-}
-function saveManifestToDisk(syncDir, manifest) {
-    const manifestPath = join(resolve(syncDir), '.wire-sync.json');
-    writeFileSync(manifestPath, serializeManifest(manifest), 'utf-8');
-}
-async function promptConfirm(message) {
-    const rl = createInterface({ input: process.stdin, output: process.stderr });
-    return new Promise((resolvePromise) => {
-        rl.question(`${message} [y/N] `, (answer) => {
-            rl.close();
-            resolvePromise(answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes');
-        });
-    });
-}
-function buildPreviewOutput(corpus, dir, diff) {
-    return {
-        corpus_slug: corpus,
-        local_dir: dir,
-        diff,
-        summary: {
-            push_new: diff.push_new.length,
-            push_update: diff.push_update.length,
-            pull_new: diff.pull_new.length,
-            pull_update: diff.pull_update.length,
-            in_sync: diff.in_sync.length,
-            conflicts: diff.conflicts.length,
-        },
-    };
-}
-async function syncCommand() {
-    const dir = getArgValue('--dir');
-    const corpus = getArgValue('--corpus');
-    const action = getArgValue('--action');
-    const watchMode = hasFlag('--watch');
-    const publish = hasFlag('--publish');
-    const autoYes = hasFlag('--yes');
-    const marketNativeDocsIngest = readMarketNativeDocsIngestFlag();
-    if (!dir) {
-        console.error('Error: --dir is required.');
-        console.error('   Usage: agent-wire-terminal sync --dir PATH --corpus SLUG --action diff|push|pull|preview');
-        process.exit(1);
-    }
-    if (!corpus) {
-        console.error('Error: --corpus is required.');
-        console.error('   Usage: agent-wire-terminal sync --dir PATH --corpus SLUG --action diff|push|pull|preview');
-        process.exit(1);
-    }
-    const validActions = ['diff', 'push', 'pull', 'preview'];
-    if (!action || !validActions.includes(action)) {
-        console.error(`Error: --action must be one of: ${validActions.join(', ')}`);
-        console.error('   Usage: agent-wire-terminal sync --dir PATH --corpus SLUG --action diff|push|pull|preview');
-        process.exit(1);
-    }
-    if (watchMode && action !== 'push') {
-        console.error('Error: --watch is only supported with --action push');
-        process.exit(1);
-    }
-    if (isMarketNativeDocsIngestEnabled(marketNativeDocsIngest) && action === 'pull') {
-        console.error('Error: --market-native-docs-ingest only applies to push-side sync.');
-        process.exit(1);
-    }
-    const resolvedDir = resolve(dir);
-    if (!existsSync(resolvedDir)) {
-        console.error(`Error: Directory does not exist: ${resolvedDir}`);
-        process.exit(1);
-    }
-    const config = loadConfig();
-    if (!config.apiToken) {
-        console.error('No API token. Run "agent-wire-terminal init --token YOUR_TOKEN" first.');
-        process.exit(1);
-    }
-    const api = new WireAPI(config);
-    // Run the sync action
-    async function runSync() {
-        console.error(`Wire Corpus Sync -- ${action}`);
-        console.error(`   Directory: ${resolvedDir}`);
-        console.error(`   Corpus: ${corpus}`);
-        if (isMarketNativeDocsIngestEnabled(marketNativeDocsIngest)) {
-            console.error(`   Market-native docs ingest: ${marketNativeDocsIngest}`);
-            if (publish) {
-                console.error('   Note: /wire/sync publishes source docs; --publish is already implied.');
-            }
-        }
-        console.error('');
-        // 1. Walk local directory
-        const localFiles = await walkDirectory(resolvedDir);
-        console.error(`   Found ${localFiles.size} local file(s)`);
-        // 2. Load manifest
-        const manifest = loadManifestFromDisk(resolvedDir);
-        if (manifest) {
-            console.error(`   Manifest loaded (last sync: ${manifest.last_sync})`);
-        }
-        else {
-            console.error('   No previous manifest -- first sync');
-        }
-        // 3. List remote documents
-        const remoteDocs = await api.listDocumentsAll(corpus);
-        console.error(`   Found ${remoteDocs.length} remote document(s)`);
-        console.error('');
-        // 4. Compute diff
-        const diff = await computeDiff(localFiles, remoteDocs, manifest);
-        const previewOutput = buildPreviewOutput(corpus, resolvedDir, diff);
-        // Handle conflicts -- list and skip
-        if (diff.conflicts.length > 0) {
-            const resolutions = new Map();
-            for (const c of diff.conflicts) {
-                resolutions.set(c.relativePath, 'skip');
-            }
-            const resolved = resolveConflicts(diff.conflicts, resolutions);
-            if (resolved.skipped.length > 0) {
-                console.error(`   Conflicts (${resolved.skipped.length} skipped):`);
-                for (const entry of resolved.skipped) {
-                    console.error(`     - ${entry.relativePath}`);
-                    for (const w of entry.warnings) {
-                        console.error(`       Warning: ${w}`);
-                    }
-                }
-                console.error('');
-            }
-        }
-        // 5. Execute action
-        if (action === 'preview' || action === 'diff') {
-            console.log(generatePreview(previewOutput));
-            return;
-        }
-        if (action === 'push') {
-            const pushEntries = [...diff.push_new, ...diff.push_update];
-            if (pushEntries.length === 0) {
-                console.error('   Nothing to push -- all files are in sync.');
-                return;
-            }
-            // Show preview
-            console.log(generatePreview(previewOutput));
-            // Confirm unless --yes
-            if (!autoYes) {
-                const confirmed = await promptConfirm(`\nPush ${pushEntries.length} file(s) to Wire corpus "${corpus}"?`);
-                if (!confirmed) {
-                    console.error('   Aborted.');
-                    return;
-                }
-            }
-            console.error(`\n   Pushing ${pushEntries.length} file(s)...`);
-            const results = await pushFiles(api, corpus, pushEntries, {
-                publish,
-                marketNativeDocsIngest,
-            });
-            // Report results
-            let successCount = 0;
-            let failCount = 0;
-            for (const r of results) {
-                if (r.success) {
-                    successCount++;
-                    console.error(`   OK: ${r.relativePath} -> ${r.documentId}`);
-                    for (const warning of r.warnings || []) {
-                        console.error(`      WARN: ${warning}`);
-                    }
-                    const marketResult = r.marketNativeDocsIngest;
-                    if (marketResult?.window_count && marketResult.window_count > 1) {
-                        console.error(`      Market windows: ${marketResult.dispatched_windows ?? 0}/${marketResult.window_count} dispatched`);
-                    }
-                    if (marketResult?.chain_result_handle_path) {
-                        console.error(`      Market result: ${marketResult.chain_result_handle_path}`);
-                    }
-                    else if (marketResult?.chain_invocation_id) {
-                        console.error(`      Market invocation: ${marketResult.chain_invocation_id}`);
-                    }
-                }
-                else {
-                    failCount++;
-                    console.error(`   FAIL: ${r.relativePath} -- ${r.error}`);
-                }
-            }
-            console.error(`\n   Push complete: ${successCount} succeeded, ${failCount} failed.`);
-            // PATCH source_path for in-sync documents missing it on the server
-            // This ensures round-trip fidelity: documents uploaded before source_path
-            // existed get their folder metadata populated without creating new versions.
-            let metadataPatched = 0;
-            for (const entry of diff.in_sync) {
-                const remoteSourcePath = entry.remoteDoc?.source_path;
-                const localPath = entry.relativePath;
-                if (entry.remoteDoc && localPath && (!remoteSourcePath || remoteSourcePath !== localPath)) {
-                    try {
-                        await api.updateDocumentSourcePath(entry.remoteDoc.id, localPath);
-                        metadataPatched++;
-                    }
-                    catch (err) {
-                        console.error(`   WARN: Failed to patch source_path for ${localPath}: ${err.message}`);
-                    }
-                }
-            }
-            if (metadataPatched > 0) {
-                console.error(`   Patched source_path on ${metadataPatched} in-sync document(s).`);
-            }
-            // Update manifest for successful pushes
-            if (successCount > 0) {
-                const currentManifest = manifest || {
-                    corpus_slug: corpus,
-                    corpus_id: corpus, // Will be refined on next sync
-                    last_sync: new Date().toISOString(),
-                    files: {},
-                };
-                const manifestEntries = results
-                    .filter(r => r.success)
-                    .map(r => {
-                    const entry = pushEntries.find(e => e.relativePath === r.relativePath);
-                    return {
-                        relativePath: r.relativePath,
-                        documentId: r.documentId,
-                        localHash: entry.localFile?.hash || '',
-                        remoteHash: entry.localFile?.hash || '', // After push, remote matches local
-                        remoteStatus: (publish || isMarketNativeDocsIngestEnabled(marketNativeDocsIngest) ? 'published' : 'draft'),
-                        remoteAnchored: false,
-                        remoteVersionNumber: r.version ?? (entry.remoteDoc?.version_number ? entry.remoteDoc.version_number + 1 : 1),
-                        remoteWordCount: entry.localFile?.content.split(/\s+/).length || 0,
-                    };
-                });
-                const updated = updateManifest(currentManifest, manifestEntries);
-                saveManifestToDisk(resolvedDir, updated);
-                console.error('   Manifest updated.');
-            }
-            return;
-        }
-        if (action === 'pull') {
-            const pullEntries = [...diff.pull_new, ...diff.pull_update];
-            if (pullEntries.length === 0) {
-                console.error('   Nothing to pull -- all files are in sync.');
-                return;
-            }
-            // Show preview
-            console.log(generatePreview(previewOutput));
-            // Confirm unless --yes
-            if (!autoYes) {
-                const confirmed = await promptConfirm(`\nPull ${pullEntries.length} file(s) from Wire corpus "${corpus}"?`);
-                if (!confirmed) {
-                    console.error('   Aborted.');
-                    return;
-                }
-            }
-            console.error(`\n   Pulling ${pullEntries.length} file(s)...`);
-            const results = await pullFiles(api, resolvedDir, pullEntries);
-            // Report results
-            let successCount = 0;
-            let failCount = 0;
-            for (const r of results) {
-                if (r.success) {
-                    successCount++;
-                    console.error(`   OK: ${r.relativePath}`);
-                }
-                else {
-                    failCount++;
-                    console.error(`   FAIL: ${r.relativePath} -- ${r.error}`);
-                }
-            }
-            console.error(`\n   Pull complete: ${successCount} succeeded, ${failCount} failed.`);
-            // Update manifest for successful pulls
-            if (successCount > 0) {
-                const currentManifest = manifest || {
-                    corpus_slug: corpus,
-                    corpus_id: corpus,
-                    last_sync: new Date().toISOString(),
-                    files: {},
-                };
-                // Re-walk to get hashes of pulled files
-                const updatedLocalFiles = await walkDirectory(resolvedDir);
-                const manifestEntries = results
-                    .filter(r => r.success)
-                    .map(r => {
-                    const entry = pullEntries.find(e => e.relativePath === r.relativePath);
-                    const localFile = updatedLocalFiles.get(r.relativePath);
-                    return {
-                        relativePath: r.relativePath,
-                        documentId: entry.remoteDoc?.id || '',
-                        localHash: localFile?.hash || '',
-                        remoteHash: entry.remoteDoc?.body_hash || '',
-                        remoteStatus: (entry.remoteDoc?.status || 'draft'),
-                        remoteAnchored: entry.remoteDoc?.anchored || false,
-                        remoteVersionNumber: entry.remoteDoc?.version_number || 1,
-                        remoteWordCount: entry.remoteDoc?.word_count || 0,
-                    };
-                });
-                const updated = updateManifest(currentManifest, manifestEntries);
-                saveManifestToDisk(resolvedDir, updated);
-                console.error('   Manifest updated.');
-            }
-            return;
-        }
-    }
-    // Execute the sync
-    await runSync();
-    // Watch mode: re-run on file changes with 2-second debounce
-    if (watchMode) {
-        console.error('\n   Watching for changes (2s debounce)... Press Ctrl+C to stop.\n');
-        let debounceTimer = null;
-        let syncing = false;
-        const watcher = fsWatch(resolvedDir, { recursive: true }, (_event, filename) => {
-            // Skip manifest file changes
-            if (filename && filename.toString().includes('.wire-sync.json'))
-                return;
-            if (debounceTimer)
-                clearTimeout(debounceTimer);
-            debounceTimer = setTimeout(async () => {
-                if (syncing)
-                    return;
-                syncing = true;
-                console.error(`\n   Change detected${filename ? `: ${filename}` : ''}. Syncing...`);
-                try {
-                    await runSync();
-                }
-                catch (err) {
-                    console.error(`   Sync error: ${err.message}`);
-                }
-                syncing = false;
-            }, 2000);
-        });
-        // Handle graceful shutdown
-        process.on('SIGINT', () => {
-            console.error('\n   Stopping watch...');
-            watcher.close();
-            if (debounceTimer)
-                clearTimeout(debounceTimer);
-            process.exit(0);
-        });
-        process.on('SIGTERM', () => {
-            watcher.close();
-            if (debounceTimer)
-                clearTimeout(debounceTimer);
-            process.exit(0);
-        });
-        // Keep the process alive
-        await new Promise(() => { });
-    }
-}
-async function pullCommand() {
-    const manifestPath = getArgValue('--manifest');
-    const init = hasFlag('--init');
-    const dryRun = hasFlag('--dry-run');
-    const json = hasFlag('--json');
-    if (init) {
-        const path = await writeDefaultLocalPullManifest(manifestPath);
-        if (!json)
-            console.error(`Initialized local-sync manifest: ${path}`);
-    }
-    const config = loadConfig();
-    if (!config.apiToken) {
-        console.error('No API token. Run "agent-wire-terminal init --token YOUR_TOKEN" first.');
-        process.exit(1);
-    }
-    const api = new WireAPI(config);
-    const report = await pullLocalSubscriptions(api, { manifestPath, dryRun });
-    console.log(json ? JSON.stringify(report, null, 2) : formatLocalPullReport(report));
-    if (report.failed > 0)
-        process.exit(1);
-}
 async function waitCommand() {
     const exitCode = await runWaitCommand(args.slice(1));
     process.exit(exitCode);
 }
-async function chainCommand() {
-    const subcommand = args[1];
-    const commandArgs = args.slice(2);
-    if (subcommand !== 'run' && subcommand !== 'poll') {
-        printChainUsage();
-        process.exit(1);
-    }
-    const config = loadConfig();
-    if (!config.apiToken) {
-        console.error('No API token. Run "agent-wire-terminal init --token YOUR_TOKEN" first.');
-        process.exit(1);
-    }
-    const chain = readFlag(commandArgs, '--chain');
-    if (!chain) {
-        console.error('Error: --chain is required');
-        printChainUsage();
-        process.exit(1);
-    }
-    const api = new WireAPI(config);
-    if (subcommand === 'poll') {
-        const runHandlePath = readFlag(commandArgs, '--run-handle');
-        const runId = readFlag(commandArgs, '--run-id');
-        if (!runHandlePath && !runId) {
-            console.error('Error: --run-handle or --run-id is required for chain poll');
-            printChainUsage();
-            process.exit(1);
-        }
-        const result = await api.pollChainRun({
-            run_handle_path: runHandlePath,
-            run_id: runId,
-            chain,
-            include_steps: commandArgs.includes('--include-steps'),
-        });
-        console.log(JSON.stringify(result, null, 2));
-        return;
-    }
-    const quoteId = readFlag(commandArgs, '--quote-id');
-    const quoteMode = commandArgs.includes('--quote');
-    const autoMode = commandArgs.includes('--auto');
-    if (quoteMode && autoMode) {
-        console.error('Error: --quote and --auto are mutually exclusive');
-        printChainUsage();
-        process.exit(1);
-    }
-    if (autoMode && quoteId) {
-        console.error('Error: --auto does not accept --quote-id');
-        printChainUsage();
-        process.exit(1);
-    }
-    const mode = autoMode ? 'auto' : quoteMode ? 'quote' : 'trusted';
-    if (mode === 'trusted' && !quoteId) {
-        console.error('Error: trusted chain execution requires --quote-id');
-        printChainUsage();
-        process.exit(1);
-    }
-    const maxCredits = parsePositiveIntegerFlag(commandArgs, '--max-credits');
-    if (mode === 'auto' && !maxCredits) {
-        console.error('Error: --auto requires --max-credits');
-        printChainUsage();
-        process.exit(1);
-    }
-    const entryMode = readFlag(commandArgs, '--entry-mode') ?? 'direct';
-    if (entryMode !== 'direct' && entryMode !== 'start') {
-        console.error('Error: --entry-mode must be direct or start');
-        process.exit(1);
-    }
-    const timeoutMs = parsePositiveIntegerFlag(commandArgs, '--timeout-ms');
-    const result = await api.runChain({
-        chain,
-        mode,
-        input: parseInputJson(readFlag(commandArgs, '--input-json')),
-        quote_id: quoteId,
-        max_credits: mode === 'auto' ? maxCredits : undefined,
-        chain_id: readFlag(commandArgs, '--chain-id'),
-        entry_mode: entryMode,
-        include_steps: commandArgs.includes('--include-steps'),
-        async_ack: mode === 'trusted' || mode === 'auto' ? commandArgs.includes('--async-ack') : undefined,
-        timeout_ms: mode === 'trusted' || mode === 'auto' ? timeoutMs : undefined,
-    });
-    console.log(JSON.stringify(result, null, 2));
-}
-function surfaceHolsterPath(commandArgs) {
-    return resolve(readFlag(commandArgs, '--holster') || join(CONFIG_DIR, 'surface-shortcuts.json'));
-}
-function firstSurfacePositional(commandArgs) {
-    const valueFlags = new Set(['--chain-id', '--entry-mode', '--holster', '--input-json', '--quote-id', '--timeout-ms', '--max-credits']);
-    for (let i = 0; i < commandArgs.length; i += 1) {
-        const arg = commandArgs[i];
-        if (valueFlags.has(arg)) {
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith('--')) {
-            continue;
-        }
-        return arg;
-    }
-    return undefined;
-}
-function readSurfaceHolster(path) {
-    if (!existsSync(path)) {
-        throw new Error(`Surface holster not found: ${path}. Run "agent-wire-terminal s init" to create one.`);
-    }
-    const parsed = JSON.parse(readFileSync(path, 'utf-8'));
-    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new Error('Surface holster must be a JSON object');
-    }
-    if (parsed.shortcuts != null && (typeof parsed.shortcuts !== 'object' || Array.isArray(parsed.shortcuts))) {
-        throw new Error('Surface holster shortcuts must be an object');
-    }
-    return parsed;
-}
-function validateSurfaceShortcut(name, shortcut) {
-    if (!shortcut || typeof shortcut !== 'object' || Array.isArray(shortcut)) {
-        throw new Error(`Shortcut "${name}" is not defined`);
-    }
-    if (typeof shortcut.chain !== 'string' || shortcut.chain.trim().length === 0) {
-        throw new Error(`Shortcut "${name}" must declare a non-empty chain`);
-    }
-    if (shortcut.input != null && (typeof shortcut.input !== 'object' || Array.isArray(shortcut.input))) {
-        throw new Error(`Shortcut "${name}" input must be a JSON object`);
-    }
-    if (shortcut.entry_mode != null && shortcut.entry_mode !== 'direct' && shortcut.entry_mode !== 'start') {
-        throw new Error(`Shortcut "${name}" entry_mode must be direct or start`);
-    }
-    return shortcut;
-}
-function initSurfaceHolster(path) {
-    if (existsSync(path)) {
-        console.error(`Surface holster already exists: ${path}`);
-        return;
-    }
-    const example = {
-        shortcuts: {
-            canary: {
-                chain: '/default/optimal-kit/canary',
-                entry_mode: 'direct',
-            },
-        },
-    };
-    mkdirSync(resolve(path, '..'), { recursive: true });
-    writeFileSync(path, JSON.stringify(example, null, 2), { mode: 0o600 });
-    console.error(`Initialized surface holster: ${path}`);
-    console.error('Seeded canary requires --input-json with battery_ref, test_run_id, subject_agent, and source_principal.');
-    console.error('source_principal and subject_agent must be different.');
-}
-async function surfaceCommand() {
-    const commandArgs = args.slice(1);
-    const subcommand = firstSurfacePositional(commandArgs) || 'list';
-    const holsterPath = surfaceHolsterPath(commandArgs);
-    if (subcommand === 'init') {
-        initSurfaceHolster(holsterPath);
-        return;
-    }
-    const holster = readSurfaceHolster(holsterPath);
-    const shortcuts = holster.shortcuts || {};
-    if (subcommand === 'list') {
-        const names = Object.keys(shortcuts).sort();
-        if (names.length === 0) {
-            console.log(JSON.stringify({ holster: holsterPath, shortcuts: [] }, null, 2));
-            return;
-        }
-        console.log(JSON.stringify({
-            holster: holsterPath,
-            shortcuts: names.map((name) => {
-                const shortcut = validateSurfaceShortcut(name, shortcuts[name]);
-                return { name, chain: shortcut.chain, entry_mode: shortcut.entry_mode || 'direct' };
-            }),
-        }, null, 2));
-        return;
-    }
-    const shortcut = validateSurfaceShortcut(subcommand, shortcuts[subcommand]);
-    const quoteId = readFlag(commandArgs, '--quote-id');
-    const autoMode = commandArgs.includes('--auto');
-    if (commandArgs.includes('--quote') && autoMode) {
-        console.error('Error: --quote and --auto are mutually exclusive');
-        printSurfaceUsage();
-        process.exit(1);
-    }
-    if (autoMode && quoteId) {
-        console.error('Error: --auto does not accept --quote-id');
-        printSurfaceUsage();
-        process.exit(1);
-    }
-    const quoteMode = !autoMode && (commandArgs.includes('--quote') || !quoteId);
-    const maxCredits = parsePositiveIntegerFlag(commandArgs, '--max-credits');
-    if (autoMode && !maxCredits) {
-        console.error('Error: --auto requires --max-credits');
-        printSurfaceUsage();
-        process.exit(1);
-    }
-    const entryMode = readFlag(commandArgs, '--entry-mode') ?? shortcut.entry_mode ?? 'direct';
-    if (entryMode !== 'direct' && entryMode !== 'start') {
-        console.error('Error: --entry-mode must be direct or start');
-        process.exit(1);
-    }
-    const config = loadConfig();
-    if (!config.apiToken) {
-        console.error('No API token. Run "agent-wire-terminal init --token YOUR_TOKEN" first.');
-        process.exit(1);
-    }
-    const api = new WireAPI(config);
-    const timeoutMs = parsePositiveIntegerFlag(commandArgs, '--timeout-ms');
-    const input = {
-        ...(shortcut.input || {}),
-        ...parseInputJson(readFlag(commandArgs, '--input-json')),
-    };
-    const result = await api.runChain({
-        chain: shortcut.chain,
-        mode: autoMode ? 'auto' : quoteMode ? 'quote' : 'trusted',
-        input,
-        quote_id: quoteId,
-        max_credits: autoMode ? maxCredits : undefined,
-        chain_id: readFlag(commandArgs, '--chain-id'),
-        entry_mode: entryMode,
-        include_steps: commandArgs.includes('--include-steps'),
-        async_ack: quoteMode ? undefined : commandArgs.includes('--async-ack'),
-        timeout_ms: quoteMode ? undefined : timeoutMs,
-    });
-    console.log(JSON.stringify(result, null, 2));
-}
 function printMainUsage() {
-    console.error('agent-wire-terminal - The Wire is a machine intelligence exchange.');
-    console.error('Run a node to earn credits. Connect via MCP to query and contribute intelligence.');
-    console.error('');
-    console.error('Usage: agent-wire-terminal <command>');
-    console.error('');
-    console.error('Commands:');
-    console.error('  serve [options]         Start MCP server. Defaults to stdio transport.');
-    console.error('                          --http         Use HTTP transport instead of stdio');
-    console.error('                          --port PORT    HTTP port (default: 3200)');
-    console.error('                          --no-worker    Skip background work loop');
-    console.error('                          Auto-detects standalone daemon and skips background work.');
-    console.error('  start                   Run standalone node daemon. Acquires a PID lock (one per');
-    console.error('                          machine). Polls for mechanical work and earns credits.');
-    console.error('  init [--token TOKEN]    Register this node with the Wire network. Requires an API');
-    console.error('                          token from /api/v1/register or WIRE_API_TOKEN env var.');
-    console.error('  balance                 Check your operator pool credits, reputation, and jobs.');
-    console.error('  status                  Show current config: API URL, token, node ID, capabilities.');
-    console.error('  wait [options]          Block on Wire coordination events over SSE and print JSON.');
-    console.error("                          --triggers LIST  Comma-separated triggers, e.g. 'board.*'");
-    console.error('                          --cursor CURSOR  Resume/replay from an opaque cursor');
-    console.error('                          --filter k=v     Repeatable AND filter');
-    console.error('                          --timeout-seconds SECONDS (default 600, max 86400; -1 = park indefinitely)');
-    console.error('                          --limit N        Matching events to print (default: 1)');
-    console.error('                          --name NAME      Cached identity override');
-    console.error('  chain run [options]     Quote or execute a canonical Wire chain.');
-    console.error('                          --chain HANDLE_OR_UUID --input-json JSON --quote');
-    console.error('                          --quote-id TOKEN [--async-ack|--timeout-ms MS]');
-    console.error('                          poll async runs with:');
-    console.error('                          --chain HANDLE_OR_UUID --run-handle HANDLE [--include-steps]');
-    console.error('  s [options]             Resolve local holster shortcuts to canonical chain runs.');
-    console.error('  surface [options]       Alias for s.');
-    console.error('                          agent-wire-terminal s SHORTCUT --input-json JSON --quote');
-    console.error('                          trusted sync defaults to --timeout-ms 600000 (max 1800000)');
-    console.error('  sync [options]          Sync local directory with a Wire corpus.');
-    console.error('                          --dir PATH       Local directory to sync (required)');
-    console.error('                          --corpus SLUG    Wire corpus slug (required)');
-    console.error('                          --action ACTION  diff|push|pull|preview (required)');
-    console.error('                          --watch          Watch for changes, auto-push (push only)');
-    console.error('                          --publish        Publish documents on push (default: draft)');
-    console.error('                          --market-native-docs-ingest MODE');
-    console.error('                                           off|auto|all; auto routes missing');
-    console.error('                                           rear-matter or oversized docs');
-    console.error('                                           oversized docs use 8000/2000 windows');
-    console.error('                          --yes            Skip confirmation prompts');
-    console.error('  pull [options]          Pull subscribed Wire contribution bodies into local');
-    console.error('                          cache/skill files from ~/.wire-node/sync-manifest.json.');
-    console.error('');
-    console.error('Quick start (MCP):');
-    console.error('  Stdio (Cursor, Claude Desktop):');
-    console.error('    "command": "npx", "args": ["-y", "agent-wire-terminal", "serve"]');
-    console.error('  HTTP (Antigravity, web agents):');
-    console.error('    WIRE_API_TOKEN=gne_live_... npx agent-wire-terminal serve --http');
-    console.error('    Then add: "wire": { "url": "http://localhost:3200/" }');
-    console.error('');
-    console.error('Quick start (standalone):');
-    console.error('  WIRE_API_TOKEN=gne_live_... npx agent-wire-terminal init');
-    console.error('  npx agent-wire-terminal start');
-    console.error('');
-    console.error('Quick start (sync):');
-    console.error('  agent-wire-terminal sync --dir ./my-docs --corpus my-corpus --action preview');
-    console.error('  agent-wire-terminal sync --dir ./my-docs --corpus my-corpus --action push --yes');
-    console.error('  agent-wire-terminal sync --dir ./my-docs --corpus my-corpus --action push --market-native-docs-ingest auto --yes');
-    console.error('  agent-wire-terminal sync --dir ./my-docs --corpus my-corpus --action push --watch');
-    console.error('  agent-wire-terminal pull --init');
-    console.error('  agent-wire-terminal pull');
-    console.error('');
-    console.error('Docs: https://agent-wire.com/docs');
-}
-// Route commands
-switch (command) {
-    case 'init':
-        if (commandHelpRequested) {
-            printInitUsage();
-            break;
-        }
-        init().catch(console.error);
-        break;
-    case 'start':
-        if (commandHelpRequested) {
-            printStartUsage();
-            break;
-        }
-        start().catch(console.error);
-        break;
-    case 'serve':
-        if (commandHelpRequested) {
-            printServeUsage();
-            break;
-        }
-        serve().catch(console.error);
-        break;
-    case 'balance':
-        if (commandHelpRequested) {
-            printBalanceUsage();
-            break;
-        }
-        balance().catch(console.error);
-        break;
-    case 'status':
-        if (commandHelpRequested) {
-            printStatusUsage();
-            break;
-        }
-        status();
-        break;
-    case 'sync':
-        if (commandHelpRequested) {
-            printSyncUsage();
-            break;
-        }
-        syncCommand().catch(console.error);
-        break;
-    case 'pull':
-        if (commandHelpRequested) {
-            printPullUsage();
-            break;
-        }
-        pullCommand().catch((err) => {
-            console.error(err);
-            process.exit(2);
-        });
-        break;
-    case 'wait':
-        waitCommand().catch((err) => {
-            console.error(err);
-            process.exit(2);
-        });
-        break;
-    case 'chain':
-        if (commandHelpRequested) {
-            printChainUsage();
-            break;
-        }
-        chainCommand().catch((err) => {
-            console.error(err);
-            process.exit(2);
-        });
-        break;
-    case 's':
-    case 'surface':
-        if (commandHelpRequested) {
-            printSurfaceUsage();
-            break;
-        }
-        surfaceCommand().catch((err) => {
-            console.error(err);
-            process.exit(2);
-        });
-        break;
-    case '--help':
-    case '-h':
-    case 'help':
-    default:
-        printMainUsage();
-        break;
+    console.log(`Usage: npx -y @agent-wire/terminal <tool> [--arg value]
+
+Commands:
+  init                   Resume an existing agent (--token TOKEN)
+  start                  Start the local worker daemon
+  serve                  Start the local MCP server (--http --port PORT --no-worker)
+  wait                   Wait for Wire activity (--help for options)
+  tools                  List current graph tools (--json for full definitions)
+
+Hub commands are projected from live tool_definition contributions.
+Run npx -y @agent-wire/terminal tools, then npx -y @agent-wire/terminal <tool> --help.
+Use WIRE_API_URL to select the hub. Terminal 1.7.9+: WIRE_API_TOKEN_FILE=/absolute/path/to/token selects the agent.
+WIRE_API_TOKEN is the alternative on every terminal version.
+Token precedence: WIRE_API_TOKEN > WIRE_API_TOKEN_FILE > saved config.
+The token file is UTF-8, trimmed and read once per process; restart after rotation.
+Example: npx -y @agent-wire/terminal wire_help --topic first-hour`);
+}
+async function main() {
+    switch (command) {
+        case 'init': return commandHelpRequested ? printInitUsage() : init();
+        case 'start': return commandHelpRequested ? printStartUsage() : start();
+        case 'serve': return commandHelpRequested ? printServeUsage() : serve();
+        case 'wait': return waitCommand();
+        case 'help':
+        case '--help':
+        case '-h':
+        case undefined: return printMainUsage();
+        case 'tools':
+            if (commandHelpRequested) {
+                console.log('Usage: npx -y @agent-wire/terminal tools [--json]\nList live tool_definition contributions.');
+                return;
+            }
+    }
+    await runProjectedCommand(command, args.slice(1));
 }
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 2;
+});
 //# sourceMappingURL=cli.js.map