@vibe-interviewing/core 0.1.0 → 0.3.0

package/README.md

@@ -0,0 +1,26 @@
+# @vibe-interviewing/core
+
+Core library for [vibe-interviewing](https://github.com/cpaczek/vibe-interviewing).
+
+Provides the scenario engine, git-based session management, workspace setup, and Claude Code launcher used by the CLI.
+
+## What's inside
+
+- **Scenario engine** — loads and validates `scenario.yaml` configs via Zod schemas
+- **Workspace manager** — clones repos at pinned commits, applies patches, injects bugs, wipes git history
+- **Session manager** — tracks interview sessions (timing, state, metadata)
+- **AI tool launcher** — launches Claude Code with system prompt injection via `--append-system-prompt`
+- **Network client** — uploads/downloads sessions to the cloud relay for remote interviews
+
+## Usage
+
+This package is used internally by the `vibe-interviewing` CLI. It's published as `@vibe-interviewing/core` on npm for the CLI's dependency resolution.
+
+```ts
+import { ScenarioEngine, WorkspaceManager, SessionManager } from '@vibe-interviewing/core'
+import { CloudClient } from '@vibe-interviewing/core/network'
+```
+
+## License
+
+MIT

package/dist/chunk-CI3BD2WQ.js

@@ -0,0 +1,141 @@
+// src/errors.ts
+var VibeError = class extends Error {
+  constructor(message, code, hint) {
+    super(message);
+    this.code = code;
+    this.hint = hint;
+    this.name = "VibeError";
+  }
+};
+var ScenarioNotFoundError = class extends VibeError {
+  constructor(name) {
+    super(
+      `Scenario not found: ${name}`,
+      "SCENARIO_NOT_FOUND",
+      "Run `vibe-interviewing list` to see available scenarios"
+    );
+  }
+};
+var ScenarioValidationError = class extends VibeError {
+  constructor(message, issues) {
+    super(`Invalid scenario config: ${message}`, "SCENARIO_VALIDATION_ERROR", issues.join("\n"));
+    this.issues = issues;
+  }
+};
+var AIToolNotFoundError = class _AIToolNotFoundError extends VibeError {
+  static installHints = {
+    "claude-code": "Install Claude Code: npm install -g @anthropic-ai/claude-code"
+  };
+  constructor(tool) {
+    super(
+      `${tool} is not installed`,
+      "AI_TOOL_NOT_FOUND",
+      _AIToolNotFoundError.installHints[tool] ?? `Install ${tool} and try again`
+    );
+  }
+};
+var SessionNotFoundError = class extends VibeError {
+  constructor(id) {
+    super(
+      `Session not found: ${id}`,
+      "SESSION_NOT_FOUND",
+      "Run `vibe-interviewing list` to see active sessions"
+    );
+  }
+};
+var GitCloneError = class extends VibeError {
+  constructor(repo, reason) {
+    super(
+      `Failed to clone repository: ${repo}${reason ? ` \u2014 ${reason}` : ""}`,
+      "GIT_CLONE_FAILED",
+      "Check the repo URL and your network connection"
+    );
+  }
+};
+var SetupError = class extends VibeError {
+  constructor(command, reason) {
+    super(
+      `Setup command failed: ${command}${reason ? ` \u2014 ${reason}` : ""}`,
+      "SETUP_FAILED",
+      "Check the scenario setup commands and try again"
+    );
+  }
+};
+var ScenarioFetchError = class extends VibeError {
+  constructor(url, reason) {
+    super(
+      `Failed to fetch scenario from URL: ${url}${reason ? ` \u2014 ${reason}` : ""}`,
+      "SCENARIO_FETCH_FAILED",
+      "Check the URL is accessible and returns valid YAML"
+    );
+  }
+};
+
+// src/network/session-code.ts
+function encodeSessionCode(host, port) {
+  const octets = host.split(".").map(Number);
+  if (octets.length !== 4 || octets.some((o) => isNaN(o) || o < 0 || o > 255)) {
+    throw new InvalidSessionCodeError(`Invalid IPv4 address: ${host}`);
+  }
+  if (port < 1 || port > 65535) {
+    throw new InvalidSessionCodeError(`Invalid port: ${port}`);
+  }
+  const buf = Buffer.alloc(6);
+  buf[0] = octets[0];
+  buf[1] = octets[1];
+  buf[2] = octets[2];
+  buf[3] = octets[3];
+  buf.writeUInt16BE(port, 4);
+  const num = buf.readUIntBE(0, 6);
+  const code = num.toString(36).toUpperCase().padStart(10, "0");
+  return `VIBE-${code}`;
+}
+function decodeSessionCode(code) {
+  let raw = code.trim().toUpperCase();
+  if (raw.startsWith("VIBE-")) {
+    raw = raw.slice(5);
+  }
+  if (!/^[0-9A-Z]{1,10}$/.test(raw)) {
+    throw new InvalidSessionCodeError(`Invalid session code format: ${code}`);
+  }
+  const num = parseInt(raw, 36);
+  if (isNaN(num) || num > 281474976710655) {
+    throw new InvalidSessionCodeError(`Invalid session code: ${code}`);
+  }
+  const buf = Buffer.alloc(6);
+  buf.writeUIntBE(num, 0, 6);
+  const host = `${buf[0]}.${buf[1]}.${buf[2]}.${buf[3]}`;
+  const port = buf.readUInt16BE(4);
+  if (port === 0) {
+    throw new InvalidSessionCodeError(`Invalid session code (port 0): ${code}`);
+  }
+  return { host, port };
+}
+function isCloudSessionCode(code) {
+  let raw = code.trim().toUpperCase();
+  if (raw.startsWith("VIBE-")) {
+    raw = raw.slice(5);
+  }
+  return /^[0-9A-Z]{6}$/.test(raw);
+}
+var InvalidSessionCodeError = class extends VibeError {
+  constructor(message) {
+    super(message, "INVALID_SESSION_CODE", "Session codes look like VIBE-XXXXXXXXXX");
+  }
+};
+
+export {
+  VibeError,
+  ScenarioNotFoundError,
+  ScenarioValidationError,
+  AIToolNotFoundError,
+  SessionNotFoundError,
+  GitCloneError,
+  SetupError,
+  ScenarioFetchError,
+  encodeSessionCode,
+  decodeSessionCode,
+  isCloudSessionCode,
+  InvalidSessionCodeError
+};
+//# sourceMappingURL=chunk-CI3BD2WQ.js.map

package/dist/chunk-CI3BD2WQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/network/session-code.ts"],"sourcesContent":["/** Base error class for all vibe-interviewing errors */\nexport class VibeError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly hint?: string,\n  ) {\n    super(message)\n    this.name = 'VibeError'\n  }\n}\n\nexport class ScenarioNotFoundError extends VibeError {\n  constructor(name: string) {\n    super(\n      `Scenario not found: ${name}`,\n      'SCENARIO_NOT_FOUND',\n      'Run `vibe-interviewing list` to see available scenarios',\n    )\n  }\n}\n\nexport class ScenarioValidationError extends VibeError {\n  constructor(\n    message: string,\n    public readonly issues: string[],\n  ) {\n    super(`Invalid scenario config: ${message}`, 'SCENARIO_VALIDATION_ERROR', issues.join('\\n'))\n  }\n}\n\nexport class AIToolNotFoundError extends VibeError {\n  static readonly installHints: Record<string, string> = {\n    'claude-code': 'Install Claude Code: npm install -g @anthropic-ai/claude-code',\n  }\n\n  constructor(tool: string) {\n    super(\n      `${tool} is not installed`,\n      'AI_TOOL_NOT_FOUND',\n      AIToolNotFoundError.installHints[tool] ?? `Install ${tool} and try again`,\n    )\n  }\n}\n\nexport class SessionNotFoundError extends VibeError {\n  constructor(id: string) {\n    super(\n      `Session not found: ${id}`,\n      'SESSION_NOT_FOUND',\n      'Run `vibe-interviewing list` to see active sessions',\n    )\n  }\n}\n\nexport class GitCloneError extends VibeError {\n  constructor(repo: string, reason?: string) {\n    super(\n      `Failed to clone repository: ${repo}${reason ? ` — ${reason}` : ''}`,\n      'GIT_CLONE_FAILED',\n      'Check the repo URL and your network connection',\n    )\n  }\n}\n\nexport class SetupError extends VibeError {\n  constructor(command: string, reason?: string) {\n    super(\n      `Setup command failed: ${command}${reason ? ` — ${reason}` : ''}`,\n      'SETUP_FAILED',\n      'Check the scenario setup commands and try again',\n    )\n  }\n}\n\nexport class ScenarioFetchError extends VibeError {\n  constructor(url: string, reason?: string) {\n    super(\n      `Failed to fetch scenario from URL: ${url}${reason ? ` — ${reason}` : ''}`,\n      'SCENARIO_FETCH_FAILED',\n      'Check the URL is accessible and returns valid YAML',\n    )\n  }\n}\n","import { VibeError } from '../errors.js'\n\n/**\n * Encode a host:port pair into a human-typeable session code.\n *\n * Format: VIBE-XXXXXXXXXX (10 base36 chars encoding 6 bytes: 4 IP octets + 2 port bytes)\n */\nexport function encodeSessionCode(host: string, port: number): string {\n  const octets = host.split('.').map(Number)\n  if (octets.length !== 4 || octets.some((o) => isNaN(o) || o < 0 || o > 255)) {\n    throw new InvalidSessionCodeError(`Invalid IPv4 address: ${host}`)\n  }\n  if (port < 1 || port > 65535) {\n    throw new InvalidSessionCodeError(`Invalid port: ${port}`)\n  }\n\n  // Pack into 6 bytes: [ip0, ip1, ip2, ip3, port_hi, port_lo]\n  const buf = Buffer.alloc(6)\n  buf[0] = octets[0]!\n  buf[1] = octets[1]!\n  buf[2] = octets[2]!\n  buf[3] = octets[3]!\n  buf.writeUInt16BE(port, 4)\n\n  // Convert to base36, zero-pad to 10 chars\n  const num = buf.readUIntBE(0, 6)\n  const code = num.toString(36).toUpperCase().padStart(10, '0')\n\n  return `VIBE-${code}`\n}\n\n/**\n * Decode a session code back to host:port.\n *\n * Accepts formats: VIBE-XXXXXXXXXX, vibe-xxxxxxxxxx, or just XXXXXXXXXX\n */\nexport function decodeSessionCode(code: string): { host: string; port: number } {\n  // Strip VIBE- prefix if present\n  let raw = code.trim().toUpperCase()\n  if (raw.startsWith('VIBE-')) {\n    raw = raw.slice(5)\n  }\n\n  if (!/^[0-9A-Z]{1,10}$/.test(raw)) {\n    throw new InvalidSessionCodeError(`Invalid session code format: ${code}`)\n  }\n\n  const num = parseInt(raw, 36)\n  if (isNaN(num) || num > 0xffffffffffff) {\n    throw new InvalidSessionCodeError(`Invalid session code: ${code}`)\n  }\n\n  const buf = Buffer.alloc(6)\n  // Write as 6-byte big-endian\n  buf.writeUIntBE(num, 0, 6)\n\n  const host = `${buf[0]}.${buf[1]}.${buf[2]}.${buf[3]}`\n  const port = buf.readUInt16BE(4)\n\n  if (port === 0) {\n    throw new InvalidSessionCodeError(`Invalid session code (port 0): ${code}`)\n  }\n\n  return { host, port }\n}\n\n/**\n * Check if a session code is a cloud code (6 chars) vs LAN code (10 chars).\n *\n * Cloud codes are 6 alphanumeric characters: VIBE-A3X9K2\n * LAN codes are 10 alphanumeric characters: VIBE-3R8KW1F0NX\n */\nexport function isCloudSessionCode(code: string): boolean {\n  let raw = code.trim().toUpperCase()\n  if (raw.startsWith('VIBE-')) {\n    raw = raw.slice(5)\n  }\n  // Cloud codes are exactly 6 chars, LAN codes are up to 10\n  return /^[0-9A-Z]{6}$/.test(raw)\n}\n\n/** Error for invalid session codes */\nexport class InvalidSessionCodeError extends VibeError {\n  constructor(message: string) {\n    super(message, 'INVALID_SESSION_CODE', 'Session codes look like VIBE-XXXXXXXXXX')\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,177 +1,24 @@
-import { z } from 'zod';
-
-declare const AIRulesSchema: z.ZodObject<{
-    /** Role description for the AI assistant */
-    role: z.ZodString;
-    /** Behavioral rules (e.g., "don't reveal the answer") */
-    rules: z.ZodArray<z.ZodString, "many">;
-    /** Knowledge about the bug/solution (hidden from candidate) */
-    knowledge: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    role: string;
-    rules: string[];
-    knowledge: string;
-}, {
-    role: string;
-    rules: string[];
-    knowledge: string;
-}>;
-declare const EvaluationSchema: z.ZodObject<{
-    /** Evaluation criteria for the interviewer */
-    criteria: z.ZodArray<z.ZodString, "many">;
-    /** Description of the expected fix */
-    expected_fix: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    criteria: string[];
-    expected_fix?: string | undefined;
-}, {
-    criteria: string[];
-    expected_fix?: string | undefined;
-}>;
-/** Full scenario configuration schema */
-declare const ScenarioConfigSchema: z.ZodObject<{
-    /** Scenario display name */
-    name: z.ZodString;
-    /** One-line description */
-    description: z.ZodString;
-    /** Difficulty level */
-    difficulty: z.ZodEnum<["easy", "medium", "hard"]>;
-    /** Estimated time (e.g., "30-45m") */
-    estimated_time: z.ZodString;
-    /** Searchable tags */
-    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    /** GitHub repo URL or owner/repo shorthand */
-    repo: z.ZodString;
-    /** Commit SHA to pin the clone to (ensures reproducibility) */
-    commit: z.ZodString;
-    /** Shell commands to run after cloning (e.g., ["npm install"]) */
-    setup: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    /** Find-and-replace patches to inject the bug after cloning */
-    patch: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Path to the file relative to repo root */
-        file: z.ZodString;
-        /** The original text to find */
-        find: z.ZodString;
-        /** The replacement text (with the bug) */
-        replace: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        find: string;
-        file: string;
-        replace: string;
-    }, {
-        find: string;
-        file: string;
-        replace: string;
-    }>, "many">>;
-    /** Briefing shown to the candidate (written like a team lead message) */
-    briefing: z.ZodString;
-    /** AI behavioral rules (injected via system prompt, hidden from candidate) */
-    ai_rules: z.ZodObject<{
-        /** Role description for the AI assistant */
-        role: z.ZodString;
-        /** Behavioral rules (e.g., "don't reveal the answer") */
-        rules: z.ZodArray<z.ZodString, "many">;
-        /** Knowledge about the bug/solution (hidden from candidate) */
-        knowledge: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        role: string;
-        rules: string[];
-        knowledge: string;
-    }, {
-        role: string;
-        rules: string[];
-        knowledge: string;
-    }>;
-    /** Interviewer reference — what the fix looks like */
-    solution: z.ZodString;
-    /** Evaluation rubric */
-    evaluation: z.ZodOptional<z.ZodObject<{
-        /** Evaluation criteria for the interviewer */
-        criteria: z.ZodArray<z.ZodString, "many">;
-        /** Description of the expected fix */
-        expected_fix: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        criteria: string[];
-        expected_fix?: string | undefined;
-    }, {
-        criteria: string[];
-        expected_fix?: string | undefined;
-    }>>;
-    /** License of the original project */
-    license: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    description: string;
-    difficulty: "easy" | "medium" | "hard";
-    estimated_time: string;
-    tags: string[];
-    repo: string;
-    commit: string;
-    setup: string[];
-    patch: {
-        find: string;
-        file: string;
-        replace: string;
-    }[];
-    briefing: string;
-    ai_rules: {
-        role: string;
-        rules: string[];
-        knowledge: string;
-    };
-    solution: string;
-    evaluation?: {
-        criteria: string[];
-        expected_fix?: string | undefined;
-    } | undefined;
-    license?: string | undefined;
-}, {
-    name: string;
-    description: string;
-    difficulty: "easy" | "medium" | "hard";
-    estimated_time: string;
-    repo: string;
-    commit: string;
-    briefing: string;
-    ai_rules: {
-        role: string;
-        rules: string[];
-        knowledge: string;
-    };
-    solution: string;
-    tags?: string[] | undefined;
-    setup?: string[] | undefined;
-    patch?: {
-        find: string;
-        file: string;
-        replace: string;
-    }[] | undefined;
-    evaluation?: {
-        criteria: string[];
-        expected_fix?: string | undefined;
-    } | undefined;
-    license?: string | undefined;
-}>;
-type ScenarioConfig = z.infer<typeof ScenarioConfigSchema>;
-type AIRules = z.infer<typeof AIRulesSchema>;
-type Evaluation = z.infer<typeof EvaluationSchema>;
-/** Metadata about a discovered scenario */
-interface ScenarioInfo {
-    /** Scenario name */
-    name: string;
-    /** Parsed config */
-    config: ScenarioConfig;
-    /** Whether this is a built-in scenario */
-    builtIn: boolean;
-}
+import { S as ScenarioConfig, a as ScenarioInfo, A as AIToolLauncher, L as LaunchConfig, b as LaunchedProcess, c as StoredSession } from './session-code-CfhXelpW.js';
+export { d as AIRules, e as AIToolNotFoundError, E as Evaluation, G as GitCloneError, I as InterviewerGuide, f as InvalidSessionCodeError, K as KeySignal, P as ProgressCallback, R as RecordingData, g as ScenarioConfigSchema, h as ScenarioFetchError, i as ScenarioNotFoundError, j as ScenarioType, k as ScenarioValidationError, l as Session, m as SessionEvent, n as SessionEventType, o as SessionManager, p as SessionNotFoundError, q as SessionRecorder, r as SetupError, V as VibeError, s as decodeSessionCode, t as encodeSessionCode, u as isCloudSessionCode, v as toStoredSession } from './session-code-CfhXelpW.js';
+import 'zod';
 
 /**
- * Load and parse a scenario config from a YAML file.
+ * Check whether a string looks like a URL (http:// or https://).
+ *
+ * @param input - The string to test
+ * @returns true if the string starts with http:// or https://
+ */
+declare function isUrl(input: string): boolean;
+/**
+ * Load and parse a scenario config from a YAML file or URL.
  *
- * @param configPath - Absolute path to the scenario.yaml file
+ * Accepts either a local file path or an HTTP(S) URL. GitHub blob URLs
+ * are automatically converted to raw content URLs.
+ *
+ * @param pathOrUrl - Absolute path to a scenario.yaml file, or a URL
  * @returns The parsed and validated scenario config
  */
-declare function loadScenarioConfig(configPath: string): Promise<ScenarioConfig>;
+declare function loadScenarioConfig(pathOrUrl: string): Promise<ScenarioConfig>;
 /**
  * Generate a system prompt string from a scenario's ai_rules.
  *
@@ -198,7 +45,7 @@ interface ValidationResult {
  * @param config - The scenario config to validate
  * @returns Validation result with errors and warnings
  */
-declare function validateScenario(config: ScenarioConfig): Promise<ValidationResult>;
+declare function validateScenario(config: ScenarioConfig): ValidationResult;
 /**
  * Validate a scenario config and throw if invalid.
  *
@@ -206,7 +53,7 @@ declare function validateScenario(config: ScenarioConfig): Promise<ValidationRes
  * @returns Validation result (only returned if valid)
  * @throws ScenarioValidationError if the config has errors
  */
-declare function validateScenarioOrThrow(config: ScenarioConfig): Promise<ValidationResult>;
+declare function validateScenarioOrThrow(config: ScenarioConfig): ValidationResult;
 
 /**
  * Discover built-in scenarios from the registry.yaml file in the scenarios package.
@@ -240,93 +87,6 @@ declare function discoverAllScenarios(): Promise<ScenarioInfo[]>;
  */
 declare function importRepo(repoUrl: string, targetPath?: string, ref?: string): Promise<string>;
 
-/** Event types that can be captured during a session */
-type SessionEventType = 'stdout' | 'stderr' | 'command' | 'note';
-/** A single timestamped event captured during a session */
-interface SessionEvent {
-    /** Milliseconds since recording started */
-    timestamp: number;
-    /** The kind of event */
-    type: SessionEventType;
-    /** The captured data */
-    data: string;
-}
-/** Serialized recording format */
-interface RecordingData {
-    /** Session ID this recording belongs to */
-    sessionId: string;
-    /** ISO string of when recording started */
-    startedAt: string;
-    /** All captured events */
-    events: SessionEvent[];
-}
-/**
- * Records timestamped events during an interview session.
- *
- * Captures stdout, stderr, commands, and notes with millisecond timestamps
- * relative to when the recorder was created.
- */
-declare class SessionRecorder {
-    private readonly events;
-    private readonly startTime;
-    private readonly startedAt;
-    constructor();
-    /** Record a timestamped event */
-    record(type: SessionEventType, data: string): void;
-    /** Get all recorded events */
-    getEvents(): ReadonlyArray<SessionEvent>;
-    /** Serialize the recording to a JSON-compatible object */
-    toJSON(sessionId: string): RecordingData;
-    /** Create a SessionRecorder pre-populated with events from serialized data */
-    static fromJSON(data: RecordingData): SessionRecorder;
-    /** Save the recording to disk */
-    save(sessionId: string): Promise<void>;
-    /** Load a recording from disk */
-    static load(sessionId: string): Promise<SessionRecorder>;
-    /** List all available recording session IDs */
-    static list(): Promise<string[]>;
-}
-
-/** Configuration for launching an AI coding tool */
-interface LaunchConfig {
-    /** Scenario name for display */
-    scenarioName: string;
-    /** Path to system prompt file (hidden from candidate) */
-    systemPromptPath: string;
-    /** Model to use */
-    model?: string;
-    /** Permission mode for the AI tool */
-    permissionMode?: 'default' | 'plan' | 'acceptEdits' | 'bypassPermissions';
-    /** Tools to disallow (e.g., WebSearch for fairness) */
-    disallowedTools?: string[];
-    /** Whether to record stdout/stderr during the session */
-    recording?: boolean;
-}
-/** A running AI tool process */
-interface LaunchedProcess {
-    /** Wait for the process to exit */
-    wait(): Promise<{
-        exitCode: number;
-    }>;
-    /** Kill the process */
-    kill(): Promise<void>;
-    /** Session recorder, present when recording is enabled */
-    recorder?: SessionRecorder;
-}
-/** Interface for AI coding tool launchers */
-interface AIToolLauncher {
-    /** Internal name identifier */
-    readonly name: string;
-    /** Human-readable display name */
-    readonly displayName: string;
-    /** Check if this tool is installed and accessible */
-    isInstalled(): Promise<boolean>;
-    /** Get the installed version string */
-    getVersion(): Promise<string | null>;
-    /** Launch the tool pointed at a working directory */
-    launch(workdir: string, config: LaunchConfig): Promise<LaunchedProcess>;
-}
-
 /** Launcher for Anthropic's Claude Code CLI */
 declare class ClaudeCodeLauncher implements AIToolLauncher {
     readonly name = "claude-code";
@@ -353,84 +113,6 @@ declare function getLauncher(name: string): AIToolLauncher | undefined;
 /** Get all registered launchers */
 declare function getAllLaunchers(): AIToolLauncher[];
 
-/** Status of an interview session */
-type SessionStatus = 'cloning' | 'setting-up' | 'running' | 'complete';
-/** A live interview session */
-interface Session {
-    /** Unique session identifier */
-    id: string;
-    /** Name of the scenario being run */
-    scenarioName: string;
-    /** Local working directory for the candidate */
-    workdir: string;
-    /** Path to the system prompt file (outside workspace) */
-    systemPromptPath: string;
-    /** Current session status */
-    status: SessionStatus;
-    /** ISO timestamp of session creation */
-    createdAt: string;
-    /** ISO timestamp of when the AI tool was launched */
-    startedAt?: string;
-    /** ISO timestamp of session completion */
-    completedAt?: string;
-    /** Name of the AI tool used */
-    aiTool?: string;
-}
-/** Serializable session data for persistence */
-interface StoredSession {
-    /** Unique session identifier */
-    id: string;
-    /** Name of the scenario being run */
-    scenarioName: string;
-    /** Current session status */
-    status: SessionStatus;
-    /** Local working directory for the candidate */
-    workdir: string;
-    /** Path to the system prompt file */
-    systemPromptPath: string;
-    /** Name of the AI tool used */
-    aiTool?: string;
-    /** ISO timestamp of session creation */
-    createdAt: string;
-    /** ISO timestamp of when the AI tool was launched */
-    startedAt?: string;
-    /** ISO timestamp of session completion */
-    completedAt?: string;
-}
-/** Convert a Session to a StoredSession for persistence */
-declare function toStoredSession(session: Session): StoredSession;
-
-/** Callback for reporting session progress */
-type ProgressCallback = (stage: string) => void;
-/** Manages the lifecycle of an interview session */
-declare class SessionManager {
-    private launcher;
-    constructor(launcher: AIToolLauncher);
-    /**
-     * Create a new interview session.
-     *
-     * Flow:
-     * 1. Clone the repo at a pinned commit
-     * 2. Apply bug patches (find/replace in source files)
-     * 3. Wipe git history so the candidate can't diff to find the bug
-     * 4. Remove scenario.yaml from workspace (interviewer-only)
-     * 5. Write BRIEFING.md and system prompt
-     * 6. Run setup commands (npm install, etc.)
-     */
-    createSession(config: ScenarioConfig, workdir?: string, onProgress?: ProgressCallback): Promise<{
-        session: Session;
-        config: ScenarioConfig;
-    }>;
-    /** Launch the AI coding tool for an active session */
-    launchAITool(session: Session, _config: ScenarioConfig, launchConfig?: Partial<LaunchConfig>): Promise<{
-        exitCode: number;
-    }>;
-    /** Destroy a session by removing its stored data */
-    destroySession(session: Session): Promise<void>;
-    /** Get elapsed time since the AI tool was launched, formatted as a human-readable string */
-    getElapsedTime(session: Session): string | null;
-}
-
 /** Save a session to disk */
 declare function saveSession(session: StoredSession): Promise<void>;
 /** Load a session from disk */
@@ -442,31 +124,4 @@ declare function listSessions(): Promise<StoredSession[]>;
 /** List only active (non-complete) sessions */
 declare function listActiveSessions(): Promise<StoredSession[]>;
 
-/** Base error class for all vibe-interviewing errors */
-declare class VibeError extends Error {
-    readonly code: string;
-    readonly hint?: string | undefined;
-    constructor(message: string, code: string, hint?: string | undefined);
-}
-declare class ScenarioNotFoundError extends VibeError {
-    constructor(name: string);
-}
-declare class ScenarioValidationError extends VibeError {
-    readonly issues: string[];
-    constructor(message: string, issues: string[]);
-}
-declare class AIToolNotFoundError extends VibeError {
-    static readonly installHints: Record<string, string>;
-    constructor(tool: string);
-}
-declare class SessionNotFoundError extends VibeError {
-    constructor(id: string);
-}
-declare class GitCloneError extends VibeError {
-    constructor(repo: string, reason?: string);
-}
-declare class SetupError extends VibeError {
-    constructor(command: string, reason?: string);
-}
-
-export { type AIRules, type AIToolLauncher, AIToolNotFoundError, ClaudeCodeLauncher, type DetectedTool, type Evaluation, GitCloneError, type LaunchConfig, type LaunchedProcess, type ProgressCallback, type RecordingData, type ScenarioConfig, ScenarioConfigSchema, type ScenarioInfo, ScenarioNotFoundError, ScenarioValidationError, type Session, type SessionEvent, type SessionEventType, SessionManager, SessionNotFoundError, SessionRecorder, SetupError, type StoredSession, type ValidationResult, VibeError, deleteSession, detectInstalledTools, discoverAllScenarios, discoverBuiltInScenarios, generateSystemPrompt, getAllLaunchers, getLauncher, importRepo, listActiveSessions, listSessions, loadScenarioConfig, loadSession, saveSession, toStoredSession, validateScenario, validateScenarioOrThrow };
+export { AIToolLauncher, ClaudeCodeLauncher, type DetectedTool, LaunchConfig, LaunchedProcess, ScenarioConfig, ScenarioInfo, StoredSession, type ValidationResult, deleteSession, detectInstalledTools, discoverAllScenarios, discoverBuiltInScenarios, generateSystemPrompt, getAllLaunchers, getLauncher, importRepo, isUrl, listActiveSessions, listSessions, loadScenarioConfig, loadSession, saveSession, validateScenario, validateScenarioOrThrow };