the-campfire 0.1.0

package/server/session-types.ts

@@ -0,0 +1,415 @@
+// Types for the WebSocket bridge between Claude Code CLI and the browser
+
+// ─── CLI Message Types (NDJSON from Claude Code CLI) ──────────────────────────
+
+export interface CLISystemInitMessage {
+  type: "system";
+  subtype: "init";
+  cwd: string;
+  session_id: string;
+  tools: string[];
+  mcp_servers: { name: string; status: string }[];
+  model: string;
+  permissionMode: string;
+  apiKeySource: string;
+  claude_code_version: string;
+  slash_commands: string[];
+  agents?: string[];
+  skills?: string[];
+  output_style: string;
+  uuid: string;
+}
+
+export interface CLISystemStatusMessage {
+  type: "system";
+  subtype: "status";
+  status: "compacting" | null;
+  permissionMode?: string;
+  uuid: string;
+  session_id: string;
+}
+
+export interface CLIAssistantMessage {
+  type: "assistant";
+  message: {
+    id: string;
+    type: "message";
+    role: "assistant";
+    model: string;
+    content: ContentBlock[];
+    stop_reason: string | null;
+    usage: {
+      input_tokens: number;
+      output_tokens: number;
+      cache_creation_input_tokens: number;
+      cache_read_input_tokens: number;
+    };
+  };
+  parent_tool_use_id: string | null;
+  error?: string;
+  uuid: string;
+  session_id: string;
+}
+
+export interface CLIResultMessage {
+  type: "result";
+  subtype: "success" | "error_during_execution" | "error_max_turns" | "error_max_budget_usd" | "error_max_structured_output_retries";
+  is_error: boolean;
+  result?: string;
+  errors?: string[];
+  duration_ms: number;
+  duration_api_ms: number;
+  num_turns: number;
+  total_cost_usd: number;
+  stop_reason: string | null;
+  usage: {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens: number;
+    cache_read_input_tokens: number;
+  };
+  modelUsage?: Record<string, {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    contextWindow: number;
+    maxOutputTokens: number;
+    costUSD: number;
+  }>;
+  total_lines_added?: number;
+  total_lines_removed?: number;
+  uuid: string;
+  session_id: string;
+}
+
+export interface CLIStreamEventMessage {
+  type: "stream_event";
+  event: unknown;
+  parent_tool_use_id: string | null;
+  uuid: string;
+  session_id: string;
+}
+
+export interface CLIToolProgressMessage {
+  type: "tool_progress";
+  tool_use_id: string;
+  tool_name: string;
+  parent_tool_use_id: string | null;
+  elapsed_time_seconds: number;
+  uuid: string;
+  session_id: string;
+}
+
+export interface CLIToolUseSummaryMessage {
+  type: "tool_use_summary";
+  summary: string;
+  preceding_tool_use_ids: string[];
+  uuid: string;
+  session_id: string;
+}
+
+export interface CLIControlRequestMessage {
+  type: "control_request";
+  request_id: string;
+  request: {
+    subtype: "can_use_tool";
+    tool_name: string;
+    input: Record<string, unknown>;
+    permission_suggestions?: PermissionUpdate[];
+    description?: string;
+    tool_use_id: string;
+    agent_id?: string;
+  };
+}
+
+export interface CLIKeepAliveMessage {
+  type: "keep_alive";
+}
+
+export interface CLIAuthStatusMessage {
+  type: "auth_status";
+  isAuthenticating: boolean;
+  output: string[];
+  error?: string;
+  uuid: string;
+  session_id: string;
+}
+
+export interface CLIControlResponseMessage {
+  type: "control_response";
+  response: {
+    subtype: "success" | "error";
+    request_id: string;
+    response?: Record<string, unknown>;
+    error?: string;
+  };
+}
+
+export type CLIMessage =
+  | CLISystemInitMessage
+  | CLISystemStatusMessage
+  | CLIAssistantMessage
+  | CLIResultMessage
+  | CLIStreamEventMessage
+  | CLIToolProgressMessage
+  | CLIToolUseSummaryMessage
+  | CLIControlRequestMessage
+  | CLIControlResponseMessage
+  | CLIKeepAliveMessage
+  | CLIAuthStatusMessage;
+
+// ─── Content Block Types ──────────────────────────────────────────────────────
+
+export type ContentBlock =
+  | { type: "text"; text: string }
+  | { type: "tool_use"; id: string; name: string; input: Record<string, unknown> }
+  | { type: "tool_result"; tool_use_id: string; content: string | ContentBlock[]; is_error?: boolean }
+  | { type: "thinking"; thinking: string; budget_tokens?: number };
+
+// ─── Browser Message Types (browser <-> bridge) ──────────────────────────────
+
+/** Messages the browser sends to the bridge */
+export type BrowserOutgoingMessage =
+  | { type: "user_message"; content: string; session_id?: string; images?: { media_type: string; data: string }[]; client_msg_id?: string }
+  | { type: "permission_response"; request_id: string; behavior: "allow" | "deny"; updated_input?: Record<string, unknown>; updated_permissions?: PermissionUpdate[]; message?: string; client_msg_id?: string }
+  | { type: "session_subscribe"; last_seq: number }
+  | { type: "session_ack"; last_seq: number }
+  | { type: "interrupt"; client_msg_id?: string }
+  | { type: "set_model"; model: string; client_msg_id?: string }
+  | { type: "set_permission_mode"; mode: string; client_msg_id?: string }
+  | { type: "mcp_get_status"; client_msg_id?: string }
+  | { type: "mcp_toggle"; serverName: string; enabled: boolean; client_msg_id?: string }
+  | { type: "mcp_reconnect"; serverName: string; client_msg_id?: string }
+  | { type: "mcp_set_servers"; servers: Record<string, McpServerConfig>; client_msg_id?: string }
+  // ── Collective Intelligence: Browser → Server ───────────────────────────────
+  | { type: "memory_query"; query: string; limit?: number }
+  | { type: "memory_store"; content: string; memoryType: string; tags: string[]; gitContext?: Record<string, unknown> }
+  | { type: "deliberation_respond"; proposalId: string; stance: string; reasoning: string; suggestedAlternative?: string; concerns?: string[] }
+  | { type: "deliberation_resolve"; proposalId: string }
+  | { type: "capability_probe_response"; probeId: string; confidence: number; reasoning: string }
+  | { type: "route_task"; taskDescription: string; availableSessions?: string[] }
+  | { type: "inject_thought"; content: string; thoughtType: string; parentId?: string };
+
+/** Messages the bridge sends to the browser */
+export type BrowserIncomingMessageBase =
+  | { type: "session_init"; session: SessionState }
+  | { type: "session_update"; session: Partial<SessionState> }
+  | { type: "assistant"; message: CLIAssistantMessage["message"]; parent_tool_use_id: string | null; timestamp?: number }
+  | { type: "stream_event"; event: unknown; parent_tool_use_id: string | null }
+  | { type: "result"; data: CLIResultMessage }
+  | { type: "permission_request"; request: PermissionRequest }
+  | { type: "permission_cancelled"; request_id: string }
+  | { type: "tool_progress"; tool_use_id: string; tool_name: string; elapsed_time_seconds: number }
+  | { type: "tool_use_summary"; summary: string; tool_use_ids: string[] }
+  | { type: "status_change"; status: "compacting" | "idle" | "running" | null }
+  | { type: "auth_status"; isAuthenticating: boolean; output: string[]; error?: string }
+  | { type: "error"; message: string }
+  | { type: "cli_disconnected" }
+  | { type: "cli_connected" }
+  | { type: "cli_launching" }
+  | { type: "user_message"; content: string; timestamp: number; id?: string }
+  | { type: "message_history"; messages: BrowserIncomingMessage[] }
+  | { type: "event_replay"; events: BufferedBrowserEvent[] }
+  | { type: "session_name_update"; name: string }
+  | { type: "pr_status_update"; pr: import("./github-pr.js").GitHubPRInfo | null; available: boolean }
+  | { type: "mcp_status"; servers: McpServerDetail[] }
+  | { type: "presence_update"; viewers: PresenceViewer[] }
+  | { type: "role_assigned"; role: SessionRole; viewerId: string }
+  | { type: "vote_update"; request_id: string; votes: PermissionVote[]; voters_total: number; deadline: number }
+  | { type: "vote_resolved"; request_id: string; result: "allow" | "deny"; policy: VotingPolicy }
+  // ── Collective Intelligence: Server → Browser ───────────────────────────────
+  // Layer 1: Semantic Memory
+  | { type: "memory_stored"; fragment: import("./semantic-memory.js").MemoryFragment }
+  | { type: "memory_query_result"; query: string; results: import("./semantic-memory.js").MemoryFragment[] }
+  | { type: "memory_consolidated"; tag: string; knowledge: import("./semantic-memory.js").ConsolidatedKnowledge }
+  // Layer 2: Deliberation
+  | { type: "deliberation_proposal"; proposal: import("./deliberation-engine.js").DeliberationProposal }
+  | { type: "deliberation_response"; response: import("./deliberation-engine.js").DeliberationResponse }
+  | { type: "deliberation_resolved"; resolution: import("./deliberation-engine.js").DeliberationResolution }
+  // Layer 3: Capabilities & Routing
+  | { type: "capability_probe"; probeId: string; taskDescription: string; instruction: string }
+  | { type: "route_result"; result: import("./capability-discovery.js").RouteTaskResult }
+  | { type: "agent_capabilities"; capabilities: import("./capability-discovery.js").AgentCapabilities }
+  | { type: "sub_agent_update"; agent: SubAgentUpdate }
+  // Layer 4: Shared Context
+  | { type: "shared_thought"; fragment: import("./shared-context.js").ContextFragment }
+  | { type: "semantic_link_added"; sourceId: string; targetId: string; relation: string }
+  | { type: "consensus_update"; state: import("./shared-context.js").ConsensusState };
+
+export type BrowserIncomingMessage = BrowserIncomingMessageBase & { seq?: number };
+
+export type ReplayableBrowserIncomingMessage = Exclude<BrowserIncomingMessageBase, { type: "event_replay" }>;
+
+export interface BufferedBrowserEvent {
+  seq: number;
+  message: ReplayableBrowserIncomingMessage;
+}
+
+// ─── Session State ────────────────────────────────────────────────────────────
+
+export type BackendType = "claude" | "codex" | "goose" | "aider" | "openhands" | "openclaw" | "opencode";
+
+export interface SessionState {
+  session_id: string;
+  backend_type?: BackendType;
+  parent_session_id?: string;
+  orchestration_role?: "lead" | "subagent" | "race_entry";
+  model: string;
+  cwd: string;
+  tools: string[];
+  permissionMode: string;
+  claude_code_version: string;
+  mcp_servers: { name: string; status: string }[];
+  agents: string[];
+  slash_commands: string[];
+  skills: string[];
+  total_cost_usd: number;
+  num_turns: number;
+  context_used_percent: number;
+  is_compacting: boolean;
+  git_branch: string;
+  is_worktree: boolean;
+  repo_root: string;
+  /** HEAD commit SHA when the session was created — used as diff base. */
+  git_start_commit?: string;
+  git_ahead: number;
+  git_behind: number;
+  total_lines_added: number;
+  total_lines_removed: number;
+  /** Cumulative API duration across all turns (from result.duration_api_ms). */
+  total_duration_api_ms: number;
+  /** Cost accumulated by child sessions spawned from this session. */
+  sub_agent_cost_usd?: number;
+  /** Environment detections and MCP recommendations computed for this session cwd. */
+  detected_environment?: DetectedEnvironment;
+  // Codex-specific token details (forwarded from thread/tokenUsage/updated)
+  codex_token_details?: {
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    reasoningOutputTokens: number;
+    modelContextWindow: number;
+  };
+  // Claude-specific token details (extracted from result.modelUsage at turn end)
+  claude_token_details?: {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    contextWindow: number;
+    costUsd: number;
+  };
+  // Codex-specific rate limits (forwarded from account/rateLimits/updated)
+  codex_rate_limits?: {
+    primary: { usedPercent: number; windowDurationMins: number; resetsAt: number } | null;
+    secondary: { usedPercent: number; windowDurationMins: number; resetsAt: number } | null;
+  };
+  /** If this session was spawned by a cron job */
+  cronJobId?: string;
+  /** Human-readable name of the cron job that spawned this session */
+  cronJobName?: string;
+}
+
+export interface DetectedEnvironmentRule {
+  id: string;
+  name: string;
+  description: string;
+  envRequired?: string[];
+  envPresent?: string[];
+  envMissing?: string[];
+}
+
+export interface DetectedEnvironment {
+  cwd: string;
+  scannedAt: number;
+  rules: DetectedEnvironmentRule[];
+  mcpServers: Record<string, McpServerConfig>;
+}
+
+export interface SubAgentUpdate {
+  parentSessionId: string;
+  toolUseId: string;
+  sessionId?: string;
+  backendType: BackendType;
+  name: string;
+  description: string;
+  status: "running" | "completed" | "failed" | "timeout";
+  startedAt: number;
+  completedAt?: number;
+  costUsd?: number;
+  durationMs?: number;
+  filesChanged?: string[];
+  summary?: string;
+  error?: string;
+}
+
+// ─── MCP Types ───────────────────────────────────────────────────────────────
+
+export interface McpServerConfig {
+  type: "stdio" | "sse" | "http" | "sdk";
+  command?: string;
+  args?: string[];
+  env?: Record<string, string>;
+  url?: string;
+}
+
+export interface McpServerDetail {
+  name: string;
+  status: "connected" | "failed" | "disabled" | "connecting";
+  serverInfo?: unknown;
+  error?: string;
+  config: { type: string; url?: string; command?: string; args?: string[] };
+  scope: string;
+  tools?: { name: string; annotations?: { readOnly?: boolean; destructive?: boolean; openWorld?: boolean } }[];
+}
+
+// ─── Session Roles (RBAC) ────────────────────────────────────────────────
+
+/** Roles for shared session access control */
+export type SessionRole = "owner" | "collaborator" | "spectator";
+
+/** Viewer info for presence tracking */
+export interface PresenceViewer {
+  id: string;
+  name: string;
+  role: SessionRole;
+}
+
+// ─── Voting Types ────────────────────────────────────────────────────────
+
+/** Policy for how votes from collaborators are aggregated */
+export type VotingPolicy = "majority-rules" | "any-deny-blocks" | "owner-decides";
+
+/** Individual vote cast by a collaborator */
+export interface PermissionVote {
+  viewerId: string;
+  viewerName: string;
+  vote: "allow" | "deny";
+  timestamp: number;
+}
+
+// ─── Permission Request ──────────────────────────────────────────────────────
+
+// ─── Permission Rule Types ───────────────────────────────────────────────────
+
+export type PermissionDestination = "userSettings" | "projectSettings" | "localSettings" | "session" | "cliArg";
+
+export type PermissionUpdate =
+  | { type: "addRules"; rules: { toolName: string; ruleContent?: string }[]; behavior: "allow" | "deny" | "ask"; destination: PermissionDestination }
+  | { type: "replaceRules"; rules: { toolName: string; ruleContent?: string }[]; behavior: "allow" | "deny" | "ask"; destination: PermissionDestination }
+  | { type: "removeRules"; rules: { toolName: string; ruleContent?: string }[]; behavior: "allow" | "deny" | "ask"; destination: PermissionDestination }
+  | { type: "setMode"; mode: string; destination: PermissionDestination }
+  | { type: "addDirectories"; directories: string[]; destination: PermissionDestination }
+  | { type: "removeDirectories"; directories: string[]; destination: PermissionDestination };
+
+export interface PermissionRequest {
+  request_id: string;
+  tool_name: string;
+  input: Record<string, unknown>;
+  permission_suggestions?: PermissionUpdate[];
+  description?: string;
+  tool_use_id: string;
+  agent_id?: string;
+  timestamp: number;
+}

package/server/settings-manager.ts

@@ -0,0 +1,120 @@
+import {
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+  existsSync,
+} from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+
+export const DEFAULT_OPENROUTER_MODEL = "openrouter/free";
+
+export type EmbeddingProvider = "openai" | "ollama" | "none";
+
+export interface CampfireSettings {
+  openrouterApiKey: string;
+  openrouterModel: string;
+  moltbookApiKey: string;
+  linearApiKey: string;
+  // Provider tokens — auto-injected into sessions for matching backends
+  /** Claude Code OAuth token (injected as CLAUDE_CODE_OAUTH_TOKEN for Claude sessions) */
+  claudeOAuthToken: string;
+  /** OpenAI API key (injected as OPENAI_API_KEY for Codex sessions) */
+  openaiApiKey: string;
+  /** Anthropic API key (injected as ANTHROPIC_API_KEY — used by Claude, Goose, Aider, etc.) */
+  anthropicApiKey: string;
+  // Collective Intelligence: embedding provider for semantic memory
+  embeddingProvider: EmbeddingProvider;
+  embeddingApiKey: string;    // OpenAI API key (if provider = "openai")
+  embeddingModel: string;     // e.g. "text-embedding-3-small" or "nomic-embed-text"
+  embeddingBaseUrl: string;   // Ollama base URL (if provider = "ollama"), default http://localhost:11434
+  /** Whether the onboarding wizard has been completed or skipped */
+  onboardingCompleted: boolean;
+  updatedAt: number;
+}
+
+const DEFAULT_PATH = join(homedir(), ".campfire", "settings.json");
+
+let loaded = false;
+let filePath = DEFAULT_PATH;
+let settings: CampfireSettings = {
+  openrouterApiKey: "",
+  openrouterModel: DEFAULT_OPENROUTER_MODEL,
+  moltbookApiKey: "",
+  linearApiKey: "",
+  claudeOAuthToken: "",
+  openaiApiKey: "",
+  anthropicApiKey: "",
+  embeddingProvider: "none",
+  embeddingApiKey: "",
+  embeddingModel: "",
+  embeddingBaseUrl: "http://localhost:11434",
+  onboardingCompleted: false,
+  updatedAt: 0,
+};
+
+function normalize(raw: Partial<CampfireSettings> | null | undefined): CampfireSettings {
+  return {
+    openrouterApiKey: typeof raw?.openrouterApiKey === "string" ? raw.openrouterApiKey : "",
+    openrouterModel:
+      typeof raw?.openrouterModel === "string" && raw.openrouterModel.trim()
+        ? raw.openrouterModel
+        : DEFAULT_OPENROUTER_MODEL,
+    moltbookApiKey: typeof raw?.moltbookApiKey === "string" ? raw.moltbookApiKey : "",
+    linearApiKey: typeof raw?.linearApiKey === "string" ? raw.linearApiKey : "",
+    claudeOAuthToken: typeof raw?.claudeOAuthToken === "string" ? raw.claudeOAuthToken : "",
+    openaiApiKey: typeof raw?.openaiApiKey === "string" ? raw.openaiApiKey : "",
+    anthropicApiKey: typeof raw?.anthropicApiKey === "string" ? raw.anthropicApiKey : "",
+    embeddingProvider: (raw?.embeddingProvider === "openai" || raw?.embeddingProvider === "ollama") ? raw.embeddingProvider : "none",
+    embeddingApiKey: typeof raw?.embeddingApiKey === "string" ? raw.embeddingApiKey : "",
+    embeddingModel: typeof raw?.embeddingModel === "string" ? raw.embeddingModel : "",
+    embeddingBaseUrl: typeof raw?.embeddingBaseUrl === "string" && raw.embeddingBaseUrl.trim()
+      ? raw.embeddingBaseUrl
+      : "http://localhost:11434",
+    onboardingCompleted: raw?.onboardingCompleted === true,
+    updatedAt: typeof raw?.updatedAt === "number" ? raw.updatedAt : 0,
+  };
+}
+
+function ensureLoaded(): void {
+  if (loaded) return;
+  try {
+    if (existsSync(filePath)) {
+      const raw = readFileSync(filePath, "utf-8");
+      settings = normalize(JSON.parse(raw) as Partial<CampfireSettings>);
+    }
+  } catch {
+    settings = normalize(null);
+  }
+  loaded = true;
+}
+
+function persist(): void {
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, JSON.stringify(settings, null, 2), "utf-8");
+}
+
+export function getSettings(): CampfireSettings {
+  ensureLoaded();
+  return { ...settings };
+}
+
+export function updateSettings(
+  patch: Partial<Pick<CampfireSettings, "openrouterApiKey" | "openrouterModel" | "moltbookApiKey" | "linearApiKey" | "claudeOAuthToken" | "openaiApiKey" | "anthropicApiKey" | "embeddingProvider" | "embeddingApiKey" | "embeddingModel" | "embeddingBaseUrl" | "onboardingCompleted">>,
+): CampfireSettings {
+  ensureLoaded();
+  settings = {
+    ...settings,
+    ...patch,
+    openrouterModel: patch.openrouterModel?.trim() || settings.openrouterModel || DEFAULT_OPENROUTER_MODEL,
+    updatedAt: Date.now(),
+  };
+  persist();
+  return { ...settings };
+}
+
+export function _resetForTest(customPath?: string): void {
+  loaded = false;
+  filePath = customPath || DEFAULT_PATH;
+  settings = normalize(null);
+}