raysurfer 1.4.2 → 1.4.3

package/dist/index.js

@@ -1,219 +1,71 @@
 import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
 };
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// src/types.ts
-var ExecutionState;
-((ExecutionState2) => {
-  ExecutionState2["COMPLETED"] = "completed";
-  ExecutionState2["ERRORED"] = "errored";
-  ExecutionState2["TIMED_OUT"] = "timed_out";
-  ExecutionState2["CANCELLED"] = "cancelled";
-})(ExecutionState ||= {});
-var AgentVerdict;
-((AgentVerdict2) => {
-  AgentVerdict2["THUMBS_UP"] = "thumbs_up";
-  AgentVerdict2["THUMBS_DOWN"] = "thumbs_down";
-  AgentVerdict2["PENDING"] = "pending";
-})(AgentVerdict ||= {});
-
-// src/accessible.ts
-function toJsonLike(value) {
-  if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
-    return value;
-  }
-  if (value === undefined) {
-    return null;
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) => toJsonLike(item));
-  }
-  if (typeof value === "object") {
-    const result = {};
-    for (const [key, nested] of Object.entries(value)) {
-      result[key] = toJsonLike(nested);
+// src/errors.ts
+var RaySurferError, APIError, AuthenticationError, CacheUnavailableError, RateLimitError, ValidationError;
+var init_errors = __esm(() => {
+  RaySurferError = class RaySurferError extends Error {
+    constructor(message) {
+      super(message);
+      this.name = "RaySurferError";
     }
-    return result;
-  }
-  return String(value);
-}
-function queueUsageTracking(fn, args, result, durationMs, errorMessage) {
-  const client = fn._raysurferClient;
-  if (!client)
-    return;
-  const codeBlockId = fn._raysurferSchema.codeBlockId ?? `function_registry:${fn._raysurferSchema.name}`;
-  const outputData = errorMessage === undefined ? result : { error: errorMessage };
-  client.storeExecution({
-    codeBlockId,
-    triggeringTask: `agent_accessible:${fn._raysurferSchema.name}`,
-    inputData: {
-      args: toJsonLike(args)
-    },
-    outputData: toJsonLike(outputData),
-    executionState: errorMessage ? "errored" /* ERRORED */ : "completed" /* COMPLETED */,
-    durationMs,
-    errorMessage
-  }).catch(() => {});
-}
-function inferParameters(fn) {
-  const src = fn.toString();
-  const match = /^[^(]*\(([^)]*)\)/.exec(src);
-  const paramStr = match?.[1];
-  if (!paramStr?.trim())
-    return {};
-  const params = {};
-  const parts = paramStr.split(",");
-  for (const part of parts) {
-    const cleaned = part.trim().replace(/\/\*.*?\*\//g, "").replace(/=.*$/, "").replace(/:.*$/, "").trim();
-    if (cleaned && cleaned !== "..." && !cleaned.startsWith("...")) {
-      params[cleaned] = "string";
+  };
+  APIError = class APIError extends RaySurferError {
+    statusCode;
+    constructor(message, statusCode) {
+      super(message);
+      this.name = "APIError";
+      this.statusCode = statusCode;
     }
-  }
-  return params;
-}
-function agentAccessible(fn, options) {
-  const resolvedName = options?.name ?? fn.name ?? "anonymous";
-  const resolvedDescription = options?.description ?? "";
-  const resolvedSchema = options?.inputSchema ?? options?.parameters ?? inferParameters(fn);
-  let marked;
-  const wrapped = (...args) => {
-    const started = Date.now();
-    try {
-      const result = fn(...args);
-      if (result instanceof Promise) {
-        const trackedPromise = result.then((resolved) => {
-          queueUsageTracking(marked, args, resolved, Date.now() - started);
-          return resolved;
-        }).catch((error) => {
-          const message = error instanceof Error ? error.message : String(error);
-          queueUsageTracking(marked, args, null, Date.now() - started, message);
-          throw error;
-        });
-        return trackedPromise;
-      }
-      queueUsageTracking(marked, args, result, Date.now() - started);
-      return result;
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      queueUsageTracking(marked, args, null, Date.now() - started, message);
-      throw error;
+  };
+  AuthenticationError = class AuthenticationError extends RaySurferError {
+    constructor(message = "Invalid API key") {
+      super(message);
+      this.name = "AuthenticationError";
     }
   };
-  marked = wrapped;
-  marked._raysurferAccessible = true;
-  marked._raysurferSchema = {
-    name: resolvedName,
-    description: resolvedDescription,
-    inputSchema: resolvedSchema,
-    parameters: resolvedSchema,
-    source: fn.toString()
+  CacheUnavailableError = class CacheUnavailableError extends RaySurferError {
+    statusCode;
+    constructor(message = "Cache backend is unreachable", statusCode = 503) {
+      super(message);
+      this.name = "CacheUnavailableError";
+      this.statusCode = statusCode;
+    }
   };
-  return marked;
-}
-function toAnthropicTool(fn) {
-  const schema = fn._raysurferSchema;
-  return {
-    name: schema.name,
-    description: schema.description,
-    input_schema: schema.inputSchema
+  RateLimitError = class RateLimitError extends RaySurferError {
+    retryAfter;
+    constructor(message = "Rate limit exceeded", retryAfter) {
+      super(message);
+      this.name = "RateLimitError";
+      this.retryAfter = retryAfter;
+    }
   };
-}
-async function publishFunctionRegistry(client, functions) {
-  const snippetNames = [];
-  for (const fn of functions) {
-    if (!fn._raysurferAccessible)
-      continue;
-    const schema = fn._raysurferSchema;
-    const resp = await client.uploadNewCodeSnip({
-      task: `Call ${schema.name}: ${schema.description}`,
-      fileWritten: { path: `${schema.name}.ts`, content: schema.source },
-      succeeded: true,
-      useRaysurferAiVoting: false,
-      tags: ["function_registry", "agent_accessible"]
-    });
-    if (resp.snippetName) {
-      snippetNames.push(resp.snippetName);
-      schema.codeBlockId = resp.snippetName;
+  ValidationError = class ValidationError extends RaySurferError {
+    field;
+    constructor(message = "Validation failed", field) {
+      super(message);
+      this.name = "ValidationError";
+      this.field = field;
     }
-    setTrackingClient(fn, client);
-  }
-  return snippetNames;
-}
-function setTrackingClient(fn, client) {
-  fn._raysurferClient = client;
-}
-// src/errors.ts
-class RaySurferError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "RaySurferError";
-  }
-}
-
-class APIError extends RaySurferError {
-  statusCode;
-  constructor(message, statusCode) {
-    super(message);
-    this.name = "APIError";
-    this.statusCode = statusCode;
-  }
-}
-
-class AuthenticationError extends RaySurferError {
-  constructor(message = "Invalid API key") {
-    super(message);
-    this.name = "AuthenticationError";
-  }
-}
-
-class CacheUnavailableError extends RaySurferError {
-  statusCode;
-  constructor(message = "Cache backend is unreachable", statusCode = 503) {
-    super(message);
-    this.name = "CacheUnavailableError";
-    this.statusCode = statusCode;
-  }
-}
-
-class RateLimitError extends RaySurferError {
-  retryAfter;
-  constructor(message = "Rate limit exceeded", retryAfter) {
-    super(message);
-    this.name = "RateLimitError";
-    this.retryAfter = retryAfter;
-  }
-}
-
-class ValidationError extends RaySurferError {
-  field;
-  constructor(message = "Validation failed", field) {
-    super(message);
-    this.name = "ValidationError";
-    this.field = field;
-  }
-}
+  };
+});
 
 // src/client.ts
-var VERSION = "1.4.0";
-var DEFAULT_BASE_URL = "https://api.raysurfer.com";
-var MAX_RETRIES = 3;
-var RETRY_BASE_DELAY = 500;
-var RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
 function normalizeDependencies(rawDeps) {
   if (!rawDeps)
     return {};
@@ -385,6 +237,9 @@ class RaySurfer {
     if (typeof taskOrOptions === "object") {
       opts = taskOrOptions;
     } else {
+      if (!fileWritten || succeeded === undefined) {
+        throw new Error("fileWritten and succeeded are required when using positional arguments");
+      }
       opts = {
         task: taskOrOptions,
         fileWritten,
@@ -400,6 +255,9 @@ class RaySurfer {
         voteCount
       };
     }
+    if (opts.repoPath || opts.githubUrl) {
+      return this.uploadRepo(opts);
+    }
     if (opts.fileWritten && opts.filesWritten) {
       throw new Error("Provide either fileWritten or filesWritten, not both.");
     }
@@ -411,7 +269,7 @@ class RaySurfer {
       normalizedFiles.push(...opts.filesWritten);
     }
     if (normalizedFiles.length === 0) {
-      throw new Error("Missing required file input: provide fileWritten or filesWritten.");
+      throw new Error("Missing required file input: provide fileWritten, filesWritten, repoPath, or githubUrl.");
     }
     if (normalizedFiles.length > 1) {
       const responses = [];
@@ -449,7 +307,8 @@ class RaySurfer {
       public: opts.public || undefined,
       vote_source: opts.voteSource,
       vote_count: opts.voteCount,
-      per_function_reputation: opts.perFunctionReputation || undefined
+      per_function_reputation: opts.perFunctionReputation || undefined,
+      content_type: opts.contentType
     };
     const result = await this.request("POST", "/api/store/execution-result", data, this.workspaceHeaders(opts.workspaceId));
     return {
@@ -459,6 +318,63 @@ class RaySurfer {
       snippetName: result.snippet_name ?? null
     };
   }
+  async uploadRepo(opts) {
+    const files = [];
+    if (opts.repoPath) {
+      const fs = await import("node:fs");
+      const path = await import("node:path");
+      const skipDirs = new Set([
+        ".git",
+        "__pycache__",
+        "node_modules",
+        ".venv",
+        "venv",
+        ".tox",
+        "dist",
+        "build"
+      ]);
+      const walkDir = (dir, base) => {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+          if (skipDirs.has(entry.name))
+            continue;
+          const fullPath = path.join(dir, entry.name);
+          const relPath = path.join(base, entry.name);
+          if (entry.isDirectory()) {
+            walkDir(fullPath, relPath);
+          } else if (entry.isFile()) {
+            try {
+              const content = fs.readFileSync(fullPath, "utf-8");
+              files.push({ path: relPath, content });
+            } catch {}
+          }
+        }
+      };
+      walkDir(opts.repoPath, "");
+    }
+    const requestData = {
+      task: opts.task,
+      files
+    };
+    if (opts.githubUrl) {
+      requestData.github_url = opts.githubUrl;
+    }
+    if (opts.dependencies) {
+      requestData.dependencies = opts.dependencies;
+    }
+    if (opts.tags) {
+      requestData.tags = opts.tags;
+    }
+    if (opts.contentType) {
+      requestData.content_type = opts.contentType;
+    }
+    const result = await this.request("POST", "/api/store/repo", requestData, this.workspaceHeaders(opts.workspaceId));
+    return {
+      success: result.success,
+      codeBlocksStored: result.success ? 1 : 0,
+      message: result.message,
+      snippetName: result.repo_id ?? null
+    };
+  }
   uploadNewCodeSnip = this.upload.bind(this);
   uploadNewCodeSnips = this.upload.bind(this);
   async delete(snippetId, options) {
@@ -474,6 +390,9 @@ class RaySurfer {
     if (!Array.isArray(promptsOrOptions)) {
       opts = promptsOrOptions;
     } else {
+      if (!filesWritten) {
+        throw new Error("filesWritten is required when using positional arguments");
+      }
       opts = {
         prompts: promptsOrOptions,
         filesWritten,
@@ -526,6 +445,12 @@ class RaySurfer {
     if (params.perFunctionReputation) {
       data.per_function_reputation = true;
     }
+    if (params.resultType && params.resultType !== "any") {
+      data.result_type = params.resultType;
+    }
+    if (params.contentType) {
+      data.content_type = params.contentType;
+    }
     const result = await this.request("POST", "/api/retrieve/search", data, this.workspaceHeaders(params.workspaceId));
     return {
       matches: result.matches.map((m) => {
@@ -563,7 +488,13 @@ class RaySurfer {
           dependencies: normalizeDependencies(m.dependencies),
           agentId: m.agent_id ?? null,
           comments: m.comments ?? [],
-          functions
+          functions,
+          type: m.type ?? "file",
+          downloadUrl: m.download_url ?? null,
+          fileTree: m.file_tree ?? null,
+          fileCount: m.file_count ?? null,
+          framework: m.framework ?? null,
+          readmePreview: m.readme_preview ?? null
         };
       }),
       totalFound: result.total_found,
@@ -716,7 +647,7 @@ class RaySurfer {
 
 ## IMPORTANT: Pre-validated Code Files Available
 `,
-      "The following validated code has been retrieved from the cache. " + `Use these files directly instead of regenerating code.
+      `The following validated code has been retrieved from the cache. Use these files directly instead of regenerating code.
 `
     ];
     for (const f of files) {
@@ -851,6 +782,35 @@ class RaySurfer {
       hasMore: response.has_more
     };
   }
+  async log(params) {
+    const response = await this.request("POST", "/api/logs/ingest", {
+      log_hash: params.logHash,
+      value: params.value,
+      source: params.source ?? "",
+      scope: params.scope ?? "",
+      run_id: params.runId ?? "",
+      metadata: params.metadata ?? {}
+    });
+    return response.log_hash;
+  }
+  async getLog(logHash, limit = 50) {
+    const response = await this.request("GET", `/api/logs/hash/${logHash}`, { limit });
+    return {
+      logHash: response.log_hash,
+      source: response.source,
+      totalEvents: response.total_events,
+      recentEvents: response.recent_events.map((e) => ({
+        id: e.id,
+        logHash: e.log_hash,
+        source: e.source,
+        value: e.value,
+        preview: e.preview,
+        runId: e.run_id,
+        metadata: e.metadata,
+        loggedAt: e.logged_at
+      }))
+    };
+  }
   async voteCodeSnip(params) {
     const data = {
       task: params.task,
@@ -1067,6 +1027,35 @@ class RaySurfer {
       codegen
     });
   }
+  async chat(query, options) {
+    const response = await this.request("POST", "/api/agent-chat", {
+      user_query: query,
+      user_id: options.user,
+      org_id: options.org,
+      model: options.model ?? "sonnet",
+      max_turns: options.maxTurns ?? 8
+    });
+    return {
+      success: response.success,
+      output: response.output,
+      error: response.error,
+      sessionId: response.session_id,
+      durationMs: response.duration_ms,
+      changedFiles: response.changed_files ?? [],
+      workspaceFiles: response.org_workspace_files ?? []
+    };
+  }
+  async heartbeat(options) {
+    return this.request("POST", "/api/agents/heartbeat", {
+      agent_id: options.agentId,
+      agent_name: options.agentName,
+      status: options.status ?? "running",
+      current_task: options.currentTask,
+      cpu_percent: options.cpuPercent,
+      memory_percent: options.memoryPercent,
+      metadata: options.metadata
+    });
+  }
   async publishFunctionRegistry(functions) {
     const snippetNames = [];
     for (const fn of functions) {
@@ -1115,53 +1104,733 @@ class RaySurfer {
     };
   }
 }
-var client_default = RaySurfer;
-
-// src/agent.ts
-var DEFAULT_CODEGEN_MODEL = "claude-opus-4-6";
-var DEFAULT_EXECUTION_TIMEOUT_MS = 300000;
-var CODEGEN_DOCS_URL = "https://docs.raysurfer.com/sdk/typescript#programmatic-tool-calling";
-function missingCodegenKeyError(value) {
-  return new Error(`Invalid codegenApiKey value: ${String(value)}. Expected format: non-empty provider API key string. ` + "Current tier/state: tier=unknown, codegen_api_key_missing=true (not configured on app and not provided at call-time). " + `Fix: pass codegenApiKey in app config or run(...). Docs: ${CODEGEN_DOCS_URL}`);
-}
-function invalidCodegenPromptError(value) {
-  return new Error(`Invalid codegenPrompt value: ${String(value)}. Expected format: non-empty prompt string. ` + "Current tier/state: tier=unknown, codegen_prompt_invalid=true. " + `Fix: pass codegenPrompt or provide a non-empty task. Docs: ${CODEGEN_DOCS_URL}`);
-}
+var VERSION = "1.4.3", DEFAULT_BASE_URL = "https://api.raysurfer.com", MAX_RETRIES = 3, RETRY_BASE_DELAY = 500, RETRYABLE_STATUS_CODES, client_default;
+var init_client = __esm(() => {
+  init_errors();
+  RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
+  client_default = RaySurfer;
+});
 
-class CodegenApp {
-  _raysurfer;
-  _defaultCodegenApiKey;
-  _defaultCodegenModel;
-  _defaultExecutionTimeoutMs;
-  constructor(options = {}) {
-    const {
-      raysurfer,
-      codegenApiKey,
-      codegenModel,
-      executionTimeoutMs,
-      ...clientOptions
-    } = options;
-    this._raysurfer = raysurfer ?? new client_default(clientOptions);
-    this._defaultCodegenApiKey = codegenApiKey;
-    this._defaultCodegenModel = codegenModel ?? DEFAULT_CODEGEN_MODEL;
-    this._defaultExecutionTimeoutMs = executionTimeoutMs ?? DEFAULT_EXECUTION_TIMEOUT_MS;
+// src/sdk-client.ts
+var exports_sdk_client = {};
+__export(exports_sdk_client, {
+  query: () => query,
+  default: () => sdk_client_default,
+  RaysurferOpencodeClient: () => ClaudeSDKClient,
+  RaysurferClient: () => ClaudeSDKClient,
+  ClaudeSDKClient: () => ClaudeSDKClient
+});
+import { existsSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
+import { join } from "node:path";
+function resolveRunParseSampleRate(configured) {
+  if (configured !== undefined) {
+    if (!Number.isFinite(configured) || configured < 0 || configured > 1) {
+      throw new Error(`runParseSampleRate must be between 0.0 and 1.0 inclusive; got ${configured}.`);
+    }
+    return configured;
   }
-  get raysurfer() {
-    return this._raysurfer;
+  const envValue = process.env[RUN_PARSE_SAMPLE_RATE_ENV_VAR];
+  if (!envValue || envValue.trim() === "") {
+    return DEFAULT_RUN_PARSE_SAMPLE_RATE;
   }
-  tool(name, description, parameters, callback) {
-    this._raysurfer.tool(name, description, parameters, callback);
-    return this;
+  const parsed = Number(envValue);
+  if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+    console.warn(`[raysurfer] ${RUN_PARSE_SAMPLE_RATE_ENV_VAR}=${JSON.stringify(envValue)} is invalid. ` + `Expected a number between 0.0 and 1.0 inclusive. Falling back to ${DEFAULT_RUN_PARSE_SAMPLE_RATE}.`);
+    return DEFAULT_RUN_PARSE_SAMPLE_RATE;
   }
-  async run(task, options = {}) {
-    const codegenApiKey = this.resolveCodegenApiKey(options.codegenApiKey);
-    const codegenPrompt = this.resolveCodegenPrompt(task, options.codegenPrompt);
-    const codegenModel = options.codegenModel ?? this._defaultCodegenModel;
-    const timeout = options.executionTimeoutMs ?? this._defaultExecutionTimeoutMs;
-    return this._raysurfer.executeWithSandboxCodegen(task, {
-      provider: "anthropic",
-      apiKey: codegenApiKey,
-      prompt: codegenPrompt,
+  return parsed;
+}
+function shouldParseRunForAiVoting(sampleRate) {
+  if (sampleRate >= 1)
+    return true;
+  if (sampleRate <= 0)
+    return false;
+  return Math.random() < sampleRate;
+}
+function augmentSystemPrompt(systemPrompt, addition) {
+  if (!addition)
+    return systemPrompt;
+  if (typeof systemPrompt === "string")
+    return systemPrompt + addition;
+  if (systemPrompt?.type === "preset") {
+    return { ...systemPrompt, append: (systemPrompt.append ?? "") + addition };
+  }
+  return addition;
+}
+function splitOptions(options) {
+  const {
+    workspaceId,
+    publicSnips,
+    debug,
+    runParseSampleRate,
+    workingDirectory,
+    agentId,
+    ...sdkOptions
+  } = options;
+  return {
+    sdkOptions,
+    extras: {
+      workspaceId,
+      publicSnips,
+      debug,
+      runParseSampleRate,
+      workingDirectory,
+      agentId
+    }
+  };
+}
+function applyDefaultAgentCompatibilityOptions(options) {
+  const merged = { ...options };
+  const hasToolsPreset = merged.tools !== undefined && merged.tools !== null;
+  const hasAllowedTools = Array.isArray(merged.allowedTools) && merged.allowedTools.length > 0;
+  if (!hasToolsPreset && !hasAllowedTools) {
+    merged.tools = DEFAULT_AGENT_COMPAT_TOOLS_PRESET;
+  }
+  if (merged.sandbox && typeof merged.sandbox === "object") {
+    merged.sandbox = {
+      ...DEFAULT_SANDBOX_SETTINGS,
+      ...merged.sandbox
+    };
+  } else {
+    merged.sandbox = { ...DEFAULT_SANDBOX_SETTINGS };
+  }
+  return merged;
+}
+function query(params) {
+  return new RaysurferQuery(params);
+}
+
+class ClaudeSDKClient {
+  options;
+  constructor(options = {}) {
+    this.options = options;
+  }
+  query(prompt) {
+    return query({ prompt, options: this.options });
+  }
+}
+var DEFAULT_RAYSURFER_URL = "https://api.raysurfer.com", CACHE_DIR = ".raysurfer_code", DEFAULT_RUN_PARSE_SAMPLE_RATE = 1, RUN_PARSE_SAMPLE_RATE_ENV_VAR = "RAYSURFER_RUN_PARSE_SAMPLE_RATE", DEFAULT_AGENT_COMPAT_TOOLS_PRESET, DEFAULT_SANDBOX_SETTINGS, FILE_MODIFY_TOOLS, TRACKABLE_EXTENSIONS, BASH_OUTPUT_PATTERNS, createDebugLogger = (enabled) => ({
+  log: (...args) => enabled && console.log("[raysurfer]", ...args),
+  time: (label) => enabled && console.time(`[raysurfer] ${label}`),
+  timeEnd: (label) => enabled && console.timeEnd(`[raysurfer] ${label}`),
+  table: (data) => enabled && console.table(data),
+  group: (label) => enabled && console.group(`[raysurfer] ${label}`),
+  groupEnd: () => enabled && console.groupEnd()
+}), RaysurferQuery, sdk_client_default;
+var init_sdk_client = __esm(() => {
+  init_client();
+  DEFAULT_AGENT_COMPAT_TOOLS_PRESET = {
+    type: "preset",
+    preset: "claude_code"
+  };
+  DEFAULT_SANDBOX_SETTINGS = {
+    enabled: true,
+    autoAllowBashIfSandboxed: true
+  };
+  FILE_MODIFY_TOOLS = ["Write", "Edit", "MultiEdit", "NotebookEdit"];
+  TRACKABLE_EXTENSIONS = new Set([
+    ".py",
+    ".js",
+    ".ts",
+    ".rb",
+    ".go",
+    ".rs",
+    ".java",
+    ".cpp",
+    ".c",
+    ".h",
+    ".pdf",
+    ".docx",
+    ".xlsx",
+    ".csv",
+    ".json",
+    ".yaml",
+    ".yml",
+    ".xml",
+    ".html",
+    ".css",
+    ".md",
+    ".txt",
+    ".sh",
+    ".sql"
+  ]);
+  BASH_OUTPUT_PATTERNS = [
+    />>\s*([^\s;&|]+)/g,
+    />\s*([^\s;&|]+)/g,
+    /-o\s+([^\s;&|]+)/g,
+    /--output[=\s]+([^\s;&|]+)/g,
+    /savefig\(['"]([^'"]+)['"]\)/g,
+    /to_csv\(['"]([^'"]+)['"]\)/g,
+    /to_excel\(['"]([^'"]+)['"]\)/g,
+    /write\(['"]([^'"]+)['"]\)/g
+  ];
+  RaysurferQuery = class RaysurferQuery {
+    _inner = null;
+    _initPromise = null;
+    _raysurfer = null;
+    _cachedFiles = [];
+    _modifiedFilePaths = new Set;
+    _bashGeneratedFiles = new Set;
+    _executionLogs = [];
+    _taskSucceeded = false;
+    _generatedCodeBlocks = [];
+    _cacheUploadDone = false;
+    _messageCount = 0;
+    _startTime = 0;
+    _promptText;
+    _params;
+    _debug;
+    _cacheEnabled;
+    _workDir;
+    _apiKey;
+    _baseUrl;
+    _extras;
+    _sdkOptions;
+    _runParseSampleRate;
+    _parseRunForAiVoting;
+    constructor(params) {
+      this._params = params;
+      const options = params.options ?? {};
+      const { sdkOptions, extras } = splitOptions(options);
+      this._sdkOptions = applyDefaultAgentCompatibilityOptions(sdkOptions);
+      this._extras = extras;
+      this._promptText = typeof params.prompt === "string" ? params.prompt : null;
+      const debugEnabled = extras.debug || process.env.RAYSURFER_DEBUG === "true";
+      this._debug = createDebugLogger(debugEnabled);
+      this._apiKey = process.env.RAYSURFER_API_KEY;
+      this._baseUrl = process.env.RAYSURFER_BASE_URL || DEFAULT_RAYSURFER_URL;
+      this._cacheEnabled = !!this._apiKey;
+      this._runParseSampleRate = resolveRunParseSampleRate(extras.runParseSampleRate);
+      this._parseRunForAiVoting = shouldParseRunForAiVoting(this._runParseSampleRate);
+      if (extras.workingDirectory && !sdkOptions.cwd) {
+        console.warn("[raysurfer] workingDirectory is deprecated, use cwd instead");
+        this._sdkOptions.cwd = extras.workingDirectory;
+      }
+      this._workDir = this._sdkOptions.cwd || process.cwd();
+    }
+    async _initialize() {
+      this._debug.group("Raysurfer Query Started");
+      this._debug.log("Prompt:", this._promptText ?? "<stream>");
+      this._debug.log("Cache enabled:", this._cacheEnabled);
+      this._debug.log("Base URL:", this._baseUrl);
+      this._debug.log("Run parse sample rate:", this._runParseSampleRate);
+      this._debug.log("Parse this run for AI voting:", this._parseRunForAiVoting);
+      if (!this._cacheEnabled) {
+        console.warn("[raysurfer] RAYSURFER_API_KEY not set - caching disabled");
+      }
+      let addToLlmPrompt = "";
+      if (this._cacheEnabled && this._promptText) {
+        this._raysurfer = new RaySurfer({
+          apiKey: this._apiKey,
+          baseUrl: this._baseUrl,
+          workspaceId: this._extras.workspaceId,
+          snipsDesired: this._extras.workspaceId ? "client" : undefined,
+          publicSnips: this._extras.publicSnips,
+          agentId: this._extras.agentId
+        });
+        try {
+          this._debug.time("Cache lookup");
+          const cacheDir = join(this._workDir, CACHE_DIR);
+          const response = await this._raysurfer.getCodeFiles({
+            task: this._promptText,
+            topK: 5,
+            minVerdictScore: 0.3,
+            preferComplete: true,
+            perFunctionReputation: true,
+            cacheDir
+          });
+          this._debug.timeEnd("Cache lookup");
+          this._cachedFiles = response.files;
+          addToLlmPrompt = response.addToLlmPrompt;
+          this._debug.log(`Found ${this._cachedFiles.length} cached files:`);
+          console.log("[raysurfer] Cache hit:", this._cachedFiles.length, "snippets retrieved");
+          if (this._cachedFiles.length > 0) {
+            this._debug.table(this._cachedFiles.map((f) => ({
+              filename: f.filename,
+              score: `${Math.round(f.score * 100)}%`,
+              thumbs: `${f.thumbsUp}/${f.thumbsDown}`,
+              sourceLength: `${f.source.length} chars`
+            })));
+            try {
+              mkdirSync(cacheDir, { recursive: true });
+              for (const file of this._cachedFiles) {
+                const filePath = join(cacheDir, file.filename);
+                writeFileSync(filePath, file.source, "utf-8");
+                this._debug.log(`  → Wrote cached file: ${filePath}`);
+                this._modifiedFilePaths.add(filePath);
+              }
+            } catch (writeErr) {
+              this._debug.log("Failed to write cached files:", writeErr instanceof Error ? writeErr : String(writeErr));
+            }
+          }
+        } catch (error) {
+          const errMsg = error instanceof Error ? error.message : String(error);
+          this._debug.log("Cache lookup failed:", errMsg);
+          console.warn("[raysurfer] Cache unavailable:", errMsg);
+        }
+      }
+      const augmented = augmentSystemPrompt(this._sdkOptions.systemPrompt, addToLlmPrompt);
+      const augmentedOptions = {
+        ...this._sdkOptions,
+        systemPrompt: augmented
+      };
+      this._debug.log("Augmented prompt addition:", addToLlmPrompt.length, "chars");
+      let sdkQueryFn;
+      try {
+        const sdk = await import("@anthropic-ai/claude-agent-sdk");
+        sdkQueryFn = sdk.query;
+      } catch {
+        throw new Error("Could not import @anthropic-ai/claude-agent-sdk. Install it with: npm install @anthropic-ai/claude-agent-sdk");
+      }
+      this._debug.time("Claude API call");
+      this._debug.log("Calling Claude Agent SDK...");
+      this._startTime = Date.now();
+      this._inner = sdkQueryFn({
+        prompt: this._params.prompt,
+        options: augmentedOptions
+      });
+    }
+    async _ensureInit() {
+      if (!this._inner) {
+        if (!this._initPromise) {
+          this._initPromise = this._initialize();
+        }
+        await this._initPromise;
+      }
+      return this._inner;
+    }
+    _extractBashOutputFiles(command) {
+      for (const pattern of BASH_OUTPUT_PATTERNS) {
+        pattern.lastIndex = 0;
+        let match = pattern.exec(command);
+        while (match !== null) {
+          const filePath = match[1];
+          if (filePath && filePath.length > 0) {
+            const ext = filePath.substring(filePath.lastIndexOf(".")).toLowerCase();
+            if (TRACKABLE_EXTENSIONS.has(ext)) {
+              this._bashGeneratedFiles.add(filePath);
+              this._debug.log(`  → Bash output file detected: ${filePath}`);
+            }
+          }
+          match = pattern.exec(command);
+        }
+      }
+    }
+    _trackMessage(message) {
+      this._messageCount++;
+      const msg = message;
+      const elapsed = Date.now() - this._startTime;
+      this._debug.log(`
+═══════════════════════════════════════════════════`);
+      this._debug.log(`Message #${this._messageCount} [${elapsed}ms] type=${msg.type} subtype=${msg.subtype ?? "none"}`);
+      this._debug.log(`═══════════════════════════════════════════════════`);
+      this._debug.log(JSON.stringify(msg, null, 2));
+      if (msg.type === "assistant" && msg.message?.content) {
+        const blocks = msg.message.content;
+        for (const block of blocks) {
+          if (block.type === "tool_use" && block.name && FILE_MODIFY_TOOLS.includes(block.name)) {
+            const filePath = block.input?.file_path ?? block.input?.notebook_path;
+            if (filePath) {
+              this._debug.log(`  → ${block.name} tool detected:`, filePath);
+              this._modifiedFilePaths.add(filePath);
+            }
+          }
+          if (block.type === "tool_use" && block.name === "Bash") {
+            const command = block.input?.command;
+            if (command) {
+              this._extractBashOutputFiles(command);
+            }
+          }
+          if (block.type === "tool_result" && block.content) {
+            if (this._parseRunForAiVoting) {
+              this._executionLogs.push(block.content.slice(0, 5000));
+            }
+          }
+          if (block.type === "text" && block.text) {
+            const codeMatches = block.text.match(/```(?:typescript|javascript|ts|js)?\n?([\s\S]*?)\n?```/g);
+            if (codeMatches) {
+              for (const match of codeMatches) {
+                const code = match.replace(/```(?:typescript|javascript|ts|js)?\n?/, "").replace(/\n?```$/, "");
+                if (code.trim().length > 50) {
+                  this._generatedCodeBlocks.push(code.trim());
+                  this._debug.log(`  → Extracted code block (${code.length} chars)`);
+                }
+              }
+            }
+          }
+        }
+      }
+      if (msg.type === "result" && msg.subtype === "success") {
+        this._taskSucceeded = true;
+        this._debug.timeEnd("Claude API call");
+        this._debug.log("Task succeeded!");
+        this._debug.log("  Duration:", msg.duration_ms, "ms");
+        this._debug.log("  Total cost:", msg.total_cost_usd, "USD");
+        this._debug.log("  Turns:", msg.num_turns);
+      }
+      if (msg.type === "result" && msg.subtype !== "success") {
+        this._debug.timeEnd("Claude API call");
+        this._debug.log("Task failed:", msg.subtype);
+      }
+    }
+    async _uploadCache() {
+      if (this._cacheUploadDone)
+        return;
+      this._cacheUploadDone = true;
+      this._debug.log("Total messages streamed:", this._messageCount);
+      this._debug.log("Modified files tracked:", this._modifiedFilePaths.size);
+      this._debug.log("Code blocks extracted:", this._generatedCodeBlocks.length);
+      const filesToCache = [];
+      for (const filePath of this._modifiedFilePaths) {
+        if (filePath.includes(CACHE_DIR)) {
+          this._debug.log("  → Skipping cached file:", filePath);
+          continue;
+        }
+        try {
+          if (existsSync(filePath)) {
+            const content = readFileSync2(filePath, "utf-8");
+            if (content.includes("\x00")) {
+              this._debug.log("  → Skipping binary file:", filePath);
+              continue;
+            }
+            filesToCache.push({ path: filePath, content });
+            this._debug.log("  → Will cache file:", filePath, `(${content.length} chars)`);
+          } else {
+            this._debug.log("  → File not found:", filePath);
+          }
+        } catch (err) {
+          this._debug.log("  → Failed to read file:", filePath, err instanceof Error ? err : String(err));
+        }
+      }
+      for (const filePath of this._bashGeneratedFiles) {
+        if (this._modifiedFilePaths.has(filePath))
+          continue;
+        try {
+          if (existsSync(filePath)) {
+            const content = readFileSync2(filePath, "utf-8");
+            if (!content.includes("\x00")) {
+              filesToCache.push({ path: filePath, content });
+              this._debug.log("  → Will cache Bash-generated file:", filePath, `(${content.length} chars)`);
+            }
+          }
+        } catch {
+          this._debug.log("  → Failed to read Bash-generated file:", filePath);
+        }
+      }
+      if (this._generatedCodeBlocks.length > 0) {
+        const largestBlock = this._generatedCodeBlocks.reduce((a, b) => a.length > b.length ? a : b);
+        filesToCache.push({
+          path: "generated-code.ts",
+          content: largestBlock
+        });
+        this._debug.log("  → Will cache generated code block:", `(${largestBlock.length} chars)`);
+      }
+      this._debug.log("Total items to cache:", filesToCache.length);
+      if (this._cacheEnabled && this._raysurfer && this._taskSucceeded && this._promptText) {
+        const cachedBlocksForVoting = this._parseRunForAiVoting ? this._cachedFiles.map((f) => ({
+          codeBlockId: f.codeBlockId,
+          filename: f.filename,
+          description: f.description
+        })) : [];
+        if (filesToCache.length > 0 || cachedBlocksForVoting.length > 0) {
+          try {
+            this._debug.time("Cache upload + voting");
+            if (!this._parseRunForAiVoting) {
+              this._debug.log("Skipping AI voting parse for this run due sampling");
+            }
+            const joinedLogs = this._parseRunForAiVoting && this._executionLogs.length > 0 ? this._executionLogs.join(`
+---
+`) : undefined;
+            this._debug.log("Uploading", filesToCache.length, "files, voting for", cachedBlocksForVoting.length, "cached blocks,", this._executionLogs.length, "log entries...");
+            for (const [i, file] of filesToCache.entries()) {
+              await this._raysurfer.uploadNewCodeSnip({
+                task: this._promptText,
+                fileWritten: file,
+                succeeded: true,
+                cachedCodeBlocks: i === 0 && cachedBlocksForVoting.length > 0 ? cachedBlocksForVoting : undefined,
+                useRaysurferAiVoting: this._parseRunForAiVoting,
+                executionLogs: joinedLogs,
+                perFunctionReputation: true
+              });
+            }
+            if (filesToCache.length === 0 && cachedBlocksForVoting.length > 0) {
+              for (const cb of cachedBlocksForVoting) {
+                await this._raysurfer.voteCodeSnip({
+                  task: this._promptText,
+                  codeBlockId: cb.codeBlockId,
+                  codeBlockName: cb.filename,
+                  codeBlockDescription: cb.description,
+                  succeeded: true
+                });
+              }
+            }
+            this._debug.timeEnd("Cache upload + voting");
+            this._debug.log("Cache upload successful, voting queued on backend");
+            console.log("[raysurfer] Cache upload successful:", filesToCache.length, "files stored");
+          } catch (error) {
+            const errMsg = error instanceof Error ? error.message : String(error);
+            this._debug.log("Cache upload failed:", errMsg);
+            console.warn("[raysurfer] Cache upload failed:", errMsg);
+          }
+        }
+      }
+      this._debug.groupEnd();
+    }
+    async next(...args) {
+      const inner = await this._ensureInit();
+      const result = await inner.next(...args);
+      if (!result.done) {
+        this._trackMessage(result.value);
+      } else {
+        await this._uploadCache();
+      }
+      return result;
+    }
+    async return(value) {
+      if (this._inner) {
+        await this._uploadCache();
+        return this._inner.return(value);
+      }
+      return { done: true, value: undefined };
+    }
+    async throw(e) {
+      if (this._inner)
+        return this._inner.throw(e);
+      throw e;
+    }
+    [Symbol.asyncIterator]() {
+      return this;
+    }
+    async[Symbol.asyncDispose]() {
+      this.close();
+    }
+    async interrupt() {
+      return (await this._ensureInit()).interrupt();
+    }
+    async setPermissionMode(mode) {
+      return (await this._ensureInit()).setPermissionMode(mode);
+    }
+    async setModel(model) {
+      return (await this._ensureInit()).setModel(model);
+    }
+    async setMaxThinkingTokens(maxThinkingTokens) {
+      return (await this._ensureInit()).setMaxThinkingTokens(maxThinkingTokens);
+    }
+    async supportedCommands() {
+      return (await this._ensureInit()).supportedCommands();
+    }
+    async supportedModels() {
+      return (await this._ensureInit()).supportedModels();
+    }
+    async mcpServerStatus() {
+      return (await this._ensureInit()).mcpServerStatus();
+    }
+    async accountInfo() {
+      return (await this._ensureInit()).accountInfo();
+    }
+    async rewindFiles(userMessageId, options) {
+      return (await this._ensureInit()).rewindFiles(userMessageId, options);
+    }
+    async setMcpServers(servers) {
+      return (await this._ensureInit()).setMcpServers(servers);
+    }
+    async streamInput(stream) {
+      return (await this._ensureInit()).streamInput(stream);
+    }
+    close() {
+      if (this._inner)
+        this._inner.close();
+    }
+  };
+  sdk_client_default = query;
+});
+
+// src/types.ts
+var ExecutionState;
+((ExecutionState2) => {
+  ExecutionState2["COMPLETED"] = "completed";
+  ExecutionState2["ERRORED"] = "errored";
+  ExecutionState2["TIMED_OUT"] = "timed_out";
+  ExecutionState2["CANCELLED"] = "cancelled";
+})(ExecutionState ||= {});
+var AgentVerdict;
+((AgentVerdict2) => {
+  AgentVerdict2["THUMBS_UP"] = "thumbs_up";
+  AgentVerdict2["THUMBS_DOWN"] = "thumbs_down";
+  AgentVerdict2["PENDING"] = "pending";
+})(AgentVerdict ||= {});
+
+// src/accessible.ts
+function toJsonLike(value) {
+  if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (value === undefined) {
+    return null;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => toJsonLike(item));
+  }
+  if (typeof value === "object") {
+    const result = {};
+    for (const [key, nested] of Object.entries(value)) {
+      result[key] = toJsonLike(nested);
+    }
+    return result;
+  }
+  return String(value);
+}
+function queueUsageTracking(fn, args, result, durationMs, errorMessage) {
+  const client = fn._raysurferClient;
+  if (!client)
+    return;
+  const codeBlockId = fn._raysurferSchema.codeBlockId ?? `function_registry:${fn._raysurferSchema.name}`;
+  const outputData = errorMessage === undefined ? result : { error: errorMessage };
+  client.storeExecution({
+    codeBlockId,
+    triggeringTask: `agent_accessible:${fn._raysurferSchema.name}`,
+    inputData: {
+      args: toJsonLike(args)
+    },
+    outputData: toJsonLike(outputData),
+    executionState: errorMessage ? "errored" /* ERRORED */ : "completed" /* COMPLETED */,
+    durationMs,
+    errorMessage
+  }).catch(() => {});
+}
+function inferParameters(fn) {
+  const src = fn.toString();
+  const match = /^[^(]*\(([^)]*)\)/.exec(src);
+  const paramStr = match?.[1];
+  if (!paramStr?.trim())
+    return {};
+  const params = {};
+  const parts = paramStr.split(",");
+  for (const part of parts) {
+    const cleaned = part.trim().replace(/\/\*.*?\*\//g, "").replace(/=.*$/, "").replace(/:.*$/, "").trim();
+    if (cleaned && cleaned !== "..." && !cleaned.startsWith("...")) {
+      params[cleaned] = "string";
+    }
+  }
+  return params;
+}
+function agentAccessible(fn, options) {
+  const resolvedName = options?.name ?? fn.name ?? "anonymous";
+  const resolvedDescription = options?.description ?? "";
+  const resolvedSchema = options?.inputSchema ?? options?.parameters ?? inferParameters(fn);
+  let marked;
+  const wrapped = (...args) => {
+    const started = Date.now();
+    try {
+      const result = fn(...args);
+      if (result instanceof Promise) {
+        const trackedPromise = result.then((resolved) => {
+          queueUsageTracking(marked, args, resolved, Date.now() - started);
+          return resolved;
+        }).catch((error) => {
+          const message = error instanceof Error ? error.message : String(error);
+          queueUsageTracking(marked, args, null, Date.now() - started, message);
+          throw error;
+        });
+        return trackedPromise;
+      }
+      queueUsageTracking(marked, args, result, Date.now() - started);
+      return result;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      queueUsageTracking(marked, args, null, Date.now() - started, message);
+      throw error;
+    }
+  };
+  marked = wrapped;
+  marked._raysurferAccessible = true;
+  marked._raysurferSchema = {
+    name: resolvedName,
+    description: resolvedDescription,
+    inputSchema: resolvedSchema,
+    parameters: resolvedSchema,
+    source: fn.toString()
+  };
+  return marked;
+}
+function toAnthropicTool(fn) {
+  const schema = fn._raysurferSchema;
+  return {
+    name: schema.name,
+    description: schema.description,
+    input_schema: schema.inputSchema
+  };
+}
+async function publishFunctionRegistry(client, functions) {
+  const snippetNames = [];
+  for (const fn of functions) {
+    if (!fn._raysurferAccessible)
+      continue;
+    const schema = fn._raysurferSchema;
+    const resp = await client.uploadNewCodeSnip({
+      task: `Call ${schema.name}: ${schema.description}`,
+      fileWritten: { path: `${schema.name}.ts`, content: schema.source },
+      succeeded: true,
+      useRaysurferAiVoting: false,
+      tags: ["function_registry", "agent_accessible"]
+    });
+    if (resp.snippetName) {
+      snippetNames.push(resp.snippetName);
+      schema.codeBlockId = resp.snippetName;
+    }
+    setTrackingClient(fn, client);
+  }
+  return snippetNames;
+}
+function setTrackingClient(fn, client) {
+  fn._raysurferClient = client;
+}
+// src/agent.ts
+init_client();
+var DEFAULT_CODEGEN_MODEL = "claude-opus-4-6";
+var DEFAULT_EXECUTION_TIMEOUT_MS = 300000;
+var CODEGEN_DOCS_URL = "https://docs.raysurfer.com/sdk/typescript#programmatic-tool-calling";
+function missingCodegenKeyError(value) {
+  return new Error(`Invalid codegenApiKey value: ${String(value)}. Expected format: non-empty provider API key string. ` + "Current tier/state: tier=unknown, codegen_api_key_missing=true (not configured on app and not provided at call-time). " + `Fix: pass codegenApiKey in app config or run(...). Docs: ${CODEGEN_DOCS_URL}`);
+}
+function invalidCodegenPromptError(value) {
+  return new Error(`Invalid codegenPrompt value: ${String(value)}. Expected format: non-empty prompt string. ` + "Current tier/state: tier=unknown, codegen_prompt_invalid=true. " + `Fix: pass codegenPrompt or provide a non-empty task. Docs: ${CODEGEN_DOCS_URL}`);
+}
+
+class CodegenApp {
+  _raysurfer;
+  _defaultCodegenApiKey;
+  _defaultCodegenModel;
+  _defaultExecutionTimeoutMs;
+  constructor(options = {}) {
+    const {
+      raysurfer,
+      codegenApiKey,
+      codegenModel,
+      executionTimeoutMs,
+      ...clientOptions
+    } = options;
+    this._raysurfer = raysurfer ?? new client_default(clientOptions);
+    this._defaultCodegenApiKey = codegenApiKey;
+    this._defaultCodegenModel = codegenModel ?? DEFAULT_CODEGEN_MODEL;
+    this._defaultExecutionTimeoutMs = executionTimeoutMs ?? DEFAULT_EXECUTION_TIMEOUT_MS;
+  }
+  get raysurfer() {
+    return this._raysurfer;
+  }
+  tool(name, description, parameters, callback) {
+    this._raysurfer.tool(name, description, parameters, callback);
+    return this;
+  }
+  async run(task, options = {}) {
+    const codegenApiKey = this.resolveCodegenApiKey(options.codegenApiKey);
+    const codegenPrompt = this.resolveCodegenPrompt(task, options.codegenPrompt);
+    const codegenModel = options.codegenModel ?? this._defaultCodegenModel;
+    const timeout = options.executionTimeoutMs ?? this._defaultExecutionTimeoutMs;
+    return this._raysurfer.executeWithSandboxCodegen(task, {
+      provider: "anthropic",
+      apiKey: codegenApiKey,
+      prompt: codegenPrompt,
       model: codegenModel
     }, { timeout });
   }
@@ -1190,6 +1859,10 @@ class CodegenApp {
     throw invalidCodegenPromptError(value);
   }
 }
+
+// src/index.ts
+init_client();
+
 // src/config.ts
 import { readFileSync } from "node:fs";
 function coerceStringList(value) {
@@ -1339,6 +2012,10 @@ function loadConfig(path, modules) {
   }
   return functions;
 }
+
+// src/index.ts
+init_errors();
+
 // src/logging.ts
 var CAP = 1000;
 var telemetry = new Map;
@@ -1685,535 +2362,83 @@ class ProgrammaticToolCallingSession {
     }
   }
 }
-// src/sdk-client.ts
-import { existsSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
-import { join } from "node:path";
-var DEFAULT_RAYSURFER_URL = "https://api.raysurfer.com";
-var CACHE_DIR = ".raysurfer_code";
-var DEFAULT_RUN_PARSE_SAMPLE_RATE = 1;
-var RUN_PARSE_SAMPLE_RATE_ENV_VAR = "RAYSURFER_RUN_PARSE_SAMPLE_RATE";
-var DEFAULT_AGENT_COMPAT_TOOLS_PRESET = {
-  type: "preset",
-  preset: "claude_code"
-};
-var DEFAULT_SANDBOX_SETTINGS = {
-  enabled: true,
-  autoAllowBashIfSandboxed: true
-};
-function resolveRunParseSampleRate(configured) {
-  if (configured !== undefined) {
-    if (!Number.isFinite(configured) || configured < 0 || configured > 1) {
-      throw new Error(`runParseSampleRate must be between 0.0 and 1.0 inclusive; got ${configured}.`);
-    }
-    return configured;
-  }
-  const envValue = process.env[RUN_PARSE_SAMPLE_RATE_ENV_VAR];
-  if (!envValue || envValue.trim() === "") {
-    return DEFAULT_RUN_PARSE_SAMPLE_RATE;
-  }
-  const parsed = Number(envValue);
-  if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
-    console.warn(`[raysurfer] ${RUN_PARSE_SAMPLE_RATE_ENV_VAR}=${JSON.stringify(envValue)} is invalid. ` + `Expected a number between 0.0 and 1.0 inclusive. Falling back to ${DEFAULT_RUN_PARSE_SAMPLE_RATE}.`);
-    return DEFAULT_RUN_PARSE_SAMPLE_RATE;
-  }
-  return parsed;
-}
-function shouldParseRunForAiVoting(sampleRate) {
-  if (sampleRate >= 1)
-    return true;
-  if (sampleRate <= 0)
-    return false;
-  return Math.random() < sampleRate;
-}
-var FILE_MODIFY_TOOLS = ["Write", "Edit", "MultiEdit", "NotebookEdit"];
-var TRACKABLE_EXTENSIONS = new Set([
-  ".py",
-  ".js",
-  ".ts",
-  ".rb",
-  ".go",
-  ".rs",
-  ".java",
-  ".cpp",
-  ".c",
-  ".h",
-  ".pdf",
-  ".docx",
-  ".xlsx",
-  ".csv",
-  ".json",
-  ".yaml",
-  ".yml",
-  ".xml",
-  ".html",
-  ".css",
-  ".md",
-  ".txt",
-  ".sh",
-  ".sql"
-]);
-var BASH_OUTPUT_PATTERNS = [
-  />>\s*([^\s;&|]+)/g,
-  />\s*([^\s;&|]+)/g,
-  /-o\s+([^\s;&|]+)/g,
-  /--output[=\s]+([^\s;&|]+)/g,
-  /savefig\(['"]([^'"]+)['"]\)/g,
-  /to_csv\(['"]([^'"]+)['"]\)/g,
-  /to_excel\(['"]([^'"]+)['"]\)/g,
-  /write\(['"]([^'"]+)['"]\)/g
-];
-var createDebugLogger = (enabled) => ({
-  log: (...args) => enabled && console.log("[raysurfer]", ...args),
-  time: (label) => enabled && console.time(`[raysurfer] ${label}`),
-  timeEnd: (label) => enabled && console.timeEnd(`[raysurfer] ${label}`),
-  table: (data) => enabled && console.table(data),
-  group: (label) => enabled && console.group(`[raysurfer] ${label}`),
-  groupEnd: () => enabled && console.groupEnd()
-});
-function augmentSystemPrompt(systemPrompt, addition) {
-  if (!addition)
-    return systemPrompt;
-  if (typeof systemPrompt === "string")
-    return systemPrompt + addition;
-  if (systemPrompt?.type === "preset") {
-    return { ...systemPrompt, append: (systemPrompt.append ?? "") + addition };
-  }
-  return addition;
-}
-function splitOptions(options) {
-  const {
-    workspaceId,
-    publicSnips,
-    debug,
-    runParseSampleRate,
-    workingDirectory,
-    agentId,
-    ...sdkOptions
-  } = options;
-  return {
-    sdkOptions,
-    extras: {
-      workspaceId,
-      publicSnips,
-      debug,
-      runParseSampleRate,
-      workingDirectory,
-      agentId
-    }
-  };
-}
-function applyDefaultAgentCompatibilityOptions(options) {
-  const merged = { ...options };
-  const hasToolsPreset = merged.tools !== undefined && merged.tools !== null;
-  const hasAllowedTools = Array.isArray(merged.allowedTools) && merged.allowedTools.length > 0;
-  if (!hasToolsPreset && !hasAllowedTools) {
-    merged.tools = DEFAULT_AGENT_COMPAT_TOOLS_PRESET;
-  }
-  if (merged.sandbox && typeof merged.sandbox === "object") {
-    merged.sandbox = {
-      ...DEFAULT_SANDBOX_SETTINGS,
-      ...merged.sandbox
-    };
-  } else {
-    merged.sandbox = { ...DEFAULT_SANDBOX_SETTINGS };
-  }
-  return merged;
-}
+// src/runner.ts
+init_client();
 
-class RaysurferQuery {
-  _inner = null;
-  _initPromise = null;
-  _raysurfer = null;
-  _cachedFiles = [];
-  _modifiedFilePaths = new Set;
-  _bashGeneratedFiles = new Set;
-  _executionLogs = [];
-  _taskSucceeded = false;
-  _generatedCodeBlocks = [];
-  _cacheUploadDone = false;
-  _messageCount = 0;
-  _startTime = 0;
-  _promptText;
-  _params;
-  _debug;
-  _cacheEnabled;
-  _workDir;
+class Agent {
   _apiKey;
   _baseUrl;
-  _extras;
-  _sdkOptions;
-  _runParseSampleRate;
-  _parseRunForAiVoting;
-  constructor(params) {
-    this._params = params;
-    const options = params.options ?? {};
-    const { sdkOptions, extras } = splitOptions(options);
-    this._sdkOptions = applyDefaultAgentCompatibilityOptions(sdkOptions);
-    this._extras = extras;
-    this._promptText = typeof params.prompt === "string" ? params.prompt : null;
-    const debugEnabled = extras.debug || process.env.RAYSURFER_DEBUG === "true";
-    this._debug = createDebugLogger(debugEnabled);
-    this._apiKey = process.env.RAYSURFER_API_KEY;
-    this._baseUrl = process.env.RAYSURFER_BASE_URL || DEFAULT_RAYSURFER_URL;
-    this._cacheEnabled = !!this._apiKey;
-    this._runParseSampleRate = resolveRunParseSampleRate(extras.runParseSampleRate);
-    this._parseRunForAiVoting = shouldParseRunForAiVoting(this._runParseSampleRate);
-    if (extras.workingDirectory && !sdkOptions.cwd) {
-      console.warn("[raysurfer] workingDirectory is deprecated, use cwd instead");
-      this._sdkOptions.cwd = extras.workingDirectory;
-    }
-    this._workDir = this._sdkOptions.cwd || process.cwd();
-  }
-  async _initialize() {
-    this._debug.group("Raysurfer Query Started");
-    this._debug.log("Prompt:", this._promptText ?? "<stream>");
-    this._debug.log("Cache enabled:", this._cacheEnabled);
-    this._debug.log("Base URL:", this._baseUrl);
-    this._debug.log("Run parse sample rate:", this._runParseSampleRate);
-    this._debug.log("Parse this run for AI voting:", this._parseRunForAiVoting);
-    if (!this._cacheEnabled) {
-      console.warn("[raysurfer] RAYSURFER_API_KEY not set - caching disabled");
-    }
-    let addToLlmPrompt = "";
-    if (this._cacheEnabled && this._promptText) {
-      this._raysurfer = new RaySurfer({
+  _agentId;
+  _allowedTools;
+  _systemPrompt;
+  _model;
+  _raysurfer;
+  constructor(options = {}) {
+    this._apiKey = options.apiKey;
+    this._baseUrl = options.baseUrl;
+    this._agentId = options.agentId;
+    this._allowedTools = options.allowedTools ?? ["Read", "Write", "Bash"];
+    this._systemPrompt = options.systemPrompt ?? "You are a helpful assistant.";
+    this._model = options.model;
+  }
+  ensureClient(orgId) {
+    if (!this._raysurfer || orgId) {
+      this._raysurfer = new client_default({
         apiKey: this._apiKey,
         baseUrl: this._baseUrl,
-        workspaceId: this._extras.workspaceId,
-        snipsDesired: this._extras.workspaceId ? "client" : undefined,
-        publicSnips: this._extras.publicSnips,
-        agentId: this._extras.agentId
+        organizationId: orgId,
+        snipsDesired: orgId ? "company" : undefined,
+        agentId: this._agentId
       });
-      try {
-        this._debug.time("Cache lookup");
-        const cacheDir = join(this._workDir, CACHE_DIR);
-        const response = await this._raysurfer.getCodeFiles({
-          task: this._promptText,
-          topK: 5,
-          minVerdictScore: 0.3,
-          preferComplete: true,
-          perFunctionReputation: true,
-          cacheDir
-        });
-        this._debug.timeEnd("Cache lookup");
-        this._cachedFiles = response.files;
-        addToLlmPrompt = response.addToLlmPrompt;
-        this._debug.log(`Found ${this._cachedFiles.length} cached files:`);
-        console.log("[raysurfer] Cache hit:", this._cachedFiles.length, "snippets retrieved");
-        if (this._cachedFiles.length > 0) {
-          this._debug.table(this._cachedFiles.map((f) => ({
-            filename: f.filename,
-            score: `${Math.round(f.score * 100)}%`,
-            thumbs: `${f.thumbsUp}/${f.thumbsDown}`,
-            sourceLength: `${f.source.length} chars`
-          })));
-          try {
-            mkdirSync(cacheDir, { recursive: true });
-            for (const file of this._cachedFiles) {
-              const filePath = join(cacheDir, file.filename);
-              writeFileSync(filePath, file.source, "utf-8");
-              this._debug.log(`  → Wrote cached file: ${filePath}`);
-              this._modifiedFilePaths.add(filePath);
-            }
-          } catch (writeErr) {
-            this._debug.log("Failed to write cached files:", writeErr instanceof Error ? writeErr : String(writeErr));
-          }
-        }
-      } catch (error) {
-        const errMsg = error instanceof Error ? error.message : String(error);
-        this._debug.log("Cache lookup failed:", errMsg);
-        console.warn("[raysurfer] Cache unavailable:", errMsg);
-      }
-    }
-    const augmented = augmentSystemPrompt(this._sdkOptions.systemPrompt, addToLlmPrompt);
-    const augmentedOptions = {
-      ...this._sdkOptions,
-      systemPrompt: augmented
-    };
-    this._debug.log("Augmented prompt addition:", addToLlmPrompt.length, "chars");
-    let sdkQueryFn;
-    try {
-      const sdk = await import("@anthropic-ai/claude-agent-sdk");
-      sdkQueryFn = sdk.query;
-    } catch {
-      throw new Error("Could not import @anthropic-ai/claude-agent-sdk. Install it with: npm install @anthropic-ai/claude-agent-sdk");
-    }
-    this._debug.time("Claude API call");
-    this._debug.log("Calling Claude Agent SDK...");
-    this._startTime = Date.now();
-    this._inner = sdkQueryFn({
-      prompt: this._params.prompt,
-      options: augmentedOptions
-    });
-  }
-  async _ensureInit() {
-    if (!this._inner) {
-      if (!this._initPromise) {
-        this._initPromise = this._initialize();
-      }
-      await this._initPromise;
-    }
-    return this._inner;
-  }
-  _extractBashOutputFiles(command) {
-    for (const pattern of BASH_OUTPUT_PATTERNS) {
-      pattern.lastIndex = 0;
-      let match = pattern.exec(command);
-      while (match !== null) {
-        const filePath = match[1];
-        if (filePath && filePath.length > 0) {
-          const ext = filePath.substring(filePath.lastIndexOf(".")).toLowerCase();
-          if (TRACKABLE_EXTENSIONS.has(ext)) {
-            this._bashGeneratedFiles.add(filePath);
-            this._debug.log(`  → Bash output file detected: ${filePath}`);
-          }
-        }
-        match = pattern.exec(command);
-      }
-    }
-  }
-  _trackMessage(message) {
-    this._messageCount++;
-    const msg = message;
-    const elapsed = Date.now() - this._startTime;
-    this._debug.log(`
-═══════════════════════════════════════════════════`);
-    this._debug.log(`Message #${this._messageCount} [${elapsed}ms] type=${msg.type} subtype=${msg.subtype ?? "none"}`);
-    this._debug.log(`═══════════════════════════════════════════════════`);
-    this._debug.log(JSON.stringify(msg, null, 2));
-    if (msg.type === "assistant" && msg.message?.content) {
-      const blocks = msg.message.content;
-      for (const block of blocks) {
-        if (block.type === "tool_use" && block.name && FILE_MODIFY_TOOLS.includes(block.name)) {
-          const filePath = block.input?.file_path ?? block.input?.notebook_path;
-          if (filePath) {
-            this._debug.log(`  → ${block.name} tool detected:`, filePath);
-            this._modifiedFilePaths.add(filePath);
-          }
-        }
-        if (block.type === "tool_use" && block.name === "Bash") {
-          const command = block.input?.command;
-          if (command) {
-            this._extractBashOutputFiles(command);
-          }
-        }
-        if (block.type === "tool_result" && block.content) {
-          if (this._parseRunForAiVoting) {
-            this._executionLogs.push(block.content.slice(0, 5000));
-          }
-        }
-        if (block.type === "text" && block.text) {
-          const codeMatches = block.text.match(/```(?:typescript|javascript|ts|js)?\n?([\s\S]*?)\n?```/g);
-          if (codeMatches) {
-            for (const match of codeMatches) {
-              const code = match.replace(/```(?:typescript|javascript|ts|js)?\n?/, "").replace(/\n?```$/, "");
-              if (code.trim().length > 50) {
-                this._generatedCodeBlocks.push(code.trim());
-                this._debug.log(`  → Extracted code block (${code.length} chars)`);
-              }
-            }
-          }
-        }
-      }
-    }
-    if (msg.type === "result" && msg.subtype === "success") {
-      this._taskSucceeded = true;
-      this._debug.timeEnd("Claude API call");
-      this._debug.log("Task succeeded!");
-      this._debug.log("  Duration:", msg.duration_ms, "ms");
-      this._debug.log("  Total cost:", msg.total_cost_usd, "USD");
-      this._debug.log("  Turns:", msg.num_turns);
-    }
-    if (msg.type === "result" && msg.subtype !== "success") {
-      this._debug.timeEnd("Claude API call");
-      this._debug.log("Task failed:", msg.subtype);
     }
+    return this._raysurfer;
   }
-  async _uploadCache() {
-    if (this._cacheUploadDone)
-      return;
-    this._cacheUploadDone = true;
-    this._debug.log("Total messages streamed:", this._messageCount);
-    this._debug.log("Modified files tracked:", this._modifiedFilePaths.size);
-    this._debug.log("Code blocks extracted:", this._generatedCodeBlocks.length);
-    const filesToCache = [];
-    for (const filePath of this._modifiedFilePaths) {
-      if (filePath.includes(CACHE_DIR)) {
-        this._debug.log("  → Skipping cached file:", filePath);
-        continue;
-      }
-      try {
-        if (existsSync(filePath)) {
-          const content = readFileSync2(filePath, "utf-8");
-          if (content.includes("\x00")) {
-            this._debug.log("  → Skipping binary file:", filePath);
-            continue;
-          }
-          filesToCache.push({ path: filePath, content });
-          this._debug.log("  → Will cache file:", filePath, `(${content.length} chars)`);
-        } else {
-          this._debug.log("  → File not found:", filePath);
-        }
-      } catch (err) {
-        this._debug.log("  → Failed to read file:", filePath, err instanceof Error ? err : String(err));
-      }
+  async run(messages, options = {}) {
+    const rs = this.ensureClient(options.orgId);
+    const lastUserMsg = [...messages].reverse().find((m) => m.role === "user");
+    if (!lastUserMsg) {
+      throw new Error("Messages must contain at least one user message.");
     }
-    for (const filePath of this._bashGeneratedFiles) {
-      if (this._modifiedFilePaths.has(filePath))
-        continue;
-      try {
-        if (existsSync(filePath)) {
-          const content = readFileSync2(filePath, "utf-8");
-          if (!content.includes("\x00")) {
-            filesToCache.push({ path: filePath, content });
-            this._debug.log("  → Will cache Bash-generated file:", filePath, `(${content.length} chars)`);
-          }
+    const query2 = lastUserMsg.content;
+    const runId = crypto.randomUUID();
+    const searchResult = await rs.search({ task: query2 });
+    const codeUsed = searchResult.matches?.map((m) => ({
+      code_block_id: m.codeBlock.id,
+      filename: m.codeBlock.name,
+      description: m.codeBlock.description
+    })) ?? [];
+    let succeeded = false;
+    const responseMessages = [];
+    try {
+      const { query: sdkQuery } = await Promise.resolve().then(() => (init_sdk_client(), exports_sdk_client));
+      for await (const msg of sdkQuery({
+        prompt: query2,
+        options: {
+          allowedTools: this._allowedTools,
+          systemPrompt: this._systemPrompt,
+          model: this._model
         }
-      } catch {
-        this._debug.log("  → Failed to read Bash-generated file:", filePath);
-      }
-    }
-    if (this._generatedCodeBlocks.length > 0) {
-      const largestBlock = this._generatedCodeBlocks.reduce((a, b) => a.length > b.length ? a : b);
-      filesToCache.push({
-        path: "generated-code.ts",
-        content: largestBlock
-      });
-      this._debug.log("  → Will cache generated code block:", `(${largestBlock.length} chars)`);
-    }
-    this._debug.log("Total items to cache:", filesToCache.length);
-    if (this._cacheEnabled && this._raysurfer && this._taskSucceeded && this._promptText) {
-      const cachedBlocksForVoting = this._parseRunForAiVoting ? this._cachedFiles.map((f) => ({
-        codeBlockId: f.codeBlockId,
-        filename: f.filename,
-        description: f.description
-      })) : [];
-      if (filesToCache.length > 0 || cachedBlocksForVoting.length > 0) {
-        try {
-          this._debug.time("Cache upload + voting");
-          if (!this._parseRunForAiVoting) {
-            this._debug.log("Skipping AI voting parse for this run due sampling");
-          }
-          const joinedLogs = this._parseRunForAiVoting && this._executionLogs.length > 0 ? this._executionLogs.join(`
----
-`) : undefined;
-          this._debug.log("Uploading", filesToCache.length, "files, voting for", cachedBlocksForVoting.length, "cached blocks,", this._executionLogs.length, "log entries...");
-          for (const [i, file] of filesToCache.entries()) {
-            await this._raysurfer.uploadNewCodeSnip({
-              task: this._promptText,
-              fileWritten: file,
-              succeeded: true,
-              cachedCodeBlocks: i === 0 && cachedBlocksForVoting.length > 0 ? cachedBlocksForVoting : undefined,
-              useRaysurferAiVoting: this._parseRunForAiVoting,
-              executionLogs: joinedLogs,
-              perFunctionReputation: true
-            });
-          }
-          if (filesToCache.length === 0 && cachedBlocksForVoting.length > 0) {
-            for (const cb of cachedBlocksForVoting) {
-              await this._raysurfer.voteCodeSnip({
-                task: this._promptText,
-                codeBlockId: cb.codeBlockId,
-                codeBlockName: cb.filename,
-                codeBlockDescription: cb.description,
-                succeeded: true
-              });
-            }
-          }
-          this._debug.timeEnd("Cache upload + voting");
-          this._debug.log("Cache upload successful, voting queued on backend");
-          console.log("[raysurfer] Cache upload successful:", filesToCache.length, "files stored");
-        } catch (error) {
-          const errMsg = error instanceof Error ? error.message : String(error);
-          this._debug.log("Cache upload failed:", errMsg);
-          console.warn("[raysurfer] Cache upload failed:", errMsg);
+      })) {
+        responseMessages.push(msg);
+        if (typeof msg === "object" && msg !== null && "type" in msg && msg.type === "result" && "subtype" in msg && msg.subtype === "success") {
+          succeeded = true;
         }
       }
+    } catch {
+      succeeded = false;
     }
-    this._debug.groupEnd();
-  }
-  async next(...args) {
-    const inner = await this._ensureInit();
-    const result = await inner.next(...args);
-    if (!result.done) {
-      this._trackMessage(result.value);
-    } else {
-      await this._uploadCache();
-    }
-    return result;
-  }
-  async return(value) {
-    if (this._inner) {
-      await this._uploadCache();
-      return this._inner.return(value);
-    }
-    return { done: true, value: undefined };
-  }
-  async throw(e) {
-    if (this._inner)
-      return this._inner.throw(e);
-    throw e;
-  }
-  [Symbol.asyncIterator]() {
-    return this;
-  }
-  async[Symbol.asyncDispose]() {
-    this.close();
-  }
-  async interrupt() {
-    return (await this._ensureInit()).interrupt();
-  }
-  async setPermissionMode(mode) {
-    return (await this._ensureInit()).setPermissionMode(mode);
-  }
-  async setModel(model) {
-    return (await this._ensureInit()).setModel(model);
-  }
-  async setMaxThinkingTokens(maxThinkingTokens) {
-    return (await this._ensureInit()).setMaxThinkingTokens(maxThinkingTokens);
-  }
-  async supportedCommands() {
-    return (await this._ensureInit()).supportedCommands();
-  }
-  async supportedModels() {
-    return (await this._ensureInit()).supportedModels();
-  }
-  async mcpServerStatus() {
-    return (await this._ensureInit()).mcpServerStatus();
-  }
-  async accountInfo() {
-    return (await this._ensureInit()).accountInfo();
-  }
-  async rewindFiles(userMessageId, options) {
-    return (await this._ensureInit()).rewindFiles(userMessageId, options);
-  }
-  async setMcpServers(servers) {
-    return (await this._ensureInit()).setMcpServers(servers);
-  }
-  async streamInput(stream) {
-    return (await this._ensureInit()).streamInput(stream);
-  }
-  close() {
-    if (this._inner)
-      this._inner.close();
-  }
-}
-function query(params) {
-  return new RaysurferQuery(params);
-}
-
-class ClaudeSDKClient {
-  options;
-  constructor(options = {}) {
-    this.options = options;
-  }
-  query(prompt) {
-    return query({ prompt, options: this.options });
+    return {
+      runId,
+      query: query2,
+      succeeded,
+      messages: responseMessages,
+      codeUsed
+    };
   }
 }
-var sdk_client_default = query;
 
 // src/index.ts
+init_sdk_client();
 import {
   AbortError,
   createSdkMcpServer,
@@ -2252,6 +2477,7 @@ export {
   CacheUnavailableError,
   AuthenticationError,
   AgentVerdict,
+  Agent,
   AbortError,
   APIError
 };