jobarbiter 0.3.2 → 0.3.4

package/dist/lib/providers.js

@@ -0,0 +1,157 @@
+/**
+ * Provider Key Management Module
+ *
+ * Securely manages API keys for AI providers (Anthropic, OpenAI, etc.)
+ * Keys are stored locally ONLY and never sent to JobArbiter's servers.
+ * Only aggregate usage stats are submitted for proficiency scoring.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+// ── Paths ──────────────────────────────────────────────────────────────
+const CONFIG_DIR = join(homedir(), ".config", "jobarbiter");
+const PROVIDERS_FILE = join(CONFIG_DIR, "providers.json");
+export function getProvidersPath() {
+    return PROVIDERS_FILE;
+}
+// ── Load / Save ────────────────────────────────────────────────────────
+export function loadProviderKeys() {
+    if (!existsSync(PROVIDERS_FILE)) {
+        return [];
+    }
+    try {
+        const raw = readFileSync(PROVIDERS_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        return data.providers || [];
+    }
+    catch {
+        return [];
+    }
+}
+export function saveProviderKey(provider, apiKey) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    const existing = loadProviderKeys();
+    // Remove any existing entry for this provider
+    const filtered = existing.filter((p) => p.provider !== provider);
+    // Add new entry
+    filtered.push({
+        provider,
+        apiKey,
+        connectedAt: new Date().toISOString(),
+    });
+    const data = {
+        version: 1,
+        providers: filtered,
+    };
+    writeFileSync(PROVIDERS_FILE, JSON.stringify(data, null, 2) + "\n", { mode: 0o600 });
+}
+export function removeProviderKey(provider) {
+    const existing = loadProviderKeys();
+    const filtered = existing.filter((p) => p.provider !== provider);
+    if (filtered.length === existing.length) {
+        return false; // Provider not found
+    }
+    const data = {
+        version: 1,
+        providers: filtered,
+    };
+    writeFileSync(PROVIDERS_FILE, JSON.stringify(data, null, 2) + "\n", { mode: 0o600 });
+    return true;
+}
+export function getProviderKey(provider) {
+    const providers = loadProviderKeys();
+    return providers.find((p) => p.provider === provider) || null;
+}
+// ── Validation ─────────────────────────────────────────────────────────
+/**
+ * Validate an Anthropic API key by making a test API call.
+ * Returns validation result with usage summary if available.
+ */
+export async function validateAnthropicKey(apiKey) {
+    try {
+        const response = await fetch("https://api.anthropic.com/v1/models", {
+            method: "GET",
+            headers: {
+                "x-api-key": apiKey,
+                "anthropic-version": "2023-06-01",
+            },
+        });
+        if (response.status === 401) {
+            return { valid: false, error: "Invalid API key" };
+        }
+        if (response.status === 403) {
+            return { valid: false, error: "API key doesn't have required permissions" };
+        }
+        if (!response.ok) {
+            return { valid: false, error: `API error: ${response.status}` };
+        }
+        // Key is valid - we can't get usage from this endpoint, 
+        // but we can confirm the key works
+        return {
+            valid: true,
+            summary: "API key validated",
+        };
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return { valid: false, error: `Connection error: ${err.message}` };
+        }
+        return { valid: false, error: "Unknown error" };
+    }
+}
+/**
+ * Validate an OpenAI API key by making a test API call.
+ * Returns validation result with usage summary if available.
+ */
+export async function validateOpenAIKey(apiKey) {
+    try {
+        const response = await fetch("https://api.openai.com/v1/models", {
+            method: "GET",
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+            },
+        });
+        if (response.status === 401) {
+            return { valid: false, error: "Invalid API key" };
+        }
+        if (response.status === 403) {
+            return { valid: false, error: "API key doesn't have required permissions" };
+        }
+        if (!response.ok) {
+            return { valid: false, error: `API error: ${response.status}` };
+        }
+        // Key is valid
+        return {
+            valid: true,
+            summary: "API key validated",
+        };
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return { valid: false, error: `Connection error: ${err.message}` };
+        }
+        return { valid: false, error: "Unknown error" };
+    }
+}
+/**
+ * Get list of supported providers.
+ */
+export function getSupportedProviders() {
+    return [
+        { id: "anthropic", name: "Anthropic" },
+        { id: "openai", name: "OpenAI" },
+    ];
+}
+/**
+ * Validate a key for any supported provider.
+ */
+export async function validateProviderKey(provider, apiKey) {
+    switch (provider) {
+        case "anthropic":
+            return validateAnthropicKey(apiKey);
+        case "openai":
+            return validateOpenAIKey(apiKey);
+        default:
+            return { valid: false, error: `Unknown provider: ${provider}` };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jobarbiter",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "CLI for JobArbiter — the first AI Proficiency Marketplace",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -781,10 +781,10 @@ program
 	});
 
 // ============================================================
-// observe (manage coding agent observers)
+// observe (manage AI agent observers)
 // ============================================================
 
-const observe = program.command("observe").description("Manage coding agent proficiency observers");
+const observe = program.command("observe").description("Manage AI tool proficiency observers");
 
 observe
 	.command("status")
@@ -796,7 +796,7 @@ observe
 
 			const detected = agents.filter((a) => a.installed);
 
-			console.log("\n🔍 Coding Agent Observers\n");
+			console.log("\n🔍 AI Agent Observers\n");
 			console.log("  Agents:");
 			for (const agent of agents) {
 				if (!agent.installed) {
@@ -839,7 +839,7 @@ observe
 
 observe
 	.command("install")
-	.description("Install observers for detected coding agents")
+	.description("Install observers for detected AI agents")
 	.option("--agent <id>", "Install for specific agent (claude-code, cursor, opencode, codex, gemini)")
 	.option("--all", "Install for all detected agents")
 	.action(async (opts) => {
@@ -848,7 +848,7 @@ observe
 			const detected = agents.filter((a) => a.installed);
 
 			if (detected.length === 0) {
-				error("No coding agents detected on this system.");
+				error("No AI agents detected on this system.");
 				console.log("  Supported: Claude Code, Cursor, OpenCode, Codex CLI, Gemini CLI");
 				process.exit(1);
 			}
@@ -890,7 +890,7 @@ observe
 
 observe
 	.command("remove")
-	.description("Remove observers from coding agents")
+	.description("Remove observers from AI agents")
 	.option("--agent <id>", "Remove from specific agent")
 	.option("--all", "Remove from all agents")
 	.action(async (opts) => {
@@ -935,7 +935,7 @@ observe
 
 			if (!status.hasData) {
 				console.log("\nNo observation data collected yet.");
-				console.log("Use your coding agents normally — data accumulates automatically.\n");
+				console.log("Use your AI agents normally — data accumulates automatically.\n");
 				process.exit(0);
 			}
 

package/src/lib/config.ts

@@ -6,6 +6,8 @@ export interface Config {
 	apiKey: string;
 	baseUrl: string;
 	userType: "worker" | "employer" | "seeker" | "poster";
+	onboardingComplete?: boolean;
+	onboardingStep?: number; // last completed step (1-7)
 }
 
 const CONFIG_DIR = join(homedir(), ".config", "jobarbiter");

package/src/lib/detect-tools.ts

@@ -15,7 +15,7 @@ import { execSync } from "node:child_process";
 
 // ── Types ──────────────────────────────────────────────────────────────
 
-export type ToolCategory = "coding-agent" | "chat" | "orchestration" | "api-provider";
+export type ToolCategory = "ai-agent" | "chat" | "orchestration" | "api-provider";
 
 export interface DetectedTool {
 	id: string;
@@ -46,11 +46,11 @@ interface ToolDefinition {
 // ── Tool Definitions ───────────────────────────────────────────────────
 
 const TOOL_DEFINITIONS: ToolDefinition[] = [
-	// AI Coding Agents
+	// AI AI Agents
 	{
 		id: "claude-code",
 		name: "Claude Code",
-		category: "coding-agent",
+		category: "ai-agent",
 		binary: "claude",
 		configDir: join(homedir(), ".claude"),
 		observerAvailable: true,
@@ -58,7 +58,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "cursor",
 		name: "Cursor",
-		category: "coding-agent",
+		category: "ai-agent",
 		binary: "cursor",
 		configDir: join(homedir(), ".cursor"),
 		macApp: "/Applications/Cursor.app",
@@ -67,7 +67,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "github-copilot",
 		name: "GitHub Copilot",
-		category: "coding-agent",
+		category: "ai-agent",
 		configDir: join(homedir(), ".config", "github-copilot"),
 		vscodeExtension: "github.copilot",
 		cursorExtension: "github.copilot",
@@ -76,7 +76,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "codex",
 		name: "Codex CLI",
-		category: "coding-agent",
+		category: "ai-agent",
 		binary: "codex",
 		configDir: join(homedir(), ".codex"),
 		observerAvailable: true,
@@ -84,7 +84,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "opencode",
 		name: "OpenCode",
-		category: "coding-agent",
+		category: "ai-agent",
 		binary: "opencode",
 		configDir: join(homedir(), ".config", "opencode"),
 		observerAvailable: true,
@@ -92,7 +92,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "aider",
 		name: "Aider",
-		category: "coding-agent",
+		category: "ai-agent",
 		binary: "aider",
 		configDir: join(homedir(), ".aider"),
 		pipPackage: "aider-chat",
@@ -101,7 +101,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "continue",
 		name: "Continue",
-		category: "coding-agent",
+		category: "ai-agent",
 		vscodeExtension: "continue.continue",
 		cursorExtension: "continue.continue",
 		observerAvailable: false,
@@ -109,7 +109,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "cline",
 		name: "Cline",
-		category: "coding-agent",
+		category: "ai-agent",
 		vscodeExtension: "saoudrizwan.claude-dev",
 		cursorExtension: "saoudrizwan.claude-dev",
 		observerAvailable: false,
@@ -117,7 +117,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "windsurf",
 		name: "Windsurf",
-		category: "coding-agent",
+		category: "ai-agent",
 		binary: "windsurf",
 		macApp: "/Applications/Windsurf.app",
 		observerAvailable: false,
@@ -125,7 +125,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "letta",
 		name: "Letta Code",
-		category: "coding-agent",
+		category: "ai-agent",
 		binary: "letta",
 		configDir: join(homedir(), ".letta"),
 		pipPackage: "letta",
@@ -134,7 +134,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 	{
 		id: "gemini",
 		name: "Gemini CLI",
-		category: "coding-agent",
+		category: "ai-agent",
 		binary: "gemini",
 		configDir: join(homedir(), ".gemini"),
 		observerAvailable: true,

package/src/lib/observe.ts

@@ -1,5 +1,5 @@
 /**
- * JobArbiter Observer — Hook installer for coding agent CLIs
+ * JobArbiter Observer — Hook installer for AI agent CLIs
  *
  * Installs observation hooks that extract proficiency signals from
  * session transcripts. Uses detect-tools.ts for agent detection.
@@ -98,7 +98,7 @@ function ensureObserverDirs(): void {
 // ── Core Observer Script ───────────────────────────────────────────────
 
 /**
- * The universal observer script. Runs as a hook in any coding agent.
+ * The universal observer script. Runs as a hook in any AI agent.
  * Reads session transcript data from stdin (JSON), extracts proficiency
  * signals, and appends them to the local observations file.
  *
@@ -109,7 +109,7 @@ function getObserverScript(): string {
 	return `#!/usr/bin/env node
 /**
  * JobArbiter Observer Hook
- * Extracts proficiency signals from coding agent sessions.
+ * Extracts proficiency signals from AI agent sessions.
  * 
  * Reads JSON from stdin, writes observations to:
  *   ~/.config/jobarbiter/observer/observations.json
@@ -139,7 +139,7 @@ process.stdin.on("end", () => {
     const observation = extractSignals(data);
     if (observation) appendObservation(observation);
   } catch (err) {
-    // Silent failure — never block the coding agent
+    // Silent failure — never block the AI agent
     fs.appendFileSync(
       path.join(os.homedir(), ".config", "jobarbiter", "observer", "errors.log"),
       \`[\${new Date().toISOString()}] \${err.message}\\n\`