@vibe-interviewing/core 0.1.0 → 0.3.0

package/dist/network/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/network/server.ts","../../src/network/client.ts","../../src/network/cloud-client.ts"],"sourcesContent":["import { createServer, type Server, type IncomingMessage, type ServerResponse } from 'node:http'\nimport { execSync } from 'node:child_process'\nimport { readFile } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport { networkInterfaces } from 'node:os'\nimport { EventEmitter } from 'node:events'\nimport type { Session } from '../session/types.js'\nimport type { ScenarioConfig } from '../scenario/types.js'\nimport { encodeSessionCode } from './session-code.js'\n\n/** Metadata served to candidates */\nexport interface SessionMetadata {\n  scenarioName: string\n  type: string\n  difficulty: string\n  estimatedTime: string\n  briefing: string\n  setupCommands: string[]\n}\n\n/** Events emitted by the session server */\nexport interface SessionServerEvents {\n  'candidate-connected': []\n  'download-complete': []\n}\n\n/** HTTP server that serves a prepared workspace to a remote candidate */\nexport class SessionServer extends EventEmitter<SessionServerEvents> {\n  private server: Server | null = null\n\n  /** Start serving the session workspace */\n  async start(\n    session: Session,\n    config: ScenarioConfig,\n    port?: number,\n  ): Promise<{ code: string; port: number; host: string }> {\n    // Create tarball of the workspace\n    const tarball = join(session.workdir, '..', `${session.id}.tar.gz`)\n    execSync(`tar czf \"${tarball}\" -C \"${session.workdir}\" .`, { stdio: 'pipe' })\n\n    const systemPrompt = await readFile(session.systemPromptPath, 'utf-8')\n\n    const metadata: SessionMetadata = {\n      scenarioName: config.name,\n      type: config.type,\n      difficulty: config.difficulty,\n      estimatedTime: config.estimated_time,\n      briefing: config.briefing,\n      setupCommands: config.setup,\n    }\n\n    this.server = createServer((req: IncomingMessage, res: ServerResponse) => {\n      if (req.method !== 'GET') {\n        res.writeHead(405)\n        res.end()\n        return\n      }\n\n      switch (req.url) {\n        case '/metadata':\n          res.writeHead(200, { 'Content-Type': 'application/json' })\n          res.end(JSON.stringify(metadata))\n          break\n\n        case '/system-prompt':\n          this.emit('candidate-connected')\n          res.writeHead(200, { 'Content-Type': 'text/plain' })\n          res.end(systemPrompt)\n          break\n\n        case '/workspace':\n          readFile(tarball)\n            .then((data) => {\n              res.writeHead(200, {\n                'Content-Type': 'application/gzip',\n                'Content-Length': data.length,\n              })\n              res.end(data)\n              this.emit('download-complete')\n            })\n            .catch(() => {\n              res.writeHead(500)\n              res.end('Failed to read workspace tarball')\n            })\n          break\n\n        default:\n          res.writeHead(404)\n          res.end()\n      }\n    })\n\n    const listenPort = port ?? 0\n\n    return new Promise((resolve, reject) => {\n      this.server!.listen(listenPort, () => {\n        const addr = this.server!.address()\n        if (!addr || typeof addr === 'string') {\n          reject(new Error('Failed to get server address'))\n          return\n        }\n\n        const host = getLanIp()\n        const code = encodeSessionCode(host, addr.port)\n\n        resolve({ code, port: addr.port, host })\n      })\n\n      this.server!.on('error', reject)\n    })\n  }\n\n  /** Stop the server and clean up */\n  async stop(): Promise<void> {\n    return new Promise((resolve) => {\n      if (this.server) {\n        this.server.close(() => resolve())\n      } else {\n        resolve()\n      }\n    })\n  }\n}\n\n/** Get the first non-internal IPv4 address */\nfunction getLanIp(): string {\n  const interfaces = networkInterfaces()\n  for (const entries of Object.values(interfaces)) {\n    if (!entries) continue\n    for (const entry of entries) {\n      if (entry.family === 'IPv4' && !entry.internal) {\n        return entry.address\n      }\n    }\n  }\n  return '127.0.0.1'\n}\n","import { get } from 'node:http'\nimport { writeFile, mkdir } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport { homedir } from 'node:os'\nimport { execSync } from 'node:child_process'\nimport { randomBytes } from 'node:crypto'\nimport { VibeError } from '../errors.js'\nimport type { SessionMetadata } from './server.js'\nimport type { ProgressCallback } from '../session/manager.js'\n\n/** Result of downloading a session from a host */\nexport interface DownloadedSession {\n  /** Path to the extracted workspace */\n  workdir: string\n  /** Path to the system prompt file */\n  systemPromptPath: string\n  /** Session metadata from the host */\n  metadata: SessionMetadata\n  /** Generated session ID */\n  id: string\n}\n\n/** Error for network/connection failures */\nexport class NetworkError extends VibeError {\n  constructor(message: string) {\n    super(message, 'NETWORK_ERROR', 'Check the session code and ensure the host is running')\n  }\n}\n\n/** Fetch JSON from an HTTP endpoint */\nfunction fetchJson<T>(host: string, port: number, path: string): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const req = get({ hostname: host, port, path, timeout: 10000 }, (res) => {\n      if (res.statusCode !== 200) {\n        reject(new NetworkError(`Server returned ${res.statusCode} for ${path}`))\n        return\n      }\n      let data = ''\n      res.on('data', (chunk: Buffer) => {\n        data += chunk.toString()\n      })\n      res.on('end', () => {\n        try {\n          resolve(JSON.parse(data) as T)\n        } catch {\n          reject(new NetworkError(`Invalid response from server for ${path}`))\n        }\n      })\n    })\n    req.on('error', (err) => reject(new NetworkError(`Connection failed: ${err.message}`)))\n    req.on('timeout', () => {\n      req.destroy()\n      reject(new NetworkError('Connection timed out'))\n    })\n  })\n}\n\n/** Fetch text from an HTTP endpoint */\nfunction fetchText(host: string, port: number, path: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const req = get({ hostname: host, port, path, timeout: 10000 }, (res) => {\n      if (res.statusCode !== 200) {\n        reject(new NetworkError(`Server returned ${res.statusCode} for ${path}`))\n        return\n      }\n      let data = ''\n      res.on('data', (chunk: Buffer) => {\n        data += chunk.toString()\n      })\n      res.on('end', () => resolve(data))\n    })\n    req.on('error', (err) => reject(new NetworkError(`Connection failed: ${err.message}`)))\n    req.on('timeout', () => {\n      req.destroy()\n      reject(new NetworkError('Connection timed out'))\n    })\n  })\n}\n\n/** Download a binary file from an HTTP endpoint */\nfunction fetchBinary(host: string, port: number, path: string): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const req = get({ hostname: host, port, path, timeout: 60000 }, (res) => {\n      if (res.statusCode !== 200) {\n        reject(new NetworkError(`Server returned ${res.statusCode} for ${path}`))\n        return\n      }\n      const chunks: Buffer[] = []\n      res.on('data', (chunk: Buffer) => chunks.push(chunk))\n      res.on('end', () => resolve(Buffer.concat(chunks)))\n    })\n    req.on('error', (err) => reject(new NetworkError(`Download failed: ${err.message}`)))\n    req.on('timeout', () => {\n      req.destroy()\n      reject(new NetworkError('Download timed out'))\n    })\n  })\n}\n\n/**\n * Download a session from a host.\n *\n * Fetches metadata, system prompt, and workspace tarball, then\n * extracts everything to a local directory.\n */\nexport async function downloadSession(\n  host: string,\n  port: number,\n  targetDir?: string,\n  onProgress?: ProgressCallback,\n): Promise<DownloadedSession> {\n  const id = randomBytes(4).toString('hex')\n\n  // 1. Fetch metadata\n  onProgress?.('Connecting to host...')\n  const metadata = await fetchJson<SessionMetadata>(host, port, '/metadata')\n\n  // 2. Fetch system prompt\n  onProgress?.('Downloading scenario...')\n  const systemPrompt = await fetchText(host, port, '/system-prompt')\n\n  // 3. Download workspace tarball\n  onProgress?.('Downloading workspace...')\n  const tarball = await fetchBinary(host, port, '/workspace')\n\n  // 4. Extract workspace\n  onProgress?.('Extracting workspace...')\n  const workdir = targetDir ?? join(homedir(), 'vibe-sessions', `${metadata.scenarioName}-${id}`)\n  await mkdir(workdir, { recursive: true })\n\n  // Write tarball to temp file, then extract\n  const tarballPath = join(workdir, '..', `${id}-download.tar.gz`)\n  await writeFile(tarballPath, tarball)\n  execSync(`tar xzf \"${tarballPath}\" -C \"${workdir}\"`, { stdio: 'pipe' })\n\n  // 5. Write system prompt outside workspace\n  const promptDir = join(homedir(), '.vibe-interviewing', 'prompts')\n  await mkdir(promptDir, { recursive: true })\n  const systemPromptPath = join(promptDir, `${id}.md`)\n  await writeFile(systemPromptPath, systemPrompt)\n\n  return { workdir, systemPromptPath, metadata, id }\n}\n","import { writeFile, mkdir, readFile } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport { homedir } from 'node:os'\nimport { execSync } from 'node:child_process'\nimport { randomBytes } from 'node:crypto'\nimport { VibeError } from '../errors.js'\nimport type { SessionMetadata } from './server.js'\nimport type { ProgressCallback } from '../session/manager.js'\nimport type { DownloadedSession } from './client.js'\n\n/** Default Cloudflare Worker URL */\nexport const DEFAULT_WORKER_URL = 'https://api.vibe-interviewing.iar.dev'\n\n/** Get the configured worker URL (env override or default) */\nexport function getWorkerUrl(): string {\n  return process.env['VIBE_WORKER_URL'] || DEFAULT_WORKER_URL\n}\n\n/** Error for cloud upload/download failures */\nexport class CloudError extends VibeError {\n  constructor(message: string) {\n    super(message, 'CLOUD_ERROR', 'Check your network connection and try again')\n  }\n}\n\n/**\n * Upload a session to the cloud relay.\n *\n * Sends metadata, system prompt, and workspace tarball to the Cloudflare Worker.\n * Returns a session code the candidate can use to download.\n */\nexport async function uploadSession(\n  workerUrl: string,\n  metadata: SessionMetadata,\n  systemPrompt: string,\n  tarballPath: string,\n  onProgress?: ProgressCallback,\n): Promise<{ code: string; expiresAt: string }> {\n  onProgress?.('Reading workspace tarball...')\n  const tarballData = await readFile(tarballPath)\n\n  onProgress?.('Uploading to cloud...')\n  const formData = new FormData()\n  formData.set('metadata', JSON.stringify(metadata))\n  formData.set('systemPrompt', systemPrompt)\n  formData.set(\n    'workspace',\n    new Blob([tarballData], { type: 'application/gzip' }),\n    'workspace.tar.gz',\n  )\n\n  let response: Response\n  try {\n    response = await fetch(`${workerUrl}/sessions`, {\n      method: 'POST',\n      body: formData,\n    })\n  } catch (err) {\n    throw new CloudError(\n      `Failed to connect to cloud relay at ${workerUrl}: ${err instanceof Error ? err.message : String(err)}`,\n    )\n  }\n\n  if (!response.ok) {\n    const body = await response.text().catch(() => 'unknown error')\n    throw new CloudError(`Cloud upload failed (${response.status}): ${body}`)\n  }\n\n  const result = (await response.json()) as { code: string; expiresAt: string }\n  return result\n}\n\n/**\n * Download a session from the cloud relay.\n *\n * Fetches metadata, system prompt, and workspace tarball from the Cloudflare Worker.\n */\nexport async function downloadSessionFromCloud(\n  workerUrl: string,\n  code: string,\n  targetDir?: string,\n  onProgress?: ProgressCallback,\n): Promise<DownloadedSession> {\n  const id = randomBytes(4).toString('hex')\n\n  // Strip VIBE- prefix and lowercase for the API\n  let rawCode = code.trim().toUpperCase()\n  if (rawCode.startsWith('VIBE-')) {\n    rawCode = rawCode.slice(5)\n  }\n  rawCode = rawCode.toLowerCase()\n\n  // 1. Fetch metadata\n  onProgress?.('Connecting to cloud relay...')\n  const metadataRes = await cloudFetch(`${workerUrl}/sessions/${rawCode}/metadata`)\n  const metadata = (await metadataRes.json()) as SessionMetadata\n\n  // 2. Fetch system prompt\n  onProgress?.('Downloading scenario...')\n  const promptRes = await cloudFetch(`${workerUrl}/sessions/${rawCode}/system-prompt`)\n  const systemPrompt = await promptRes.text()\n\n  // 3. Download workspace tarball\n  onProgress?.('Downloading workspace...')\n  const workspaceRes = await cloudFetch(`${workerUrl}/sessions/${rawCode}/workspace`)\n  const tarball = Buffer.from(await workspaceRes.arrayBuffer())\n\n  // 4. Extract workspace\n  onProgress?.('Extracting workspace...')\n  const workdir = targetDir ?? join(homedir(), 'vibe-sessions', `${metadata.scenarioName}-${id}`)\n  await mkdir(workdir, { recursive: true })\n\n  const tarballPath = join(workdir, '..', `${id}-download.tar.gz`)\n  await writeFile(tarballPath, tarball)\n  execSync(`tar xzf \"${tarballPath}\" -C \"${workdir}\"`, { stdio: 'pipe' })\n\n  // 5. Write system prompt outside workspace\n  const promptDir = join(homedir(), '.vibe-interviewing', 'prompts')\n  await mkdir(promptDir, { recursive: true })\n  const systemPromptPath = join(promptDir, `${id}.md`)\n  await writeFile(systemPromptPath, systemPrompt)\n\n  return { workdir, systemPromptPath, metadata, id }\n}\n\n/** Fetch from the cloud worker with error handling */\nasync function cloudFetch(url: string): Promise<Response> {\n  let response: Response\n  try {\n    response = await fetch(url, { signal: AbortSignal.timeout(60000) })\n  } catch (err) {\n    if (err instanceof DOMException && err.name === 'TimeoutError') {\n      throw new CloudError('Cloud download timed out')\n    }\n    throw new CloudError(\n      `Failed to connect to cloud relay: ${err instanceof Error ? err.message : String(err)}`,\n    )\n  }\n\n  if (response.status === 404) {\n    throw new CloudError('Session not found or expired')\n  }\n\n  if (!response.ok) {\n    const body = await response.text().catch(() => 'unknown error')\n    throw new CloudError(`Cloud request failed (${response.status}): ${body}`)\n  }\n\n  return response\n}\n"],"mappings":"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","names":["join","execSync","join","execSync","writeFile","mkdir","readFile","join","homedir","execSync","randomBytes","readFile","randomBytes","join","homedir","mkdir","writeFile","execSync"]}

package/dist/session-code-CfhXelpW.d.ts

@@ -0,0 +1,519 @@
+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;
+}>;
+/** A signal to watch for during the interview, with green and red flag indicators */
+declare const KeySignalSchema: z.ZodObject<{
+    /** What behavior or skill this signal measures */
+    signal: z.ZodString;
+    /** What a strong candidate does (green flag) */
+    positive: z.ZodString;
+    /** What a weak candidate does (red flag) */
+    negative: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    signal: string;
+    positive: string;
+    negative: string;
+}, {
+    signal: string;
+    positive: string;
+    negative: string;
+}>;
+/** Structured guide for the interviewer — shown during hosting, never to the candidate */
+declare const InterviewerGuideSchema: z.ZodObject<{
+    /** High-level summary of what this scenario evaluates and why */
+    overview: z.ZodString;
+    /** Specific behaviors to watch for, with green/red flag indicators */
+    key_signals: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** What behavior or skill this signal measures */
+        signal: z.ZodString;
+        /** What a strong candidate does (green flag) */
+        positive: z.ZodString;
+        /** What a weak candidate does (red flag) */
+        negative: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        signal: string;
+        positive: string;
+        negative: string;
+    }, {
+        signal: string;
+        positive: string;
+        negative: string;
+    }>, "many">>;
+    /** Common mistakes candidates make */
+    common_pitfalls: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Questions to ask the candidate after the session */
+    debrief_questions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    overview: string;
+    key_signals: {
+        signal: string;
+        positive: string;
+        negative: string;
+    }[];
+    common_pitfalls: string[];
+    debrief_questions: string[];
+}, {
+    overview: string;
+    key_signals?: {
+        signal: string;
+        positive: string;
+        negative: string;
+    }[] | undefined;
+    common_pitfalls?: string[] | undefined;
+    debrief_questions?: string[] | undefined;
+}>;
+/** Scenario type — determines validation rules and system prompt context */
+declare const ScenarioTypeSchema: z.ZodDefault<z.ZodEnum<["debug", "feature", "refactor"]>>;
+/** Full scenario configuration schema */
+declare const ScenarioConfigSchema: z.ZodObject<{
+    /** Scenario display name */
+    name: z.ZodString;
+    /** One-line description (candidate-visible — describe symptoms/task, never the root cause or solution) */
+    description: z.ZodString;
+    /** Scenario type: debug (find a bug), feature (build something), refactor (improve code) */
+    type: z.ZodDefault<z.ZodEnum<["debug", "feature", "refactor"]>>;
+    /** 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">>;
+    /** Files or directories to delete after cloning (globs relative to repo root) */
+    delete_files: z.ZodDefault<z.ZodArray<z.ZodString, "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/implementation looks like */
+    solution: z.ZodOptional<z.ZodString>;
+    /** Acceptance criteria for feature scenarios (concrete, testable requirements) */
+    acceptance_criteria: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 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;
+    }>>;
+    /** Structured interviewer guide — what to watch for, common pitfalls, debrief questions */
+    interviewer_guide: z.ZodOptional<z.ZodObject<{
+        /** High-level summary of what this scenario evaluates and why */
+        overview: z.ZodString;
+        /** Specific behaviors to watch for, with green/red flag indicators */
+        key_signals: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            /** What behavior or skill this signal measures */
+            signal: z.ZodString;
+            /** What a strong candidate does (green flag) */
+            positive: z.ZodString;
+            /** What a weak candidate does (red flag) */
+            negative: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            signal: string;
+            positive: string;
+            negative: string;
+        }, {
+            signal: string;
+            positive: string;
+            negative: string;
+        }>, "many">>;
+        /** Common mistakes candidates make */
+        common_pitfalls: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Questions to ask the candidate after the session */
+        debrief_questions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        overview: string;
+        key_signals: {
+            signal: string;
+            positive: string;
+            negative: string;
+        }[];
+        common_pitfalls: string[];
+        debrief_questions: string[];
+    }, {
+        overview: string;
+        key_signals?: {
+            signal: string;
+            positive: string;
+            negative: string;
+        }[] | undefined;
+        common_pitfalls?: string[] | undefined;
+        debrief_questions?: string[] | undefined;
+    }>>;
+    /** License of the original project */
+    license: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "debug" | "feature" | "refactor";
+    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;
+    }[];
+    delete_files: string[];
+    briefing: string;
+    ai_rules: {
+        role: string;
+        rules: string[];
+        knowledge: string;
+    };
+    solution?: string | undefined;
+    acceptance_criteria?: string[] | undefined;
+    evaluation?: {
+        criteria: string[];
+        expected_fix?: string | undefined;
+    } | undefined;
+    interviewer_guide?: {
+        overview: string;
+        key_signals: {
+            signal: string;
+            positive: string;
+            negative: string;
+        }[];
+        common_pitfalls: string[];
+        debrief_questions: string[];
+    } | 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;
+    };
+    type?: "debug" | "feature" | "refactor" | undefined;
+    tags?: string[] | undefined;
+    setup?: string[] | undefined;
+    patch?: {
+        find: string;
+        file: string;
+        replace: string;
+    }[] | undefined;
+    delete_files?: string[] | undefined;
+    solution?: string | undefined;
+    acceptance_criteria?: string[] | undefined;
+    evaluation?: {
+        criteria: string[];
+        expected_fix?: string | undefined;
+    } | undefined;
+    interviewer_guide?: {
+        overview: string;
+        key_signals?: {
+            signal: string;
+            positive: string;
+            negative: string;
+        }[] | undefined;
+        common_pitfalls?: string[] | undefined;
+        debrief_questions?: string[] | undefined;
+    } | undefined;
+    license?: string | undefined;
+}>;
+type ScenarioConfig = z.infer<typeof ScenarioConfigSchema>;
+type ScenarioType = z.infer<typeof ScenarioTypeSchema>;
+type AIRules = z.infer<typeof AIRulesSchema>;
+type Evaluation = z.infer<typeof EvaluationSchema>;
+type InterviewerGuide = z.infer<typeof InterviewerGuideSchema>;
+type KeySignal = z.infer<typeof KeySignalSchema>;
+/** Metadata about a discovered scenario */
+interface ScenarioInfo {
+    /** Scenario name */
+    name: string;
+    /** Parsed config */
+    config: ScenarioConfig;
+    /** Whether this is a built-in scenario */
+    builtIn: boolean;
+}
+
+/** 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>;
+}
+
+/** Status of an interview session */
+type SessionStatus = 'cloning' | 'setting-up' | 'running' | 'complete';
+/** Interview session — used both in-memory and for persistence */
+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.
+ * Identical to Session — kept as an alias for API clarity at persistence boundaries.
+ */
+type StoredSession = Session;
+/** 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. Delete files excluded by the scenario (e.g., tests that reveal the bug)
+     * 4. Wipe git history so the candidate can't diff to find the bug
+     * 5. Remove scenario.yaml from workspace (interviewer-only)
+     * 6. Write BRIEFING.md and system prompt
+     * 7. Run setup commands (npm install, etc.)
+     */
+    createSession(config: ScenarioConfig, workdir?: string, onProgress?: ProgressCallback, options?: {
+        skipSetup?: boolean;
+    }): 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;
+}
+
+/** 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);
+}
+declare class ScenarioFetchError extends VibeError {
+    constructor(url: string, reason?: string);
+}
+
+/**
+ * Encode a host:port pair into a human-typeable session code.
+ *
+ * Format: VIBE-XXXXXXXXXX (10 base36 chars encoding 6 bytes: 4 IP octets + 2 port bytes)
+ */
+declare function encodeSessionCode(host: string, port: number): string;
+/**
+ * Decode a session code back to host:port.
+ *
+ * Accepts formats: VIBE-XXXXXXXXXX, vibe-xxxxxxxxxx, or just XXXXXXXXXX
+ */
+declare function decodeSessionCode(code: string): {
+    host: string;
+    port: number;
+};
+/**
+ * Check if a session code is a cloud code (6 chars) vs LAN code (10 chars).
+ *
+ * Cloud codes are 6 alphanumeric characters: VIBE-A3X9K2
+ * LAN codes are 10 alphanumeric characters: VIBE-3R8KW1F0NX
+ */
+declare function isCloudSessionCode(code: string): boolean;
+/** Error for invalid session codes */
+declare class InvalidSessionCodeError extends VibeError {
+    constructor(message: string);
+}
+
+export { type AIToolLauncher as A, type Evaluation as E, GitCloneError as G, type InterviewerGuide as I, type KeySignal as K, type LaunchConfig as L, type ProgressCallback as P, type RecordingData as R, type ScenarioConfig as S, VibeError as V, type ScenarioInfo as a, type LaunchedProcess as b, type StoredSession as c, type AIRules as d, AIToolNotFoundError as e, InvalidSessionCodeError as f, ScenarioConfigSchema as g, ScenarioFetchError as h, ScenarioNotFoundError as i, type ScenarioType as j, ScenarioValidationError as k, type Session as l, type SessionEvent as m, type SessionEventType as n, SessionManager as o, SessionNotFoundError as p, SessionRecorder as q, SetupError as r, decodeSessionCode as s, encodeSessionCode as t, isCloudSessionCode as u, toStoredSession as v };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-interviewing/core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Core library for vibe-interviewing — scenario engine, session management, AI tool launchers",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,13 +9,17 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./network": {
+      "types": "./dist/network/index.d.ts",
+      "default": "./dist/network/index.js"
     }
   },
   "dependencies": {
     "simple-git": "^3.27.0",
     "yaml": "^2.7.0",
     "zod": "^3.24.0",
-    "@vibe-interviewing/scenarios": "0.1.0"
+    "@vibe-interviewing/scenarios": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.0",