@webannotates/runner 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { LocalCodeAgentRunner, RunnerApiClient, defaultRunnerName, detectCapabilities, diagnose, loadConfig, loadLocalJobs, saveConfig, updateConfig, validateRepository } from '@webannotates/code-agent-runner-core';
+function usage() {
+    console.log(`WebAnnotate local coding-agent runner
+
+Commands:
+  connect <code> <owner/repository> <local-path> [--url URL] [--provider codex|claude]
+  pair <code> [--url URL] [--name NAME]
+  map <owner/repository> <local-path>
+  unmap <owner/repository>
+  doctor
+  jobs
+  rotate-token
+  start
+  config`);
+}
+function flag(name) { const index = process.argv.indexOf(name); return index >= 0 ? process.argv[index + 1] : undefined; }
+async function main() {
+    const command = process.argv[2];
+    if (!command || ['help', '--help', '-h'].includes(command))
+        return usage();
+    if (command === 'connect') {
+        const code = process.argv[3], repository = process.argv[4], localPath = process.argv[5];
+        if (!code || !repository || !localPath)
+            throw new Error('Usage: connect <code> <owner/repository> <local-path> [--url URL] [--provider codex|claude]');
+        const current = await loadConfig();
+        const baseUrl = flag('--url') || current.baseUrl;
+        const name = flag('--name') || defaultRunnerName();
+        const provider = flag('--provider') || 'codex';
+        if (!['codex', 'claude'].includes(provider))
+            throw new Error('Provider must be codex or claude.');
+        const resolved = path.resolve(localPath);
+        await validateRepository(resolved, repository);
+        const preflightConfig = { ...current, baseUrl, repositories: { ...current.repositories, [repository]: resolved } };
+        const capabilities = await detectCapabilities(preflightConfig);
+        if (provider === 'codex' && !capabilities.codex) {
+            throw new Error(capabilities.codexInstalled ? 'Codex is installed but not authenticated. Run: codex login --device-auth' : 'Codex CLI was not found. Install it, then run this command again.');
+        }
+        if (provider === 'claude' && !capabilities.claude) {
+            throw new Error(capabilities.claudeInstalled ? 'Claude Code is installed but not authenticated. Run: claude auth login' : 'Claude Code CLI was not found. Install it, then run this command again.');
+        }
+        const result = await new RunnerApiClient({ ...preflightConfig, token: undefined }).pair(code, name);
+        const config = {
+            ...preflightConfig,
+            token: result.token,
+            runnerId: result.runner.id,
+            runnerName: result.runner.name,
+        };
+        await saveConfig(config);
+        await new RunnerApiClient(config).heartbeat(capabilities);
+        console.log(`Connected ${result.runner.name} to ${repository}. Processing jobs now; keep this terminal running.`);
+        const runner = new LocalCodeAgentRunner(config, (event, detail) => {
+            const output = [new Date().toISOString(), event, detail || ''];
+            if (event === 'error')
+                console.error(...output);
+            else
+                console.log(...output);
+        });
+        process.on('SIGINT', () => runner.stop());
+        process.on('SIGTERM', () => runner.stop());
+        await runner.run();
+        return;
+    }
+    if (command === 'pair') {
+        const code = process.argv[3];
+        if (!code)
+            throw new Error('Pairing code is required.');
+        const current = await loadConfig();
+        const baseUrl = flag('--url') || current.baseUrl;
+        const name = flag('--name') || defaultRunnerName();
+        const result = await new RunnerApiClient({ ...current, baseUrl, token: undefined }).pair(code, name);
+        const config = { ...current, baseUrl, token: result.token, runnerId: result.runner.id, runnerName: result.runner.name };
+        await saveConfig(config);
+        await new RunnerApiClient(config).heartbeat(await detectCapabilities(config));
+        console.log(`Paired runner ${result.runner.name}.`);
+        return;
+    }
+    if (command === 'map') {
+        const repository = process.argv[3], localPath = process.argv[4];
+        if (!repository || !localPath)
+            throw new Error('Usage: map <owner/repository> <local-path>');
+        const resolved = path.resolve(localPath);
+        if (!(await fs.stat(resolved)).isDirectory())
+            throw new Error('Local repository path must be a directory.');
+        await validateRepository(resolved, repository);
+        const config = await loadConfig();
+        const next = await updateConfig({ repositories: { ...config.repositories, [repository]: resolved } });
+        if (next.token)
+            await new RunnerApiClient(next).heartbeat(await detectCapabilities(next));
+        console.log(`Mapped ${repository} to ${resolved}.`);
+        return;
+    }
+    if (command === 'unmap') {
+        const repository = process.argv[3];
+        if (!repository)
+            throw new Error('Repository name is required.');
+        const config = await loadConfig(), repositories = { ...config.repositories };
+        delete repositories[repository];
+        await updateConfig({ repositories });
+        console.log(`Removed mapping for ${repository}.`);
+        return;
+    }
+    if (command === 'doctor') {
+        console.log(JSON.stringify(await diagnose(await loadConfig()), null, 2));
+        return;
+    }
+    if (command === 'jobs') {
+        console.log(JSON.stringify(await loadLocalJobs(), null, 2));
+        return;
+    }
+    if (command === 'rotate-token') {
+        const config = await loadConfig();
+        if (!config.token)
+            throw new Error('Runner is not paired.');
+        const result = await new RunnerApiClient(config).rotateToken();
+        await saveConfig({ ...config, token: result.token });
+        console.log('Runner token rotated.');
+        return;
+    }
+    if (command === 'config') {
+        const config = await loadConfig();
+        console.log(JSON.stringify({ ...config, token: config.token ? '[stored locally]' : undefined }, null, 2));
+        return;
+    }
+    if (command === 'start') {
+        const runner = new LocalCodeAgentRunner(await loadConfig(), (event, detail) => {
+            const output = [new Date().toISOString(), event, detail || ''];
+            if (event === 'error')
+                console.error(...output);
+            else
+                console.log(...output);
+        });
+        process.on('SIGINT', () => runner.stop());
+        process.on('SIGTERM', () => runner.stop());
+        await runner.run();
+        return;
+    }
+    usage();
+    process.exitCode = 1;
+}
+main().catch(error => { console.error(error?.message || error); process.exitCode = 1; });

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@webannotates/runner",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "webannotate-runner": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "start": "node dist/cli.js",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@webannotates/code-agent-runner-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "@workspace/eslint-config": "*",
+    "@workspace/typescript-config": "*",
+    "typescript": "5.9.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}